Useful commands
🔑 Key management
Add new key
stchaind keys add wallet
Recover existing key
stchaind keys add wallet --recover
List all keys
stchaind keys list
Delete key
stchaind keys delete wallet
Export key to the file
stchaind keys export wallet
Import key from the file
stchaind keys import wallet wallet.backup
Query wallet balance
stchaind q bank balances $(stchaind keys show wallet -a)
👷 Validator management
{% hint style="info" %} Please make sure you have adjusted moniker, identity, details and website to match your values. {% endhint %}
Create new validator
stchaind tx staking create-validator \
--amount 1stos \
--pubkey $(stchaind tendermint show-validator) \
--moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id stratos-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 1000000000wei \
-y
Edit existing validator
stchaind tx staking edit-validator \
--new-moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id stratos-1 \
--commission-rate 0.05 \
--from wallet \
--gas-adjustment 1.4 \
--gas auto \
--gas-prices 1000000000wei \
-y
Unjail validator
stchaind tx slashing unjail --from wallet --chain-id stratos-1 --gas-adjustment 1.4 --gas auto --gas-prices 1000000000wei -y
Jail reason
stchaind query slashing signing-info $(stchaind tendermint show-validator)
List all active validators
stchaind 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
stchaind 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
stchaind q staking validator $(stchaind keys show wallet --bech val -a)
💲 Token management
Withdraw rewards from all validators
stchaind tx distribution withdraw-all-rewards --from wallet --chain-id stratos-1 --gas-adjustment 1.4 --gas auto --gas-prices 1000000000wei -y
Withdraw commission and rewards from your validator
stchaind tx distribution withdraw-rewards $(stchaind keys show wallet --bech val -a) --commission --from wallet --chain-id stratos-1 --gas-adjustment 1.4 --gas auto --gas-prices 1000000000wei -y
Delegate tokens to yourself
stchaind tx staking delegate $(stchaind keys show wallet --bech val -a) 1000000000wei --from wallet --chain-id stratos-1 --gas-adjustment 1.4 --gas auto --gas-prices 1000000000wei -y
Delegate tokens to validator
stchaind tx staking delegate <TO_VALOPER_ADDRESS> 1000000000wei --from wallet --chain-id stratos-1 --gas-adjustment 1.4 --gas auto --gas-prices 1000000000wei -y
Redelegate tokens to another validator
stchaind tx staking redelegate $(stchaind keys show wallet --bech val -a) <TO_VALOPER_ADDRESS> 1000000000wei --from wallet --chain-id stratos-1 --gas-adjustment 1.4 --gas auto --gas-prices 1000000000wei -y
Unbond tokens from your validator
stchaind tx staking unbond $(stchaind keys show wallet --bech val -a) 1000000000wei --from wallet --chain-id stratos-1 --gas-adjustment 1.4 --gas auto --gas-prices 1000000000wei -y
Send tokens to the wallet
stchaind tx bank send wallet <TO_WALLET_ADDRESS> 1000000000wei --from wallet --chain-id stratos-1 --gas-adjustment 1.4 --gas auto --gas-prices 1000000000wei -y
🗳 Governance
List all proposals
stchaind query gov proposals
View proposal by id
stchaind query gov proposal 1
Vote 'Yes'
stchaind tx gov vote 1 yes --from wallet --chain-id stratos-1 --gas-adjustment 1.4 --gas auto --gas-prices 1000000000wei -y
Vote 'No'
stchaind tx gov vote 1 no --from wallet --chain-id stratos-1 --gas-adjustment 1.4 --gas auto --gas-prices 1000000000wei -y
Vote 'Abstain'
stchaind tx gov vote 1 abstain --from wallet --chain-id stratos-1 --gas-adjustment 1.4 --gas auto --gas-prices 1000000000wei -y
Vote 'NoWithVeto'
stchaind tx gov vote 1 NoWithVeto --from wallet --chain-id stratos-1 --gas-adjustment 1.4 --gas auto --gas-prices 1000000000wei -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/.stchaind/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/.stchaind/config/app.toml
Update Indexer
Disable indexer
sed -i -e 's|^indexer *=.*|indexer = "null"|' $HOME/.stchaind/config/config.toml
Enable indexer
sed -i -e 's|^indexer *=.*|indexer = "kv"|' $HOME/.stchaind/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/.stchaind/config/app.toml
🚨 Maintenance
Get validator info
stchaind status 2>&1 | jq .ValidatorInfo
Get sync info
stchaind status 2>&1 | jq .SyncInfo
Get node peer
echo $(stchaind tendermint show-node-id)'@'$(curl -s ifconfig.me)':'$(cat $HOME/.stchaind/config/config.toml | sed -n '/Address to listen for incoming connection/{n;p;}' | sed 's/.*://; s/".*//')
Check if validator key is correct
[[ $(stchaind q staking validator $(stchaind keys show wallet --bech val -a) -oj | jq -r .consensus_pubkey.key) = $(stchaind 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 = \"1000000000wei\"/" $HOME/.stchaind/config/app.toml
Enable prometheus
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.stchaind/config/config.toml
Reset chain data
stchaind tendermint unsafe-reset-all --keep-addr-book --home $HOME/.stchaind --keep-addr-book
Remove node
{% hint style='danger' %} Please, before proceeding with the next step! All chain data will be lost! Make sure you have backed up your priv_validator_key.json! {% endhint %}
cd $HOME
sudo systemctl stop stchaind
sudo systemctl disable stchaind
sudo rm /etc/systemd/system/stchaind.service
sudo systemctl daemon-reload
rm -f $(which stchaind)
rm -rf $HOME/.stchaind
rm -rf $HOME/stratos-chain
⚙️ Service Management
Reload service configuration
sudo systemctl daemon-reload
Enable service
sudo systemctl enable stchaind
Disable service
sudo systemctl disable stchaind
Start service
sudo systemctl start stchaind
Stop service
sudo systemctl stop stchaind
Restart service
sudo systemctl restart stchaind
Check service status
sudo systemctl status stchaind
Check service logs
sudo journalctl -u stchaind -f --no-hostname -o cat