Dymension Hub
Overview
Welcome to the Dymension Hub, the Settlement Layer of the Dymension protocol.
This guide will walk you through the steps required to set up and run a Dymension Hub full node.
Table of Contents
Prerequisites
Installation
Clone dymension
:
git clone https://github.com/dymensionxyz/dymension.git
cd dymension
make install
Check that the dymd binaries have been successfully installed:
dymd version
If the dymd command is not found an error message is returned, confirm that your GOPATH is correctly configured by running the following command:
export PATH=$PATH:$(go env GOPATH)/bin
Initializing dymd
-
Using the setup script:
This method is preffered as it preconfigured to support running rollapps locally
bash scripts/setup_local.sh
-
Manually:
First, set the following environment variables:
export CHAIN_ID="dymension_100-1" export KEY_NAME="local-user" export MONIKER_NAME="local"
Then, initialize a chain with a user:
dymd init "$MONIKER_NAME" --chain-id "$CHAIN_ID" dymd keys add "$KEY_NAME" --keyring-backend test dymd add-genesis-account "$(dymd keys show "$KEY_NAME" -a --keyring-backend test)" 100000000000udym dymd gentx "$KEY_NAME" 1000000dym --chain-id "$CHAIN_ID" --keyring-backend test dymd collect-gentxs
Running the Chain
Now start the chain!
dymd start
You should have a running local node!
Adding liquidity
To bootstrap the GAMM
module with pools:
sh scripts/pools/pools_bootstrap.sh
Adding incentives
Setting incentivised pools and weights
After creating the pools above, set the incentives weights through gov:
sh scripts/incentives/incentive_pools_bootstrap.sh
wait for the gov proposal to pass, and valitate with:
dymd q poolincentives distr-info
Locking tokens
To get incentives, we need to lock the LP tokens:
sh scripts/incentives/lockup_bootstrap.sh
Valitate with:
dymd q lockup module-balance
Fund the incentives
Now we fund the pool incentives. The funds will be distributed between the incentivised pools according to weights. The following script funds the pool incentives both by external funds (direct funds transfer from some user) and using the community pool (using gov proposal)
sh scripts/incentives/fund_incentives.sh
validate with:
dymd q incentives gauges
If you have any issues please contact us on discord in the Developer section. We are here for you!