Useful commands

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

Picasso
Picasso

Daemon configuration

picad config node https://composable-rpc.lavenderfive.com:443
picad config chain-id centauri-1

🔑 Key management

Add new key

picad keys add wallet

Recover existing key

picad keys add wallet --recover

List all keys

picad keys list

Delete key

picad keys delete wallet

Export key to the file

picad keys export wallet

Import key from the file

picad keys import wallet wallet.backup

Query wallet balance

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

👷 Validator management

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

Create new validator

picad tx staking create-validator \
--amount 0ppica \
--pubkey $(picad tendermint show-validator) \
--moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id centauri-1 \
--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

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

Unjail validator

picad tx slashing unjail --from wallet --chain-id centauri-1 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

Jail reason

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

List all active validators

picad 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

picad 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

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

💲 Token management

Withdraw rewards from all validators

picad tx distribution withdraw-all-rewards --from wallet --chain-id centauri-1 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

Withdraw commission and rewards from your validator

picad tx distribution withdraw-rewards $(picad keys show wallet --bech val -a) --commission --from wallet --chain-id centauri-1 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

Delegate tokens to yourself

picad tx staking delegate $(picad keys show wallet --bech val -a) 0ppica --from wallet --chain-id centauri-1 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

Delegate tokens to validator

picad tx staking delegate <TO_VALOPER_ADDRESS> 0ppica --from wallet --chain-id centauri-1 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

Redelegate tokens to another validator

picad tx staking redelegate $(picad keys show wallet --bech val -a) <TO_VALOPER_ADDRESS> 0ppica --from wallet --chain-id centauri-1 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

Unbond tokens from your validator

picad tx staking unbond $(picad keys show wallet --bech val -a) 0ppica --from wallet --chain-id centauri-1 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

Send tokens to the wallet

picad tx bank send wallet <TO_WALLET_ADDRESS> 0ppica --from wallet --chain-id centauri-1 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

🗳 Governance

List all proposals

picad query gov proposals

View proposal by id

picad query gov proposal 1

Vote 'Yes'

picad tx gov vote 1 yes --from wallet --chain-id centauri-1 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

Vote 'No'

picad tx gov vote 1 no --from wallet --chain-id centauri-1 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

Vote 'Abstain'

picad tx gov vote 1 abstain --from wallet --chain-id centauri-1 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

Vote 'NoWithVeto'

picad tx gov vote 1 NoWithVeto --from wallet --chain-id centauri-1 --gas-adjustment 1.4 --gas auto --gas-prices 0ppica -y

⚡️ Utility

Update ports

CUSTOM_PORT=222
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 = "107"|' \
  -e 's|^pruning-keep-every *=.*|pruning-keep-every = "0"|' \
  -e 's|^pruning-interval *=.*|pruning-interval = "13"|' \
  $HOME/.banksy/config/app.toml

🚨 Maintenance

Get validator info

picad status 2>&1 | jq .ValidatorInfo

Get sync info

picad status 2>&1 | jq .SyncInfo

Get node peer

echo $(picad 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

[[ $(picad q staking validator $(picad keys show wallet --bech val -a) -oj | jq -r .consensus_pubkey.key) = $(picad 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:22257/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

picad tendermint unsafe-reset-all --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 picad
sudo systemctl disable picad
sudo rm /etc/systemd/system/picad.picad
sudo systemctl daemon-reload
rm -f $(which picad)
rm -rf $HOME/.banksy
rm -rf $HOME/osmosis

⚙️ Service Management

Reload picad configuration

sudo systemctl daemon-reload

Enable picad

sudo systemctl enable picad

Disable picad

sudo systemctl disable picad

Start picad

sudo systemctl start picad

Stop picad

sudo systemctl stop picad

Restart picad

sudo systemctl restart picad

Check picad status

sudo systemctl status picad

Check picad logs

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

Last updated