Skip to content

Latest commit

 

History

History
154 lines (100 loc) · 5.42 KB

genesis_validators.md

File metadata and controls

154 lines (100 loc) · 5.42 KB

Dymension Hub Genesis Validators

Welcome Genesis Validators!

The primary point of communication for the genesis process will be the #blumbus-hub channel on the Dymension Discord. Selected validators may participate in the genesis event of the Blumbus 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 January 10 at 14: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.19. You need to ensure your GOPATH configuration is correct.

Install Dymension Hub:

git clone https://github.com/dymensionxyz/dymension.git --branch v3.0.0-rc03
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: v3.0.0-rc03
commit: 532317a73c24a0af40afaa5c18cc0c0624e4325f

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

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 /blumbus/gentx/:
cd testnets/dymension-hub/blumbus
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.

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
a686b83570dcd42f2d8779fa1b4457ebf28b4f2564f127ca43e81510ef8e141c ~/.dymension/config/genesis.json

Validate the Genesis file

dymd validate-genesis

Genesis time is: 2024-01-15 14:00 UTC

dymd start

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