consensus
base-consensus runs the Base consensus layer, implementing the OP Stack consensus protocol on top of the Kona derivation framework.
Package
Section titled “Package”- Crate name:
base-consensus - Source:
bin/consensus
Architecture
Section titled “Architecture”The consensus binary:
- L1 derivation — Connects to L1 Ethereum to read rollup data and derives L2 blocks from L1 batches using the derivation pipeline
- P2P networking — Manages peer-to-peer networking for block gossip and state sync
- Engine API — Communicates with the execution layer (base-reth-node) via the Engine API to deliver derived payloads
- Kona integration — Uses
kona-node-servicefor the core consensus loop andkona-genesisfor chain configuration
Key Dependencies
Section titled “Key Dependencies”base-cli-utils— CLI utilities (logging, metrics)base-client-cli— Client CLI extensionskona-genesis— Genesis configurationkona-cli— Consensus CLI frameworkkona-node-service— Node service orchestration
cargo build --bin base-consensus --release./target/release/base-consensus [OPTIONS]The consensus node must be configured with:
- An L1 Ethereum RPC endpoint for reading rollup data
- An Engine API endpoint for communicating with the execution layer
- A P2P configuration for block gossip