Client
CLI
A user can query and interact with the upgrade module using the CLI.
Query
The query commands allow users to query upgrade state.
simd query upgrade --helpapplied
The applied command allows users to query the block header for height at which a completed upgrade was applied.
simd query upgrade applied [upgrade-name] [flags]If upgrade-name was previously executed on the chain, this returns the header for the block at which it was applied. This helps a client determine which binary was valid over a given range of blocks, as well as more context to understand past migrations.
Example:
simd query upgrade applied "test-upgrade"Example Output:
"block_id": {
"hash": "A769136351786B9034A5F196DC53F7E50FCEB53B48FA0786E1BFC45A0BB646B5",
"parts": {
"total": 1,
"hash": "B13CBD23011C7480E6F11BE4594EE316548648E6A666B3575409F8F16EC6939E"
}
},
"block_size": "7213",
"header": {
"version": {
"block": "11"
},
"chain_id": "testnet-2",
"height": "455200",
"time": "2021-04-10T04:37:57.085493838Z",
"last_block_id": {
"hash": "0E8AD9309C2DC411DF98217AF59E044A0E1CCEAE7C0338417A70338DF50F4783",
"parts": {
"total": 1,
"hash": "8FE572A48CD10BC2CBB02653CA04CA247A0F6830FF19DC972F64D339A355E77D"
}
},
"last_commit_hash": "DE890239416A19E6164C2076B837CC1D7F7822FC214F305616725F11D2533140",
"data_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"validators_hash": "A31047ADE54AE9072EE2A12FF260A8990BA4C39F903EAF5636B50D58DBA72582",
"next_validators_hash": "A31047ADE54AE9072EE2A12FF260A8990BA4C39F903EAF5636B50D58DBA72582",
"consensus_hash": "048091BC7DDC283F77BFBF91D73C44DA58C3DF8A9CBC867405D8B7F3DAADA22F",
"app_hash": "28ECC486AFC332BA6CC976706DBDE87E7D32441375E3F10FD084CD4BAF0DA021",
"last_results_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
"proposer_address": "2ABC4854B1A1C5AA8403C4EA853A81ACA901CC76"
},
"num_txs": "0"
}module versions
The module_versions command gets a list of module names and their respective consensus versions.
Following the command with a specific module name will return only that module's information.
Example:
Example Output:
Example:
Example Output:
plan
The plan command gets the currently scheduled upgrade plan, if one exists.
Example:
Example Output:
REST
A user can query the upgrade module using REST endpoints.
Applied Plan
AppliedPlan queries a previously applied upgrade plan by its name.
Example:
Example Output:
Current Plan
CurrentPlan queries the current upgrade plan.
Example:
Example Output:
Module versions
ModuleVersions queries the list of module versions from state.
Example:
Example Output:
gRPC
A user can query the upgrade module using gRPC endpoints.
Applied Plan
AppliedPlan queries a previously applied upgrade plan by its name.
Example:
Example Output:
Current Plan
CurrentPlan queries the current upgrade plan.
Example:
Example Output:
Module versions
ModuleVersions queries the list of module versions from state.
Example:
Example Output:
Last updated