How the3rdweblabs/magiclob works
magiCLOB is a Solana central-limit order book with Magicblock Ephemeral Rollup sessions, an integration SDK, and a web trading demo. The principal workflow initializes a market and funds trader custody on Solana, delegates the book and trader to an ER, routes orders through matching, then settles and undelegates. The README also documents staking, governance, flash loans, and an indexer-backed market-data path, which are represented as distinct capabilities. Some app and SDK implementation details were not sampled; edges for those branches use documented relationships rather than inferred calls.
Main entry points: lib.rs Anchor Program · matcher.rs Matching Engine · sdk.ts SDK Facade · delegate_trader_session.rs ER Delegation
Components 26
Trading Demo
- MagicBook UI
app/src/app/magicbook/page.tsx - Trading Components
app/src/components/orderbook - Market Data
app/src/server/indexer.ts - Data API
app/src/app/api
Integrator SDK
- SDK Facade
sdk/src/sdk.ts - Base ER Router
sdk/src/client.ts - Instruction Builders
sdk/src/instructions - Account Readers
sdk/src/accounts - Account Codec
sdk/src/codec.ts - PDA Derivation
sdk/src/pda.ts
Solana Program
- Anchor Program
contracts/programs/magiclob/src/lib.rs - Market Setup
contracts/programs/magiclob/src/instructions/initialize_market.rs - Vault Custody
contracts/programs/magiclob/src/instructions/deposit.rs - ER Delegation
contracts/programs/magiclob/src/instructions/delegate_trader_session.rs - Settlement
contracts/programs/magiclob/src/instructions/settle_and_undelegate.rs - Market State
contracts/programs/magiclob/src/state/market.rs - Order Book State
contracts/programs/magiclob/src/state/order_book.rs - Trader State
contracts/programs/magiclob/src/state/trader.rs - Finance Governance
contracts/programs/magiclob/src/instructions - Order Entry
contracts/programs/magiclob/src/instructions/place_limit_order.rs
Execution Engine
- Matching Engine
contracts/programs/magiclob/src/engine/matcher.rs - Order Types
contracts/programs/magiclob/src/engine/order_types.rs - Fee Router
contracts/programs/magiclob/src/fees.rs
Other components
- Trader
- Solana Network
- Ephemeral Rollup
Connections 32
- Trader → MagicBook UI: trades through
README.md - MagicBook UI → Trading Components: uses
- Trading Components → SDK Facade: submits orders
- MagicBook UI → Market Data: reads market data
README.md - Market Data → Data API: serves streams
README.md - Trading Components → Data API: requests data
- SDK Facade → Base ER Router: routes transactions
README.md - SDK Facade → Instruction Builders: builds instructions
- SDK Facade → Account Readers: reads accounts
- Account Readers → Account Codec: decodes accounts
sdk/src/accounts/market.ts - Instruction Builders → PDA Derivation: derives addresses
sdk/src/instructions/delegateSession.ts - Base ER Router → Solana Network: sends base transactions
sdk/src/client.ts - Base ER Router → Ephemeral Rollup: sends session transactions
README.md - Solana Network → Anchor Program: executes program
README.md - Anchor Program → Market Setup: dispatches setup
contracts/programs/magiclob/src/lib.rs - Anchor Program → Vault Custody: dispatches deposits
contracts/programs/magiclob/src/lib.rs - Anchor Program → ER Delegation: dispatches delegation
contracts/programs/magiclob/src/lib.rs - Anchor Program → Order Entry: dispatches orders
contracts/programs/magiclob/src/lib.rs - Anchor Program → Settlement: dispatches settlement
contracts/programs/magiclob/src/lib.rs - Market Setup → Market State: initializes
README.md - Vault Custody → Solana Network: moves SPL tokens
README.md - ER Delegation → Ephemeral Rollup: delegates session
contracts/programs/magiclob/src/instructions/delegate_trader_session.rs - ER Delegation → Order Book State: delegates book
contracts/programs/magiclob/src/instructions/delegate_trader_session.rs - ER Delegation → Trader State: delegates trader
contracts/programs/magiclob/src/instructions/delegate_trader_session.rs - Order Entry → Matching Engine: matches orders
README.md - Matching Engine → Order Book State: reads and updates
contracts/programs/magiclob/src/engine/matcher.rs - Matching Engine → Trader State: settles fills
contracts/programs/magiclob/src/engine/matcher.rs - Matching Engine → Order Types: uses order types
contracts/programs/magiclob/src/engine/matcher.rs - Matching Engine → Fee Router: calculates fees
contracts/programs/magiclob/src/engine/matcher.rs - Settlement → Solana Network: commits and undelegates
README.md - Anchor Program → Finance Governance: dispatches finance actions
contracts/programs/magiclob/src/lib.rs - Market Data → Order Book State: watches fills
README.md