BNB Smart Chain

Firehose configuration for BNB Smart Chain

This page provides BNB Smart Chain (BSC) specific configuration. First read the Ethereum general notes for common information.

Docker Image

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

View available versions on GitHub Packages

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

Client Binary

Client	Repository	Source Branch	Releases
BSC Geth (Firehose-patched)	streamingfast/go-ethereum	release/bnb-1.x-fh3.0	bnb-*

Networks

Network	Chain Name
BSC Mainnet	bsc-mainnet
BSC Testnet	bsc-testnet

Reader Node Configuration

BSC Mainnet

fireeth start reader-node <apps> \
  --advertise-chain-name="bsc-mainnet" \
  --reader-node-path="geth" \
  --reader-node-arguments="--datadir={node-data-dir} --networkid=56 --syncmode=full --vmtrace=firehose" \
  <other_flags...>

BSC Testnet

fireeth start reader-node <apps> \
  --advertise-chain-name="bsc-testnet" \
  --reader-node-path="geth" \
  --reader-node-arguments="--datadir={node-data-dir} --networkid=97 --syncmode=full --vmtrace=firehose" \
  <other_flags...>

Key BSC Geth Flags

Flag	Description
--vmtrace=firehose	Required. Enables Firehose Protocol output
--networkid	Network ID (56 for mainnet, 97 for testnet)
--syncmode	full recommended for BSC
--datadir	Data directory (use {node-data-dir} template)

Resources

• BSC Documentation

• BSC Node Best Practices

• streamingfast/go-ethereum