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

Chain ID: passage-2 | Latest Version Tag: 2.4.0
🔑 Key management
Add new key
passage keys add wallet
Recover existing key
passage keys add wallet --recover
List all keys
passage keys list
Delete key
passage keys delete wallet
Export key to the file
passage keys export wallet
Import key from the file
passage keys import wallet wallet.backup
Query wallet balance
passage q bank balances $(passage keys show wallet -a)
👷 Validator management
Create new validator
passage tx staking create-validator \
--amount=1000000upasg \
--pubkey=$(passage tendermint show-validator) \
--moniker="YOUR_MONIKER_NAME" \
--identity="YOUR_KEYBASE_ID" \
--details="YOUR_DETAILS" \
--website="YOUR_WEBSITE_URL"
--chain-id=passage-2 \
--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 \
-y
Edit existing validator
passage tx staking edit-validator \
--moniker="YOUR_MONIKER_NAME" \
--identity="YOUR_KEYBASE_ID" \
--details="YOUR_DETAILS" \
--website="YOUR_WEBSITE_URL"
--chain-id=passage-2 \
--commission-rate=0.05 \
--from=wallet \
--gas-adjustment=1.4 \
--gas=auto \
-y
Unjail validator
passage tx slashing unjail --from wallet --chain-id passage-2 --gas-adjustment 1.4 --gas auto -y
Jail reason
passage query slashing signing-info $(passage tendermint show-validator)
List all active validators
passage 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
passage 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
passage q staking validator $(passage keys show wallet --bech val
💲 Token management
Withdraw rewards from all validators
passage tx distribution withdraw-all-rewards --from wallet --chain-id passage-2 --gas-adjustment 1.4 --gas auto -y
Withdraw commission and rewards from your validator
passage tx distribution withdraw-rewards $(passage keys show wallet --bech val -a) --commission --from wallet --chain-id passage-2 --gas-adjustment 1.4 --gas auto --y
Delegate tokens to yourself
passage tx staking delegate $(passage keys show wallet --bech val -a) 1000000upasg --from wallet --chain-id passage-2 --gas-adjustment 1.4 --gas auto -y
Delegate tokens to validator
passage tx staking delegate <TO_VALOPER_ADDRESS> 1000000.passage --from wallet --chain-id passage-2 --gas-adjustment 1.4 --gas auto -y
Redelegate tokens to another validator
passage tx staking redelegate $(passage keys show wallet --bech val <TO_VALOPER_ADDRESS> 1000000upasg --from wallet --chain-id passage-2 --gas-adjustment 1.4 --gas auto -y
Unbond tokens from your validator
passage tx staking unbond $(passage keys show wallet --bech val -a) 1000000upasg --from wallet --chain-id passage-2 --gas-adjustment 1.4 --gas auto -y
Send tokens to the wallet
passage tx bank send wallet <TO_WALLET_ADDRESS> 1000000upasg --from wallet --chain-id passage-2
🗳 Governance
List all proposals
passage query gov proposals
View proposal by id
passage query gov proposal 1
Vote 'Yes'
passage tx gov vote 1 yes --from wallet --chain-id passage-2 --gas-adjustment 1.4 --gas auto -y
Vote 'No'
passage tx gov vote 1 no --from wallet --chain-id passage-2 --gas-adjustment 1.4 --gas auto -y
Vote 'Abstain'
passage tx gov vote 1 abstain --from wallet --chain-id passage-2 --gas-adjustment 1.4 --gas auto -y
Vote 'NoWithVeto'
passage tx gov vote 1 nowithveto --from wallet --chain-id passage-2 --gas-adjustment 1.4 --gas auto -y
⚡️ Utility
Update ports
CUSTOM_PORT=156
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}60\"%" $HOME/.passage/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/.passage/config/app.toml
Update Indexer
Disable indexer
sed -i -e 's|^indexer *=.*|indexer = "null"|' $HOME/.passage/config/config.toml
Enable indexer
sed -i -e 's|^indexer *=.*|indexer = "kv"|' $HOME/.passage/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/.passage/config/app.toml
🚨 Maintenance
Get validator info
passage status 2>&1 | jq .ValidatorInfo
Get sync info
passage status 2>&1 | jq .SyncInfo
Get node peer
echo $(passage tendermint show-node-id)'@'$(curl -s ifconfig.me)':'$(cat $HOME/.passage/config/config.toml | sed -n '/Address to listen for incoming connection/{n;p;}' | sed 's/.*://; s/".*//')
Check if validator key is correct
[[ $(passage q staking validator $(passage keys show wallet --bech val -a) -oj | jq -r .consensus_pubkey.key) = $(passage 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:26657/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.passage\"/" $HOME/.passage/config/app.toml
Enable prometheus
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.passage/config/config.toml
Reset chain data
passage tendermint unsafe-reset-all --home $HOME/.passage --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 passage
sudo systemctl disable passage
sudo rm /etc/systemd/system/passage.service
sudo systemctl daemon-reload
rm -f $(which passage)
rm -rf $HOME/.passage
rm -rf $HOME/passage
⚙️ Service Management
Reload service configuration
sudo systemctl daemon-reload
Enable service
sudo systemctl enable passage
Disable service
sudo systemctl disable passage
Start service
sudo systemctl start passage
Stop service
sudo systemctl stop passage
Restart service
sudo systemctl restart passage
Check service status
sudo systemctl status passage
Check service logs
sudo journalctl -u passage -f --no-hostname -o cat
Last updated