Join the Network

This tutorial introduces deploying a new node on AWS and join the Panacea Mainnet.

Launch an AWS EC2 Instance

Choose an AMI

Choose Ubuntu Server 20.04 LTS 64-bit (x86) with SSD Volume Type.

Choose the instance type

Choose the m5.large instance type (minimum spec).

Configure instance details

Add a storage

Configure a Security Group

The P2P 26656 port must be exposed to other Panacea nodes. If your node will be in the VPC guarded by Sentry nodes, expose 26656 to only Sentry nodes (recommended). If not, expose it to anywhere. For details about Sentry nodes, please see the Tendermint guide.

The RPC 26657 and HTTP 1317 ports are for sending transactions/queries to your node. So, expose them to the network where you perform operational actions.

Connect to your EC2 instance and install prerequisites.

ssh ubuntu@<your-ec2-ip> -i <your-key>.pem

Install prerequisites by following the Installation guide.

Setup a New Node

These instructions are for setting up a brand new full node from scratch.

First, initialize the node and create the necessary config files:

panacead init <your_custom_moniker>

The moniker can contains only ASCII characters. Using Unicode characters will render your node unreachable.

Then, modify the timeout_commit in the ~/.panacead/config/config.toml as below.

[consensus]

timeout_commit = "5s"

After that, edit the ~/.panacead/config/app.toml file in order to enable the anti-spam mechanism and reject incoming transactions with less than the minimum-gas-prices:

# Validators reject any tx from the mempool with less than the minimum-gas-prices.
minimum-gas-prices = "5umed"

# NOTE: For the Testnet, please set minimum-gas-prices as "", so that no fee is required.

Now, your full node has been initialized!

Copy the Genesis file

Fetch the genesis.json file of the latest chain from the following links, and place it to ~/.panacead/config/genesis.json.

Mainnet: https://github.com/medibloc/panacea-mainnet
Testnet: https://github.com/medibloc/panacea-testnet

Configure Seed Nodes

Your node needs to know how to find peers.

Seed nodes can be found in:

Mainnet: https://github.com/medibloc/panacea-mainnet#seed-nodes
Testnet: https://github.com/medibloc/panacea-testnet#seed-nodes

Insert those <node_id>@<ip>s with 26656 port to the persistent_peers field in ~/.panacead/config/config.toml.

# Comma separated list of nodes to keep persistent connections to
persistent_peers = "c238f279c970764d6893ae44bdf5c949dc22b009@13.114.44.199:26656,395aead00e99f828e4af92531dcd8c8da1255a8f@3.36.50.133:26656,00c57e36559b49ce7d29fa4920b5132584994368@52.77.227.241:26656"

For more information on seeds and peers, see the Using Tendermint: Peers.

State Sync

Your node can rapidly sync with the network using state sync without replaying historical blocks. For more details, please refer to this.

To set state sync enabled, RPC servers and trusted block info (height and hash) are required.

trusted block info can be obtained via RPC.

curl -s https://rpc.gopanacea.org/block | jq -r '.result.block.header.height + "\n" + .result.block_id.hash'
# 7700000 (height)
# 0D3E53F02ABCDDA8AAC1520342D37A290DDABE4C28190EE6E2C6B0C819F74D4A (hash)

Then, you need to edit several things in ~/.panacea/config/config.toml file.

[statesync]

enable = true

rpc_servers = "15.165.191.68:26657,13.209.53.86:26657" # rpc addresses
trust_height = <trusted-block-height>
trust_hash = "<trusted-block-hash>"
trust_period = "336h0m0s" # 2/3 of 21 days (unbonding period)