Syncing from genesis

This document is a how-to-guide on joining the FirmaChain network using ‘Syncing from genesis’.

List of networks provided

Please check the genesis file, the seed and the github link according to the network you are planning to join.










Initialize the firmachain

Initialize the node and designate the moniker name.

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

Rename the moniker

Before activating the chain, you can modify the name of the node from 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 's/minimum-gas-prices = "0stake"/minimum-gas-prices = "0.01ufct"/g' ~/.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 = \",,\"/" ~/.firmachain/config/config.toml
# Testnet
sed -i.bak -e "s/^seeds *=.*/seeds = \",\"/" ~/.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 -O ~/.firmachain/config/genesis.json
# Testnet genesis.json
wget -O ~/.firmachain/config/genesis.json

Syncing node

Finally, you can start the syncing process

firmachaind start

If the genesis sync halts showing the error message below, please upgrade the chain binary.

ERR UPGRADE "v0.3.5" NEEDED at height: 4806000:
panic: UPGRADE "v0.3.5" NEEDED at height: 4806000:

Please click on the link below for the upgrade guide.


You can start firmachain using Cosmovisor or System Daemon.

Last updated