Useful Command
Useful set of commands for node operators. From key management to chain governance.
🔑 Key management
Add new key
selfchaind keys add wallet
Recover existing key
selfchaind keys add wallet --recover
List all keys
selfchaind keys list
Delete key
selfchaind keys delete wallet
Export key to the file
selfchaind keys export wallet
Import key from the file
selfchaind keys import wallet wallet.backup
Query wallet balance
selfchaind q bank balances $(selfchaind keys show wallet -a)
👷 Validator management
Please make sure you have adjusted moniker, identity, details and website to match your values.
Create new validator
selfchaind tx staking create-validator \
--amount "1000000uslf" \
--pubkey $(selfchaind tendermint show-validator) \
--moniker "<MONIKER>" \
--identity "" \
--details "CodeBlockLabs Community" \
--website "YOUR WEBSITE" \
--chain-id selfchain-testnet \
--commission-rate "0.05" \
--commission-max-rate "0.2" \
--commission-max-change-rate "0.01" \
--min-self-delegation "1" \
--gas-prices 1uslf \
--gas "auto" \
--gas-adjustment "1.5" \
--from wallet \
-y
Edit existing validator
selfchaind tx staking edit-validator \
--new-moniker "<MONIKER>" \
--identity "" \
--details "CodeBlockLabs Community" \
--website "YOUR WEBSITE" \
--chain-id selfchain-testnet \
--commission-rate "0.05" \
--gas-prices 1uslf \
--gas "auto" \
--gas-adjustment "1.5" \
--from wallet \
-y
Unjail validator
selfchaind tx slashing unjail \
--chain-id selfchain-testnet \
--gas-prices 1uslf \
--gas-adjustment 1.5 \
--gas "auto" \
--from wallet \
-y
Jail reason
selfchaind query slashing signing-info $(selfchaind tendermint show-validator)
List all active validators
selfchaind q staking validators -oj --limit=3000 | jq '.validators[] | select(.status=="BOND_STATUS_BONDED")' | jq -r '(.tokens|tonumber/pow(10; 6)|floor|tostring) + " " + .description.moniker' | sort -gr | nl
List all inactive validators
selfchaind q staking validators -oj --limit=3000 | jq '.validators[] | select(.status=="BOND_STATUS_UNBONDED") or .status=="BOND_STATUS_UNBONDING")' | jq -r '(.tokens|tonumber/pow(10; 6)|floor|tostring) + " " + .description.moniker' | sort -gr | nl
View validator details
selfchaind q staking validator $(selfchaind keys show wallet --bech val -a)
💲 Token management
Withdraw rewards from all validators
selfchaind tx distribution withdraw-all-rewards --from wallet --chain-id selfchain-testnet --gas-prices 1uslf --gas-adjustment 1.5 --gas "auto" -y
Withdraw commission and rewards from your validator
selfchaind tx distribution withdraw-rewards $(selfchaind keys show wallet --bech val -a) --commission --from wallet --chain-id selfchain-testnet --gas-adjustment 1.4 --gas auto --fees 500uslf -y
Delegate tokens to yourself
selfchaind tx staking delegate $(selfchaind keys show wallet --bech val -a) 1000000uslf --from wallet --chain-id selfchain-testnet --gas-adjustment 1.4 --gas auto --fees 500uslf -y
Delegate tokens to validator
selfchaind tx staking delegate <TO_VALOPER_ADDRESS> 1000000uslf --from wallet --chain-id selfchain-testnet --gas-adjustment 1.4 --gas auto --fees 500uslf -y
Redelegate tokens to another validator
selfchaind tx staking redelegate $(selfchaind keys show wallet --bech val -a) <TO_VALOPER_ADDRESS> 1000000uslf --from wallet --chain-id selfchain-testnet --gas-adjustment 1.4 --gas auto --fees 500uslf -y
Unbond tokens from your validator
selfchaind tx staking unbond $(selfchaind keys show wallet --bech val -a) 1000000uslf --from wallet --chain-id selfchain-testnet --gas-adjustment 1.4 --gas auto --fees 500uslf -y
Send tokens to the wallet
selfchaind tx bank send wallet <TO_WALLET_ADDRESS> 1000000uslf --from wallet --chain-id selfchain-testnet
🗳 Governance
List all proposals
selfchaind query gov proposals
View proposal by id
selfchaind query gov proposal 1
Vote 'Yes'
selfchaind tx gov vote 1 yes --from wallet --chain-id selfchain-testnet --gas-adjustment 1.4 --gas auto --fees 500uslf -y
Vote 'No'
selfchaind tx gov vote 1 no --from wallet --chain-id selfchain-testnet --gas-adjustment 1.4 --gas auto --fees 500uslf -y
Vote 'Abstain'
selfchaind tx gov vote 1 abstain --from wallet --chain-id selfchain-testnet --gas-adjustment 1.4 --gas auto --fees 500uslf -y
Vote 'NoWithVeto'
selfchaind tx gov vote 1 nowithveto --from wallet --chain-id selfchain--testnet --gas-adjustment 1.4 --gas auto --fees 500uslf -y
⚡️ Utility
Update ports
CUSTOM_PORT=20
sed -i -e "s%^proxy_app = \"tcp://127.0.0.1:26658\"%proxy_app = \"tcp://127.0.0.1:${CUSTOM_PORT}658\"%; s%^laddr = \"tcp://127.0.0.1:26657\"%laddr = \"tcp://127.0.0.1:${CUSTOM_PORT}657\"%; s%^pprof_laddr = \"localhost:6060\"%pprof_laddr = \"localhost:${CUSTOM_PORT}060\"%; s%^laddr = \"tcp://0.0.0.0:26656\"%laddr = \"tcp://0.0.0.0:${CUSTOM_PORT}656\"%; s%^prometheus_listen_addr = \":26660\"%prometheus_listen_addr = \":${CUSTOM_PORT}660\"%" $HOME/.selfchaind/config/config.toml
sed -i -e "s%^address = \"tcp://0.0.0.0:1317\"%address = \"tcp://0.0.0.0:${CUSTOM_PORT}317\"%; s%^address = \":8080\"%address = \":${CUSTOM_PORT}080\"%; s%^address = \"0.0.0.0:9090\"%address = \"0.0.0.0:${CUSTOM_PORT}090\"%; s%^address = \"0.0.0.0:9091\"%address = \"0.0.0.0:${CUSTOM_PORT}091\"%" $HOME/.selfchaind/config/app.toml
Update Indexer
Disable indexer
sed -i -e 's|^indexer *=.*|indexer = "null"|' $HOME/.selfchaind/config/config.toml
Enable indexer
sed -i -e 's|^indexer *=.*|indexer = "kv"|' $HOME/.selfchaind/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/.selfchaind/config/app.toml
🚨 Maintenance
Get validator info
selfchaind status 2>&1 | jq .ValidatorInfo
Get sync info
selfchaind status 2>&1 | jq .SyncInfo
Get node peer
echo $(selfchaind tendermint show-node-id)'@'$(curl -s ifconfig.me)':'$(cat $HOME/.selfchaind/config/config.toml | sed -n '/Address to listen for incoming connection/{n;p;}' | sed 's/.*://; s/".*//')
Check if validator key is correct
[[ $(selfchaind q staking validator $(selfchaind keys show wallet --bech val -a) -oj | jq -r .consensus_pubkey.key) = $(blockxd 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:25657/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.0025uslf\"/" $HOME/.selfchaind/config/app.toml
Enable prometheus
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.selfchaind/config/config.toml
Reset chain data
selfchaind tendermint unsafe-reset-all --home $HOME/.selfchaind --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 selfchaind
sudo systemctl disable selfchaind
sudo rm /etc/systemd/system/selfchaind.service
sudo systemctl daemon-reload
rm -f $(which selfchaind)
rm -rf $HOME/.selfchaind
⚙️ Service Management
Reload service configuration
sudo systemctl daemon-reload
Enable service
sudo systemctl enable selfchaind
Disable service
sudo systemctl disable selfchaind
Start service
sudo systemctl start selfchaind
Stop service
sudo systemctl stop selfchaind
Restart service
sudo systemctl restart selfchaind
Check service status
sudo systemctl status selfchaind
Check service logs
sudo journalctl -u selfchaind -f --no-hostname -o cat
Last updated