Node Installation

Firma Mainnet guide

Minimum hardware requirements:

Node Type

CPU

RAM

Storage

Mainnet

16GB

250GB

1) Auto_install script

source <(curl -s https://raw.githubusercontent.com/111STAVR111/props/refs/heads/main/Firmachain/firmam)

2) Manual installation

Preparing the server

sudo apt update && sudo apt upgrade -y
sudo apt install curl tar wget clang pkg-config libssl-dev jq build-essential bsdmainutils git make ncdu gcc git jq chrony liblz4-tool -y

GO 1.19

ver="1.19" && \
wget "https://golang.org/dl/go$ver.linux-amd64.tar.gz" && \
sudo rm -rf /usr/local/go && \
sudo tar -C /usr/local -xzf "go$ver.linux-amd64.tar.gz" && \
rm "go$ver.linux-amd64.tar.gz" && \
echo "export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin" >> $HOME/.bash_profile && \
source $HOME/.bash_profile && \
go version

Build 19.12.24

cd $HOME && mkdir -p go/bin/
git clone https://github.com/FirmaChain/firmachain.git
cd firmachain
git checkout v0.4.0
make install

firmachaind version --long | grep -e commit -e version

version: 0.4.0
commit: e2ab40a4074a05838f94babab566fe231f4c39b3

Initiation

firmachaind init STAVR_guide --chain-id=colosseum-1
firmachaind config chain-id colosseum-1

Create/recover wallet

firmachaind ahuad keys add <walletname>
           OR
firmachaind keys add <walletname> --recover

Download Genesis

wget -O $HOME/.firmachain/config/genesis.json "https://server-1.stavr.tech/Mainnet/Firmachain/genesis.json"

sha256sum $HOME/.firmachain/config/genesis.json

d03edc3362a677f4a0c2f605c7f848f9516fd4f55432fda63625398c52419954

Set up the minimum gas price and Peers/Seeds/Filter peers/MaxPeers

sed -i.bak -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0.1ufct\"/;" ~/.firmachain/config/app.toml
external_address=$(wget -qO- eth0.me) 
sed -i.bak -e "s/^external_address *=.*/external_address = \"$external_address:26656\"/" $HOME/.firmachain/config/config.toml
peers=""
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.firmachain/config/config.toml
seeds=""
sed -i.bak -e "s/^seeds =.*/seeds = \"$seeds\"/" $HOME/.firmachain/config/config.toml
sed -i 's/max_num_inbound_peers =.*/max_num_inbound_peers = 50/g' $HOME/.firmachain/config/config.toml
sed -i 's/max_num_outbound_peers =.*/max_num_outbound_peers = 50/g' $HOME/.firmachain/config/config.toml

Pruning (optional)

pruning="custom"
pruning_keep_recent="1000"
pruning_keep_every="0"
pruning_interval="10"
sed -i -e "s/^pruning *=.*/pruning = \"$pruning\"/" $HOME/.firmachain/config/app.toml
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"$pruning_keep_recent\"/" $HOME/.firmachain/config/app.toml
sed -i -e "s/^pruning-keep-every *=.*/pruning-keep-every = \"$pruning_keep_every\"/" $HOME/.firmachain/config/app.toml
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"$pruning_interval\"/" $HOME/.firmachain/config/app.toml

Indexer (optional)

indexer="null" &&
sed -i -e "s/^indexer *=.*/indexer = \"$indexer\"/" $HOME/.firmachain/config/config.toml

Download addrbook

wget -O $HOME/.firmachain/config/addrbook.json "https://server-1.stavr.tech/Mainnet/Firmachain/addrbook.json"

Create a service file

sudo tee /etc/systemd/system/firmachaind.service > /dev/null <<EOF
[Unit]
Description=firmachaind
After=network-online.target

[Service]
User=$USER
ExecStart=$(which firmachaind) start
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

StateSync Firma Mainnet

systemctl stop firmachaind
SNAP_RPC=https://firma.rpc.m.stavr.tech:443
LATEST_HEIGHT=$(curl -s $SNAP_RPC/block | jq -r .result.block.header.height); \
BLOCK_HEIGHT=$((LATEST_HEIGHT - 1000)); \
TRUST_HASH=$(curl -s "$SNAP_RPC/block?height=$BLOCK_HEIGHT" | jq -r .result.block_id.hash)

echo $LATEST_HEIGHT $BLOCK_HEIGHT $TRUST_HASH

sed -i.bak -E "s|^(enable[[:space:]]+=[[:space:]]+).*$|\1true| ; \
s|^(rpc_servers[[:space:]]+=[[:space:]]+).*$|\1\"$SNAP_RPC,$SNAP_RPC\"| ; \
s|^(trust_height[[:space:]]+=[[:space:]]+).*$|\1$BLOCK_HEIGHT| ; \
s|^(trust_hash[[:space:]]+=[[:space:]]+).*$|\1\"$TRUST_HASH\"| ; \
s|^(seeds[[:space:]]+=[[:space:]]+).*$|\1\"\"|" $HOME/.firmachain/config/config.toml
firmachaind tendermint unsafe-reset-all --home /root/.firmachain
wget -O $HOME/.firmachain/config/addrbook.json "https://server-1.stavr.tech/Mainnet/Firmachain/addrbook.json"
curl -o - -L http://firma.wasm.stavr.tech:12/wasm-firma.tar.lz4 | lz4 -c -d - | tar -x -C $HOME/.firmachain
sudo systemctl restart firmachaind && journalctl -fu firmachaind -o cat

SnapShot Mainnet updated every 5 hours

You can check the size and time of snapshot creation with this command curl -sI https://server-1.stavr.tech/Mainnet/Firmachain/firma-snap-1.tar.lz4 | grep "last" && curl -sI https://server-1.stavr.tech/Mainnet/Firmachain/firma-snap-1.tar.lz4 | grep content-length | awk '{printf "%.2f GB\n", $2/1024/1024/1024}'

cd $HOME
apt install lz4
sudo systemctl stop firmachaind
cp $HOME/.firmachain/data/priv_validator_state.json $HOME/.firmachain/priv_validator_state.json.backup
rm -rf $HOME/.firmachain/data
LATEST_SNAPSHOT=$(curl -s https://server-1.stavr.tech/Mainnet/Firmachain/ | grep -oE 'firma-snap-[0-9]+\.tar\.lz4' | while read SNAPSHOT; do HEIGHT=$(curl -s "https://server-1.stavr.tech/Mainnet/Firmachain/${SNAPSHOT%.tar.lz4}-info.txt" | awk '/Block height:/ {print $3}'); echo "$SNAPSHOT $HEIGHT"; done | sort -k2 -nr | head -n 1 | awk '{print $1}')
curl -o - -L https://server-1.stavr.tech/Mainnet/Firmachain/$LATEST_SNAPSHOT | lz4 -c -d - | tar -x -C $HOME/.firmachain
mv $HOME/.firmachain/priv_validator_state.json.backup $HOME/.firmachain/data/priv_validator_state.json
wget -O $HOME/.firmachain/config/addrbook.json "https://server-1.stavr.tech/Mainnet/Firmachain/addrbook.json"
sudo systemctl restart firmachaind && journalctl -fu firmachaind -o cat

Start

sudo systemctl daemon-reload
sudo systemctl enable firmachaind 
sudo systemctl restart firmachaind && sudo journalctl -fu firmachaind -o cat

Create validator

firmachaind tx staking create-validator \
--commission-rate 0.1 \
--commission-max-rate 0.2 \
--commission-max-change-rate 0.1 \
--min-self-delegation "1" \
--amount=1000000ufct \
--pubkey $(firmachaind tendermint show-validator) \
--from <wallet> \
--moniker="STAVR_guide" \
--chain-id colosseum-1 \
--fees="20000ufct" \
--identity="" \
--website="" \
--details="" -y

Monitoring

Security

You can create secure management of your wallet and your node by following this links.

Delete node

sudo systemctl stop firmachaind
sudo systemctl disable firmachaind
rm /etc/systemd/system/firmachaind.service
sudo systemctl daemon-reload
cd $HOME
rm -rf firmachain
rm -rf .firmachain
rm -rf $(which firmachaind)

PreviousFirmachain NextStateSync/Snapshot

Last updated 4 months ago

Was this helpful?