Skip to content

Latest commit

 

History

History
164 lines (106 loc) · 5.83 KB

genesis_validators.md

File metadata and controls

164 lines (106 loc) · 5.83 KB
Raw

Dymension Hub Genesis Validators

Welcome Genesis Validators!

The primary point of communication for the genesis process will be the #genesis-froopyland channel on the Dymension Discord. Selected validators may participate in the genesis event of the Froopyland network. 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 August 18 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 200GB of SSD disk storage
  • At least 8GB 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 v1.0.2-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: v1.0.2-beta
commit: 74457e007dc802bd9c0be979baa5d83ab4d3226e

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 froopyland_100-1

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=froopyland_100-1
  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 100000000000000000000000udym, other amounts will be ignored.
dymd add-genesis-account <ADDRESS> 100000000000000000000000udym
  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. Use only 100000000000000000000000udym:
dymd gentx <KEY_NAME> --chain-id=froopyland_100-1 100000000000000000000000udym

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 /froopyland/gentx/:
cd testnets/dymension-hub/froopyland
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
2c39abf9fd87222fc3b8178763e1c0e250029a445a3775b3507e88140910049e ~/.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

Genesis time is: 2023-08-22 14:00 UTC

dymd start

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