Join Mainnet

This document outlines the steps to join an existing mainnet

Pre-requisite Readings

• Validator Security

Mainnet

You need to set the genesis file and seeds. If you need more information about past networks, check our mainnet repo (opens new window). The table below gives an overview of all Mainnet Chain IDs. Note that, the displayed version might differ when an active Software Upgrade proposal exists on chain.

Chain ID	Description	Site	Version	Status
planq_7070-2	Planq Mainnet 2	Planq (opens new window)	v1.0.3 (opens new window)	Live
planq_7070-1	Planq Mainnet 1	-	v0.10.0 (opens new window)	Stale

IMPORTANT: If you join mainnet as a validator make sure you follow all the security recommendations!

Install planqd

Follow the installation document to install the Planq binary planqd.

Make sure you have the right version of planqd installed.

Save Chain ID

We recommend saving the mainnet chain-id into your planqd's client.toml. This will make it so you do not have to manually pass in the chain-id flag for every CLI command.

See the Official Chain IDs for reference.

Copy planqd config chain-id planq_7070-2

Initialize Node

We need to initialize the node to create all the necessary validator and node configuration files:

Copy planqd init <your_custom_moniker> --chain-id planq_7070-2

Monikers can contain only ASCII characters. Using Unicode characters will render your node unreachable.

By default, the init command creates your ~/.planqd (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

Download the genesis.json file from the archive (opens new window) and copy it over to the config directory: ~/.planqd/config/genesis.json. This is a genesis file with the chain-id and genesis accounts balances.

Copy wget https://raw.githubusercontent.com/planq-network/networks/main/mainnet/genesis.json mv genesis.json ~/.planqd/config/

Then verify the correctness of the genesis configuration file:

Copy planqd validate-genesis

Add Seed Nodes

Your node needs to know how to find peers (opens new window). You'll need to add healthy seed nodes (opens new window) to $HOME/.planqd/config/config.toml. The networks (opens new window) repo contains links to some seed nodes.

Edit the file located in ~/.planqd/config/config.toml and the seeds to the following:

Copy ####################################################### ### P2P Configuration Options ### ####################################################### [p2p] # ... # Comma separated list of seed nodes to connect to seeds = "<node-id>@<ip>:<p2p port>"

You can use the following code to get seeds from the repo and add it to your config:

Copy SEEDS=`curl -sL https://raw.githubusercontent.com/planq-network/networks/main/mainnet/seeds.txt | awk '{print $1}' | paste -s -d, -` sed -i.bak -e "s/^seeds =.*/seeds = \"$SEEDS\"/" ~/.planqd/config/config.toml

For more information on seeds and peers, you can the Tendermint P2P documentation (opens new window).

Add Persistent Peers

We can set the persistent_peers (opens new window) field in ~/.planqd/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 networks (opens new window) repo.

A list of available persistent peers is also available in the #find-peers channel in the Planq Discord (opens new window). You can get a random 10 entries from the peers.txt file in the PEERS variable by running the following command:

Copy PEERS=`curl -sL https://raw.githubusercontent.com/planq-network/networks/main/mainnet/peers.txt | sort -R | head -n 10 | awk '{print $1}' | paste -s -d, -`

Use sed to include them into the configuration. You can also add them manually:

Copy sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$PEERS\"/" ~/.planqd/config/config.toml

Run a Mainnet Validator

For more details on how to run your validator, follow the validator these instructions.

Copy planqd tx staking create-validator \ --amount=1000000000000aplanq \ --pubkey=$(planqd tendermint show-validator) \ --moniker="PlanqWhale" \ --chain-id=<chain_id> \ --commission-rate="0.05" \ --commission-max-rate="0.20" \ --commission-max-change-rate="0.01" \ --min-self-delegation="1000000" \ --gas="1000000" \ --gas-prices="30000000000aplanq" \ --gas-adjustment="1.15" \ --from=<key_name>

🚨 DANGER: Never create your validator keys using a test keying backend. Doing so might result in a loss of funds by making your funds remotely accessible via the eth_sendTransaction JSON-RPC endpoint.

Ref: Security Advisory: Insecurely configured geth can make funds remotely accessible (opens new window)

Start mainnet

The final step is to start the nodes. Once enough voting power (+2/3) from the genesis validators is up-and-running, the node will start producing blocks.

Copy planqd start

Share your Peer

You can share your peer to posting it in the #find-peers channel in the Planq Discord (opens new window).

To get your Node ID use

Copy planqd tendermint show-node-id

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 (opens new window) page