Commands

A set of useful commonly used commands for node operators

Key Management

Add a new key

kujirad keys add wallet_name

Recover an existing wallet

kujirad keys add wallet_name --recover

List all keys

kujirad keys list

Validator Management

Create a new validator

kujirad tx staking create-validator \
--amount=1000000 \
--pubkey=$(kujirad tendermint show-validator) \
--moniker="YOUR_MONIKER_NAME" \
--identity="YOUR_KEYBASE_ID" \
--details="YOUR_DETAILS" \
--website="YOUR_WEBSITE_URL"
--chain-id=kaiyo-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.005ukuji

Unjail a validator

kujirad tx slashing unjail --from wallet_name --chain-id kaiyo-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.005ukuji

Query Jail Reason

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

Token Management

Query wallet balance

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

Withdraw all rewards from validator, excluding commission

kujirad tx distribution withdraw-all-rewards --from wallet_name --chain-id kaiyo-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.005ukuji

Withdraw all rewards and commission from validator

kujirad tx distribution withdraw-rewards $(kujirad keys show wallet --bech val -a) --commission --from wallet_name --chain-id kaiyo-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.005ukuji

Delegate tokens to yourself

kujirad tx staking delegate $(kujirad keys show wallet --bech val -a) 1000000ukuji --from wallet_name --chain-id kaiyo-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.005ukuji

Governance

List all proposals

kujirad query gov proposals

View a specific proposal

NOTE: Replace 1 with the desired proposal id

kujirad 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

kujirad tx gov vote 1 yes --from wallet_name --chain-id kaiyo-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.005ukuji

Config Changes

Maintenance and status

Get validator info

kujirad status 2>&1 | jq .ValidatorInfo

Get syncing info

kujirad 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

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