Useful commands

Useful set of commands for node operators. From key management to chain governance.

🔑 Key management

Add new key

centaurid keys add wallet

Recover existing key

centaurid keys add wallet --recover

List all keys

centaurid keys list

Delete key

centaurid keys delete wallet

Export key to the file

centaurid keys export wallet

Import key from the file

centaurid keys import wallet wallet.backup

Query wallet balance

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

👷 Validator management

Please make sure you have adjusted moniker, identity, details and website to match your values.

Create new validator

centaurid tx staking create-validator \
--amount 1000000ppica \
--pubkey $(centaurid tendermint show-validator) \
--moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id banksy-testnet-3 \
--commission-rate 0.05 \
--commission-max-rate 0.20 \
--commission-max-change-rate 0.01 \
--min-self-delegation 1 \
--from wallet \
--gas-adjustment 1.4 \
--gas auto \
--gas-prices 0ppica \
-y

Edit existing validator

centaurid tx staking edit-validator \
--new-moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id banksy-testnet-3 \
--commission-rate 0.05 \
--from wallet \
--gas-adjustment 1.4 \
--gas auto \
--gas-prices 0ppica \
-y

Unjail validator

centaurid tx slashing unjail --from wallet --chain-id banksy-testnet-3 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

Jail reason

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

List all active validators

centaurid q staking validators -oj --limit=3000 | jq '.validators[] | select(.status=="BOND_STATUS_BONDED")' | jq -r '(.tokens|tonumber/pow(10; 6)|floor|tostring) + " \t " + .description.moniker' | sort -gr | nl

List all inactive validators

centaurid q staking validators -oj --limit=3000 | jq '.validators[] | select(.status=="BOND_STATUS_UNBONDED")' | jq -r '(.tokens|tonumber/pow(10; 6)|floor|tostring) + " \t " + .description.moniker' | sort -gr | nl

View validator details

centaurid q staking validator $(centaurid keys show wallet --bech val -a)

💲 Token management

Withdraw rewards from all validators

centaurid tx distribution withdraw-all-rewards --from wallet --chain-id banksy-testnet-3 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

Withdraw commission and rewards from your validator

centaurid tx distribution withdraw-rewards $(centaurid keys show wallet --bech val -a) --commission --from wallet --chain-id banksy-testnet-3 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

Delegate tokens to yourself

centaurid tx staking delegate $(centaurid keys show wallet --bech val -a) 1000000ppica --from wallet --chain-id banksy-testnet-3 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

Delegate tokens to validator

centaurid tx staking delegate <TO_VALOPER_ADDRESS> 1000000ppica --from wallet --chain-id banksy-testnet-3 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

Redelegate tokens to another validator

centaurid tx staking redelegate $(centaurid keys show wallet --bech val -a) <TO_VALOPER_ADDRESS> 1000000ppica --from wallet --chain-id banksy-testnet-3 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

Unbond tokens from your validator

centaurid tx staking unbond $(centaurid keys show wallet --bech val -a) 1000000ppica --from wallet --chain-id banksy-testnet-3 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

Send tokens to the wallet

centaurid tx bank send wallet <TO_WALLET_ADDRESS> 1000000ppica --from wallet --chain-id banksy-testnet-3 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

🗳 Governance

List all proposals

centaurid query gov proposals

View proposal by id

centaurid query gov proposal 1

Vote 'Yes'

centaurid tx gov vote 1 yes --from wallet --chain-id banksy-testnet-3 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

Vote 'No'

centaurid tx gov vote 1 no --from wallet --chain-id banksy-testnet-3 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

Vote 'Abstain'

centaurid tx gov vote 1 abstain --from wallet --chain-id banksy-testnet-3 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

Vote 'NoWithVeto'

centaurid tx gov vote 1 NoWithVeto --from wallet --chain-id banksy-testnet-3 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

⚡️ Utility

Update ports

CUSTOM_PORT=110
sed -i -e "s%^proxy_app = \"tcp://127.0.0.1:26658\"%proxy_app = \"tcp://127.0.0.1:${CUSTOM_PORT}58\"%; s%^laddr = \"tcp://127.0.0.1:26657\"%laddr = \"tcp://127.0.0.1:${CUSTOM_PORT}57\"%; s%^pprof_laddr = \"localhost:6060\"%pprof_laddr = \"localhost:${CUSTOM_PORT}60\"%; s%^laddr = \"tcp://0.0.0.0:26656\"%laddr = \"tcp://0.0.0.0:${CUSTOM_PORT}56\"%; s%^prometheus_listen_addr = \":26660\"%prometheus_listen_addr = \":${CUSTOM_PORT}66\"%" $HOME/.banksy/config/config.toml
sed -i -e "s%^address = \"tcp://0.0.0.0:1317\"%address = \"tcp://0.0.0.0:${CUSTOM_PORT}17\"%; s%^address = \":8080\"%address = \":${CUSTOM_PORT}80\"%; s%^address = \"0.0.0.0:9090\"%address = \"0.0.0.0:${CUSTOM_PORT}90\"%; s%^address = \"0.0.0.0:9091\"%address = \"0.0.0.0:${CUSTOM_PORT}91\"%" $HOME/.banksy/config/app.toml

Update Indexer

Disable indexer

sed -i -e 's|^indexer *=.*|indexer = "null"|' $HOME/.banksy/config/config.toml

Enable indexer

sed -i -e 's|^indexer *=.*|indexer = "kv"|' $HOME/.banksy/config/config.toml

Update pruning

sed -i \
  -e 's|^pruning *=.*|pruning = "custom"|' \
  -e 's|^pruning-keep-recent *=.*|pruning-keep-recent = "100"|' \
  -e 's|^pruning-keep-every *=.*|pruning-keep-every = "0"|' \
  -e 's|^pruning-interval *=.*|pruning-interval = "19"|' \
  $HOME/.banksy/config/app.toml

🚨 Maintenance

Get validator info

centaurid status 2>&1 | jq .ValidatorInfo

Get sync info

centaurid status 2>&1 | jq .SyncInfo

Get node peer

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

Check if validator key is correct

[[ $(centaurid q staking validator $(centaurid keys show wallet --bech val -a) -oj | jq -r .consensus_pubkey.key) = $(centaurid 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 http://localhost:15957/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 = \"0ppica\"/" $HOME/.banksy/config/app.toml

Enable prometheus

sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.banksy/config/config.toml

Reset chain data

centaurid tendermint unsafe-reset-all --keep-addr-book --home $HOME/.banksy --keep-addr-book

Remove node

Please, before proceeding with the next step! All chain data will be lost! Make sure you have backed up your priv_validator_key.json!

cd $HOME
sudo systemctl stop centaurid
sudo systemctl disable centaurid
sudo rm /etc/systemd/system/centaurid.service
sudo systemctl daemon-reload
rm -f $(which centaurid)
rm -rf $HOME/.banksy
rm -rf $HOME/composable-testnet

⚙️ Service Management

Reload service configuration

sudo systemctl daemon-reload

Enable service

sudo systemctl enable centaurid

Disable service

sudo systemctl disable centaurid

Start service

sudo systemctl start centaurid

Stop service

sudo systemctl stop centaurid

Restart service

sudo systemctl restart centaurid

Check service status

sudo systemctl status centaurid

Check service logs

sudo journalctl -u centaurid -f --no-hostname -o cat
PreviousState syncNextHypersign

Last updated