Useful commands Useful set of commands for node operators. From key management to chain governance.
Daemon configuration
Copy nilchaind config node https://testnet-nillion-rpc.lavenderfive.com:443
nilchaind config chain-id nillion-chain-testnet-1
🔑 Key management
Add new key
Copy nilchaind keys add wallet
Recover existing key
Copy nilchaind keys add wallet --recover
List all keys
Delete key
Copy nilchaind keys delete wallet
Export key to the file
Copy nilchaind keys export wallet
Import key from the file
Copy nilchaind keys import wallet wallet.backup
Query wallet balance
Copy nilchaind q bank balances $( nilchaind keys show wallet -a )
👷 Validator management
Please make sure you have adjusted moniker , identity , details and website to match your values.
Create new validator
Copy nilchaind tx staking create-validator \
--amount \
--pubkey $( nilchaind tendermint show-validator ) \
--moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id nillion-chain-testnet-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 \
-y
Edit existing validator
Copy nilchaind tx staking edit-validator \
--new-moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id nillion-chain-testnet-1 \
--commission-rate 0.05 \
--from wallet \
--gas-adjustment 1.4 \
--gas auto \
--gas-prices \
-y
Unjail validator
Copy nilchaind tx slashing unjail --from wallet --chain-id nillion-chain-testnet-1 --gas-adjustment 1.4 --gas auto --gas-prices -y
Jail reason
Copy nilchaind query slashing signing-info $( nilchaind tendermint show-validator )
List all active validators
Copy nilchaind 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
Copy nilchaind 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
Copy nilchaind q staking validator $( nilchaind keys show wallet --bech val -a )
💲 Token management
Withdraw rewards from all validators
Copy nilchaind tx distribution withdraw-all-rewards --from wallet --chain-id nillion-chain-testnet-1 --gas-adjustment 1.4 --gas auto --gas-prices -y
Withdraw commission and rewards from your validator
Copy nilchaind tx distribution withdraw-rewards $(nilchaind keys show wallet --bech val -a) --commission --from wallet --chain-id nillion-chain-testnet-1 --gas-adjustment 1.4 --gas auto --gas-prices -y
Delegate tokens to yourself
Copy nilchaind tx staking delegate $(nilchaind keys show wallet --bech val -a) --from wallet --chain-id nillion-chain-testnet-1 --gas-adjustment 1.4 --gas auto --gas-prices -y
Delegate tokens to validator
Copy nilchaind tx staking delegate <TO_VALOPER_ADDRESS> --from wallet --chain-id nillion-chain-testnet-1 --gas-adjustment 1.4 --gas auto --gas-prices -y
Redelegate tokens to another validator
Copy nilchaind tx staking redelegate $(nilchaind keys show wallet --bech val -a) <TO_VALOPER_ADDRESS> --from wallet --chain-id nillion-chain-testnet-1 --gas-adjustment 1.4 --gas auto --gas-prices -y
Unbond tokens from your validator
Copy nilchaind tx staking unbond $(nilchaind keys show wallet --bech val -a) --from wallet --chain-id nillion-chain-testnet-1 --gas-adjustment 1.4 --gas auto --gas-prices -y
Send tokens to the wallet
Copy nilchaind tx bank send wallet <TO_WALLET_ADDRESS> --from wallet --chain-id nillion-chain-testnet-1 --gas-adjustment 1.4 --gas auto --gas-prices -y
🗳 Governance
List all proposals
Copy nilchaind query gov proposals
View proposal by id
Copy nilchaind query gov proposal 1
Vote 'Yes'
Copy nilchaind tx gov vote 1 yes --from wallet --chain-id nillion-chain-testnet-1 --gas-adjustment 1.4 --gas auto --gas-prices -y
Vote 'No'
Copy nilchaind tx gov vote 1 no --from wallet --chain-id nillion-chain-testnet-1 --gas-adjustment 1.4 --gas auto --gas-prices -y
Vote 'Abstain'
Copy nilchaind tx gov vote 1 abstain --from wallet --chain-id nillion-chain-testnet-1 --gas-adjustment 1.4 --gas auto --gas-prices -y
Vote 'NoWithVeto'
Copy nilchaind tx gov vote 1 NoWithVeto --from wallet --chain-id nillion-chain-testnet-1 --gas-adjustment 1.4 --gas auto --gas-prices -y
⚡️ Utility
Update ports
Copy CUSTOM_PORT = 281
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\"%" .nillionapp/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\"%" .nillionapp/config/app.toml
Update Indexer
Disable indexer
Copy sed -i -e 's|^indexer *=.*|indexer = "null"|' .nillionapp/config/config.toml
Enable indexer
Copy sed -i -e 's|^indexer *=.*|indexer = "kv"|' .nillionapp/config/config.toml
Update pruning
Copy 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"|' \
.nillionapp/config/app.toml
🚨 Maintenance
Get validator info
Copy nilchaind status 2>&1 | jq .ValidatorInfo
Get sync info
Copy nilchaind status 2>&1 | jq .SyncInfo
Get node peer
Copy echo $(nilchaind tendermint show-node-id)'@'$(curl -s ifconfig.me)':'$(cat .nillionapp/config/config.toml | sed -n '/Address to listen for incoming connection/{n;p;}' | sed 's/.*://; s/".*//')
Check if validator key is correct
Copy [[ $(nilchaind q staking validator $(nilchaind keys show wallet --bech val -a) -oj | jq -r .consensus_pubkey.key) = $(nilchaind 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
Copy curl -sS http://localhost:28157/net_info | jq -r '.result.peers[] | "\(.node_info.id)@\(.remote_ip):\(.node_info.listen_addr)"' | awk -F ':' '{print $1":"$(NF)}'
Set minimum gas price
Copy sed -i -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"\"/" .nillionapp/config/app.toml
Enable prometheus
Copy sed -i -e "s/prometheus = false/prometheus = true/" .nillionapp/config/config.toml
Reset chain data
Copy nilchaind tendermint unsafe-reset-all --home .nillionapp --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 !
Copy cd $HOME
sudo systemctl stop nilchaind
sudo systemctl disable nilchaind
sudo rm /etc/systemd/system/nilchaind.nilchaind
sudo systemctl daemon-reload
rm -f $( which nilchaind )
rm -rf .nillionapp
rm -rf $HOME /osmosis
⚙️ Service Management
Reload nilchaind configuration
Copy sudo systemctl daemon-reload
Enable nilchaind
Copy sudo systemctl enable nilchaind
Disable nilchaind
Copy sudo systemctl disable nilchaind
Start nilchaind
Copy sudo systemctl start nilchaind
Stop nilchaind
Copy sudo systemctl stop nilchaind
Restart nilchaind
Copy sudo systemctl restart nilchaind
Check nilchaind status
Copy sudo systemctl status nilchaind
Check nilchaind logs
Copy sudo journalctl -u nilchaind -f --no-hostname -o cat