🔑 Key management
Add new key
osmosisd keys add wallet
Recover existing key
osmosisd keys add wallet --recover
List all keys
osmosisd keys list
Delete key
osmosisd keys delete wallet
Export key to a file
osmosisd keys export wallet
Import key from a file
osmosisd keys import wallet wallet.backup
Query wallet balance
osmosisd q bank balances $(osmosisd keys show wallet -a)
👷 Validator management
Please make sure you have adjusted moniker, identity, details and website to match your values.
Create new validator
osmosisd tx staking create-validator \
--amount 1000000uosmo \
--pubkey $(osmosisd tendermint show-validator) \
--moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id osmosis-1 \
--commission-rate 0.05 \
--commission-max-rate 0.20 \
--commission-max-change-rate 0.05 \
--min-self-delegation 1 \
--from wallet \
--gas-adjustment 1.4 \
--gas auto \
--gas-prices 0.0025uosmo \
-y
Edit existing validator
osmosisd tx staking edit-validator \
--new-moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id osmosis-1 \
--commission-rate 0.05 \
--from wallet \
--gas-adjustment 1.4 \
--gas auto \
--gas-prices 0.0025uosmo \
-y
Unjail validator
osmosisd tx slashing unjail --from wallet --chain-id osmosis-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.0025uosmo -y
Jail reason
osmosisd query slashing signing-info $(osmosisd tendermint show-validator)
List all active validators
osmosisd q staking validators -oj --limit=3000 | jq '.validators[] | select(.status=="BOND_STATUS_BONDED")' | jq -r '(.tokens|tonumber/pow(10; 6)|floor|tostring) + " \t " + .description.moniker' | sort -gr | nl
List all inactive validators
osmosisd q staking validators -oj --limit=3000 | jq '.validators[] | select(.status=="BOND_STATUS_UNBONDED")' | jq -r '(.tokens|tonumber/pow(10; 6)|floor|tostring) + " \t " + .description.moniker' | sort -gr | nl
View validator details
osmosisd q staking validator $(osmosisd keys show wallet --bech val -a)
💲 Token management
Withdraw rewards from all validators
osmosisd tx distribution withdraw-all-rewards --from wallet --chain-id osmosis-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.0025uosmo -y
Withdraw commission and rewards from your validator
osmosisd tx distribution withdraw-rewards $(osmosisd keys show wallet --bech val -a) --commission --from wallet --chain-id osmosis-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.0025uosmo -y
Delegate tokens to yourself
osmosisd tx staking delegate $(osmosisd keys show wallet --bech val -a) 1000000uosmo --from wallet --chain-id osmosis-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.0025uosmo -y
Delegate tokens to validator
osmosisd tx staking delegate <TO_VALOPER_ADDRESS> 1000000uosmo --from wallet --chain-id osmosis-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.0025uosmo -y
Redelegate tokens to another validator
osmosisd tx staking redelegate $(osmosisd keys show wallet --bech val -a) <TO_VALOPER_ADDRESS> 1000000uosmo --from wallet --chain-id osmosis-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.0025uosmo -y
Unbond tokens from your validator
osmosisd tx staking unbond $(osmosisd keys show wallet --bech val -a) 1000000uosmo --from wallet --chain-id osmosis-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.0025uosmo -y
Send tokens to the wallet
osmosisd tx bank send wallet <TO_WALLET_ADDRESS> 1000000uosmo --from wallet --chain-id osmosis-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.0025uosmo -y
🗳 Governance
List all proposals
osmosisd query gov proposals
View proposal by id
osmosisd query gov proposal 1
Vote ‘Yes’
osmosisd tx gov vote 1 yes --from wallet --chain-id osmosis-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.0025uosmo -y
Vote ‘No’
osmosisd tx gov vote 1 no --from wallet --chain-id osmosis-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.0025uosmo -y
Vote ‘Abstain’
osmosisd tx gov vote 1 abstain --from wallet --chain-id osmosis-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.0025uosmo -y
Vote ‘NoWithVeto’
osmosisd tx gov vote 1 NoWithVeto --from wallet --chain-id osmosis-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.0025uosmo -y
⚡️ Utility
Update ports
CUSTOM_PORT=110
sed -i -e "s%^proxy_app = \"tcp://127.0.0.1:26658\"%proxy_app = \"tcp://127.0.0.1:${CUSTOM_PORT}58\"%; s%^laddr = \"tcp://127.0.0.1:26657\"%laddr = \"tcp://127.0.0.1:${CUSTOM_PORT}57\"%; s%^pprof_laddr = \"localhost:6060\"%pprof_laddr = \"localhost:${CUSTOM_PORT}60\"%; s%^laddr = \"tcp://0.0.0.0:26656\"%laddr = \"tcp://0.0.0.0:${CUSTOM_PORT}56\"%; s%^prometheus_listen_addr = \":26660\"%prometheus_listen_addr = \":${CUSTOM_PORT}66\"%" $HOME/.osmosisd/config/config.toml
sed -i -e "s%^address = \"tcp://0.0.0.0:1317\"%address = \"tcp://0.0.0.0:${CUSTOM_PORT}17\"%; s%^address = \":8080\"%address = \":${CUSTOM_PORT}80\"%; s%^address = \"0.0.0.0:9090\"%address = \"0.0.0.0:${CUSTOM_PORT}90\"%; s%^address = \"0.0.0.0:9091\"%address = \"0.0.0.0:${CUSTOM_PORT}91\"%" $HOME/.osmosisd/config/app.toml
Update Indexer
Disable indexer
sed -i -e 's|^indexer *=.*|indexer = "null"|' $HOME/.osmosisd/config/config.toml
Enable indexer
sed -i -e 's|^indexer *=.*|indexer = "kv"|' $HOME/.osmosisd/config/config.toml
Update pruning
sed -i \
-e 's|^pruning *=.*|pruning = "custom"|' \
-e 's|^pruning-keep-recent *=.*|pruning-keep-recent = "100"|' \
-e 's|^pruning-keep-every *=.*|pruning-keep-every = "0"|' \
-e 's|^pruning-interval *=.*|pruning-interval = "19"|' \
$HOME/.osmosisd/config/app.toml
🚨 Maintenance
Get validator info
osmosisd status 2>&1 | jq .ValidatorInfo
Get sync info
osmosisd status 2>&1 | jq .SyncInfo
Get node peer
echo $(osmosisd tendermint show-node-id)'@'$(curl -s ifconfig.me)':'$(cat $HOME/.osmosisd/config/config.toml | sed -n '/Address to listen for incoming connection/{n;p;}' | sed 's/.*://; s/".*//')
Check if validator key is correct
[[ $(osmosisd q staking validator $(osmosisd keys show wallet --bech val -a) -oj | jq -r .consensus_pubkey.key) = $(osmosisd status | jq -r .ValidatorInfo.PubKey.value) ]] && echo -e "\n\e[1m\e[32mTrue\e[0m\n" || echo -e "\n\e[1m\e[31mFalse\e[0m\n"
Get live peers
curl -sS http://localhost:12957/net_info | jq -r '.result.peers[] | "\(.node_info.id)@\(.remote_ip):\(.node_info.listen_addr)"' | awk -F ':' '{print $1":"$(NF)}'
Set minimum gas price
sed -i -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0.0025uosmo\"/" $HOME/.osmosisd/config/app.toml
Enable prometheus
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.osmosisd/config/config.toml
Reset chain data
osmosisd tendermint unsafe-reset-all --keep-addr-book --home $HOME/.osmosisd --keep-addr-book
Remove node
Please, before proceeding with the next step! All chain data will be lost! Make sure you have backed up your priv_validator_key.json!
cd $HOME
sudo systemctl stop osmosis.service
sudo systemctl disable osmosis.service
sudo rm /etc/systemd/system/osmosis.service
sudo systemctl daemon-reload
rm -f $(which osmosisd)
rm -rf $HOME/.osmosisd
rm -rf $HOME/osmosis
⚙️ Service Management
Reload service configuration
sudo systemctl daemon-reload
Enable service
sudo systemctl enable osmosis.service
Disable service
sudo systemctl disable osmosis.service
Start service
sudo systemctl start osmosis.service
Stop service
sudo systemctl stop osmosis.service
Restart service
sudo systemctl restart osmosis.service
Check service status
sudo systemctl status osmosis.service
Check service logs
sudo journalctl -u osmosis.service -f --no-hostname -o cat