Cosmos Hub - Cheat-sheet

Cosmos Hub Cheat Sheet and Key Management

This guide provides essential commands for managing wallets, nodes, and validators on the Cosmos Hub network. Make sure the environment variables mentioned at the end are correctly configured before using these commands.

1. Key Management

Create a New Wallet

⚠️ Important: Keep the generated seed phrase safe. It is the only way to recover your wallet.

gaiad keys add $WALLET

Recover Wallet from Seed Phrase

gaiad keys add $WALLET --recover

List Wallets

gaiad keys list

Show Wallet Details

gaiad keys show $WALLET

Delete Wallet

gaiad keys delete $WALLET

2. Wallet Operations

Check Balance

gaiad query bank balances $(gaiad keys show $WALLET -a)

Send Tokens

gaiad tx bank send $WALLET <recipient_address> <amount>uatom --chain-id cosmoshub-4 --gas auto --gas-adjustment 1.5 --fees 500uatom

3. Validator Management

💡 Note: Ensure you have enough tokens for self-delegation and transaction fees before creating a validator.

Create Validator

gaiad tx staking create-validator \\
  --amount 1000000uatom \\
  --from $WALLET \\
  --commission-rate 0.1 \\
  --commission-max-rate 0.2 \\
  --commission-max-change-rate 0.01 \\
  --min-self-delegation 1 \\
  --pubkey $(gaiad tendermint show-validator) \\
  --moniker "$MONIKER" \\
  --identity "" \\
  --website "" \\
  --details "Your validator description" \\
  --security-contact "your@email.com" \\
  --chain-id cosmoshub-4 \\
  --gas auto --gas-adjustment 1.5 \\
  --fees 500uatom

Edit Validator

gaiad tx staking edit-validator \\
  --new-moniker "$MONIKER" \\
  --identity "" \\
  --website "" \\
  --details "Your validator description" \\
  --chain-id cosmoshub-4 \\
  --from $WALLET \\
  --gas auto --gas-adjustment 1.5 \\
  --fees 500uatom

Delegate Tokens

gaiad tx staking delegate $(gaiad keys show $WALLET --bech val -a) 1000000uatom --from $WALLET --chain-id cosmoshub-4 --gas auto --gas-adjustment 1.5 --fees 500uatom

Withdraw Rewards (Delegator)

gaiad tx distribution withdraw-rewards $(gaiad keys show $WALLET --bech val -a) --from $WALLET --chain-id cosmoshub-4 --gas auto --gas-adjustment 1.5 --fees 500uatom

Withdraw Rewards (Validator Commission)

gaiad tx distribution withdraw-rewards $(gaiad keys show $WALLET --bech val -a) --commission --from $WALLET --chain-id cosmoshub-4 --gas auto --gas-adjustment 1.5 --fees 500uatom

Unbond Tokens

gaiad tx staking unbond $(gaiad keys show $WALLET --bech val -a) 1000000uatom --from $WALLET --chain-id cosmoshub-4 --gas auto --gas-adjustment 1.5 --fees 500uatom

Redelegate Tokens

gaiad tx staking redelegate $(gaiad keys show $WALLET --bech val -a) <destination_validator_address> 1000000uatom --from $WALLET --chain-id cosmoshub-4 --gas auto --gas-adjustment 1.5 --fees 500uatom

4. Node Status & Info

Check Sync Status

gaiad status 2>&1 | jq .SyncInfo

Check Peer Info

curl -s localhost:26657/net_info | jq -r '.result.peers[] | "\\(.node_info.id)@\\(.remote_ip):\\(.node_info.listen_addr | split(":")[2])"'

Show Node ID

gaiad tendermint show-node-id

Restart Node

sudo systemctl restart gaiad

View Node Logs

sudo journalctl -u gaiad -f -o cat

5. Governance

List Proposals

gaiad query gov proposals

View Proposal Details

gaiad query gov proposal <proposal_id>

Vote on Proposal

gaiad tx gov vote <proposal_id> yes --from $WALLET --chain-id cosmoshub-4 --gas auto --gas-adjustment 1.5 --fees 500uatom

6. Environment Variables

💡 Tip: Make sure to set these in your ~/.bash_profile or equivalent shell config.

echo "export WALLET=\"wallet\"" >> $HOME/.bash_profile
echo "export MONIKER=\"your-moniker\"" >> $HOME/.bash_profile
echo "export CHAIN_ID=\"cosmoshub-4\"" >> $HOME/.bash_profile
source $HOME/.bash_profile

This cheat sheet is provided to streamline Cosmos Hub validator and wallet management. All commands use environment variables for easier management.