Skip to main content

Join a network

It is highly recommended that you set up a private local network before joining a public network. This will help you get familiar with the setup process, and provide an environment for testing. The following sections outline this process.

Set up a local node

Validators can set up a private Dymension Hub network to become familiar with running a full Dymension Hub node before joining a public network.

The simplest Dymension Hub network you can set up is a local testnet with just a single node. In a single-node environment, you have one account and are the only validator signing blocks for your private network.

  1. Initialize a genesis file:
dymd init <Moniker> --chain-id=<YOUR-CHAIN-ID>
  1. Generate a Dymension account. Replace the variable with your account name:
dymd keys add <KEY_NAME_HERE>
  1. Run the following commands to add your account and set the initial balance:
dymd add-genesis-account <ADDRESS_HERE> 600000000000udym
  1. Declare your validator and self-delegation via a special transaction included in the genesis file called a gentx:
dymd gentx <KEY_NAME> 500000000000udym --chain-id=<YOUR-CHAIN-ID>
  1. Add the gentx to the genesis file:
dymd collect-gentxs
  1. Run the following command to start your private network:
dymd start

If the private Dymension Hub network is set up correctly, your Dymd node will be running on tcp://localhost:26656, listening for incoming transactions, and signing blocks.

Join a public network

Download the genesis file

Genesis file specifies the account balances and parameters at the start of the network to use when replaying transactions and syncing.

For default dymd configurations, the genesis should be placed under ~/.dymension/config/genesis.json.

Continue to the Sync page to find out more about syncing your node.