Ethereum

Firehose chain-specific configuration for Ethereum and EVM chains

This page covers Reader Node configuration for Ethereum and EVM-compatible chains. For general Firehose architecture and deployment, see the Single Machine Deployment or Distributed Deployment guides.

This guide does not cover how to sync an Ethereum node. For node synchronization, storage requirements, and network configuration, refer to the official documentation of your chosen client.

Binary & Releases

Component	Repository	Binary
Firehose	firehose-ethereum	fireeth

The fireeth binary includes all firecore functionality plus Ethereum-specific features and commands. Download releases from the GitHub releases page or use published Docker images from GitHub Container Registry.

For Reader Nodes, each network provides bundle Docker images containing both fireeth and the network's Firehose-patched node binary. See the network-specific guides below for Docker image references.

Supported Networks

Firehose for Ethereum supports Geth and Geth forks. Each network requires a Firehose-patched version of its client:

Network	Guide
Ethereum Mainnet, Sepolia, Hoodi	Ethereum Mainnet
Arbitrum One, Nova	Arbitrum
Base Mainnet, Sepolia	Base
BNB Smart Chain	BNB Smart Chain
Katana	Katana
Optimism Mainnet, Sepolia	Optimism
Polygon PoS	Polygon
Unichain	Unichain
Monad Mainnet	Monad
Worldchain	Worldchain

Common Configuration

All Ethereum-based networks share these characteristics:

Chain Name (The Graph Network Registry)

Only --advertise-chain-name needs to be specified. All other advertise fields (block ID encoding, chain aliases, etc.) are automatically derived from The Graph Network Registry.

--advertise-chain-name="<chain-name>"

VM Trace Flag

The Firehose-patched Geth (and forks) require the --vmtrace=firehose flag to emit Firehose Protocol logs to stdout.

Basic Reader Node Pattern

fireeth start reader-node <apps> \
  --reader-node-path="<path-to-geth-binary>" \
  --reader-node-arguments="--vmtrace=firehose --datadir={node-data-dir} <network-flags>" \
  --advertise-chain-name="<chain-name>" \
  <other_flags...>

Resources

• firehose-ethereum GitHub

• The Graph Network Registry

• Geth Documentation