Useful commands Useful set of commands for node operators. From key management to chain governance.
Daemon configuration
Copy marsd config node https://mars-rpc.lavenderfive.com:443
marsd config chain-id mars-1
🔑 Key management
Add new key
Copy marsd keys add wallet
Recover existing key
Copy marsd keys add wallet --recover
List all keys
Delete key
Copy marsd keys delete wallet
Export key to the file
Copy marsd keys export wallet
Import key from the file
Copy marsd keys import wallet wallet.backup
Query wallet balance
Copy marsd q bank balances $( marsd keys show wallet -a )
👷 Validator management
Please make sure you have adjusted moniker , identity , details and website to match your values.
Create new validator
Copy marsd tx staking create-validator \
--amount 0umars \
--pubkey $( marsd tendermint show-validator ) \
--moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id mars-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 0umars \
-y
Edit existing validator
Copy marsd tx staking edit-validator \
--new-moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id mars-1 \
--commission-rate 0.05 \
--from wallet \
--gas-adjustment 1.4 \
--gas auto \
--gas-prices 0umars \
-y
Unjail validator
Copy marsd tx slashing unjail --from wallet --chain-id mars-1 --gas-adjustment 1.4 --gas auto --gas-prices 0umars -y
Jail reason
Copy marsd query slashing signing-info $( marsd tendermint show-validator )
List all active validators
Copy marsd 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
Copy marsd 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
Copy marsd q staking validator $( marsd keys show wallet --bech val -a )
💲 Token management
Withdraw rewards from all validators
Copy marsd tx distribution withdraw-all-rewards --from wallet --chain-id mars-1 --gas-adjustment 1.4 --gas auto --gas-prices 0umars -y
Withdraw commission and rewards from your validator
Copy marsd tx distribution withdraw-rewards $(marsd keys show wallet --bech val -a) --commission --from wallet --chain-id mars-1 --gas-adjustment 1.4 --gas auto --gas-prices 0umars -y
Delegate tokens to yourself
Copy marsd tx staking delegate $(marsd keys show wallet --bech val -a) 0umars --from wallet --chain-id mars-1 --gas-adjustment 1.4 --gas auto --gas-prices 0umars -y
Delegate tokens to validator
Copy marsd tx staking delegate <TO_VALOPER_ADDRESS> 0umars --from wallet --chain-id mars-1 --gas-adjustment 1.4 --gas auto --gas-prices 0umars -y
Redelegate tokens to another validator
Copy marsd tx staking redelegate $(marsd keys show wallet --bech val -a) <TO_VALOPER_ADDRESS> 0umars --from wallet --chain-id mars-1 --gas-adjustment 1.4 --gas auto --gas-prices 0umars -y
Unbond tokens from your validator
Copy marsd tx staking unbond $(marsd keys show wallet --bech val -a) 0umars --from wallet --chain-id mars-1 --gas-adjustment 1.4 --gas auto --gas-prices 0umars -y
Send tokens to the wallet
Copy marsd tx bank send wallet <TO_WALLET_ADDRESS> 0umars --from wallet --chain-id mars-1 --gas-adjustment 1.4 --gas auto --gas-prices 0umars -y
🗳 Governance
List all proposals
Copy marsd query gov proposals
View proposal by id
Copy marsd query gov proposal 1
Vote 'Yes'
Copy marsd tx gov vote 1 yes --from wallet --chain-id mars-1 --gas-adjustment 1.4 --gas auto --gas-prices 0umars -y
Vote 'No'
Copy marsd tx gov vote 1 no --from wallet --chain-id mars-1 --gas-adjustment 1.4 --gas auto --gas-prices 0umars -y
Vote 'Abstain'
Copy marsd tx gov vote 1 abstain --from wallet --chain-id mars-1 --gas-adjustment 1.4 --gas auto --gas-prices 0umars -y
Vote 'NoWithVeto'
Copy marsd tx gov vote 1 NoWithVeto --from wallet --chain-id mars-1 --gas-adjustment 1.4 --gas auto --gas-prices 0umars -y
⚡️ Utility
Update ports
Copy CUSTOM_PORT = 185
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/.mars/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/.mars/config/app.toml
Update Indexer
Disable indexer
Copy sed -i -e 's|^indexer *=.*|indexer = "null"|' $HOME /.mars/config/config.toml
Enable indexer
Copy sed -i -e 's|^indexer *=.*|indexer = "kv"|' $HOME /.mars/config/config.toml
Update pruning
Copy 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 /.mars/config/app.toml
🚨 Maintenance
Get validator info
Copy marsd status 2>&1 | jq .ValidatorInfo
Get sync info
Copy marsd status 2>&1 | jq .SyncInfo
Get node peer
Copy echo $(marsd tendermint show-node-id)'@'$(curl -s ifconfig.me)':'$(cat $HOME/.mars/config/config.toml | sed -n '/Address to listen for incoming connection/{n;p;}' | sed 's/.*://; s/".*//')
Check if validator key is correct
Copy [[ $(marsd q staking validator $(marsd keys show wallet --bech val -a) -oj | jq -r .consensus_pubkey.key) = $(marsd 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
Copy curl -sS http://localhost:18557/net_info | jq -r '.result.peers[] | "\(.node_info.id)@\(.remote_ip):\(.node_info.listen_addr)"' | awk -F ':' '{print $1":"$(NF)}'
Set minimum gas price
Copy sed -i -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0umars\"/" $HOME /.mars/config/app.toml
Enable prometheus
Copy sed -i -e "s/prometheus = false/prometheus = true/" $HOME /.mars/config/config.toml
Reset chain data
Copy marsd tendermint unsafe-reset-all --home $HOME /.mars --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 !
Copy cd $HOME
sudo systemctl stop marsd
sudo systemctl disable marsd
sudo rm /etc/systemd/system/marsd.marsd
sudo systemctl daemon-reload
rm -f $( which marsd )
rm -rf $HOME /.mars
rm -rf $HOME /osmosis
⚙️ Service Management
Reload marsd configuration
Copy sudo systemctl daemon-reload
Enable marsd
Copy sudo systemctl enable marsd
Disable marsd
Copy sudo systemctl disable marsd
Start marsd
Copy sudo systemctl start marsd
Stop marsd
Copy sudo systemctl stop marsd
Restart marsd
Copy sudo systemctl restart marsd
Check marsd status
Copy sudo systemctl status marsd
Check marsd logs
Copy sudo journalctl -u marsd -f --no-hostname -o cat