This is a unified implementation of the Reth node set up that supports running both standard Reth or Base Reth with Flashblocks support.

• See hardware requirements mentioned in the master README
• For Base Reth mode: Access to a Flashblocks websocket endpoint (for RETH_FB_WEBSOCKET_URL)
  • We provide public websocket endpoints for mainnet and devnet, included in .env.mainnet and .env.sepolia

Use the NODE_TYPE environment variable to select the implementation:

• NODE_TYPE=vanilla - Standard Reth implementation (default)
• NODE_TYPE=base - Base L2 Reth implementation with Flashblocks support

The node follows the standard docker-compose workflow in the master README.

# Run standard Reth node
CLIENT=reth docker-compose up

# Run Base L2 Reth node with Flashblocks support
NODE_TYPE=base CLIENT=reth docker-compose up

When running in Base mode (NODE_TYPE=base), you can query a pending block using the Flashblocks RPC:

curl -X POST \
  --data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["pending", false],"id":1}' \
  http://localhost:8545

For a complete list of supported RPC methods, refer to:

• Standard Ethereum JSON-RPC
• Flashblocks RPC Methods (Base mode only)