Dymension
Run the node
Chain ID | Port | Version |
---|---|---|
dymension_1100-1 | 150 | v3.0.0 |
Minimum hardware
Spec | Requirements |
---|---|
CPU | 8 Cores (Intel / AMD) |
RAM | 16 GB |
NVME | 1 TB |
RPC, API, gRPC and Snapshot
✅ RPC: https://rpc-dym.vnbnode.com/
✅ API: https://api-dym.vnbnode.com/
✅ gRPC: https://grpc-dym.vnbnode.com/
✅ Auto Snapshot daily
- 🖼️ Validator
- 🖼️ Rollapp
- 🖼️ Command
- 🖼️ Snapshot
Setup validator name
Replace YOUR_MONIKER with your validator name
MONIKER="YOUR_MONIKER"
Install dependencies
# UPDATE SYSTEM AND INSTALL BUILD TOOLS
sudo apt -q update
sudo apt -qy install curl git jq lz4 build-essential
sudo apt -qy upgrade
# INSTALL GO
sudo rm -rf /usr/local/go
curl -Ls https://go.dev/dl/go1.21.7.linux-amd64.tar.gz | sudo tar -xzf - -C /usr/local
eval $(echo 'export PATH=$PATH:/usr/local/go/bin' | sudo tee /etc/profile.d/golang.sh)
eval $(echo 'export PATH=$PATH:$HOME/go/bin' | tee -a $HOME/.profile)
Download and build binaries
# Clone project repository
cd $HOME
rm -rf dymension
git clone https://github.com/dymensionxyz/dymension.git
cd dymension
git checkout v3.0.0
# Build binaries
make build
# Prepare binaries for Cosmovisor
mkdir -p $HOME/.dymension/cosmovisor/genesis/bin
mv build/dymd $HOME/.dymension/cosmovisor/genesis/bin/
rm -rf build
# Create application symlinks
sudo ln -s $HOME/.dymension/cosmovisor/genesis $HOME/.dymension/cosmovisor/current -f
sudo ln -s $HOME/.dymension/cosmovisor/current/bin/dymd /usr/local/bin/dymd -f
Install Cosmovisor and create a service
# Download and install Cosmovisor
go install cosmossdk.io/tools/cosmovisor/cmd/[email protected]
# Create service
sudo tee /etc/systemd/system/dymension.service > /dev/null << EOF
[Unit]
Description=dymension node service
After=network-online.target
[Service]
User=$USER
ExecStart=$(which cosmovisor) run start
Restart=on-failure
RestartSec=10
LimitNOFILE=65535
Environment="DAEMON_HOME=$HOME/.dymension"
Environment="DAEMON_NAME=dymd"
Environment="UNSAFE_SKIP_BACKUP=true"
Environment="PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin:$HOME/.dymension/cosmovisor/current/bin"
[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable dymension.service
Initialize the node
# Set node configuration
dymd config chain-id dymension_1100-1
dymd config keyring-backend file
dymd config node tcp://localhost:15057
# Initialize the node
dymd init $MONIKER --chain-id dymension_1100-1
# Download genesis and addrbook
curl -Ls https://snap.vnbnode.com/dymension/genesis.json > $HOME/.dymension/config/genesis.json
curl -Ls https://snap.vnbnode.com/dymension/addrbook.json > $HOME/.dymension/config/addrbook.json
# Add seeds
sed -i -e "s|^seeds *=.*|seeds = \"400f3d9e30b69e78a7fb891f60d76fa3c73f0ecc@dymension.rpc.kjnodes.com:14659\"|" $HOME/.dymension/config/config.toml
# Set minimum gas price
sed -i -e "s|^minimum-gas-prices *=.*|minimum-gas-prices = \"5000000000adym\"|" $HOME/.dymension/config/app.toml
# Set 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/.dymension/config/app.toml
# Set custom ports
sed -i -e "s%^proxy_app = \"tcp://127.0.0.1:26658\"%proxy_app = \"tcp://127.0.0.1:58\"%; s%^laddr = \"tcp://127.0.0.1:26657\"%laddr = \"tcp://127.0.0.1:15057\"%; s%^pprof_laddr = \"localhost:6060\"%pprof_laddr = \"localhost:15060\"%; s%^laddr = \"tcp://0.0.0.0:26656\"%laddr = \"tcp://0.0.0.0:15056\"%; s%^prometheus_listen_addr = \":26660\"%prometheus_listen_addr = \":15066\"%" $HOME/.dymension/config/config.toml
sed -i -e "s%^address = \"tcp://0.0.0.0:1317\"%address = \"tcp://0.0.0.0:15017\"%; s%^address = \":8080\"%address = \":15080\"%; s%^address = \"0.0.0.0:9090\"%address = \"0.0.0.0:15090\"%; s%^address = \"0.0.0.0:9091\"%address = \"0.0.0.0:15091\"%; s%:8545%:15045%; s%:8546%:15046%; s%:6065%:15065%" $HOME/.dymension/config/app.toml
Start service and check the logs
sudo systemctl start dymension.service && sudo journalctl -u dymension.service -f --no-hostname -o cat
Snapshot
Stop Node and Reset Data
sudo systemctl stop dymension
cp $HOME/.dymension/data/priv_validator_state.json $HOME/.dymension/priv_validator_state.json.backup
rm -rf $HOME/.dymension/data && mkdir -p $HOME/.dymension/data
Download Snapshot
curl -L https://snap.vnbnode.com/dymension/dymension_1100-1_snapshot_latest.tar.lz4 | tar -I lz4 -xf - -C $HOME/.dymension/data
mv $HOME/.dymension/priv_validator_state.json.backup $HOME/.dymension/data/priv_validator_state.json
Restart Node
sudo systemctl start dymension.service && sudo journalctl -u dymension -f --no-hostname -o cat
Step 1: Update libraries:
sudo apt update && sudo apt upgrade -y
Step 2: Install Roller (changed to version 1.03):
curl -L https://dymensionxyz.github.io/roller/install.sh | bash
Step 3: Check version of Roller
roller version
Step 4: Initiate Roller
roller config init --interactive
Enter your RollApp ID
Using this format to name your RollApp:
- Name: Lowercase English letters
- EIP155: 1 to 5 digit number representing the EIP155 rollapp ID
- Version: 1 to 5 digit number representing the version Example: vnbnode_8668-1
Specify your RollApp denom: Name your native token as you want: Set the genesis token supply: This is the initial token supply in the RollApp (default: 1,000,000,000). It’s up to you to define the quantity. Select Data Availability layer As default there are 2 DA layers: Celestia and Avail to select.
Select your execution environment: As default is EVM or custom (RDK). \Recommend to use EVM
One you finished, it will return to you 3 address as below:
Copy 3 addresses and go to Discord to claim faucets as below:
Thank to support VNBnode.
Visit us at:
VNBnodegroup VNBnode News VNBnode.comKey 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 A FILE
dymd keys export wallet
- IMPORT KEY FROM A 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 1000000adym \
--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) 1000000adym --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 <TO_VALOPER_ADDRESS> 1000000adym --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) <TO_VALOPER_ADDRESS> 1000000adym --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) 1000000adym --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 <TO_WALLET_ADDRESS> 1000000adym --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=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/.dymension/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/.dymension/config/app.toml
- UPDATE INDEXER Disable indexer
sed -i -e 's|^indexer *=.*|indexer = "null"|' $HOME/.dymension/config/config.toml
Enable indexer
sed -i -e 's|^indexer *=.*|indexer = "kv"|' $HOME/.dymension/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/.dymension/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/.dymension/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:14657/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/.dymension/config/app.toml
- ENABLE PROMETHEUS
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.dymension/config/config.toml
- RESET CHAIN DATA
dymd tendermint unsafe-reset-all --keep-addr-book --home $HOME/.dymension --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 dymension.service
sudo systemctl disable dymension.service
sudo rm /etc/systemd/system/dymension.service
sudo systemctl daemon-reload
rm -f $(which dymd)
rm -rf $HOME/.dymension
rm -rf $HOME/dymension
Service Management
- RELOAD SERVICE CONFIGURATION
sudo systemctl daemon-reload
- ENABLE SERVICE
sudo systemctl enable dymension.service
- DISABLE SERVICE
sudo systemctl disable dymension.service
- START SERVICE
sudo systemctl start dymension.service
- STOP SERVICE
sudo systemctl stop dymension.service
- RESTART SERVICE
sudo systemctl restart dymension.service
- CHECK SERVICE STATUS
sudo systemctl status dymension.service
CHECK SERVICE LOGS
sudo journalctl -u dymension.service -f --no-hostname -o cat
Snapshot
Stop Node and Reset Data
sudo systemctl stop dymension
cp $HOME/.dymension/data/priv_validator_state.json $HOME/.dymension/priv_validator_state.json.backup
rm -rf $HOME/.dymension/data && mkdir -p $HOME/.dymension/data
Download Snapshot
curl -L https://snap.vnbnode.com/dymension/dymension_1100-1_snapshot_latest.tar.lz4 | tar -I lz4 -xf - -C $HOME/.dymension/data
mv $HOME/.dymension/priv_validator_state.json.backup $HOME/.dymension/data/priv_validator_state.json
Restart Node
sudo systemctl start dymension.service && sudo journalctl -u dymension -f --no-hostname -o cat