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 ibc client upgrade

Upgrade an IBC client.

Synopsis

Upgrade the IBC client associated with the provided client identifier while providing proof committed by the counterparty chain to the new client and consensus states.

Terrad
Copy

_8
_8
ClientState JSON Example
_8
_8
{"@type":"/ibc.lightclients.solomachine.v1.ClientState","sequence":"1","frozen_sequence":"0","consensus_state":{"public_key":{"@type":"/cosmos.crypto.secp256k1.PubKey","key":"AtK50+5pJOoaa04qqAqrnyAqsYrwrR/INnA6UPIaYZlp"},"diversifier":"testing","timestamp":"10"},"allow_update_after_proposal":false}
_8
_8
ConsensusState JSON Example
_8
_8
{"@type":"/ibc.lightclients.solomachine.v1.ConsensusState","public_key":{"@type":"/cosmos.crypto.secp256k1.PubKey","key":"AtK50+5pJOoaa04qqAqrnyAqsYrwrR/INnA6UPIaYZlp"},"diversifier":"testing","timestamp":"10"}

Usage

Terrad
Copy

_1
terrad tx ibc client upgrade [client-identifier] [path/to/client_state.json] [path/to/consensus_state.json] [upgrade-client-proof] [upgrade-consensus-state-proof] [flags]

Example

Terrad
Copy

_1
terrad tx ibc client upgrade [client-identifier] [path/to/client_state.json] [path/to/consensus_state.json] [client-state-proof] [consensus-state-proof] --from node0 --home ../node0/<app>cli --chain-id $CID

Options

Terrad
Copy

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

Options inherited from parent commands

Terrad
Copy

_1
--chain-id string The network chain ID

See also