# alyssadaypin/sequencer--001 architecture

> Architecture diagram of the GitHub repository alyssadaypin/sequencer--001, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/alyssadaypin/sequencer--001
- Repository: https://github.com/alyssadaypin/sequencer--001

## Overview

This is a multi-crate Starknet sequencer: its intended product workflow accepts transactions, orders and executes them into blocks, reaches consensus, commits state, and exposes node services. The tree also shows L1 event handling, class compilation/storage, synchronization, proofs, peer networking, and monitoring. The excerpts substantiate several batcher-to-helper relationships; most other service connections are not shown, so those links are marked unverified rather than asserted as source-backed calls.

Main entry points: [`crates/apollo_batcher/src/batcher.rs`](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_batcher/src/batcher.rs) (Batcher), [`crates/apollo_gateway/src/gateway.rs`](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_gateway/src/gateway.rs) (Gateway), [`crates/apollo_storage/src/storage_reader_server.rs`](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_storage/src/storage_reader_server.rs) (Sequencer storage), [`crates/apollo_consensus_orchestrator/src/build_proposal.rs`](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_consensus_orchestrator/src/build_proposal.rs) (Consensus orchestrator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_tx["Transaction and blocks"]
  node_mempool[("Mempool<br/>[mempool.rs]")]
  node_batcher["Batcher<br/>[batcher.rs]"]
  node_builder["Block builder<br/>[block_builder.rs]"]
  node_executor["Transaction executor"]
end

subgraph group_consensus["Consensus and networking"]
  node_consensus["Consensus<br/>[manager.rs]"]
  node_orchestrator["Consensus orchestrator<br/>[build_proposal.rs]"]
  node_network["Peer network<br/>[mod.rs]"]
  node_propeller["Propeller protocol<br/>[engine.rs]"]
end

subgraph group_state["State and proofs"]
  node_commitment["Commitment manager"]
  node_committer["State committer<br/>[state_committer.rs]"]
  node_sync["Central sync<br/>[lib.rs]"]
  node_storage[("Sequencer storage")]
  node_proof["Storage proofs<br/>[storage_proofs.rs]"]
end

subgraph group_services["Node services"]
  node_gateway["Gateway<br/>[gateway.rs]"]
  node_l1events["L1 events"]
  node_classes[("Class management<br/>[class_storage.rs]")]
  node_compiler["Cairo compiler<br/>[compiler.rs]"]
  node_http["HTTP server<br/>[http_server.rs]"]
  node_rpc["RPC"]
  node_dashboard["Monitoring dashboards<br/>[dashboard.rs]"]
end

node_user(("Transaction client"))

node_user -.->|"submits transactions"| node_gateway
node_gateway -.->|"forwards transactions"| node_mempool
node_mempool -.->|"provides transactions"| node_batcher
node_batcher -->|"builds blocks"| node_builder
node_batcher -.->|"executes transactions"| node_executor
node_batcher -->|"adds commitment tasks"| node_commitment
node_commitment -->|"dispatches tasks"| node_committer
node_committer -.->|"writes commitments"| node_storage
node_orchestrator -.->|"requests proposals"| node_batcher
node_orchestrator -.->|"coordinates consensus"| node_consensus
node_consensus -.->|"exchanges messages"| node_network
node_propeller -.->|"adapts peer protocol"| node_network
node_sync -.->|"updates state"| node_storage
node_proof -.->|"queries state proofs"| node_storage
node_l1events -.->|"supplies L1 handlers"| node_batcher
node_classes -.->|"stores compiled classes"| node_compiler
node_http -.->|"routes requests"| node_gateway
node_http -.->|"serves RPC"| node_rpc
node_dashboard -.->|"reports health"| node_user

click node_gateway "https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_gateway/src/gateway.rs"
click node_mempool "https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_mempool/src/mempool.rs"
click node_batcher "https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_batcher/src/batcher.rs"
click node_builder "https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_batcher/src/block_builder.rs"
click node_executor "https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_batcher/src/transaction_executor.rs"
click node_commitment "https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_batcher/src/commitment_manager/commitment_manager_impl.rs"
click node_committer "https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_batcher/src/commitment_manager/state_committer.rs"
click node_consensus "https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_consensus/src/manager.rs"
click node_orchestrator "https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_consensus_orchestrator/src/build_proposal.rs"
click node_network "https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_network/src/network_manager/mod.rs"
click node_propeller "https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_propeller/src/engine.rs"
click node_sync "https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_central_sync/src/lib.rs"
click node_storage "https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_storage/src/storage_reader_server.rs"
click node_proof "https://github.com/alyssadaypin/sequencer--001/blob/master/crates/starknet_transaction_prover/src/running/storage_proofs.rs"
click node_l1events "https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_l1_events/src/transaction_manager.rs"
click node_classes "https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_class_manager/src/class_storage.rs"
click node_compiler "https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_compile_to_casm/src/compiler.rs"
click node_http "https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_http_server/src/http_server.rs"
click node_rpc "https://github.com/alyssadaypin/sequencer--001/tree/master/crates/apollo_rpc/src"
click node_dashboard "https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_dashboard/src/dashboard.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_mempool,node_batcher,node_builder,node_executor,node_user toneBlue
class node_consensus,node_orchestrator,node_network,node_propeller toneAmber
class node_commitment,node_committer,node_sync,node_storage,node_proof toneMint
class node_gateway,node_l1events,node_classes,node_compiler,node_http,node_rpc,node_dashboard toneRose
```

## Components

### Transaction and blocks

- [Mempool](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_mempool/src/mempool.rs): `crates/apollo_mempool/src/mempool.rs`
- [Batcher](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_batcher/src/batcher.rs): `crates/apollo_batcher/src/batcher.rs`
- [Block builder](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_batcher/src/block_builder.rs): `crates/apollo_batcher/src/block_builder.rs`
- [Transaction executor](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_batcher/src/transaction_executor.rs): `crates/apollo_batcher/src/transaction_executor.rs`

### Consensus and networking

- [Consensus](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_consensus/src/manager.rs): `crates/apollo_consensus/src/manager.rs`
- [Consensus orchestrator](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_consensus_orchestrator/src/build_proposal.rs): `crates/apollo_consensus_orchestrator/src/build_proposal.rs`
- [Peer network](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_network/src/network_manager/mod.rs): `crates/apollo_network/src/network_manager/mod.rs`
- [Propeller protocol](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_propeller/src/engine.rs): `crates/apollo_propeller/src/engine.rs`

### State and proofs

- [Commitment manager](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_batcher/src/commitment_manager/commitment_manager_impl.rs): `crates/apollo_batcher/src/commitment_manager/commitment_manager_impl.rs`
- [State committer](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_batcher/src/commitment_manager/state_committer.rs): `crates/apollo_batcher/src/commitment_manager/state_committer.rs`
- [Central sync](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_central_sync/src/lib.rs): `crates/apollo_central_sync/src/lib.rs`
- [Sequencer storage](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_storage/src/storage_reader_server.rs): `crates/apollo_storage/src/storage_reader_server.rs`
- [Storage proofs](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/starknet_transaction_prover/src/running/storage_proofs.rs): `crates/starknet_transaction_prover/src/running/storage_proofs.rs`

### Node services

- [Gateway](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_gateway/src/gateway.rs): `crates/apollo_gateway/src/gateway.rs`
- [L1 events](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_l1_events/src/transaction_manager.rs): `crates/apollo_l1_events/src/transaction_manager.rs`
- [Class management](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_class_manager/src/class_storage.rs): `crates/apollo_class_manager/src/class_storage.rs`
- [Cairo compiler](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_compile_to_casm/src/compiler.rs): `crates/apollo_compile_to_casm/src/compiler.rs`
- [HTTP server](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_http_server/src/http_server.rs): `crates/apollo_http_server/src/http_server.rs`
- [RPC](https://github.com/alyssadaypin/sequencer--001/tree/master/crates/apollo_rpc/src): `crates/apollo_rpc/src`
- [Monitoring dashboards](https://github.com/alyssadaypin/sequencer--001/blob/master/crates/apollo_dashboard/src/dashboard.rs): `crates/apollo_dashboard/src/dashboard.rs`

### Other components

- **Transaction client**

## Connections

- Transaction client → Gateway: submits transactions
- Gateway → Mempool: forwards transactions
- Mempool → Batcher: provides transactions
- Batcher → Block builder: builds blocks (evidence: `crates/apollo_batcher/src/batcher.rs`)
- Batcher → Transaction executor: executes transactions
- Batcher → Commitment manager: adds commitment tasks (evidence: `crates/apollo_batcher/src/batcher.rs`)
- Commitment manager → State committer: dispatches tasks (evidence: `crates/apollo_batcher/src/commitment_manager/commitment_manager_impl.rs`)
- State committer → Sequencer storage: writes commitments
- Consensus orchestrator → Batcher: requests proposals
- Consensus orchestrator → Consensus: coordinates consensus
- Consensus → Peer network: exchanges messages
- Propeller protocol → Peer network: adapts peer protocol
- Central sync → Sequencer storage: updates state
- Storage proofs → Sequencer storage: queries state proofs
- L1 events → Batcher: supplies L1 handlers
- Class management → Cairo compiler: stores compiled classes
- HTTP server → Gateway: routes requests
- HTTP server → RPC: serves RPC
- Monitoring dashboards → Transaction client: reports health
