Repolode
Submit
bnb-chain

bnb-chain/reth-bsc

A BSC-compatible execution client built on Reth's NodeBuilder API, able to sync BSC Mainnet and Testnet.

View on GitHub
Stars
89
Forks
62
Open issues
50
Last commit
yesterday

What is it?

reth-bsc is a BSC-compatible client implementation built on Reth. It is not a fork of Reth; instead it extends Reth through its NodeBuilder API to add BSC-specific behavior while keeping compatibility with the Reth ecosystem.

The project can run as a full node or an archive node on BSC Mainnet or BSC Testnet, supports historical and live sync, and includes Pectra support. Standard Ethereum JSON-RPC modules such as eth, net, web3, txpool, debug and trace can be exposed over HTTP and WebSocket. Metrics and file logging are available, and an EVN handshake extension is implemented.

The project also ships Ethereum Execution Spec Tests targets for checking EVM compatibility, and a one-time migration command for moving existing nodes from the v1 storage layout to v2. Running as a validator is not yet supported. The README describes the project as experimental and under active development.

Key features

  • 01Runs as a full node or archive node on BSC Mainnet and Testnet.
  • 02Supports historical sync, live sync and snapshot-based sync.
  • 03Exposes eth, net, web3, txpool, debug, trace and admin JSON-RPC modules over HTTP and WebSocket.
  • 04Includes an EVN upgrade-status handshake extension.
  • 05Provides Prometheus-style metrics and configurable file logging.
  • 06Offers a v1-to-v2 storage migration command.

Use cases

  • Running a BSC node for RPC access to chain data.
  • Operating a BSC archive node for historical state and trace queries.
  • Testing BSC EVM compatibility with Ethereum execution spec tests.
  • Exploring a Rust-based BSC client built on the Reth codebase.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/bnb-chain/reth-bsc.git
  2. 2

    Build the release binary with cargo

    cargo build --release
  3. 3

    Run a full node on BSC Mainnet

    ./target/${profile}/reth-bsc node --full --chain bsc --datadir ./data_dir

Things to know

  • The README calls the project experimental and under active development, so use it at your own risk.
  • Running as a validator is not yet supported.
  • Full nodes need roughly 8 TB or more of disk, and archive nodes need 20 TB or more.

Topics

#blockchain#bsc#ethereum#rust#evm#json-rpc#node-client

FAQ

What is reth-bsc?
A BSC-compatible execution client built on Reth's NodeBuilder API, able to sync BSC Mainnet and Testnet. reth-bsc is a BSC-compatible client implementation built on Reth. It is not a fork of Reth; instead it extends Reth through its NodeBuilder API to add BSC-specific behavior while keeping compatibility with the Reth ecosystem.
Is reth-bsc free to use? What license does it have?
reth-bsc is open source under the MIT license. Check the license terms before using it in commercial products.
Is reth-bsc still maintained?
Actively maintained. The last commit to reth-bsc was on Nov 6, 2026.
What can I use reth-bsc for?
Running a BSC node for RPC access to chain data. Operating a BSC archive node for historical state and trace queries. Testing BSC EVM compatibility with Ethereum execution spec tests. Exploring a Rust-based BSC client built on the Reth codebase.
How do I install reth-bsc?
Clone the repository: git clone https://github.com/bnb-chain/reth-bsc.git Build the release binary with cargo: cargo build --release Run a full node on BSC Mainnet: ./target/${profile}/reth-bsc node --full --chain bsc --datadir ./data_dir
Where can I get reth-bsc?
The source code and installation instructions are on GitHub: https://github.com/bnb-chain/reth-bsc

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects