Sequencer Integration (Besu + Plugins)
Home · Chain Index · Chain Overlays
This document summarizes how the sequencer plugin stack and the Credible Layer plugin integrate with Besu and the sidecar in this workspace.
Configuration Context
- The sequencer plugin defaults live in
linea-monorepo/docker/config/linea-besu-sequencer/sequencer.config.toml. - The combined sequencer + Credible plugin stack used in the local stack is defined in
credible-sdk/docker/maru-besu-sidecar/config/linea-besu-sequencer/sequencer-credible-grpc.config.toml.
Sequencer Plugin Stack (High-Level)
Block Build and Sidecar Enforcement Flow
Notes:
- The sequencer RPC endpoints include estimate gas, extra-data configuration, and bundle endpoints used by clients.
- The Credible plugin runs alongside the sequencer plugins and uses the sidecar for transaction-level enforcement.
- In this repo, the sequencer plugin stack is implemented by Linea plugins, and the transaction validator plugin exists in code but is not enabled in the current sequencer configs.
Sequencer Plugin Pipeline (Detailed)
Notes:
- The pool validator runs a fail-fast chain of validators (line limits, deny lists, gas, calldata, profitability, simulation).
- The selection service invokes the sequencer selector and the Credible selector for each candidate transaction.
- Bundle and liveness transactions are injected via the sequencer selector before normal pool selection.
- Rejected transaction reporting is optional and posts JSON-RPC payloads to a configured endpoint.
Pool Validation Chain (Fail-Fast)
Bundles and Liveness Injection
Custom RPC Endpoints (Sequencer)
Notes:
- The estimate gas endpoint runs simulation, line-count validation, and fee estimation before returning a response.
- The extra data config endpoint updates runtime pricing config and forwards to in-process miner RPC calls.
- Bundle endpoints validate and enqueue bundles that are evaluated during block selection.