Useful commands

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

Saga Multiverse

Daemon configuration

sscd config node https://testnet-saga-rpc.lavenderfive.com:443
sscd config chain-id ssc-testnet-2

🔑 Key management

Add new key

sscd keys add wallet

Recover existing key

sscd keys add wallet --recover

List all keys

sscd keys list

Delete key

sscd keys delete wallet

Export key to the file

sscd keys export wallet

Import key from the file

sscd keys import wallet wallet.backup

Query wallet balance

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

👷 Validator management

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

Create new validator

sscd tx staking create-validator \
--amount  \
--pubkey $(sscd tendermint show-validator) \
--moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id ssc-testnet-2 \
--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

sscd tx staking edit-validator \
--new-moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id ssc-testnet-2 \
--commission-rate 0.05 \
--from wallet \
--gas-adjustment 1.4 \
--gas auto \
--gas-prices  \
-y

Unjail validator

sscd tx slashing unjail --from wallet --chain-id ssc-testnet-2 --gas-adjustment 1.4 --gas auto --gas-prices  -y

Jail reason

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

List all active validators

sscd 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

sscd 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

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

💲 Token management

Withdraw rewards from all validators

sscd tx distribution withdraw-all-rewards --from wallet --chain-id ssc-testnet-2 --gas-adjustment 1.4 --gas auto --gas-prices  -y

Withdraw commission and rewards from your validator

sscd tx distribution withdraw-rewards $(sscd keys show wallet --bech val -a) --commission --from wallet --chain-id ssc-testnet-2 --gas-adjustment 1.4 --gas auto --gas-prices  -y

Delegate tokens to yourself

sscd tx staking delegate $(sscd keys show wallet --bech val -a)  --from wallet --chain-id ssc-testnet-2 --gas-adjustment 1.4 --gas auto --gas-prices  -y

Delegate tokens to validator

sscd tx staking delegate <TO_VALOPER_ADDRESS>  --from wallet --chain-id ssc-testnet-2 --gas-adjustment 1.4 --gas auto --gas-prices  -y

Redelegate tokens to another validator

sscd tx staking redelegate $(sscd keys show wallet --bech val -a) <TO_VALOPER_ADDRESS>  --from wallet --chain-id ssc-testnet-2 --gas-adjustment 1.4 --gas auto --gas-prices  -y

Unbond tokens from your validator

sscd tx staking unbond $(sscd keys show wallet --bech val -a)  --from wallet --chain-id ssc-testnet-2 --gas-adjustment 1.4 --gas auto --gas-prices  -y

Send tokens to the wallet

sscd tx bank send wallet <TO_WALLET_ADDRESS>  --from wallet --chain-id ssc-testnet-2 --gas-adjustment 1.4 --gas auto --gas-prices  -y

🗳 Governance

List all proposals

sscd query gov proposals

View proposal by id

sscd query gov proposal 1

Vote 'Yes'

sscd tx gov vote 1 yes --from wallet --chain-id ssc-testnet-2 --gas-adjustment 1.4 --gas auto --gas-prices  -y

Vote 'No'

sscd tx gov vote 1 no --from wallet --chain-id ssc-testnet-2 --gas-adjustment 1.4 --gas auto --gas-prices  -y

Vote 'Abstain'

sscd tx gov vote 1 abstain --from wallet --chain-id ssc-testnet-2 --gas-adjustment 1.4 --gas auto --gas-prices  -y

Vote 'NoWithVeto'

sscd tx gov vote 1 NoWithVeto --from wallet --chain-id ssc-testnet-2 --gas-adjustment 1.4 --gas auto --gas-prices  -y

⚡️ Utility

Update ports

CUSTOM_PORT=249
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\"%" .ssc/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\"%" .ssc/config/app.toml

Update Indexer

Disable indexer

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

Enable indexer

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

🚨 Maintenance

Get validator info

sscd status 2>&1 | jq .ValidatorInfo

Get sync info

sscd status 2>&1 | jq .SyncInfo

Get node peer

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

Check if validator key is correct

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

Enable prometheus

sed -i -e "s/prometheus = false/prometheus = true/" .ssc/config/config.toml

Reset chain data

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

⚙️ Service Management

Reload sscd configuration

sudo systemctl daemon-reload

Enable sscd

sudo systemctl enable sscd

Disable sscd

sudo systemctl disable sscd

Start sscd

sudo systemctl start sscd

Stop sscd

sudo systemctl stop sscd

Restart sscd

sudo systemctl restart sscd

Check sscd status

sudo systemctl status sscd

Check sscd logs

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