Useful commands Useful set of commands for node operators. From key management to chain governance.
Daemon configuration
Copy terrad config node https://terra2-rpc.lavenderfive.com:443
terrad config chain-id phoenix-1
🔑 Key management
Add new key
Copy terrad keys add wallet
Recover existing key
Copy terrad keys add wallet --recover
List all keys
Delete key
Copy terrad keys delete wallet
Export key to the file
Copy terrad keys export wallet
Import key from the file
Copy terrad keys import wallet wallet.backup
Query wallet balance
Copy terrad q bank balances $( terrad keys show wallet -a )
👷 Validator management
Please make sure you have adjusted moniker , identity , details and website to match your values.
Create new validator
Copy terrad tx staking create-validator \
--amount 0.015uluna \
--pubkey $( terrad tendermint show-validator ) \
--moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id phoenix-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 \
--gas-prices 0.015uluna \
-y
Edit existing validator
Copy terrad tx staking edit-validator \
--new-moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id phoenix-1 \
--commission-rate 0.05 \
--from wallet \
--gas-adjustment 1.4 \
--gas auto \
--gas-prices 0.015uluna \
-y
Unjail validator
Copy terrad tx slashing unjail --from wallet --chain-id phoenix-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.015uluna -y
Jail reason
Copy terrad query slashing signing-info $( terrad tendermint show-validator )
List all active validators
Copy terrad 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
Copy terrad 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
Copy terrad q staking validator $( terrad keys show wallet --bech val -a )
💲 Token management
Withdraw rewards from all validators
Copy terrad tx distribution withdraw-all-rewards --from wallet --chain-id phoenix-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.015uluna -y
Withdraw commission and rewards from your validator
Copy terrad tx distribution withdraw-rewards $(terrad keys show wallet --bech val -a) --commission --from wallet --chain-id phoenix-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.015uluna -y
Delegate tokens to yourself
Copy terrad tx staking delegate $(terrad keys show wallet --bech val -a) 0.015uluna --from wallet --chain-id phoenix-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.015uluna -y
Delegate tokens to validator
Copy terrad tx staking delegate <TO_VALOPER_ADDRESS> 0.015uluna --from wallet --chain-id phoenix-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.015uluna -y
Redelegate tokens to another validator
Copy terrad tx staking redelegate $(terrad keys show wallet --bech val -a) <TO_VALOPER_ADDRESS> 0.015uluna --from wallet --chain-id phoenix-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.015uluna -y
Unbond tokens from your validator
Copy terrad tx staking unbond $(terrad keys show wallet --bech val -a) 0.015uluna --from wallet --chain-id phoenix-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.015uluna -y
Send tokens to the wallet
Copy terrad tx bank send wallet <TO_WALLET_ADDRESS> 0.015uluna --from wallet --chain-id phoenix-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.015uluna -y
🗳 Governance
List all proposals
Copy terrad query gov proposals
View proposal by id
Copy terrad query gov proposal 1
Vote 'Yes'
Copy terrad tx gov vote 1 yes --from wallet --chain-id phoenix-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.015uluna -y
Vote 'No'
Copy terrad tx gov vote 1 no --from wallet --chain-id phoenix-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.015uluna -y
Vote 'Abstain'
Copy terrad tx gov vote 1 abstain --from wallet --chain-id phoenix-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.015uluna -y
Vote 'NoWithVeto'
Copy terrad tx gov vote 1 NoWithVeto --from wallet --chain-id phoenix-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.015uluna -y
⚡️ Utility
Update ports
Copy CUSTOM_PORT = 117
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/.terra/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/.terra/config/app.toml
Update Indexer
Disable indexer
Copy sed -i -e 's|^indexer *=.*|indexer = "null"|' $HOME /.terra/config/config.toml
Enable indexer
Copy sed -i -e 's|^indexer *=.*|indexer = "kv"|' $HOME /.terra/config/config.toml
Update pruning
Copy sed -i \
-e 's|^pruning *=.*|pruning = "custom"|' \
-e 's|^pruning-keep-recent *=.*|pruning-keep-recent = "107"|' \
-e 's|^pruning-keep-every *=.*|pruning-keep-every = "0"|' \
-e 's|^pruning-interval *=.*|pruning-interval = "13"|' \
$HOME /.terra/config/app.toml
🚨 Maintenance
Get validator info
Copy terrad status 2>&1 | jq .ValidatorInfo
Get sync info
Copy terrad status 2>&1 | jq .SyncInfo
Get node peer
Copy echo $(terrad tendermint show-node-id)'@'$(curl -s ifconfig.me)':'$(cat $HOME/.terra/config/config.toml | sed -n '/Address to listen for incoming connection/{n;p;}' | sed 's/.*://; s/".*//')
Check if validator key is correct
Copy [[ $(terrad q staking validator $(terrad keys show wallet --bech val -a) -oj | jq -r .consensus_pubkey.key) = $(terrad 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
Copy curl -sS http://localhost:11757/net_info | jq -r '.result.peers[] | "\(.node_info.id)@\(.remote_ip):\(.node_info.listen_addr)"' | awk -F ':' '{print $1":"$(NF)}'
Set minimum gas price
Copy sed -i -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0.015uluna\"/" $HOME /.terra/config/app.toml
Enable prometheus
Copy sed -i -e "s/prometheus = false/prometheus = true/" $HOME /.terra/config/config.toml
Reset chain data
Copy terrad tendermint unsafe-reset-all --home $HOME /.terra --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 !
Copy cd $HOME
sudo systemctl stop terrad
sudo systemctl disable terrad
sudo rm /etc/systemd/system/terrad.terrad
sudo systemctl daemon-reload
rm -f $( which terrad )
rm -rf $HOME /.terra
rm -rf $HOME /osmosis
⚙️ Service Management
Reload terrad configuration
Copy sudo systemctl daemon-reload
Enable terrad
Copy sudo systemctl enable terrad
Disable terrad
Copy sudo systemctl disable terrad
Start terrad
Copy sudo systemctl start terrad
Stop terrad
Copy sudo systemctl stop terrad
Restart terrad
Copy sudo systemctl restart terrad
Check terrad status
Copy sudo systemctl status terrad
Check terrad logs
Copy sudo journalctl -u terrad -f --no-hostname -o cat
Last updated 7 months ago