Mainnet
The release to run on the Cosmos Hub mainnet, chain-idcosmoshub-4, is gaia v29.0.1.
v29.0.1 at height 33789237.
The chain moved to v29 at height 33618500 on 2026-10-28, through governance proposal 1059 (upgrade name v29.0.0). The v29.0.1 release notes tell operators to run v29.0.1 for that upgrade. It is the same upgrade built with a newer Go toolchain. Upgrade history lists every upgrade. Build or download v29.0.1.
Confirm the same numbers from your own binary:
Testnet
The public testnet, chain-idprovider, runs the release candidate that will reach mainnet next. On 2026-11-08 it ran gaia v29.1.0-rc0, upgraded at height 19696000 on 2026-11-03 through testnet proposal 332.
Facts that depend on the version
- The Hub currently runs Cosmos SDK v0.53 staking. gaia v29.0.1 has no command to rotate a validator key:
gaiad tx staking --helplistscancel-unbond,create-validator,delegate,edit-validator,redelegate, andunbondonly. The operator key can never be changed. The consensus key has no rotation path on the Hub. The node key is simply regenerated when needed. - The
gaiad configcommand is confix v0.1.2. Setting aconfig.tomlkey needsgaiad config set config <key> <value> -s. Without-s, confix answerscometbft config is not supported. App keys work without it:gaiad config set app <key> <value>. - The database backend defaults to goleveldb. PebbleDB is built in (
pebbledb). See Database backends. - The
--x-crisis-skip-assert-invariantsflag is gone. Thepruning-keep-everyoption is gone. Both still appear in old guides. - The
x/paramsmodule is gone in v29. There is nogaiad query paramscommand and nocosmos.params.v1beta1.Queryservice. Each module keeps its own parameters, read withgaiad query <module> paramsand changed by a governance proposal carrying that module’sMsgUpdateParams. The legacyParameterChangeProposalroute is gone. See Parameter change proposals. - On v29.0.x, 21 old proposals (the newest is 868) carry
ParameterChangeProposalcontent the node can no longer decode. Any query that reads one of them fails withno concrete type registered for type URL /cosmos.params.v1beta1.ParameterChangeProposal. That includesgaiad query gov proposalswith a--proposal-statusfilter. Read recent proposals withgaiad query gov proposals --page-reverse --page-limit 20instead. gaia v29.1.0 restores decoding. It is on the testnet and has not reached mainnet. - On Cosmos SDK v0.53.8,
--gas autodoes not work for a transaction from a multisig account. Pass a fixed--gasvalue. Single-key accounts are not affected. - The upgrade handlers compiled into v29.0.1 cover
v29_0_0only. Older upgrades require older binaries. See Upgrade history.
Which upstream docs apply
The Cosmos SDK and CometBFT sections of this site document their newest releases, which are ahead of what the Hub runs. The table says which copy to read for each operator topic. Concept pages are safe on the newest copy. Configuration references are not, so they point at the archived copy that matches the Hub.Verify
v29.0.1 for a mainnet binary built from the current tag. If your binary prints a different version, it is either an older release or a testnet release candidate.