State sync

‘State Sync’ feature was included in the recent release of the tendermint core v0.34 update. The feature allows users to look up information on the most recent credible block height instead of having to look up all block information from the past. The ‘state sync’ feature reduces the time required to synchronize the network to a matter of minutes.

State syncing a node

FirmaChain is structured to create a status sync snapshot of a portion of its nodes to allow a new node to join the network using the ‘State Sync’ feature. In order to join the network through ‘State Sync’ the following information must be retrieved in advance.

• At least 2 available RPC servers.

• A trusted height.

• The block ID hash of the trusted height.

List of networks provided

Please refer to the genesis file, the seed and the github link according to your choice of network.

Network	chain-id	genesis.json	seeds	github
Mainnet	colosseum-1	Link	Link	Link
Testnet	imperium-4	Link	Link	Link

Initialize the firmachain

Initialize the node and designate the name of the moniker.

firmachaind init <moniker-name> --chain-id <chain-id>

Rename the moniker

Before activating the chain, you can modify the name of the node using the moniker field at ~/.firmachain/config/config.toml.

vim .firmachain/config/config.toml

# A custom human readable name for this node
moniker = "<moniker-name>"

Setup minimum gas prices

Modify minimum gas fee.

sed -i -E 's/minimum-gas-prices = ".*"/minimum-gas-prices = "0.01ufct"/' ~/.firmachain/config/app.toml

Set seeds

FirmaChain discloses information on seed nodes for the purpose of P2P connection.

# Mainnet
sed -i.bak -e "s/^seeds *=.*/seeds = \"[e-mail]:26656,[e-mail]:26656,[e-mail]:26656\"/" ~/.firmachain/config/config.toml

# Testnet
sed -i.bak -e "s/^seeds *=.*/seeds = \"[e-mail]:26656,[e-mail]:26656\"/" ~/.firmachain/config/config.toml

Download genesis.json file

After downloading the genesis.json file of the network you are planning to join, please swap the file with ~/.firmachain/config/genesis.json.

# Mainnet genesis.json
wget https://raw.githubusercontent.com/FirmaChain/mainnet/main/colosseum-1/genesis.json -O ~/.firmachain/config/genesis.json

# Testnet genesis.json
wget https://raw.githubusercontent.com/FirmaChain/testnet/master/imperium-4/genesis.json -O ~/.firmachain/config/genesis.json

Set trust datas

If you do not have a jq package, please install the jq package.

sudo apt install jq -y

By running the command below, you will be able to retrieve data on the ‘trust height’ and ‘trust_hash’ via RPC.

# Mainnet
SNAP_RPC="https://lcd-mainnet.firmachain.dev:26657"
BLOCK_HEIGHT=$(curl -s $SNAP_RPC/block | jq -r .result.block.header.height | awk '{print $1 - ($1 % 10000-1)}') &&
TRUST_HASH=$(curl -s "$SNAP_RPC/block?height=$BLOCK_HEIGHT" | jq -r .result.block_id.hash)

echo $BLOCK_HEIGHT $TRUST_HASH

# Expected return data
18520001 7623BBA5B341DA3C9FC716103A56AAD3ABA2D4FC4BC57F786B3474F5F631DEE8

# Testnet
SNAP_RPC="https://lcd-testnet.firmachain.dev:26657"
BLOCK_HEIGHT=$(curl -s $SNAP_RPC/block | jq -r .result.block.header.height | awk '{print $1 - ($1 % 10000-1)}') &&
TRUST_HASH=$(curl -s "$SNAP_RPC/block?height=$BLOCK_HEIGHT" | jq -r .result.block_id.hash)

echo $BLOCK_HEIGHT $TRUST_HASH

# Expected return data
3500001 C4D994F9BDEF1A49EBEAF3552B9BD5BCF2E887CDA318816E6A70C69E0EEADD99

A method other than JQ

Use this method if you don't want to use a Docker image or install JQ.

SNAP_RPC= # Mainnet or Testnet PRC address
BLOCK_HEIGHT=$(curl -s $SNAP_RPC/block | grep -o '"height":"[0-9]\+"' | head -n1 | grep -o '[0-9]\+' | awk '{print $1 - ($1 % 10000 - 1)}')
TRUST_HASH=$(curl -s "$SNAP_RPC/block?height=$BLOCK_HEIGHT" \
  | grep -o '"hash":"[A-F0-9]\+"' \
  | head -n1 \
  | sed 's/"hash":"//;s/"//')

echo $BLOCK_HEIGHT $TRUST_HASH

Please set the chain to allow ‘State Sync’ feature and put in the retrieved data in the config.toml file.

# Mainnet
sed -i -e 's/enable = false/enable = true/g' ~/.firmachain/config/config.toml
sed -i -e 's/rpc_servers = ""/rpc_servers = "mainnet-seed1.firmachain.dev:26657,mainnet-seed2.firmachain.dev:26657,mainnet-seed3.firmachain.dev:26657"/g' ~/.firmachain/config/config.toml
sed -i -e 's/trust_height = 0/trust_height = 18520001/g' ~/.firmachain/config/config.toml
sed -i -e 's/trust_hash = ""/trust_hash = "7623BBA5B341DA3C9FC716103A56AAD3ABA2D4FC4BC57F786B3474F5F631DEE8"/g' ~/.firmachain/config/config.toml
sed -i -e 's/trust_period = "168h0m0s"/trust_period = "336h0m0s"/g' ~/.firmachain/config/config.toml

# Testnet
sed -i -e 's/enable = false/enable = true/g' ~/.firmachain/config/config.toml
sed -i -e 's/rpc_servers = ""/rpc_servers = "testnet-seed1.firmachain.dev:26657,testnet-seed2.firmachain.dev:26657"/g' ~/.firmachain/config/config.toml
sed -i -e 's/trust_height = 0/trust_height = 1337168/g' ~/.firmachain/config/config.toml
sed -i -e 's/trust_hash = ""/trust_hash = "C826D099BD2F4E941597140115F4871067B293563A9019A9E788FF434EF3771B"/g' ~/.firmachain/config/config.toml
sed -i -e 's/trust_period = "168h0m0s"/trust_period = "336h0m0s"/g' ~/.firmachain/config/config.toml

Now we are all set. Please start the chain. Once you start the chain, it will automatically search and restore the status sync snapshot from the network. (This process takes approximately 2 to 5 minutes.)

firmachaind start

Discovering snapshots for 15s
Discovered new snapshot        height=3000 format=1 hash=0F14A473
Discovered new snapshot        height=2000 format=1 hash=C6209AF7

Option

You can start firmachain using Cosmovisor or System Daemon.

• How to set Cosmovisor

• How to set System Demon