The primary point of communication for the genesis process will be the #genesis-validators-35-c channel on the Dymension Discord. It is absolutely critical that you and your team join the Discord during launch, as it will be the coordination point in case of any hiccups or issues during the launch process. The channel is private by default in order to keep it free of spam and unnecessary noise.
After Gentxs are collected we will provide a pre-genesis.json file for review. As long as there are no recommended changes we will provide the Genesis file with the genesis time in Part 2 after the collection of Gentxs.
Recommended minimum hardware requirements:
- 4 or more physical CPU cores
- At least 500GB of SSD disk storage
- At least 16GB of memory
- At least 100mbps network bandwidth
These instructions are for creating a basic setup of a single node. Validators should modify these instructions for their own custom setups as needed (i.e. sentry nodes, tmkms, etc).
Prerequisites: Make sure to have Golang >=1.18. You need to ensure your GOPATH configuration is correct.
git clone https://github.com/dymensionxyz/dymension.git --branch v0.2.0-beta
cd dymension
make install
This will install dymd
binary into $GOBIN
. Check that you have the right Dymension version installed:
dymd version --long
Returns:
name: dymension
server_name: dymd
version: v0.2.0-beta
commit: 987e33407911c0578251f3ace95d2382be7e661d
We recommend saving the testnet chain-id into your Dymension client.toml. This will make it so you do not have to manually pass in the chain-id flag for every CLI command.
dymd config chain-id 35-C
- Initialize the Dymension directories and create a local genesis file with the correct chain-id. You will be asked to replace the temporary Genesis file with the finalized Genesis file once all participating validators submit their Gentx.
dymd init <NODE_NAME> --chain-id=35-C
- Create a key pair:
dymd keys add <KEY_NAME>
- Add your account to the genesis file with the given amount and the key you just created. Use only
600000000000udym
, other amounts will be ignored.
dymd add-genesis-account <ADDRESS> 600000000000udym
- Create the Gentx. The
dymd gentx -h
command will provide helpful flags to configure your validator node. The only required flags are chain-id and amount of self-delegated udym, everything else is recommended but optional. Use only500000000000udym
:
dymd gentx <KEY_NAME> --chain-id 35-C 500000000000udym
If all goes well, you will see a message similar to the following:
Genesis transaction written to "/home/user/.dymension/config/gentx/gentx-******.json"
-
Rename the Gentx file to gentx-{your-moniker}.json (please do not have any spaces or special characters in the file name).
-
Fork the testnets repo into your GitHub account
-
Clone your repo using:
git clone https://github.com/<your-github-username>/testnets
- Copy the generated gentx json file to
/35-C/gentx/
:
cd testnets/dymension-hub/35-C
cp ~/.dymension/config/gentx/gentx*.json ./gentx/
- Commit and push to your repo:
git add .
git commit -m "<your validator moniker> gentx"
git push origin main
- Create a PR to https://github.com/dymensionXYZ/testnets
For a demonstration of a step-by-step guide to creating a PR please follow the GitHub documentation or watch this helpful youtube video.
Please DM Ganeshti#1471 on Dymension's discord with a link of the GitHub PR. Only PRs from selected validators will be accepted. Validators must submit their PRs prior to the deadline submission date.
The Dymension core team will provide Part 2 instructions for replacing the genesis.json after collecting Gentxs. Please follow on-going communication on Discord and reach out to the Dymension core team whenever you have any questions.
Welcome to Part 2 of the Genesis Event of the Dymension Hub's testnet. We recommend reviewing What is a Genesis File?
here. Below you will find the source of the genesis file which includes validator gentx provided in Part 1. Follow these instructions to download the genesis file, validate, and prepare for launching the testnet!
Genesis File
cp genesis.json ~/.dymension/config/genesis.json
Genesis sha256
sha256sum ~/.dymension/config/genesis.json
cf20e3b15d089ceeaaa9bb2abcd48a50f98e9f2274f4320aeae534d6972c4ee2 ~/.dymension/config/genesis.json
Validate the Genesis file
dymd validate-genesis
Add seed nodes in config.toml. These nodes can be found in the seeds.txt file.
vi $HOME/.dymension/config/config.toml
You can set the minimum gas prices for transactions to be accepted into your node's mempool. This sets a lower bound on gas prices, preventing spam. Dymension can accept gas in any currency. To accept both DYM and ATOM for example, set minimum-gas-prices
in app.toml
.
vi $HOME/.dymension/config/app.toml
minimum-gas-prices = "0.025udym,0.025uatom"
dymd start
Once 2/3rd of staked tokens are online after genesis time the blockchain has begun!