Upgrade

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)

get

Path parameters

last_heightanyRequired

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

Responses

200

A successful response.

application/json

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

upgraded_consensus_statestring · byteOptional

default

An unexpected error response.

application/json

get

/cosmos/upgrade/v1beta1/upgraded_consensus_state/{last_height}

HTTPcURLJavaScriptPython

GET /cosmos/upgrade/v1beta1/upgraded_consensus_state/{last_height} HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*

{
  "upgraded_consensus_state": "Ynl0ZXM="
}

AppliedPlan queries a previously applied upgrade plan by its name.

get

Path parameters

nameanyRequired

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

Responses

200

A successful response.

application/json

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

heightstring · int64Optional

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

default

An unexpected error response.

application/json

get

/cosmos/upgrade/v1beta1/applied_plan/{name}

HTTPcURLJavaScriptPython

GET /cosmos/upgrade/v1beta1/applied_plan/{name} HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*

{
  "height": "text"
}

Returns the account with authority to conduct upgrades

get

Since: cosmos-sdk 0.46

Responses

200

A successful response.

application/json

Since: cosmos-sdk 0.46

addressstringOptional

default

An unexpected error response.

application/json

get

/cosmos/upgrade/v1beta1/authority

HTTPcURLJavaScriptPython

GET /cosmos/upgrade/v1beta1/authority HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*

{
  "address": "text"
}

CurrentPlan queries the current upgrade plan.

get

Responses

200

A successful response.

application/json

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

default

An unexpected error response.

application/json

get

/cosmos/upgrade/v1beta1/current_plan

HTTPcURLJavaScriptPython

GET /cosmos/upgrade/v1beta1/current_plan HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*

{
  "plan": {
    "name": "text",
    "time": "2026-02-19T22:41:45.736Z",
    "height": "text",
    "info": "text",
    "upgraded_client_state": {
      "type_url": "text",
      "value": "Ynl0ZXM="
    }
  }
}

ModuleVersions queries the list of module versions from state.

get

Since: cosmos-sdk 0.43

Query parameters

module_nameanyOptional

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.

Responses

200

A successful response.

application/json

QueryModuleVersionsResponse is the response type for the Query/ModuleVersions RPC method.

Since: cosmos-sdk 0.43

default

An unexpected error response.

application/json

get

/cosmos/upgrade/v1beta1/module_versions

HTTPcURLJavaScriptPython

GET /cosmos/upgrade/v1beta1/module_versions HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*

{
  "module_versions": [
    {
      "name": "text",
      "version": "text"
    }
  ]
}