Skip to main content

CLI Cheatsheet

Chain ID: namada.5f5de2dd1b88cba30586420 | Current Node Version: v1.0.0​

This cheatsheet collects commonly used CLI commands for node operators to easily copy and paste. A few conventions we follow:

  • Capitalized words indicate placeholders
  • Always use our own [NODERS]TEAM RPC endpoints
  • Always specify --chain-id and --node flags even when they are unnecessary
  • Query CLI command always uses --output json flag and pipes result through jq

Wallet generate and recover​

Add new keypair​

namadaw gen --alias KEY

Recover keypair (via existing mnemonic)​

namada wallet derive --alias KEY --hd-path default

List your keypair​

namadaw find --alias KEY

List all keypair​

namadaw list

Remove your keypair​

namadaw remove --alias KEY --do-it

Add some tokens using faucet:​

https://faucet.heliax.click/

Wallet​

Wallet balance​

namadac balance --owner KEY

Send​

namadac transfer --source KEY --target RECIPIENT --token NAAN --amount AMOUNT --signing-keys KEY --memo MEMO

Delegate tokens to validator​

namadac bond --source KEY --validator VAL_ADDRESS --amount AMOUNT  --memo MEMO

Check your user bonds​

namadac bonds --owner KEY

Unbond tokens from validator​

namadac unbond --source KEY --validator VAL_ADDRESS --amount AMOUNT  --memo $MEMO

Withdraw unbonded tokens​

namadac withdraw --source KEY --validator VAL_ADDRESS  --memo $MEMO

Redelegate bonded tokens​

namadac redelegate --owner KEY --source-validator VAL_ADDRESS --destination-validator DESSTINATION_VAL_ADDRESS --amount AMOUNT  --memo MEMO

Claim rewards​

namadac claim-rewards --source KEY --validator VAL_ADDRESS  --memo MEMO

Governance​

List of all proposals​

namadac query-proposal

Vote​

namadac vote-proposal --proposal-id PROPOSAL_ID --vote yay --address KEY --signing-keys KEY --memo MEMO

Service Management​

Reload service configuration​

sudo systemctl daemon-reload

Enable service​

sudo systemctl enable namadad

Disable service​

sudo systemctl disable namadad

Start service​

sudo systemctl start namadad

Stop service​

sudo systemctl stop namadad

Restart service​

sudo systemctl restart namadad

Check service status​

sudo systemctl status namadad

Check service logs​

sudo journalctl -u namadad -f --no-hostname -o cat

Remove node​

cd $HOME
sudo systemctl stop namadad
sudo systemctl disable namadad
sudo rm /etc/systemd/system/namada.service
sudo systemctl daemon-reload
rm -f $(which namadad)
rm -rf ~/.local
rm -rf $HOME/namada