Skip to content

docs(ENG-314): Add eCLOB architecture sketch#2

Merged
alnoki merged 1 commit into
mainfrom
eng-314
Apr 23, 2026
Merged

docs(ENG-314): Add eCLOB architecture sketch#2
alnoki merged 1 commit into
mainfrom
eng-314

Conversation

@alnoki

@alnoki alnoki commented Apr 18, 2026

Copy link
Copy Markdown
Contributor

Changes

  1. Add docs/architecture.md — a design sketch for the eCLOB (ephemeral central limit order book), positioning it between legacy CLOBs (fully-sorted onchain state, expensive per-quote rebalancing) and propAMMs (opaque per-maker accounts that fragment liquidity).
  2. Document core data structures (Seat, ReferencePrice, Remaining, BookProfile, Level, MarketHeader, Registry) with field-level comments.
  3. Describe the market account's contiguous memory layout (header + seat slab), DLL + free-list threading, and absolute SVM pointer handling.
  4. Specify maker operations (OpenSeat, SetBookProfile, SetReferencePrice) and the authority/pointer validation scheme, including the zero-data-maker-account constraint.
  5. Describe just-in-time order book reconstruction — the ephemeral heap-ordered book built per take — and the FLUSH_BIT protocol that lets makers defer per-level allowance refills onto taker flow.
  6. Add clob, permissionless, pubkeys, and solana to the cspell dictionary.

@linear

linear Bot commented Apr 18, 2026

Copy link
Copy Markdown

ENG-314

@alnoki alnoki changed the title ENG-314 docs(ENG-314): Add architecture sketch Apr 23, 2026
@alnoki alnoki marked this pull request as ready for review April 23, 2026 00:26
@alnoki alnoki requested a review from chen-robert April 23, 2026 00:26
@alnoki alnoki changed the title docs(ENG-314): Add architecture sketch docs(ENG-314): Add eCLOB architecture sketch Apr 23, 2026
@alnoki alnoki merged commit 9618a64 into main Apr 23, 2026
2 checks passed
@alnoki alnoki deleted the eng-314 branch April 23, 2026 21:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant