Upgrade

AppliedPlan queries a previously applied upgrade plan by its name.

get
Authorizations
Path parameters
namestringRequired

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

Responses
200
A successful response.
application/json
get
GET /cosmos/upgrade/v1beta1/applied_plan/{name} HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*
{
  "height": "text"
}

Returns the account with authority to conduct upgrades

get

Since: cosmos-sdk 0.46

Authorizations
Responses
200
A successful response.
application/json
get
GET /cosmos/upgrade/v1beta1/authority HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*
{
  "address": "text"
}

CurrentPlan queries the current upgrade plan.

get
Authorizations
Responses
200
A successful response.
application/json
get
GET /cosmos/upgrade/v1beta1/current_plan HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*
{
  "plan": {
    "name": "text",
    "time": "2025-07-22T15:01:24.235Z",
    "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

Authorizations
Query parameters
module_namestringOptional

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
get
GET /cosmos/upgrade/v1beta1/module_versions HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*
{
  "module_versions": [
    {
      "name": "text",
      "version": "text"
    }
  ]
}

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
Authorizations
Path parameters
last_heightstring · int64Required

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
get
GET /cosmos/upgrade/v1beta1/upgraded_consensus_state/{last_height} HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*
{
  "upgraded_consensus_state": "Ynl0ZXM="
}