Useful commands
Useful set of commands for node operators. From key management to chain governance.

Chain ID: stargaze-1 | Latest Version Tag: 14.0.0
🔑 Key management
Add new key
starsd keys add wallet
Recover existing key
starsd keys add wallet --recover
List all keys
starsd keys list
Delete key
starsd keys delete wallet
Export key to the file
starsd keys export wallet
Import key from the file
starsd keys import wallet wallet.backup
Query wallet balance
starsd q bank balances $(starsd keys show wallet -a)
👷 Validator management
Create new validator
starsd tx staking create-validator \
--amount=1000000 \
--pubkey=$(starsd tendermint show-validator) \
--moniker="YOUR_MONIKER_NAME" \
--identity="YOUR_KEYBASE_ID" \
--details="YOUR_DETAILS" \
--website="YOUR_WEBSITE_URL"
--chain-id=stargaze-1 \
--commission-rate=0.05 \
--commission-max-rate=0.20 \
--commission-max-change-rate=0.01 \
--min-self-delegation=1 \
--from=wallet \
--gas-adjustment=1.4 \
--gas=auto \
-y
Edit existing validator
starsd tx staking edit-validator \
--moniker="YOUR_MONIKER_NAME" \
--identity="YOUR_KEYBASE_ID" \
--details="YOUR_DETAILS" \
--website="YOUR_WEBSITE_URL"
--chain-id=stargaze-1 \
--commission-rate=0.05 \
--from=wallet \
--gas-adjustment=1.4 \
--gas=auto \
-y
Unjail validator
starsd tx slashing unjail --from wallet --chain-id stargaze-1 --gas-adjustment 1.4 --gas auto -y
Jail reason
starsd query slashing signing-info $(starsd tendermint show-validator)
List all active validators
starsd 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
starsd 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
starsd q staking validator $(starsd keys show wallet --bech val
💲 Token management
Withdraw rewards from all validators
starsd tx distribution withdraw-all-rewards --from wallet --chain-id stargaze-1 --gas-adjustment 1.4 --gas auto -y
Withdraw commission and rewards from your validator
starsd tx distribution withdraw-rewards $(starsd keys show wallet --bech val -a) --commission --from wallet --chain-id stargaze-1 --gas-adjustment 1.4 --gas auto --y
Delegate tokens to yourself
starsd tx staking delegate $(starsd keys show wallet --bech val -a) 1000000 --from wallet --chain-id stargaze-1 --gas-adjustment 1.4 --gas auto -y
Delegate tokens to validator
starsd tx staking delegate <TO_VALOPER_ADDRESS> 1000000.starsd --from wallet --chain-id stargaze-1 --gas-adjustment 1.4 --gas auto -y
Redelegate tokens to another validator
starsd tx staking redelegate $(starsd keys show wallet --bech val <TO_VALOPER_ADDRESS> 1000000 --from wallet --chain-id stargaze-1 --gas-adjustment 1.4 --gas auto -y
Unbond tokens from your validator
starsd tx staking unbond $(starsd keys show wallet --bech val -a) 1000000 --from wallet --chain-id stargaze-1 --gas-adjustment 1.4 --gas auto -y
Send tokens to the wallet
starsd tx bank send wallet <TO_WALLET_ADDRESS> 1000000 --from wallet --chain-id stargaze-1
🗳 Governance
List all proposals
starsd query gov proposals
View proposal by id
starsd query gov proposal 1
Vote 'Yes'
starsd tx gov vote 1 yes --from wallet --chain-id stargaze-1 --gas-adjustment 1.4 --gas auto -y
Vote 'No'
starsd tx gov vote 1 no --from wallet --chain-id stargaze-1 --gas-adjustment 1.4 --gas auto -y
Vote 'Abstain'
starsd tx gov vote 1 abstain --from wallet --chain-id stargaze-1 --gas-adjustment 1.4 --gas auto -y
Vote 'NoWithVeto'
starsd tx gov vote 1 nowithveto --from wallet --chain-id stargaze-1 --gas-adjustment 1.4 --gas auto -y
⚡️ Utility
Update ports
CUSTOM_PORT=137
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}60\"%" $HOME/.starsd/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/.starsd/config/app.toml
Update Indexer
Disable indexer
sed -i -e 's|^indexer *=.*|indexer = "null"|' $HOME/.starsd/config/config.toml
Enable indexer
sed -i -e 's|^indexer *=.*|indexer = "kv"|' $HOME/.starsd/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/.starsd/config/app.toml
🚨 Maintenance
Get validator info
starsd status 2>&1 | jq .ValidatorInfo
Get sync info
starsd status 2>&1 | jq .SyncInfo
Get node peer
echo $(starsd tendermint show-node-id)'@'$(curl -s ifconfig.me)':'$(cat $HOME/.starsd/config/config.toml | sed -n '/Address to listen for incoming connection/{n;p;}' | sed 's/.*://; s/".*//')
Check if validator key is correct
[[ $(starsd q staking validator $(starsd keys show wallet --bech val -a) -oj | jq -r .consensus_pubkey.key) = $(starsd 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:26657/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.starsd\"/" $HOME/.starsd/config/app.toml
Enable prometheus
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.starsd/config/config.toml
Reset chain data
starsd tendermint unsafe-reset-all --home $HOME/.starsd --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 starsd
sudo systemctl disable starsd
sudo rm /etc/systemd/system/starsd.service
sudo systemctl daemon-reload
rm -f $(which starsd)
rm -rf $HOME/.starsd
rm -rf $HOME/stargaze
⚙️ Service Management
Reload service configuration
sudo systemctl daemon-reload
Enable service
sudo systemctl enable starsd
Disable service
sudo systemctl disable starsd
Start service
sudo systemctl start starsd
Stop service
sudo systemctl stop starsd
Restart service
sudo systemctl restart starsd
Check service status
sudo systemctl status starsd
Check service logs
sudo journalctl -u starsd -f --no-hostname -o cat
Last updated