package cosmos.upgrade.v1beta1

Get desktop application:
View/edit binary Protocol Buffers messages

Msg defines the upgrade Msg service.

• rpc SoftwareUpgrade (MsgSoftwareUpgrade, MsgSoftwareUpgradeResponse)

  tx.proto:20

  SoftwareUpgrade is a governance operation for initiating a software upgrade. Since: cosmos-sdk 0.46

  message MsgSoftwareUpgrade

  tx.proto:32

  MsgSoftwareUpgrade is the Msg/SoftwareUpgrade request type. Since: cosmos-sdk 0.46

  • string authority = 1

    authority is the address that controls the module (defaults to x/gov unless overwritten).

  • optional Plan plan = 2

    plan is the upgrade plan.

  message MsgSoftwareUpgradeResponse

  tx.proto:46

  MsgSoftwareUpgradeResponse is the Msg/SoftwareUpgrade response type. Since: cosmos-sdk 0.46

  (message has no fields)

• rpc CancelUpgrade (MsgCancelUpgrade, MsgCancelUpgradeResponse)

  tx.proto:26

  CancelUpgrade is a governance operation for cancelling a previously approved software upgrade. Since: cosmos-sdk 0.46

  message MsgCancelUpgrade

  tx.proto:51

  MsgCancelUpgrade is the Msg/CancelUpgrade request type. Since: cosmos-sdk 0.46

  • string authority = 1

    authority is the address that controls the module (defaults to x/gov unless overwritten).

  message MsgCancelUpgradeResponse

  tx.proto:62

  MsgCancelUpgradeResponse is the Msg/CancelUpgrade response type. Since: cosmos-sdk 0.46

  (message has no fields)

Query defines the gRPC upgrade querier service.

• rpc CurrentPlan (QueryCurrentPlanRequest, QueryCurrentPlanResponse)

  query.proto:12

  CurrentPlan queries the current upgrade plan.

  message QueryCurrentPlanRequest

  query.proto:49

  QueryCurrentPlanRequest is the request type for the Query/CurrentPlan RPC method.

  (message has no fields)

  message QueryCurrentPlanResponse

  query.proto:53

  QueryCurrentPlanResponse is the response type for the Query/CurrentPlan RPC method.

  • optional Plan plan = 1

    plan is the current upgrade plan.

• rpc AppliedPlan (QueryAppliedPlanRequest, QueryAppliedPlanResponse)

  query.proto:17

  AppliedPlan queries a previously applied upgrade plan by its name.

  message QueryAppliedPlanRequest

  query.proto:60

  QueryCurrentPlanRequest is the request type for the Query/AppliedPlan RPC method.

  • string name = 1

    name is the name of the applied plan to query for.

  message QueryAppliedPlanResponse

  query.proto:67

  QueryAppliedPlanResponse is the response type for the Query/AppliedPlan RPC method.

  • int64 height = 1

    height is the block height at which the plan was applied.

• rpc UpgradedConsensusState (QueryUpgradedConsensusStateRequest, QueryUpgradedConsensusStateResponse)

  query.proto:27

  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)

  message QueryUpgradedConsensusStateRequest

  query.proto:74

  QueryUpgradedConsensusStateRequest is the request type for the Query/UpgradedConsensusState RPC method.

  • int64 last_height = 1

    last height of the current chain must be sent in request as this is the height under which next consensus state is stored

  message QueryUpgradedConsensusStateResponse

  query.proto:84

  QueryUpgradedConsensusStateResponse is the response type for the Query/UpgradedConsensusState RPC method.

  • bytes upgraded_consensus_state = 2

    Since: cosmos-sdk 0.43

• rpc ModuleVersions (QueryModuleVersionsRequest, QueryModuleVersionsResponse)

  query.proto:35

  ModuleVersions queries the list of module versions from state. Since: cosmos-sdk 0.43

  message QueryModuleVersionsRequest

  query.proto:96

  QueryModuleVersionsRequest is the request type for the Query/ModuleVersions RPC method. Since: cosmos-sdk 0.43

  • string module_name = 1

    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

  message QueryModuleVersionsResponse

  query.proto:107

  QueryModuleVersionsResponse is the response type for the Query/ModuleVersions RPC method. Since: cosmos-sdk 0.43

  • repeated ModuleVersion module_versions = 1

    module_versions is a list of module names with their consensus versions.

• rpc Authority (QueryAuthorityRequest, QueryAuthorityResponse)

  query.proto:42

  Returns the account with authority to conduct upgrades Since: cosmos-sdk 0.46

  message QueryAuthorityRequest

  query.proto:115

  QueryAuthorityRequest is the request type for Query/Authority Since: cosmos-sdk 0.46

  (message has no fields)

  message QueryAuthorityResponse

  query.proto:120

  QueryAuthorityResponse is the response type for Query/Authority Since: cosmos-sdk 0.46

  • string address = 1

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.

• string title = 1

  title of the proposal

• string description = 2

  description of the proposal

ModuleVersion specifies a module and its consensus version. Since: cosmos-sdk 0.43

Used in: QueryModuleVersionsResponse

• string name = 1

  name of the app module

• uint64 version = 2

  consensus version of the app module

Plan specifies information about a planned upgrade and when it should occur.

Used in: MsgSoftwareUpgrade, QueryCurrentPlanResponse, SoftwareUpgradeProposal, ibc.core.client.v1.UpgradeProposal

• string name = 1

  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.

• optional google.protobuf.Timestamp time = 2

  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.

• int64 height = 3

  The height at which the upgrade must be performed.

• string info = 4

  Any application specific upgrade info to be included on-chain such as a git commit that validators could automatically upgrade to

• optional google.protobuf.Any upgraded_client_state = 5

  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.

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.

• string title = 1

  title of the proposal

• string description = 2

  description of the proposal

• optional Plan plan = 3

  plan of the proposal