πŸ”Œ Installation

πŸ’» Hardware Requirements

ComponentsMinimum Requirements
CPU4
RAM8+ GB
STORAGE+200 GB SSD

1️⃣ Installation

sudo apt -q update
sudo apt -qy install curl git jq lz4 build-essential
sudo apt -qy upgrade
sudo apt-get update && apt-get install -y libssl-dev

➑️ Go Installation

cd $HOME
VER="1.23.0"
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"
[ ! -f ~/.bash_profile ] && touch ~/.bash_profile
echo "export PATH=$PATH:/usr/local/go/bin:~/go/bin" >> ~/.bash_profile
source $HOME/.bash_profile
[ ! -d ~/go/bin ] && mkdir -p ~/go/bin

2️⃣ Install node

echo "export FIAMMA_PORT="37"" >> $HOME/.bash_profile
source $HOME/.bash_profile
cd $HOME
rm -rf fiamma
git clone https://github.com/fiamma-chain/fiamma
cd fiamma
git checkout v1.0.0
make build
mkdir -p ~/.fiamma/cosmovisor/upgrades/1.0.0/bin
mv $HOME/fiamma/build/fiammad ~/.fiamma/cosmovisor/upgrades/1.0.0/bin/
sudo ln -s ~/.fiamma/cosmovisor/upgrades/1.0.0 ~/.fiamma/cosmovisor/current -f
sudo ln -s ~/.fiamma/cosmovisor/current/bin/fiammad /usr/local/bin/fiammad -f
go install cosmossdk.io/tools/cosmovisor/cmd/[email protected]

➑️ Create a service

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

[Service]
User=$USER
ExecStart=$(which cosmovisor) run start --home $HOME/.fiamma
Restart=on-failure
RestartSec=10
LimitNOFILE=65535
Environment="DAEMON_HOME=${HOME}/.fiamma"
Environment="DAEMON_NAME=fiammad"
Environment="UNSAFE_SKIP_BACKUP=true"
Environment="PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin:~/.fiamma/cosmovisor/current/bin"

[Install]
WantedBy=multi-user.target
EOF

➑️ Let’s activate it

sudo systemctl daemon-reload
sudo systemctl enable fiammad
cd

➑️ Initialize the node

fiammad init NODE_NAME --chain-id fiamma-testnet-1
sed -i -e "s|^node *=.*|node = \"tcp://localhost:${FIAMMA_PORT}657\"|" $HOME/.fiamma/config/client.toml
sed -i -e "s|^keyring-backend *=.*|keyring-backend = \"test\"|" $HOME/.fiamma/config/client.toml
sed -i -e "s|^chain-id *=.*|chain-id = \"fiamma-testnet-1\"|" $HOME/.fiamma/config/client.toml

➑️ Genesis addrbook

curl https://raw.githubusercontent.com/fiamma-chain/networks/refs/heads/main/fiamma-testnet-1/genesis.json -o ~/.fiamma/config/genesis.json
curl https://raw.githubusercontent.com/MictoNode/fiamma-chain/main/addrbook.json -o ~/.fiamma/config/addrbook.json

➑️ Port

sed -i.bak -e "s%:1317%:${FIAMMA_PORT}317%g;
s%:8080%:${FIAMMA_PORT}080%g;
s%:9090%:${FIAMMA_PORT}090%g;
s%:9091%:${FIAMMA_PORT}091%g;
s%:8545%:${FIAMMA_PORT}545%g;
s%:8546%:${FIAMMA_PORT}546%g;
s%:6065%:${FIAMMA_PORT}065%g" $HOME/.fiamma/config/app.toml
sed -i.bak -e "s%:26658%:${FIAMMA_PORT}658%g;
s%:26657%:${FIAMMA_PORT}657%g;
s%:6060%:${FIAMMA_PORT}060%g;
s%:26656%:${FIAMMA_PORT}656%g;
s%^external_address = \"\"%external_address = \"$(wget -qO- eth0.me):${FIAMMA_PORT}656\"%;
s%:26660%:${FIAMMA_PORT}660%g" $HOME/.fiamma/config/config.toml

➑️ Peers and Seeds

peers="[email protected]:40656,[email protected]:50656,[email protected]:26656,[email protected]:40056,[email protected]:26656,[email protected]:45656,[email protected]:26656,[email protected]:37656,[email protected]:50656,[email protected]:29556,[email protected]:26656,[email protected]:26656,[email protected]:22656,[email protected]:56396,[email protected]:22656,[email protected]:20156"
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.fiamma/config/config.toml

➑️ Pruning

sed -i -e "s/^pruning *=.*/pruning = \"custom\"/" $HOME/.fiamma/config/app.toml
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"100\"/" $HOME/.fiamma/config/app.toml
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"10\"/" $HOME/.fiamma/config/app.toml

➑️ Gas Settings

sed -i 's|minimum-gas-prices =.*|minimum-gas-prices = "0.00001ufia"|g' $HOME/.fiamma/config/app.toml

➑️ Indexer

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

➑️ Snap (Thx Itrocket)

fiammad tendermint unsafe-reset-all --home $HOME/.fiamma

SNAPSHOT_URL="https://server-5.itrocket.net/testnet/fiamma/"
LATEST_SNAPSHOT=$(curl -s $SNAPSHOT_URL | grep -oP 'fiamma_\d{4}-\d{2}-\d{2}_\d+_snap\.tar\.lz4' | sort | tail -n 1)

if [ -n "$LATEST_SNAPSHOT" ]; then
  FULL_URL="${SNAPSHOT_URL}${LATEST_SNAPSHOT}"
  if curl -s --head "$FULL_URL" | head -n 1 | grep "200" > /dev/null; then
    curl "$FULL_URL" | lz4 -dc - | tar -xf - -C $HOME/.fiamma
  else
    echo "Snapshot URL not accessible"
  fi
else
  echo "No snapshot found"
fi

➑️ Let’s get started

sudo systemctl start fiammad && sudo journalctl -u fiammad -f -o cat

➑️ Log Command

journalctl -u fiammad -f -o cat

➑️ Create wallet

fiammad keys add wallet-name

➑️ Import wallet

fiammad keys add wallet-name --recover

➑️ Faucet

Faucet Website

Discord Faucet

$request fiamma-address

➑️ Create Validator

cd $HOME

Code below will give you pubkey. Save it. You’ll need it.

fiammad tendermint show-validator
nano validator.json

Copy the below directly. Make the changes and save (ctrl+x, y, enter).

{
        "pubkey": <a data-footnote-ref href="#user-content-fn-4">write-your-pubkey,
        "amount": "10000ufia",
        "moniker": "myvalidator",
        "identity": "optional identity signature (ex. UPort or Keybase)",
        "website": "validator's (optional) website",
        "security": "validator's (optional) security contact email",
        "details": "validator's (optional) details",
        "commission-rate": "0.1",
        "commission-max-rate": "0.2",
        "commission-max-change-rate": "0.01",
        "min-self-delegation": "1"
}
fiammad tx staking create-validator $HOME/validator.json \
    --from=wallet-name \
    --chain-id=fiamma-testnet-1 \
    --gas auto \
    --gas-adjustment 1.5

➑️ Delegate to Yourself

Find your valoper address with the code below

fiammad q staking validator $(fiammad keys show wallet-name --bech val -a) --node=http://localhost:(whatever you typed in custom_port)657
fiammad tx staking delegate valoper-address 10000ufia \
--chain-id fiamma-testnet-1 \
--from "wallet-name" \
--gas auto \
--gas-adjustment 1.5

➑️ Edit Validator

fiammad tx staking edit-validator \
--chain-id fiamma-testnet-1 \
--commission-rate 0.1 \
--new-moniker "validator-name" \
--identity "" \
--details "" \
--website "" \
--security-contact "" \
--from "wallet-name" \
--node http://localhost:(whatever you typed in custom_port)657 \
--gas auto \
--gas-adjustment 1.5

➑️ Complete deletion

cd $HOME
sudo systemctl stop fiammad
sudo systemctl disable fiammad
sudo rm -rf /etc/systemd/system/fiammad.service
sudo systemctl daemon-reload
sudo rm -f /usr/local/bin/fiammad
sudo rm -f $(which fiamma)
sudo rm -rf $HOME/.fiamma $HOME/fiamma
sed -i "/FIAMMA_/d" $HOME/.bash_profile

➑️ Block check

local_height=$(curl -s localhost:(whatever you typed in custom_port)657/status | jq -r .result.sync_info.latest_block_height); network_height=$(curl -s https://fiamma-testnet-rpc.mictonode.com/status | jq -r .result.sync_info.latest_block_height); blocks_left=$((network_height - local_height)); echo "Your node height: $local_height"; echo "Network height: $network_height"; echo "Blocks left: $blocks_left"
  • Your node height - the current block of your node
  • Network height - the last block of the network
  • Blocks left - how many blocks your node has left to sync.