Skip to content

Latest commit

 

History

History
176 lines (114 loc) · 6.09 KB

genesis_validators.md

File metadata and controls

176 lines (114 loc) · 6.09 KB

Dymension Hub Genesis Validators

Welcome Genesis Validators!

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.

The deadline for submitting a Gentx PR is February 8 at 12:00 UTC

The genesis event is broken into two parts:

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

Part 1

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.

Install Dymension Hub:

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.

Save the testnet chain-id:

dymd config chain-id 35-C

Generate genesis transaction (gentx):

  1. 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
  1. Create a key pair:
dymd keys add <KEY_NAME>
  1. 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
  1. 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 only 500000000000udym:
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"

Submitting the Genesis transaction:

  1. Rename the Gentx file to gentx-{your-moniker}.json (please do not have any spaces or special characters in the file name).

  2. Fork the testnets repo into your GitHub account

  3. Clone your repo using:

git clone https://github.com/<your-github-username>/testnets
  1. Copy the generated gentx json file to /35-C/gentx/:
cd testnets/dymension-hub/35-C
cp ~/.dymension/config/gentx/gentx*.json ./gentx/
  1. Commit and push to your repo:
git add .
git commit -m "<your validator moniker> gentx"
git push origin main
  1. 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 aboard!

Part 2

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

Set validator gas fees

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"

Genesis time is: 2023-02-15 14:00 UTC

dymd start

Once 2/3rd of staked tokens are online after genesis time the blockchain has begun!