Commands
A set of useful commonly used commands for node operators
Key Management
Add a new key
cland keys add wallet_name
Recover an existing wallet
cland keys add wallet_name --recover
List all keys
Validator Management
Create a new validator
cland tx staking create-validator \
--amount=1000000 \
--pubkey=$(cland tendermint show-validator) \
--moniker="YOUR_MONIKER_NAME" \
--identity="YOUR_KEYBASE_ID" \
--details="YOUR_DETAILS" \
--website="YOUR_WEBSITE_URL"
--chain-id=playstation-2 \
--commission-rate=0.05 \
--commission-max-rate=0.20 \
--commission-max-change-rate=0.01 \
--min-self-delegation=1 \
--from=wallet_name \
--gas-adjustment=1.4 \
--gas=auto \
--gas-prices=0.0005uclan
Unjail a validator
cland tx slashing unjail --from wallet_name --chain-id playstation-2 --gas-adjustment 1 --gas auto --gas-prices 0.0005uclan
Query Jail Reason
cland query slashing signing-info $(cland tendermint show-validator)
Token Management
Query wallet balance
cland q bank balances $(cland keys show wallet -a)
Withdraw all rewards from validator, excluding commission
cland tx distribution withdraw-all-rewards --from wallet_name --chain-id playstation-2 --gas-adjustment 1 --gas auto --gas-prices 0.0005uclan
Withdraw all rewards and commission from validator
cland tx distribution withdraw-rewards $(cland keys show wallet --bech val -a) --commission --from wallet_name --chain-id playstation-2 --gas-adjustment 1 --gas auto --gas-prices 0.0005uclan
Delegate tokens to yourself
cland tx staking delegate $(cland keys show wallet --bech val -a) 1000000uclan --from wallet_name --chain-id playstation-2 --gas-adjustment 1 --gas auto --gas-prices 0.0005uclan
Governance
List all proposals
cland query gov proposals
View a specific proposal
NOTE: Replace 1 with the desired proposal id
cland query gov proposal 1
Vote on a proposal
NOTE: Replace "1" with the desired proposal id. Replace "yes" with one of the cli commands from the table below.
The valid vote options are:
CLI Command
Name
Description
Vote to pass the proposal
Vote to not pass the proposal
Vote to abstain from the proposal
Vote to fail the proposal and burn the deposit. Typically only used for spam/scam proposals
cland tx gov vote 1 yes --from wallet_name --chain-id playstation-2 --gas-adjustment 1 --gas auto --gas-prices 0.0005uclan
Config Changes
Maintenance and status
Get validator info
cland status 2>&1 | jq .ValidatorInfo
Get syncing info
cland status 2>&1 | jq .SyncInfo
Get live peers
NOTE: Replace the CUSTOM_PORT value as needed. 26657 is the default port, but can change based on the config.toml settings.
CUSTOM_PORT="26657" && \
curl -sS http://localhost:${CUSTOM_PORT}/net_info | jq -r '.result.peers[] | "\(.node_info.id)@\(.remote_ip):\(.node_info.listen_addr)"' | awk -F ':' '{print $1":"$(NF)}'
Reset chain data
cland tendermint unsafe-reset-all --home $HOME/.clan --keep-addr-book || \
cland unsafe-reset-all --home $HOME/.clan --keep-addr-book
Linux Service Management
Check daemon/cosmovisor logs
NOTE: Replace cosmovisor with the systemd service name if different
sudo journalctl -fu cosmovisor -o cat