Skip to main content

CLI Cheatsheet

Chain ID: exrp_1440002-1 | Current Node Version: v6.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 key​

exrpd keys add KEY

Recover key (via existing mnemonic)​

exrpd keys add KEY --recover

List all keys​

exrpd keys list

Delete key​

exrpd keys delete KEY

Wallet​

Wallet balance​

exrpd q bank balances $(exrpd keys show KEY -a) --node https://xrp-t-rpc.noders.services:443

Send​

exrpd tx bank send YOUR_KEY RECEIVER_ADDRESS 1000000apoa \
  --chain-id exrp_1440002-1 \
  --node https://xrp-t-rpc.noders.services:443 --fees 3000000apoa \
  --from KEY

Withdraw rewards from all validators​

exrpd tx distribution withdraw-all-rewards \
  --chain-id exrp_1440002-1 \
  --node https://xrp-t-rpc.noders.services:443 --fees 3000000apoa \
  --from KEY

Withdraw Rewards including Commission​

exrpd tx distribution withdraw-rewards VALIDATOR_ADRESS \
  --commission \
  --chain-id exrp_1440002-1 \
  --node https://xrp-t-rpc.noders.services:443 --fees 3000000apoa \
  --from KEY

Delegate tokens to yourself​

exrpd tx staking delegate $(exrpd keys show KEY --bech val -a) 1000000apoa \
--chain-id exrp_1440002-1 \
--node https://xrp-t-rpc.noders.services:443 --fees 3000000apoa \
--from KEY

Delegate tokens to validator​

exrpd tx staking delegate VALIDATOR_ADDRESS 1000000apoa \
--chain-id exrp_1440002-1 \
--node https://xrp-t-rpc.noders.services:443 --fees 3000000apoa \
--from KEY

Redelegate tokens to another validator​

exrpd tx staking redelegate $(exrpd keys show KEY --bech val -a) VALIDATOR_ADDRESS 1000000apoa \
  --chain-id exrp_1440002-1 \
  --node https://xrp-t-rpc.noders.services:443 --fees 3000000apoa \
  --from KEY

Unbond tokens from your validator​

exrpd tx staking unbond $(exrpd keys show KEY --bech val -a) apoa \
  --chain-id andromeda-1 \
  --node https://xrp-t-rpc.noders.services:443 --fees 3000000apoa \
  --from KEY

Governance​

List of all proposals​

exrpd query gov proposals --node https://xrp-t-rpc.noders.services:443

Check vote​

exrpd query gov proposal PROPOSAL_NUMBER \
  --chain-id exrp_1440002-1 \
  --node https://xrp-t-rpc.noders.services:443 --fees 3000000apoa \
  --output json | jq

Vote​

Vote options:​

  • yes
  • no
  • no_with_veto
  • abstain
exrpd tx gov vote PROPOSAL_NUMBER VOTE_OPTION \
  --chain-id exrp_1440002-1 \
  --node https://xrp-t-rpc.noders.services:443 --fees 3000000apoa \
  --from KEY

Validator management​

Create Validator​

note

We use example filed values instead of capitalized dummy words for demo purpose in this command. Please make sure to adjust accordingly for your use.

exrpd tx staking create-validator \
  --amount 1000000apoa \
  --commission-max-change-rate "0.05" \
  --commission-max-rate "0.10" \
  --commission-rate "0.05" \
  --min-self-delegation "1" \
  --pubkey=$(exrpd tendermint show-validator) \
  --moniker '[NODERS]TEAM SERVICE' \
  --website "https://noders.team" \
  --identity "220491ADDD660741" \
  --details "Trusted blockchain validator and web3 developer team" \
  --security-contact="office@noders.team" \
  --chain-id exrp_1440002-1 \
  --node https://xrp-t-rpc.noders.services:443 --fees 3000000apoa \
  --from KEY

Edit validator​

exrpd tx staking edit-validator \
--new-moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id exrp_1440002-1 \
--commission-rate 0.05 \
--from KEY \
--node https://xrp-t-rpc.noders.services:443 --fees 3000000apoa \

Unjail​

exrpd tx slashing unjail \
  --chain-id exrp_1440002-1 \
  --node https://xrp-t-rpc.noders.services:443 --fees 3000000apoa \
  --from KEY

Jail reason​

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

Validator details​

exrpd q staking validator $(exrpd keys show KEY --bech val -a)

Maintenance​

Get validator info​

exrpd status 2>&1 | jq .ValidatorInfo

Get sync info​

exrpd status 2>&1 | jq .SyncInfo

Get node peer​

echo $(exrpd tendermint show-node-id)'@'$(curl -s ifconfig.me)':'$(cat ~/.exrpd/config/config.toml | sed -n '/Address to listen for incoming connection/{n;p;}' | sed 's/.*://; s/".*//')

Check if validator key is correct​

[[ $(exrpd q staking validator $(exrpd keys show KEY --bech val -a) -oj | jq -r .consensus_pubkey.key) = $(exrpd status | jq -r .ValidatorInfo.PubKey.value) ]] && echo -e "\n\e[1m\e[32mTrue\e[0m\n" || echo -e "\n\e[1m\e[31mFalse\e[0m\n"

Get live peers​

curl -sS https://xrp-t-rpc.noders.services:443/net_info | jq -r '.result.peers[] | "\(.node_info.id)@\(.remote_ip):\(.node_info.listen_addr)"' | awk -F ':' '{print $1":"$(NF)}'

Set minimum gas price​

sed -i -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0.001apoa\"/" ~/.exrpd/config/app.toml

###Enable prometheus

sed -i -e "s/prometheus = false/prometheus = true/" ~/.exrpd/config/config.toml

Reset chain data​

exrpd tendermint unsafe-reset-all --keep-addr-book --home ~/.exrpd

Service Management​

Reload service configuration​

sudo systemctl daemon-reload

Enable service​

sudo systemctl enable exrpd

Disable service​

sudo systemctl disable exrpd

Start service​

sudo systemctl start exrpd

Stop service​

sudo systemctl stop exrpd

Restart service​

sudo systemctl restart exrpd

Check service status​

sudo systemctl status exrpd

Check service logs​

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

Remove node​

cd $HOME
sudo systemctl stop exrpd
sudo systemctl disable exrpd
sudo rm /etc/systemd/system/xrp.service
sudo systemctl daemon-reload
rm -f $(which exrpd)
rm -rf ~/.exrpd
rm -rf $HOME/node