Osmosis - Cheat-sheet

Osmosis Cheat Sheet and Key Management

This guide provides essential commands for managing wallets, nodes, and validators on the Osmosis 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.

osmosisd keys add $WALLET

Recover Wallet from Seed Phrase

osmosisd keys add $WALLET --recover

List Wallets

osmosisd keys list

Show Wallet Details

osmosisd keys show $WALLET

Delete Wallet

osmosisd keys delete $WALLET

2. Wallet Operations

Check Balance

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

Send Tokens

osmosisd tx bank send $WALLET <recipient_address> <amount>uosmo --chain-id osmosis-1 --gas auto --gas-adjustment 1.5 --fees 500uosmo

3. Validator Management

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

Create Validator

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

Edit Validator

osmosisd tx staking edit-validator \\
  --new-moniker "$MONIKER" \\
  --identity "" \\
  --website "" \\
  --details "Your validator description" \\
  --chain-id osmosis-1 \\
  --from $WALLET \\
  --gas auto --gas-adjustment 1.5 \\
  --fees 500uosmo

Delegate Tokens

osmosisd tx staking delegate $(osmosisd keys show $WALLET --bech val -a) 1000000uosmo --from $WALLET --chain-id osmosis-1 --gas auto --gas-adjustment 1.5 --fees 500uosmo

Withdraw Rewards (Delegator)

osmosisd tx distribution withdraw-rewards $(osmosisd keys show $WALLET --bech val -a) --from $WALLET --chain-id osmosis-1 --gas auto --gas-adjustment 1.5 --fees 500uosmo

Withdraw Rewards (Validator Commission)

osmosisd tx distribution withdraw-rewards $(osmosisd keys show $WALLET --bech val -a) --commission --from $WALLET --chain-id osmosis-1 --gas auto --gas-adjustment 1.5 --fees 500uosmo

Unbond Tokens

osmosisd tx staking unbond $(osmosisd keys show $WALLET --bech val -a) 1000000uosmo --from $WALLET --chain-id osmosis-1 --gas auto --gas-adjustment 1.5 --fees 500uosmo

Redelegate Tokens

osmosisd tx staking redelegate $(osmosisd keys show $WALLET --bech val -a) <destination_validator_address> 1000000uosmo --from $WALLET --chain-id osmosis-1 --gas auto --gas-adjustment 1.5 --fees 500uosmo

4. Node Status & Info

Check Sync Status

osmosisd 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

osmosisd tendermint show-node-id

Restart Node

sudo systemctl restart osmosisd

View Node Logs

sudo journalctl -u osmosisd -f -o cat

5. Governance

List Proposals

osmosisd query gov proposals

View Proposal Details

osmosisd query gov proposal <proposal_id>

Vote on Proposal

osmosisd tx gov vote <proposal_id> yes --from $WALLET --chain-id osmosis-1 --gas auto --gas-adjustment 1.5 --fees 500uosmo

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=\"osmosis-1\"" >> $HOME/.bash_profile
source $HOME/.bash_profile

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