Usefull commands for Saga Protocol

🔑 Key management

👛

Change wallet in the commands to your own wallet name.

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

🙋‍♀️

Make sure to change values for moniker, identity, details website to your own values.

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-1 \
--commission-rate 0.05 \
--from wallet \
--gas-adjustment 1.5 \
--gas auto \
--gas-prices 0usaga \
-y

Unjail validator

sscd tx slashing unjail --from wallet --chain-id ssc-1 --gas-adjustment 1.5 --gas auto
 --gas-prices 0usaga -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-1 --gas-adjustment 1.5 --gas auto --gas-prices 0usaga -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-1 --gas-adjustment 1.5 --gas auto --gas-prices 0usaga -y

Delegate tokens to yourself

sscd tx staking delegate $( sscd keys show wallet --bech val -a) 1000000usaga --from wallet --chain-id ssc-1 --gas-adjustment 1.5 --gas auto --gas-prices 0usaga -y

Delegate tokens to validator

sscd tx staking delegate <TO_VALOPER_ADDRESS> 1000000usaga --from wallet --chain-id ssc-1 --gas-adjustment 1.5 --gas auto --gas-prices 0usaga  -y

Redelegate tokens to another validator

sscd tx staking redelegate $( sscd keys show wallet --bech val -a) <TO_VALOPER_ADDRESS> 1000000usaga --from wallet --chain-id ssc-1 --gas-adjustment 1.5 --gas auto --gas-prices 0usaga -y

Unbond tokens from your validator

sscd tx staking unbond $( sscd keys show wallet --bech val -a) 1000000usaga --from wallet --chain-id ssc-1 --gas-adjustment 1.5 --gas auto --gas-prices 0usaga -y

Send tokens to the wallet

sscd tx bank send wallet <TO_WALLET_ADDRESS> 1000000usaga --from wallet --chain-id ssc-1 --gas-adjustment 1.5 --gas auto --gas-prices 0usaga -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-1 --gas-adjustment 1.5 --gas auto --gas-prices 0usaga -y

Vote 'No'

sscd tx gov vote 1 no --from wallet --chain-id ssc-1 --gas-adjustment 1.5 --gas auto --gas-prices 0usaga -y

Vote 'Abstain'

sscd tx gov vote 1 abstain --from wallet --chain-id ssc-1 --gas-adjustment 1.5 --gas auto --gas-prices 0usaga -y

Vote 'NoWithVeto'

sscd tx gov vote 1 NoWithVeto --from wallet --chain-id ssc-1 --gas-adjustment 1.5 --gas auto --gas-prices 0usaga -y

⚡️ Utility

Update Indexer

Disable indexer

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

Enable indexer

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

Update pruning

sed -i \
  -e 's|^pruning *=.*|pruning = "custom"|' \
  -e 's|^pruning-keep-recent *=.*|pruning-keep-recent = "2000"|' \
  -e 's|^pruning-keep-every *=.*|pruning-keep-every = "0"|' \
  -e 's|^pruning-interval *=.*|pruning-interval = "100"|' \
  $HOME/.sscd/config/app.toml

🔧 Maintenance

Get validator info

sscd status 2>&1 | jq .ValidatorInfo

Get sync info

sscd status 2>&1 | jq .SyncInfo

Enable prometheus

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

Reset chain data

sscd tendermint unsafe-reset-all --keep-addr-book --home $HOME/.ssc --keep-addr-book

Remove node

☢️

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.service
sudo systemctl daemon-reload
rm -f $(which sscd)
rm -rf $HOME/.ssc
rm -rf $HOME/ssc

⚙️ Service Management

Reload service configuration

sudo systemctl daemon-reload

Enable service

sudo systemctl enable sscd

Disable service

sudo systemctl disable sscd

Start service

sudo systemctl start sscd

Stop service

sudo systemctl stop saga

Restart service

sudo systemctl restart saga

Check service status

sudo systemctl status saga

Check service logs

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

Install Node Validator Setup