Dymension Hub Validator Tools & Infrastructure Documentation
Complete infrastructure toolkit for Dymension Hub validators and developers. Access our professional-grade services including RPC nodes, API endpoints, daily snapshots, and real-time metrics. Our dymension infrastructure features optimized pruning configurations, automated backups, and comprehensive monitoring solutions. Supporting both mainnet and testnet environments with dedicated endpoints, state-sync services, and detailed technical documentation for seamless network participation and development.
Useful set of commands for node operators. From key management to chain governance.
#Daemon configuration
dymd config node https://rpc.lavenderfive.com:443/dymension
dymd config chain-id dymension_1100-1
#🔑 Key management
#Add new key
dymd keys add wallet
#Recover existing key
dymd keys add wallet --recover
#List all keys
dymd keys list
#Delete key
dymd keys delete wallet
#Export key to the file
dymd keys export wallet
#Import key from the file
dymd keys import wallet wallet.backup
#Query wallet balance
dymd q bank balances $(dymd keys show wallet -a)
#👷 Validator management
ⓘ
Please make sure you have adjusted **moniker**, **identity**, **details** and **website** to match your values.
#Create new validator
dymd tx staking create-validator \
--amount 5000000000adym \
--pubkey $(dymd tendermint show-validator) \
--moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id dymension_1100-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 5000000000adym \
-y
#Edit existing validator
dymd tx staking edit-validator \
--new-moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id dymension_1100-1 \
--commission-rate 0.05 \
--from wallet \
--gas-adjustment 1.4 \
--gas auto \
--gas-prices 5000000000adym \
-y
#Unjail validator
dymd tx slashing unjail --from wallet --chain-id dymension_1100-1 --gas-adjustment 1.4 --gas auto --gas-prices 5000000000adym -y
#Jail reason
dymd query slashing signing-info $(dymd tendermint show-validator)
#List all active validators
dymd 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
dymd 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
dymd q staking validator $(dymd keys show wallet --bech val -a)
#💲 Token management
#Withdraw rewards from all validators
dymd tx distribution withdraw-all-rewards --from wallet --chain-id dymension_1100-1 --gas-adjustment 1.4 --gas auto --gas-prices 5000000000adym -y
#Withdraw commission and rewards from your validator
dymd tx distribution withdraw-rewards $(dymd keys show wallet --bech val -a) --commission --from wallet --chain-id dymension_1100-1 --gas-adjustment 1.4 --gas auto --gas-prices 5000000000adym -y
#Delegate tokens to yourself
dymd tx staking delegate $(dymd keys show wallet --bech val -a) 5000000000adym --from wallet --chain-id dymension_1100-1 --gas-adjustment 1.4 --gas auto --gas-prices 5000000000adym -y
#Delegate tokens to validator
dymd tx staking delegate 5000000000adym --from wallet --chain-id dymension_1100-1 --gas-adjustment 1.4 --gas auto --gas-prices 5000000000adym -y
#Redelegate tokens to another validator
dymd tx staking redelegate $(dymd keys show wallet --bech val -a) 5000000000adym --from wallet --chain-id dymension_1100-1 --gas-adjustment 1.4 --gas auto --gas-prices 5000000000adym -y
#Unbond tokens from your validator
dymd tx staking unbond $(dymd keys show wallet --bech val -a) 5000000000adym --from wallet --chain-id dymension_1100-1 --gas-adjustment 1.4 --gas auto --gas-prices 5000000000adym -y
#Send tokens to the wallet
dymd tx bank send wallet 5000000000adym --from wallet --chain-id dymension_1100-1 --gas-adjustment 1.4 --gas auto --gas-prices 5000000000adym -y
#🗳 Governance
#List all proposals
dymd query gov proposals
#View proposal by id
dymd query gov proposal 1
#Vote 'Yes'
dymd tx gov vote 1 yes --from wallet --chain-id dymension_1100-1 --gas-adjustment 1.4 --gas auto --gas-prices 5000000000adym -y
#Vote 'No'
dymd tx gov vote 1 no --from wallet --chain-id dymension_1100-1 --gas-adjustment 1.4 --gas auto --gas-prices 5000000000adym -y
#Vote 'Abstain'
dymd tx gov vote 1 abstain --from wallet --chain-id dymension_1100-1 --gas-adjustment 1.4 --gas auto --gas-prices 5000000000adym -y
#Vote 'NoWithVeto'
dymd tx gov vote 1 NoWithVeto --from wallet --chain-id dymension_1100-1 --gas-adjustment 1.4 --gas auto --gas-prices 5000000000adym -y
#⚡️ Utility
#Update ports
CUSTOM_PORT=205
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/.dymd/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/.dymd/config/app.toml
#Update Indexer
Disable indexer
sed -i -e 's|^indexer *=.*|indexer = "null"|' $HOME/.dymd/config/config.toml
Enable indexer
sed -i -e 's|^indexer *=.*|indexer = "kv"|' $HOME/.dymd/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/.dymd/config/app.toml
#🚨 Maintenance
#Get validator info
dymd status 2>&1 | jq .ValidatorInfo
#Get sync info
dymd status 2>&1 | jq .SyncInfo
#Get node peer
echo $(dymd tendermint show-node-id)'@'$(curl -s ifconfig.me)':'$(cat $HOME/.dymd/config/config.toml | sed -n '/Address to listen for incoming connection/{n;p;}' | sed 's/.*://; s/".*//')
#Check if validator key is correct
[[ $(dymd q staking validator $(dymd keys show wallet --bech val -a) -oj | jq -r .consensus_pubkey.key) = $(dymd 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:20557/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 = \"5000000000adym\"/" $HOME/.dymd/config/app.toml
#Enable prometheus
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.dymd/config/config.toml
#Reset chain data
dymd tendermint unsafe-reset-all --home $HOME/.dymd --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 dymd
sudo systemctl disable dymd
sudo rm /etc/systemd/system/dymd.service
sudo systemctl daemon-reload
rm -f $(which dymd)
rm -rf $HOME/.dymd
rm -rf $HOME/dymd
#⚙️ Service Management
#Reload dymd configuration
sudo systemctl daemon-reload
#Enable dymd
sudo systemctl enable dymd
#Disable dymd
sudo systemctl disable dymd
#Start dymd
sudo systemctl start dymd
#Stop dymd
sudo systemctl stop dymd
#Restart dymd
sudo systemctl restart dymd
#Check dymd status
sudo systemctl status dymd
#Check dymd logs
sudo journalctl -u dymd -f --no-hostname -o cat
Chain ID:
The unique identifier for the blockchain network.
dymension_1100-1Latest Version:
The latest version of the chain software.
v3.0.0Github:
The Github repository hosting the code for the network in question.
Public endpoints
Public endpoints are rate limited but can be used for basic CLI usage, node syncing or testing environments. Request an API key for enhanced access limits, we offer free trial periods of 14 days and cheap shared access plans from $50 a month.
REST/LCD
REST endpoint for querying blockchain data through the REST framework. Often available for Cosmos chains but also the main framework for Aleo as an example.
rest.lavenderfive.com:443/dymension
RPC
Remote Procedure Call endpoint for the consensus client of a blockchain. This is not an EVM endpoint (we call this json RPC) but the main framework for blockchain frameworks like Cosmos, Aptos, Sui and Near.
rpc.lavenderfive.com:443/dymension
gRPC
High-performance RPC endpoint for blockchain communication using the Google gRPC framework. This is often standard gRPC and not the "WEB" framework which is sometimes also accesible.
dymension.lavenderfive.com:443
WebSocket
WebSocket endpoint for real-time blockchain updates of the consensus client. This is not the EVM websocket integration, we name and expose that separately. WS is commonly available for Cosmos and Move networks that also expose a REST endpoint.
wss://rpc.lavenderfive.com:443/dymension/ws
Json-RPC
JSON-RPC endpoint for EVM interactions and queries. This is the main endpoint for Ethereum like networks but might co-exist alongside a consensus RPCs on Cosmos like networks that have a separate consensus endpoint like Berachain, Story and Evmos.
jsonrpc.lavenderfive.com:443/dymension
Json-RPC (websocket)
The websocket interface for the json-RPC EVM endpoint to listen/subscribe to event feeds.
wss://jsonrpc.lavenderfive.com:443/dymension/ws
© 2022 Lavender.Five Nodes. All rights reserved.