cosmos/upgrade
Table of Contents
cosmos/upgrade/module/v1/module.proto
TopModule
Module is the config object of the upgrade module.
| Field | Type | Label | Description |
| authority | string | authority defines the custom module authority. If not set, defaults to the governance module. |
cosmos/upgrade/v1beta1/query.proto
TopQueryAppliedPlanRequest
QueryCurrentPlanRequest is the request type for the Query/AppliedPlan RPC
method.
| Field | Type | Label | Description |
| name | string | name is the name of the applied plan to query for. |
QueryAppliedPlanResponse
QueryAppliedPlanResponse is the response type for the Query/AppliedPlan RPC
method.
| Field | Type | Label | Description |
| height | int64 | height is the block height at which the plan was applied. |
QueryAuthorityRequest
QueryAuthorityRequest is the request type for Query/Authority
Since: cosmos-sdk 0.46
QueryAuthorityResponse
QueryAuthorityResponse is the response type for Query/Authority
Since: cosmos-sdk 0.46
| Field | Type | Label | Description |
| address | string |
|
QueryCurrentPlanRequest
QueryCurrentPlanRequest is the request type for the Query/CurrentPlan RPC
method.
QueryCurrentPlanResponse
QueryCurrentPlanResponse is the response type for the Query/CurrentPlan RPC
method.
| Field | Type | Label | Description |
| plan | Plan | plan is the current upgrade plan. |
QueryModuleVersionsRequest
QueryModuleVersionsRequest is the request type for the Query/ModuleVersions
RPC method.
Since: cosmos-sdk 0.43
| Field | Type | Label | Description |
| module_name | string | module_name is a field to query a specific module consensus version from state. Leaving this empty will fetch the full list of module versions from state |
QueryModuleVersionsResponse
QueryModuleVersionsResponse is the response type for the Query/ModuleVersions
RPC method.
Since: cosmos-sdk 0.43
| Field | Type | Label | Description |
| module_versions | ModuleVersion | repeated | module_versions is a list of module names with their consensus versions. |
QueryUpgradedConsensusStateRequest
QueryUpgradedConsensusStateRequest is the request type for the Query/UpgradedConsensusState
RPC method.
| Field | Type | Label | Description |
| last_height | int64 | last height of the current chain must be sent in request as this is the height under which next consensus state is stored |
QueryUpgradedConsensusStateResponse
QueryUpgradedConsensusStateResponse is the response type for the Query/UpgradedConsensusState
RPC method.
| Field | Type | Label | Description |
| upgraded_consensus_state | bytes | Since: cosmos-sdk 0.43 |
Query
Query defines the gRPC upgrade querier service.
| Method Name | Request Type | Response Type | Description |
| CurrentPlan | QueryCurrentPlanRequest | QueryCurrentPlanResponse | CurrentPlan queries the current upgrade plan. |
| AppliedPlan | QueryAppliedPlanRequest | QueryAppliedPlanResponse | AppliedPlan queries a previously applied upgrade plan by its name. |
| UpgradedConsensusState | QueryUpgradedConsensusStateRequest | QueryUpgradedConsensusStateResponse | UpgradedConsensusState queries the consensus state that will serve as a trusted kernel for the next version of this chain. It will only be stored at the last height of this chain. UpgradedConsensusState RPC not supported with legacy querier This rpc is deprecated now that IBC has its own replacement (https://github.com/cosmos/ibc-go/blob/2c880a22e9f9cc75f62b527ca94aa75ce1106001/proto/ibc/core/client/v1/query.proto#L54) |
| ModuleVersions | QueryModuleVersionsRequest | QueryModuleVersionsResponse | ModuleVersions queries the list of module versions from state. Since: cosmos-sdk 0.43 |
| Authority | QueryAuthorityRequest | QueryAuthorityResponse | Returns the account with authority to conduct upgrades Since: cosmos-sdk 0.46 |
Methods with deprecated option
| Method Name | Option |
| UpgradedConsensusState | true |
Methods with HTTP bindings
| Method Name | Method | Pattern | Body |
| CurrentPlan | GET | /cosmos/upgrade/v1beta1/current_plan | |
| AppliedPlan | GET | /cosmos/upgrade/v1beta1/applied_plan/{name} | |
| UpgradedConsensusState | GET | /cosmos/upgrade/v1beta1/upgraded_consensus_state/{last_height} | |
| ModuleVersions | GET | /cosmos/upgrade/v1beta1/module_versions | |
| Authority | GET | /cosmos/upgrade/v1beta1/authority |
cosmos/upgrade/v1beta1/tx.proto
TopSince: cosmos-sdk 0.46
MsgCancelUpgrade
MsgCancelUpgrade is the Msg/CancelUpgrade request type.
Since: cosmos-sdk 0.46
| Field | Type | Label | Description |
| authority | string | authority is the address that controls the module (defaults to x/gov unless overwritten). |
MsgCancelUpgradeResponse
MsgCancelUpgradeResponse is the Msg/CancelUpgrade response type.
Since: cosmos-sdk 0.46
MsgSoftwareUpgrade
MsgSoftwareUpgrade is the Msg/SoftwareUpgrade request type.
Since: cosmos-sdk 0.46
| Field | Type | Label | Description |
| authority | string | authority is the address that controls the module (defaults to x/gov unless overwritten). |
|
| plan | Plan | plan is the upgrade plan. |
MsgSoftwareUpgradeResponse
MsgSoftwareUpgradeResponse is the Msg/SoftwareUpgrade response type.
Since: cosmos-sdk 0.46
Msg
Msg defines the upgrade Msg service.
| Method Name | Request Type | Response Type | Description |
| SoftwareUpgrade | MsgSoftwareUpgrade | MsgSoftwareUpgradeResponse | SoftwareUpgrade is a governance operation for initiating a software upgrade. Since: cosmos-sdk 0.46 |
| CancelUpgrade | MsgCancelUpgrade | MsgCancelUpgradeResponse | CancelUpgrade is a governance operation for cancelling a previously approved software upgrade. Since: cosmos-sdk 0.46 |
cosmos/upgrade/v1beta1/upgrade.proto
TopCancelSoftwareUpgradeProposal
CancelSoftwareUpgradeProposal is a gov Content type for cancelling a software
upgrade.
Deprecated: This legacy proposal is deprecated in favor of Msg-based gov
proposals, see MsgCancelUpgrade.
| Field | Type | Label | Description |
| title | string | title of the proposal |
|
| description | string | description of the proposal |
ModuleVersion
ModuleVersion specifies a module and its consensus version.
Since: cosmos-sdk 0.43
| Field | Type | Label | Description |
| name | string | name of the app module |
|
| version | uint64 | consensus version of the app module |
Plan
Plan specifies information about a planned upgrade and when it should occur.
| Field | Type | Label | Description |
| name | string | Sets the name for the upgrade. This name will be used by the upgraded version of the software to apply any special "on-upgrade" commands during the first BeginBlock method after the upgrade is applied. It is also used to detect whether a software version can handle a given upgrade. If no upgrade handler with this name has been set in the software, it will be assumed that the software is out-of-date when the upgrade Time or Height is reached and the software will exit. |
|
| time | google.protobuf.Timestamp | Deprecated. Deprecated: Time based upgrades have been deprecated. Time based upgrade logic has been removed from the SDK. If this field is not empty, an error will be thrown. |
|
| height | int64 | The height at which the upgrade must be performed. |
|
| info | string | Any application specific upgrade info to be included on-chain such as a git commit that validators could automatically upgrade to |
|
| upgraded_client_state | google.protobuf.Any | Deprecated. Deprecated: UpgradedClientState field has been deprecated. IBC upgrade logic has been moved to the IBC module in the sub module 02-client. If this field is not empty, an error will be thrown. |
Fields with deprecated option
| Name | Option |
| time | true |
| upgraded_client_state | true |
SoftwareUpgradeProposal
SoftwareUpgradeProposal is a gov Content type for initiating a software
upgrade.
Deprecated: This legacy proposal is deprecated in favor of Msg-based gov
proposals, see MsgSoftwareUpgrade.
| Field | Type | Label | Description |
| title | string | title of the proposal |
|
| description | string | description of the proposal |
|
| plan | Plan | plan of the proposal |
Scalar Value Types
| .proto Type | Notes | Python Type |
| double | float | |
| float | float | |
| int32 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. | int |
| int64 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. | int/long |
| uint32 | Uses variable-length encoding. | int/long |
| uint64 | Uses variable-length encoding. | int/long |
| sint32 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. | int |
| sint64 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. | int/long |
| fixed32 | Always four bytes. More efficient than uint32 if values are often greater than 2^28. | int |
| fixed64 | Always eight bytes. More efficient than uint64 if values are often greater than 2^56. | int/long |
| sfixed32 | Always four bytes. | int |
| sfixed64 | Always eight bytes. | int/long |
| bool | boolean | |
| string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | str/unicode |
| bytes | May contain any arbitrary sequence of bytes. | str |