Skip to main content

Join a network

You can either setup your own local private network or join a public network. If you want to join a public network (e.g. Testnet), you can skip to join a public network.

Set up a local private network​

1. Create a single node​

The simplest JMES 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 your genesis file that will bootstrap the network. Replace the following variables with your own information:


    _1
    jmesd init --chain-id=<private-network-id> <node-moniker>

  2. Generate a JMES account. Replace the variable with your account name:


    _1
    jmesd keys add <account-name>

2. Add your account to the genesis​

Run the following commands to add your account and set the initial balance:


_3
jmesd add-genesis-account $(jmesd keys show <account-name> -a) 20000000000000ujmes
_3
jmesd gentx <my-account> 100000000ujmes --chain-id=<private-network-id>
_3
jmesd collect-gentxs

3. Start your private JMES network​

Run the following command to start your private network:


_3
jmesd start
_3
# OR
_3
systemctl start jmesd # runs as a system service in the background

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

Join a public network​

1. Select a network​

Specify the network you want to join by choosing the corresponding genesis file and address book:

NetworkTypeGenesisAddress book
jmes-testnet-1TestnetGenesis LinkPeer List Community maintained by JMES
jmes-888TestnetGenesis LinkPeer List Community maintained by JMES

2. Download genesis file and address book​

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

Addressbook lists a selection of peers for your node to dial to in order to discover other nodes in the network. Public address books of peers are made available by the JMES community.

Choose a testnet or mainnet address type and download the appropriate genesis-transaction and addressbook. Links to these are posted in the Select a network section.

  • For default jmesd configurations, the genesis and addressbook files should be placed under ~/.jmes/config/genesis.json and ~/.jmes/config/addrbook.json respectively.

Example:


_5
# Obtain the genesis for jmes-888:
_5
wget https://raw.githubusercontent.com/jmesworld/testnet/main/jmes-testnet-1/genesis.json -O ~/.jmes/config/genesis.json
_5
_5
# Obtain the addressbook for the jmes-888:
_5
wget https://raw.githubusercontent.com/jmesworld/testnet/main/jmes-testnet-1/addrbook.json -O ~/.jmes/config/addrbook.json

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