Useful commands

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

IRISnet

Daemon configuration

iris config node https://irisnet-rpc.lavenderfive.com:443
iris config chain-id irishub-1

🔑 Key management

Add new key

iris keys add wallet

Recover existing key

iris keys add wallet --recover

List all keys

iris keys list

Delete key

iris keys delete wallet

Export key to the file

iris keys export wallet

Import key from the file

iris keys import wallet wallet.backup

Query wallet balance

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

👷 Validator management

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

Create new validator

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

Edit existing validator

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

Unjail validator

iris tx slashing unjail --from wallet --chain-id irishub-1 --gas-adjustment 1.4 --gas auto --gas-prices 0uiris -y

Jail reason

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

List all active validators

iris 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

iris 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

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

💲 Token management

Withdraw rewards from all validators

iris tx distribution withdraw-all-rewards --from wallet --chain-id irishub-1 --gas-adjustment 1.4 --gas auto --gas-prices 0uiris -y

Withdraw commission and rewards from your validator

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

Delegate tokens to yourself

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

Delegate tokens to validator

iris tx staking delegate <TO_VALOPER_ADDRESS> 0uiris --from wallet --chain-id irishub-1 --gas-adjustment 1.4 --gas auto --gas-prices 0uiris -y

Redelegate tokens to another validator

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

Unbond tokens from your validator

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

Send tokens to the wallet

iris tx bank send wallet <TO_WALLET_ADDRESS> 0uiris --from wallet --chain-id irishub-1 --gas-adjustment 1.4 --gas auto --gas-prices 0uiris -y

🗳 Governance

List all proposals

iris query gov proposals

View proposal by id

iris query gov proposal 1

Vote 'Yes'

iris tx gov vote 1 yes --from wallet --chain-id irishub-1 --gas-adjustment 1.4 --gas auto --gas-prices 0uiris -y

Vote 'No'

iris tx gov vote 1 no --from wallet --chain-id irishub-1 --gas-adjustment 1.4 --gas auto --gas-prices 0uiris -y

Vote 'Abstain'

iris tx gov vote 1 abstain --from wallet --chain-id irishub-1 --gas-adjustment 1.4 --gas auto --gas-prices 0uiris -y

Vote 'NoWithVeto'

iris tx gov vote 1 NoWithVeto --from wallet --chain-id irishub-1 --gas-adjustment 1.4 --gas auto --gas-prices 0uiris -y

⚡️ Utility

Update ports

CUSTOM_PORT=226
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/.iris/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/.iris/config/app.toml

Update Indexer

Disable indexer

sed -i -e 's|^indexer *=.*|indexer = "null"|' $HOME/.iris/config/config.toml

Enable indexer

sed -i -e 's|^indexer *=.*|indexer = "kv"|' $HOME/.iris/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/.iris/config/app.toml

🚨 Maintenance

Get validator info

iris status 2>&1 | jq .ValidatorInfo

Get sync info

iris status 2>&1 | jq .SyncInfo

Get node peer

echo $(iris tendermint show-node-id)'@'$(curl -s ifconfig.me)':'$(cat $HOME/.iris/config/config.toml | sed -n '/Address to listen for incoming connection/{n;p;}' | sed 's/.*://; s/".*//')

Check if validator key is correct

[[ $(iris q staking validator $(iris keys show wallet --bech val -a) -oj | jq -r .consensus_pubkey.key) = $(iris 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:22657/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 = \"0uiris\"/" $HOME/.iris/config/app.toml

Enable prometheus

sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.iris/config/config.toml

Reset chain data

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

⚙️ Service Management

Reload iris configuration

sudo systemctl daemon-reload

Enable iris

sudo systemctl enable iris

Disable iris

sudo systemctl disable iris

Start iris

sudo systemctl start iris

Stop iris

sudo systemctl stop iris

Restart iris

sudo systemctl restart iris

Check iris status

sudo systemctl status iris

Check iris logs

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