# immunefi-team/audit-comp-base-everest-base architecture

> Architecture diagram of the GitHub repository immunefi-team/audit-comp-base-everest-base, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/immunefi-team/audit-comp-base-everest-base
- Repository: https://github.com/immunefi-team/audit-comp-base-everest-base

## Overview

Base is an Ethereum rollup node and protocol implementation. The main operational story is L1 input being derived into L2 payload attributes, sequenced into blocks, executed by the node, and published through batching; the README documents sequencing, derivation, and batching as core devnet capabilities. The repository also includes proof and native-precompile subsystems. The excerpts document derivation-stage ordering and some engine/sequencer responsibilities, but do not establish most runtime wiring, so uncertain connections are dashed.

Main entry points: [`bin/node/src/main.rs`](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/bin/node/src/main.rs) (Base Node), [`crates/consensus/derive/src/stages/mod.rs`](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/consensus/derive/src/stages/mod.rs) (Derivation Pipeline), [`crates/batcher/service/src/service.rs`](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/batcher/service/src/service.rs) (Batcher Service), [`crates/batcher/core/src/driver.rs`](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/batcher/core/src/driver.rs) (Batcher Driver)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_consensus["Consensus &amp; Derivation"]
  node_engine["Engine Actor"]
  node_derivation_client["Engine Derivation Client<br/>[client.rs]"]
  node_derivation_stages["Derivation Pipeline<br/>[mod.rs]"]
  node_l1_retrieval["L1 Retrieval<br/>[l1_retrieval.rs]"]
  node_frame_queue["Frame Queue<br/>[frame_queue.rs]"]
  node_attributes_queue["Attributes Queue"]
end

subgraph group_execution["Execution &amp; Protocol"]
  node_node["Base Node<br/>[main.rs]"]
  node_execution_engine["Execution Engine<br/>[engine.rs]"]
  node_evm["Base EVM<br/>[evm.rs]"]
  node_precompiles["Native Precompiles<br/>[lib.rs]"]
  node_storage_context["Precompile Storage Context<br/>[storage_ctx.rs]"]
  node_storage_provider[("Storage Provider<br/>[provider.rs]")]
end

subgraph group_batching["Sequencing &amp; Batching"]
  node_sequencer["Sequencer Actor"]
  node_batcher_service["Batcher Service<br/>[service.rs]"]
  node_batcher_core["Batcher Driver<br/>[driver.rs]"]
  node_batch_encoder["Batch Encoder<br/>[pipeline.rs]"]
  node_l1_batch_source["L1 Batch Source<br/>[l1_source.rs]"]
  node_tx_manager["Transaction Manager<br/>[manager.rs]"]
end

subgraph group_proof["Proof Systems"]
  node_proof_driver["Proof Driver<br/>[pipeline.rs]"]
  node_proof_pipeline["L1 Proof Pipeline<br/>[pipeline.rs]"]
  node_proposer["Proof Proposer<br/>[pipeline.rs]"]
  node_challenger["Proof Challenger<br/>[proof_manager.rs]"]
end

node_operator(("Node Operator"))
node_ethereum(("Ethereum L1"))

node_operator -.->|"runs"| node_node
node_ethereum -.->|"provides L1 data"| node_l1_retrieval
node_derivation_stages -->|"orders first"| node_l1_retrieval
node_derivation_stages -->|"then queues frames"| node_frame_queue
node_derivation_stages -->|"derives attributes"| node_attributes_queue
node_engine -.->|"notifies derivation"| node_derivation_client
node_node -.->|"hosts"| node_engine
node_node -.->|"hosts"| node_sequencer
node_sequencer -.->|"routes engine requests"| node_engine
node_node -.->|"runs execution"| node_execution_engine
node_execution_engine -.->|"executes transactions"| node_evm
node_precompiles -.->|"uses storage context"| node_storage_context
node_storage_context -->|"accesses storage"| node_storage_provider
node_node -.->|"hosts batching"| node_batcher_service
node_batcher_service -.->|"drives submissions"| node_batcher_core
node_batcher_core -.->|"encodes batches"| node_batch_encoder
node_batcher_service -.->|"reads L1"| node_l1_batch_source
node_batcher_core -.->|"publishes transactions"| node_tx_manager
node_node -.->|"supports proof workflow"| node_proof_driver
node_proof_driver -.->|"prepares proofs"| node_proof_pipeline
node_proof_pipeline -.->|"supplies proof work"| node_proposer
node_challenger -.->|"checks proofs"| node_proof_pipeline

click node_node "https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/bin/node/src/main.rs"
click node_engine "https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/consensus/service/src/actors/engine/engine_request_processor.rs"
click node_derivation_client "https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/consensus/service/src/actors/engine/client.rs"
click node_sequencer "https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/consensus/service/src/actors/sequencer/engine_request_coordinator.rs"
click node_derivation_stages "https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/consensus/derive/src/stages/mod.rs"
click node_l1_retrieval "https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/consensus/derive/src/stages/l1_retrieval.rs"
click node_frame_queue "https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/consensus/derive/src/stages/frame_queue.rs"
click node_attributes_queue "https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/consensus/derive/src/stages/attributes_queue.rs"
click node_execution_engine "https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/execution/node/src/engine.rs"
click node_evm "https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/common/evm/src/evm.rs"
click node_precompiles "https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/common/precompiles/src/lib.rs"
click node_storage_context "https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/common/precompile-storage/src/storage_ctx.rs"
click node_storage_provider "https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/common/precompile-storage/src/provider.rs"
click node_batcher_service "https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/batcher/service/src/service.rs"
click node_batcher_core "https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/batcher/core/src/driver.rs"
click node_batch_encoder "https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/batcher/encoder/src/pipeline.rs"
click node_l1_batch_source "https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/batcher/source/src/l1_source.rs"
click node_tx_manager "https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/utilities/tx-manager/src/manager.rs"
click node_proof_driver "https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/proof/driver/src/pipeline.rs"
click node_proof_pipeline "https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/proof/proof/src/l1/pipeline.rs"
click node_proposer "https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/proof/proposer/src/pipeline.rs"
click node_challenger "https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/proof/challenge/src/proof_manager.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_engine,node_derivation_client,node_derivation_stages,node_l1_retrieval,node_frame_queue,node_attributes_queue toneBlue
class node_node,node_execution_engine,node_evm,node_precompiles,node_storage_context,node_storage_provider toneAmber
class node_sequencer,node_batcher_service,node_batcher_core,node_batch_encoder,node_l1_batch_source,node_tx_manager toneMint
class node_proof_driver,node_proof_pipeline,node_proposer,node_challenger toneRose
class node_operator,node_ethereum toneIndigo
```

## Components

### Consensus & Derivation

- [Engine Actor](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/consensus/service/src/actors/engine/engine_request_processor.rs): `crates/consensus/service/src/actors/engine/engine_request_processor.rs`
- [Engine Derivation Client](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/consensus/service/src/actors/engine/client.rs): `crates/consensus/service/src/actors/engine/client.rs`
- [Derivation Pipeline](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/consensus/derive/src/stages/mod.rs): `crates/consensus/derive/src/stages/mod.rs`
- [L1 Retrieval](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/consensus/derive/src/stages/l1_retrieval.rs): `crates/consensus/derive/src/stages/l1_retrieval.rs`
- [Frame Queue](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/consensus/derive/src/stages/frame_queue.rs): `crates/consensus/derive/src/stages/frame_queue.rs`
- [Attributes Queue](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/consensus/derive/src/stages/attributes_queue.rs): `crates/consensus/derive/src/stages/attributes_queue.rs`

### Execution & Protocol

- [Base Node](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/bin/node/src/main.rs): `bin/node/src/main.rs`
- [Execution Engine](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/execution/node/src/engine.rs): `crates/execution/node/src/engine.rs`
- [Base EVM](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/common/evm/src/evm.rs): `crates/common/evm/src/evm.rs`
- [Native Precompiles](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/common/precompiles/src/lib.rs): `crates/common/precompiles/src/lib.rs`
- [Precompile Storage Context](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/common/precompile-storage/src/storage_ctx.rs): `crates/common/precompile-storage/src/storage_ctx.rs`
- [Storage Provider](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/common/precompile-storage/src/provider.rs): `crates/common/precompile-storage/src/provider.rs`

### Sequencing & Batching

- [Sequencer Actor](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/consensus/service/src/actors/sequencer/engine_request_coordinator.rs): `crates/consensus/service/src/actors/sequencer/engine_request_coordinator.rs`
- [Batcher Service](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/batcher/service/src/service.rs): `crates/batcher/service/src/service.rs`
- [Batcher Driver](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/batcher/core/src/driver.rs): `crates/batcher/core/src/driver.rs`
- [Batch Encoder](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/batcher/encoder/src/pipeline.rs): `crates/batcher/encoder/src/pipeline.rs`
- [L1 Batch Source](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/batcher/source/src/l1_source.rs): `crates/batcher/source/src/l1_source.rs`
- [Transaction Manager](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/utilities/tx-manager/src/manager.rs): `crates/utilities/tx-manager/src/manager.rs`

### Proof Systems

- [Proof Driver](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/proof/driver/src/pipeline.rs): `crates/proof/driver/src/pipeline.rs`
- [L1 Proof Pipeline](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/proof/proof/src/l1/pipeline.rs): `crates/proof/proof/src/l1/pipeline.rs`
- [Proof Proposer](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/proof/proposer/src/pipeline.rs): `crates/proof/proposer/src/pipeline.rs`
- [Proof Challenger](https://github.com/immunefi-team/audit-comp-base-everest-base/blob/audit-competition/crates/proof/challenge/src/proof_manager.rs): `crates/proof/challenge/src/proof_manager.rs`

### Other components

- **Node Operator**
- **Ethereum L1**

## Connections

- Node Operator → Base Node: runs
- Ethereum L1 → L1 Retrieval: provides L1 data
- Derivation Pipeline → L1 Retrieval: orders first (evidence: `crates/consensus/derive/src/stages/mod.rs`)
- Derivation Pipeline → Frame Queue: then queues frames (evidence: `crates/consensus/derive/src/stages/mod.rs`)
- Derivation Pipeline → Attributes Queue: derives attributes (evidence: `crates/consensus/derive/src/stages/mod.rs`)
- Engine Actor → Engine Derivation Client: notifies derivation (evidence: `crates/consensus/service/src/actors/engine/engine_request_processor.rs`)
- Base Node → Engine Actor: hosts
- Base Node → Sequencer Actor: hosts
- Sequencer Actor → Engine Actor: routes engine requests
- Base Node → Execution Engine: runs execution
- Execution Engine → Base EVM: executes transactions
- Native Precompiles → Precompile Storage Context: uses storage context
- Precompile Storage Context → Storage Provider: accesses storage (evidence: `crates/common/precompile-storage/src/storage_ctx.rs`)
- Base Node → Batcher Service: hosts batching
- Batcher Service → Batcher Driver: drives submissions
- Batcher Driver → Batch Encoder: encodes batches
- Batcher Service → L1 Batch Source: reads L1
- Batcher Driver → Transaction Manager: publishes transactions
- Base Node → Proof Driver: supports proof workflow
- Proof Driver → L1 Proof Pipeline: prepares proofs
- L1 Proof Pipeline → Proof Proposer: supplies proof work
- Proof Challenger → L1 Proof Pipeline: checks proofs
