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

cland keys list

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
yes	Yes	Vote to pass the proposal
no	No	Vote to not pass the proposal
abstain	Abstain	Vote to abstain from the proposal
nowithveto	No With Veto	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