🔑 Key management
Add new key
nilchaind keys add wallet
Recover existing key
nilchaind keys add wallet --recover
List all keys
nilchaind keys list
Delete key
nilchaind keys delete wallet
Export key to a file
nilchaind keys export wallet
Import key from a file
nilchaind keys import wallet wallet.backup
Query wallet balance
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
nilchaind tx staking create-validator <(cat <<EOF
{
"pubkey": $(nilchaind comet show-validator),
"amount": "1000000unil",
"moniker": "YOUR_MONIKER_NAME",
"identity": "YOUR_KEYBASE_ID",
"website": "YOUR_WEBSITE_URL",
"security": "YOUR_SECURITY_EMAIL",
"details": "YOUR_DETAILS",
"commission-rate": "0.05",
"commission-max-rate": "0.20",
"commission-max-change-rate": "0.05",
"min-self-delegation": "1"
}
EOF
) \
--chain-id nillion-1 \
--from wallet \
--gas-adjustment 1.4 \
--gas auto \
--gas-prices 0unil \
-y
Edit existing validator
nilchaind tx staking edit-validator \
--new-moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id nillion-1 \
--commission-rate 0.05 \
--from wallet \
--gas-adjustment 1.4 \
--gas auto \
--gas-prices 0unil \
-y
Unjail validator
nilchaind tx slashing unjail --from wallet --chain-id nillion-1 --gas-adjustment 1.4 --gas auto --gas-prices 0unil -y
Jail reason
nilchaind query slashing signing-info $(nilchaind comet show-validator)
List all active validators
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
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
nilchaind q staking validator $(nilchaind keys show wallet --bech val -a)
💲 Token management
Withdraw rewards from all validators
nilchaind tx distribution withdraw-all-rewards --from wallet --chain-id nillion-1 --gas-adjustment 1.4 --gas auto --gas-prices 0unil -y
Withdraw commission and rewards from your validator
nilchaind tx distribution withdraw-rewards $(nilchaind keys show wallet --bech val -a) --commission --from wallet --chain-id nillion-1 --gas-adjustment 1.4 --gas auto --gas-prices 0unil -y
Delegate tokens to yourself
nilchaind tx staking delegate $(nilchaind keys show wallet --bech val -a) 1000000unil --from wallet --chain-id nillion-1 --gas-adjustment 1.4 --gas auto --gas-prices 0unil -y
Delegate tokens to validator
nilchaind tx staking delegate <TO_VALOPER_ADDRESS> 1000000unil --from wallet --chain-id nillion-1 --gas-adjustment 1.4 --gas auto --gas-prices 0unil -y
Redelegate tokens to another validator
nilchaind tx staking redelegate $(nilchaind keys show wallet --bech val -a) <TO_VALOPER_ADDRESS> 1000000unil --from wallet --chain-id nillion-1 --gas-adjustment 1.4 --gas auto --gas-prices 0unil -y
Unbond tokens from your validator
nilchaind tx staking unbond $(nilchaind keys show wallet --bech val -a) 1000000unil --from wallet --chain-id nillion-1 --gas-adjustment 1.4 --gas auto --gas-prices 0unil -y
Send tokens to the wallet
nilchaind tx bank send wallet <TO_WALLET_ADDRESS> 1000000unil --from wallet --chain-id nillion-1 --gas-adjustment 1.4 --gas auto --gas-prices 0unil -y
🗳 Governance
List all proposals
nilchaind query gov proposals
View proposal by id
nilchaind query gov proposal 1
Vote ‘Yes’
nilchaind tx gov vote 1 yes --from wallet --chain-id nillion-1 --gas-adjustment 1.4 --gas auto --gas-prices 0unil -y
Vote ‘No’
nilchaind tx gov vote 1 no --from wallet --chain-id nillion-1 --gas-adjustment 1.4 --gas auto --gas-prices 0unil -y
Vote ‘Abstain’
nilchaind tx gov vote 1 abstain --from wallet --chain-id nillion-1 --gas-adjustment 1.4 --gas auto --gas-prices 0unil -y
Vote ‘NoWithVeto’
nilchaind tx gov vote 1 NoWithVeto --from wallet --chain-id nillion-1 --gas-adjustment 1.4 --gas auto --gas-prices 0unil -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/.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\"%" $HOME/.nillionapp/config/app.toml
Update Indexer
Disable indexer
sed -i -e 's|^indexer *=.*|indexer = "null"|' $HOME/.nillionapp/config/config.toml
Enable indexer
sed -i -e 's|^indexer *=.*|indexer = "kv"|' $HOME/.nillionapp/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/.nillionapp/config/app.toml
🚨 Maintenance
Get validator info
nilchaind status 2>&1 | jq .ValidatorInfo
Get sync info
nilchaind status 2>&1 | jq .SyncInfo
Get node peer
echo $(nilchaind comet show-node-id)'@'$(curl -4s ifconfig.me)':'$(cat $HOME/.nillionapp/config/config.toml | sed -n '/Address to listen for incoming connection/{n;p;}' | sed 's/.*://; s/".*//')
Check if validator key is correct
[[ $(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
curl -sS http://localhost:18057/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 = \"0unil\"/" $HOME/.nillionapp/config/app.toml
Enable prometheus
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.nillionapp/config/config.toml
Reset chain data
nilchaind comet unsafe-reset-all --keep-addr-book --home $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!
cd $HOME
sudo systemctl stop nillion.service
sudo systemctl disable nillion.service
sudo rm /etc/systemd/system/nillion.service
sudo systemctl daemon-reload
rm -f $(which nilchaind)
rm -rf $HOME/.nillionapp
rm -rf $HOME/nilchain
⚙️ Service Management
Reload service configuration
sudo systemctl daemon-reload
Enable service
sudo systemctl enable nillion.service
Disable service
sudo systemctl disable nillion.service
Start service
sudo systemctl start nillion.service
Stop service
sudo systemctl stop nillion.service
Restart service
sudo systemctl restart nillion.service
Check service status
sudo systemctl status nillion.service
Check service logs
sudo journalctl -u nillion.service -f --no-hostname -o cat