var img = document.createElement('img'); img.src = "https://terradocs.matomo.cloud//piwik.php?idsite=1&rec=1&url=https://docs.terra.money" + location.pathname; img.style = "border:0"; img.alt = "tracker"; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(img,s);
Skip to main content

terrad tx gov submit-proposal ibc-upgrade

Submit an IBC upgrade proposal.

Synopsis

Submit an IBC client breaking upgrade proposal along with an initial deposit. The client state specified is the upgraded client state representing the upgraded chain.

Example Upgraded Client State JSON

JSON
Copy

_8
{
_8
"@type":"/ibc.lightclients.tendermint.v1.ClientState",
_8
"chain_id":"testchain1",
_8
"unbonding_period":"1814400s",
_8
"latest_height":{"revision_number":"0","revision_height":"2"},
_8
"proof_specs":[{"leaf_spec":{"hash":"SHA256","prehash_key":"NO_HASH","prehash_value":"SHA256","length":"VAR_PROTO","prefix":"AA=="},"inner_spec":{"child_order":[0,1],"child_size":33,"min_prefix_length":4,"max_prefix_length":12,"empty_child":null,"hash":"SHA256"},"max_depth":0,"min_depth":0},{"leaf_spec":{"hash":"SHA256","prehash_key":"NO_HASH","prehash_value":"SHA256","length":"VAR_PROTO","prefix":"AA=="},"inner_spec":{"child_order":[0,1],"child_size":32,"min_prefix_length":1,"max_prefix_length":1,"empty_child":null,"hash":"SHA256"},"max_depth":0,"min_depth":0}],
_8
"upgrade_path":["upgrade","upgradedIBCState"],
_8
}

Usage

Terrad
Copy

_1
terrad tx gov submit-proposal ibc-upgrade [name] [height] [path/to/upgraded_client_state.json] [flags]

Options

Terrad
Copy

_25
-a, --account-number uint The account number of the signing account (offline mode only)
_25
-b, --broadcast-mode string Transaction broadcasting mode (sync|async|block) (default "sync")
_25
--deposit string deposit of proposal
_25
--description string description of proposal
_25
--dry-run ignore the --gas flag and perform a simulation of a transaction, but don't broadcast it (when enabled, the local Keybase is not accessible)
_25
--fee-account string Fee account pays fees for the transaction instead of deducting from the signer
_25
--fees string Fees to pay along with transaction; eg: 10uluna
_25
--from string Name or address of private key with which to sign
_25
--gas string gas limit to set per-transaction; set to "auto" to calculate sufficient gas automatically (default 200000)
_25
--gas-adjustment float adjustment factor to be multiplied against the estimate returned by the tx simulation; if the gas limit is set manually this flag is ignored (default 1)
_25
--gas-prices string Gas prices in decimal format to determine the transaction fee (e.g. 0.1uluna)
_25
--generate-only Build an unsigned transaction and write it to STDOUT (when enabled, the local Keybase is not accessible)
_25
-h, --help help
_25
--keyring-backend string Select keyring's backend (os|file|kwallet|pass|test|memory) (default "os")
_25
--keyring-dir string The client Keyring directory; if omitted, the default 'home' directory will be used
_25
--ledger Use a connected Ledger device
_25
--node string <host>:<port> to tendermint rpc interface for this chain (default "tcp://localhost:26657")
_25
--note string Note to add a description to the transaction (previously --memo)
_25
--offline Offline mode (does not allow any online functionality
_25
-o, --output string Output format (text|json) (default "json")
_25
-s, --sequence uint The sequence number of the signing account (offline mode only)
_25
--sign-mode string Choose sign mode (direct|amino-json), this is an advanced feature
_25
--timeout-height uint Set a block timeout height to prevent the tx from being committed past a certain height
_25
--title string title of proposal
_25
-y, --yes Skip tx broadcasting prompt confirmation

Options inherited from parent commands

Terrad
Copy

_1
--chain-id string The network chain ID

See also