Polygon

Firehose configuration for Polygon PoS

This page provides Polygon PoS specific configuration. First read the Ethereum general notes for common information.

Docker Image

ghcr.io/streamingfast/go-ethereum:polygon-<version>-fh3.0

View available versions on GitHub Packages

The image contains both the Firehose-patched Bor binary and fireeth.

Client Binary

Client	Repository	Source Branch	Releases
Bor (Firehose-patched)	streamingfast/go-ethereum	release/polygon-2.x-fh3.0	polygon-*

Networks

Network	Chain Name
Polygon Mainnet	polygon-mainnet
Polygon Amoy	polygon-amoy

Heimdall Dependency

Polygon PoS requires a Heimdall node running alongside Bor. Heimdall provides checkpoint validation. You must run your own Heimdall node. Refer to the Polygon documentation for Heimdall setup instructions.

Reader Node Configuration

Polygon Mainnet

fireeth start reader-node <apps> \
  --advertise-chain-name="polygon-mainnet" \
  --reader-node-path="bor" \
  --reader-node-arguments="server --chain=mainnet --config=/path/to/config.toml --datadir={node-data-dir} --bor.heimdall=http://heimdall:1317 --syncmode=full --vmtrace=firehose" \
  <other_flags...>

Polygon Amoy Testnet

fireeth start reader-node <apps> \
  --advertise-chain-name="polygon-amoy" \
  --reader-node-path="bor" \
  --reader-node-arguments="server --chain=amoy --config=/path/to/config.toml --datadir={node-data-dir} --bor.heimdall=http://heimdall:1317 --syncmode=full --vmtrace=firehose" \
  <other_flags...>

Key Bor Flags

Flag	Description
server	Bor subcommand to start the node
--vmtrace=firehose	Required. Enables Firehose Protocol output
--syncmode	full recommended for Polygon
--chain	mainnet or amoy
--config	Path to Bor configuration TOML file
--bor.heimdall	Heimdall REST API endpoint (e.g., http://heimdall:1317)
--datadir	Data directory (use {node-data-dir} template)

Resources

• Polygon Documentation

• Polygon Node Requirements

• streamingfast/go-ethereum