solo

Solo Sequencer

A minimal single-leader sequencer without forced inclusion support. It accepts mempool transactions via an in-memory queue and produces batches on demand.

Overview

The solo sequencer is the simplest sequencer implementation. It has no DA-layer interaction for transaction ordering and no crash-recovery persistence. Transactions are held in memory and lost on restart.

Use it when you need a single node that orders transactions without the overhead of forced inclusion checkpoints or DA-based sequencing.

flowchart LR
    Client["Client"] -->|SubmitBatchTxs| Sequencer["SoloSequencer"]
    Sequencer -->|GetNextBatch| BlockManager["Block Manager"]

Design Decisions

Flow

SubmitBatchTxs

flowchart TD
    A["SubmitBatchTxs()"] --> B{"Valid ID?"}
    B -->|No| C["Return ErrInvalidID"]
    B -->|Yes| D{"Empty batch?"}
    D -->|Yes| E["Return OK"]
    D -->|No| H["Append txs to queue"]
    H --> E

GetNextBatch

flowchart TD
    A["GetNextBatch()"] --> B{"Valid ID?"}
    B -->|No| C["Return ErrInvalidID"]
    B -->|Yes| D["Drain queue"]
    D --> E{"Queue was empty?"}
    E -->|Yes| F["Return empty batch"]
    E -->|No| G["FilterTxs via executor"]
    G --> H["Re-queue postponed txs"]
    H --> I["Return valid txs"]

Comparison with Other Sequencers