Commands

A set of useful commonly used commands for node operators

Key Management

Add a new key

canined keys add wallet_name

Recover an existing wallet

canined keys add wallet_name --recover

List all keys

canined keys list

Validator Management

Create a new validator

canined tx staking create-validator \
--amount=1000000 \
--pubkey=$(canined tendermint show-validator) \
--moniker="YOUR_MONIKER_NAME" \
--identity="YOUR_KEYBASE_ID" \
--details="YOUR_DETAILS" \
--website="YOUR_WEBSITE_URL"
--chain-id=jackal-1 \
--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.0002ujkl

Unjail a validator

canined tx slashing unjail --from wallet_name --chain-id jackal-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.0002ujkl

Query Jail Reason

canined query slashing signing-info $(canined tendermint show-validator)

Token Management

Query wallet balance

canined q bank balances $(canined keys show wallet -a)

Withdraw all rewards from validator, excluding commission

canined tx distribution withdraw-all-rewards --from wallet_name --chain-id jackal-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.0002ujkl

Withdraw all rewards and commission from validator

canined tx distribution withdraw-rewards $(canined keys show wallet --bech val -a) --commission --from wallet_name --chain-id jackal-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.0002ujkl

Delegate tokens to yourself

canined tx staking delegate $(canined keys show wallet --bech val -a) 1000000ujkl --from wallet_name --chain-id jackal-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.0002ujkl

Governance

List all proposals

canined query gov proposals

View a specific proposal

NOTE: Replace 1 with the desired proposal id

canined 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

canined tx gov vote 1 yes --from wallet_name --chain-id jackal-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.0002ujkl

Config Changes

Maintenance and status

Get validator info

canined status 2>&1 | jq .ValidatorInfo

Get syncing info

canined 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

canined tendermint unsafe-reset-all --home $HOME/.canine --keep-addr-book || \
canined unsafe-reset-all --home $HOME/.canine --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

Last updated