Testnet
This document outlines the steps to join an existing testnet.
Pick a Testnet
You specify the network you want to join by setting the genesis file and seeds. If you need more information about past networks, check our testnets repo.
Description | Site | Version | Status |
---|---|---|---|
Egaxd_9000-4 Testnet | Egaxd 9000-4 | v16.0.0-rc5 |
|
Egaxds_9000-3 Testnet | Egaxd 9000-3 |
|
|
Olympus Mons Incentivized Testnet | Olympus Mons |
|
|
Arsia Mons Testnet | Arsia Mons |
|
|
Server Timezone Configuration
Make sure your server timezone configuration is UTC. To know what is your current timezone, run the timedatectl
command.
DANGER
🚨 DANGER: Having a different timezone configuration may cause a LastResultsHash
mismatch error. This will take down your node!
Install egaxd
egaxd
Follow the installation document to install the Evmos binary egaxd.
DANGER
Make sure you have the right version of egaxd installed.
Save Chain ID
We recommend saving the testnet chain-id
into your evmosd's client.toml
. This will make it so you do not have to manually pass in the chain-id
flag for every CLI command.
TIP
See the Official Chain IDs for reference.
Initialize Node
We need to initialize the node to create all the necessary validator and node configuration files:
DANGER
Monikers can contain only ASCII characters. Using Unicode characters will render your node unreachable.
By default, the init
command creates your ~/.egaxd
(i.e $HOME
) directory with subfolders config/
and data/
. In the config
directory, the most important files for configuration are app.toml
and config.toml
.
Genesis & Seeds
Copy the Genesis File
Check the genesis.json
file from the archive
and copy it over to the config
directory: ~/.egaxd/config/genesis.json
. This is a genesis file with the chain-id and genesis accounts balances.
Then verify the correctness of the genesis configuration file:
Add Seed Nodes
Your node needs to know how to find peers. You'll need to add healthy seed nodes to $HOME/.egaxd/config/config.toml
. The testnets
repo contains links to some seed nodes.
Edit the file located in ~/.egaxd/config/config.toml
and the seeds
to the following:
You can use the following code to get seeds from the repo and add it to your config:
TIP
For more information on seeds and peers, you can the Tendermint P2P documentation.
Add Persistent Peers
We can set the persistent_peers
field in ~/.egaxd/config/config.toml
to specify peers that your node will maintain persistent connections with. You can retrieve them from the list of available peers on the testnets
repo.
A list of available persistent peers is also available in the #find-peers
channel in the Egaxd Discord. You can get a random 10 entries from the peers.txt
file in the PEERS
variable by running the following command:
Use sed
to include them into the configuration. You can also add them manually:
Run a Testnet Validator
Claim your testnet tEvmos on the faucet using your validator account address and submit your validator account address:
TIP
For more details on how to run your validator, follow these instructions.
Start testnet
The final step is to start the nodes. Once enough voting power (+2/3) from the genesis validators is up-and-running, the testnet will start producing blocks.
Upgrading Your Node
TIP
These instructions are for full nodes that have ran on previous versions of and would like to upgrade to the latest testnet version.
Reset Data
DANGER
If the version <new_version> you are upgrading to is not breaking from the previous one, you should not reset the data. If this is the case you can skip to Restart
First, remove the outdated files and reset the data.
Your node is now in a pristine state while keeping the original priv_validator.json
and config.toml
. If you had any sentry nodes or full nodes setup before, your node will still try to connect to them, but may fail if they haven't also been upgraded.
WARNING
Make sure that every node has a unique priv_validator.json
. Do not copy the priv_validator.json
from an old node to multiple new nodes. Running two nodes with the same priv_validator.json
will cause you to double sign.
Restart
To restart your node, just type:
Share your Peer
You can share your peer to posting it in the #find-peers
channel in the Egaxd Discord.
TIP
To get your Node ID use
State Syncing a Node
If you want to join the network using State Sync (quick, but not applicable for archive nodes), check our State Sync page
Last updated