Skip to content

Transactions & Governance (Cosmos SDK 0.53)

All governance actions are performed from your Cold Account Machine, using the cold-key-name stored in your file keyring. This is the governance key you created when joining the network (see quickstart).

Transactions are sent through an RPC endpoint (here referred to as $SEED_URL/chain-rpc/). If you do not specify --node, the CLI defaults to tcp://localhost:26657. Unless you run your own node locally, always provide --node $SEED_URL/chain-rpc/.

Unordered transactions are supported and recommended here to avoid sequence contention. (docs.cosmos.network)

Always include these flags in transaction commands:

  • --from <cold-key-name> -> use your cold governance key.
  • --keyring-backend file -> ensures signing with your local key (you will be prompted).
  • --unordered --timeout-duration=60s -> makes the tx valid for a bounded time, bypassing sequence ordering (new in v0.53+).
  • --gas=2000000 --gas-adjustment=5.0 -> manual gas setting with buffer.
  • --node $SEED_URL/chain-rpc/ -> required unless you run a local RPC node.
  • --yes -> auto-approve broadcasting.

For background on transaction lifecycle and gas, see Cosmos SDK: Transactions and Gas & Fees.

When a Governance Proposal Is Required

Governance Proposals are required for any on-chain changes that affect the network, for example:

  • Updating module parameters (MsgUpdateParams)
  • Executing software upgrades
  • Adding, updating, or deprecating inference models
  • Any other actions that must be approved and executed via the governance module

Who can create a Governance Proposal

Anyone with a valid governance key (cold account) can pay the required fee and create a Governance Proposal. However, each proposal must still be approved by active participants through PoC-weighted voting.

Proposers are encouraged to discuss significant changes off-chain first (for example, via GitHub or community forums) to increase the likelihood of approval.

Track Proposal Status

# One proposal
inferenced query gov proposal <proposal_id> -o json --node $SEED_URL/chain-rpc/
# Tally only
inferenced query gov tally <proposal_id> -o json --node $SEED_URL/chain-rpc/
# List all
inferenced query gov proposals -o json --node $SEED_URL/chain-rpc/

(docs.cosmos.network)

Notes

  • Unordered tx semantics. When using --unordered, the tx carries an expiry via --timeout-duration, and its sequence is left unset. External tooling that expects monotonic sequences must not rely on them for these txs. (docs.cosmos.network)
  • Gas tuning. If simulations are tight or validators use higher min gas prices, raise --gas-adjustment or set --gas-prices per network policy. (docs.cosmos.network)