go-flare

go-flare is a modified version of [email protected] and [email protected], incorporating specific features for Flare and Songbird networks. These features include prioritized contract handling and the invocation of the daemon contract.

Networks should be updated to this version before

• Coston2: June 24, 2025 at 12:00:00 UTC
• Coston: July 1, 2025 at 12:00:00 UTC
• Songbird: July 22, 2025 at 12:00:00 UTC
• Flare: August 5, 2025 at 12:00:00 UTC

See release notes for more info.

System Requirements

• go version 1.22
• gcc, g++ and jq
• CPU: Equivalent of 8 AWS vCPU
• RAM: 16 GiB
• Storage: 1TB Flare / 3.5TB Songbird
• OS: Ubuntu 22.04/24.04

Compilation

After cloning this repository, run:

cd go-flare/avalanchego && ./scripts/build.sh

Deploy a Validation Node

These servers fulfill a critical role in securing the network:

• They check that all received transactions are valid.
• They run a consensus algorithm so that all validators in the network agree on the transactions to add to the blockchain.
• Finally, they add the agreed-upon transactions to their copy of the ledger.

This guide explains how to deploy your own validator node so you can participate in the consensus and collect the rewards that the network provides to those who help secure it: https://docs.flare.network/infra/validation/deploying/

Deploy an Observation Node

Observation nodes enable anyone to observe the network and submit transactions. Unlike validator nodes, which provide state consensus and add blocks, observation nodes remain outside the network and have no effect on consensus or blocks.

This guide explains how to deploy your own observation node: https://docs.flare.network/infra/observation/deploying/

Tests

See tests/README.md for testing details

Container image

Public container images are hosted on Docker HUB and Github Packages;

docker.io/flarefoundation/go-flare
ghcr.io/flare-foundation/go-flare

Images are signed using Cosign with the GitHub OIDC provider. To verify the image, run this command:

cosign verify \
  --certificate-identity-regexp="^https://github\.com/flare-foundation/go-flare/\.github/workflows/build-container\.yml@" \
  --certificate-oidc-issuer=https://token.actions.githubusercontent.com \
  ghcr.io/flare-foundation/go-flare:<TAG>

cosign verify \
  --certificate-identity-regexp="^https://github\.com/flare-foundation/go-flare/\.github/workflows/build-container\.yml@" \
  --certificate-oidc-issuer=https://token.actions.githubusercontent.com \
  docker.io/flarefoundation/go-flare:<TAG>

Container builds in CI

CI builds on each:

• push on main branch, pushes image tagged as "dev"
• creation of a tag, pushes images tagged as the tag itself