Appearance
Chapter 2 Spec — Where Liquidity Lives
Status: STRAWMAN (drafted by agent, 2026-05-13 — Nick edits before Phase 1) Production order: Second chapter to draft, after Chapter 4
⚠️ This SPEC is a strawman. Nick wrote the Ch 4 SPEC; this one was drafted by the agent off OUTLINE.md and the Ch 4 template, then handed back for editing. The fields most worth Nick's attention are Worked example candidates (the Ch 4 SPEC included Nick's preference; this one flags the recommended option but leaves the call open), Tone notes specific to this chapter, and Open questions for the agent's Phase 1 research (these become the SPEC's research targets).
Learning objective
By the end of this chapter, the reader can:
- Distinguish the AMM and CLOB architectures and articulate which problems each one solves and which it doesn't.
- Name the economic actors who provide liquidity in each architecture — passive LPs in AMMs, resting market makers in CLOBs — and describe each one's revenue source and risk profile.
- Explain why aggregators (Jupiter, 1inch, CoW) and RFQ have become the dominant retail layer on top of either architecture.
- Identify the chain-specific reasons Solana converged on AMMs plus aggregators, Hyperliquid built a native CLOB, and Ethereum supports both.
Why this chapter
Chapter 2 establishes the foundational vocabulary the rest of the book needs.
Chapter 4 (the voice-calibration chapter, drafted first) already mentioned LPs as silent counterparties twice — in §5a (CEX–DEX arbitrage as a tax on the on-chain pool) and §7 (passive LPs as one of the named losers). Those references work in Ch 4 because the reader needs just enough to follow the argument. Chapter 2 makes the LP role explicit and develops the MM-vs-LP distinction that every later actor chapter leans on.
This chapter is not adversarial in the way Chapter 4 was. Its job is to build the board. The adversarial thesis returns in Chapter 3 (mempool dynamics) and is in full force by Chapters 5–7.
Key questions answered
- What is liquidity, in plain terms, and why doesn't a market "just work" without it?
- What is an AMM, and how does it differ economically from a CLOB?
- What's the difference between being a passive LP and being a market maker, and why does it matter to a business reader?
- Why have aggregators become the dominant retail interface on Solana and Ethereum, and what value does an aggregator capture for itself versus pass through to the trader?
- Why did Hyperliquid build a native on-chain CLOB when every prior on-chain CLOB attempt has failed?
Characters introduced
- The Market Maker (full sidebar — first appearance in the book)
- The Passive LP (the silent counterparty Chapter 4 referenced; explicit treatment here, no full sidebar but a half-page "How an LP earns and loses" treatment)
- The Aggregator (Jupiter as the named exemplar; cameo in Ch 4 as a routing layer, full treatment here)
- The Solver (cameo only — full treatment in Chapter 7 when exclusive flow is the topic)
Worked example candidates
The agent should consider all three and pick one to anchor:
A market maker on a Solana on-chain CLOB posts a two-sided quote for SOL/USDC and gets adversely selected when a CEX prints first. The chapter walks through the MM's P&L on a single tick: the spread they collected, the position they're now stuck with, the hedge they need to put on. Pros: vivid, lets the chapter develop the adverse-selection mechanic concretely, sets up the "informed flow vs. uninformed flow" thread that runs through later chapters. Cons: forces a Solana frame early and may be too inside-baseball for the reader's first encounter with market making.
A passive LP deposits $50,000 into a Uniswap V3 ETH/USDC pool and tracks P&L over a month — fees earned, impermanent loss, the cost of staying. Pros: relatable, dollar-anchored in the Book Bible's preferred style, lets the chapter develop the LP role in detail and plant the "passive LP as silent counterparty" thread for Chapters 4 (already drafted) and 11. Cons: less adversarial than the rest of the book; needs to be paired with the explicit observation that someone is on the other side of every LP fill.
A trader on Hyperliquid lifts an offer on the BTC perpetual; the depth that filled them was provided by HLP plus three named market makers; the spread that closed was 8 bps. Pros: showcases CLOB mechanics, concrete, lets HLP appear early (it's load-bearing for Chapter 9). Cons: Hyperliquid has less broad reader familiarity at this stage of the book; the chapter would need to define perpetuals briefly even though they don't recur much in the book.
Agent's recommendation (Nick edits): Option 2 (the LP P&L), with Option 1 as a 1–2 paragraph cameo in the MM section and Option 3 as a paragraph cameo in the chain-comparison box. Reasons: Option 2 is the most accessible for a business reader on the chapter's first material encounter with liquidity, it carries the Bible's "show the dollar" mandate clean through, and it gives the chapter its strongest forward link — once the reader has watched a $50K LP position lose $X to impermanent loss and earn $Y in fees, the "passive LP as chronic loser" thread for Chapter 11 is already half-built.
Glossary terms this chapter introduces
The chapter will introduce a lot of terms — most belong in cameo form (one sentence inline plus glossary entry); only a handful warrant full treatment in the prose.
Full prose treatment (definitions earn their length in the chapter):
- Liquidity
- AMM (automated market maker)
- CLOB (central limit order book)
- Liquidity provider (LP) — distinguishing passive LP and active LP
- Market maker (MM) — distinguishing on-chain MM and off-chain-MM-quoting-on-chain
- Spread
- Slippage
- Impermanent loss / divergence loss
- Aggregator
- RFQ (request for quote)
Cameo only (one inline sentence, full glossary entry):
- Concentrated liquidity (Uniswap V3-style)
- Constant-product curve (
xy = k) - Resting order, marketable order
- Taker / Maker
- HLP (Hyperliquid LP vault) — cameo here, full treatment in Chapter 9
- Solver — cameo here, full treatment in Chapter 7
Diagrams needed
2–4 diagrams, per the Bible's per-chapter budget.
The AMM curve. A constant-product bonding curve showing the price-impact-vs-trade-size relationship. Annotated: where the curve sits, what a swap does to it, what an LP deposit does. The reader should be able to point at the curve and explain why a $10K swap on a $1M pool moves the price more than a $10K swap on a $100M pool.
The CLOB order book. A snapshot of bid/ask depth — say five levels each side, with named market makers attributed to each level. The reader should see the spread, see the depth, see who's quoting where.
Aggregator routing. A Sankey-style diagram showing Alice's $10,000 swap from the prologue (recall: the same Alice from Chapter 4) being routed across three pools to minimise slippage — for instance, 60% through one Raydium pool, 25% through Orca, 15% through a Phoenix CLOB if relevant. Each leg annotated with the price it took.
(Optional) MM vs LP P&L profile. A two-column table comparing the income sources, risk drivers, and time horizons of an MM versus a passive LP. Useful if the prose runs short; potentially redundant if the worked example does the job.
Forward and backward links
Backward:
- Chapter 1 (What Is a Trade, On-Chain). Not yet drafted. Chapter 1 will define the three phases (intent, settlement, finality) the reader needs before Chapter 2's mechanics land. If Chapter 1 is not yet drafted when Chapter 2 enters Phase 3, this chapter must briefly establish "what a trade is on-chain" inline (one or two sentences) before §3 begins.
- Prologue (Alice's $10K swap). Not yet drafted. The aggregator routing diagram should plausibly continue the prologue's setup.
Forward:
- Chapter 3 (The Mempool and What Replaces It). The pre-trade visibility surface that creates the sandwich opportunity Chapter 4 already developed.
- Chapter 4 (The Searcher). Already drafted. The passive-LP thread planted in Ch 2 is referenced in Ch 4 §5a and §7 — Ch 2 should make explicit that the LP role is the one Chapter 4 referred to without fully introducing.
- Chapter 6 (Infrastructure Layer). Aggregators get richer treatment as routing infrastructure once the actor structure is in place.
- Chapters 8, 9, 10 (Solana, Hyperliquid, Ethereum). The chain-specific convergence story this chapter argues for is the foundation those chapters develop in depth.
- Chapter 11 (Who's at a Disadvantage). The "passive LP as chronic loser" thread Ch 2 sets up is one of the four loser archetypes Chapter 11 revisits.
Tone notes specific to this chapter
- The chapter is not adversarial. It is structural. Resist the urge to score points against any particular architecture; the chapter's job is to describe the board. The verdict on each architecture lives in Chapter 11.
- Diagrams replace prose, they don't supplement it. This chapter introduces three or four mechanics that lend themselves to visual explanation — the AMM curve, the order book, the routing graph. The text should say what the diagram means, not narrate what the diagram shows.
- "Meet the Market Maker" is the book's first actor sidebar — set the format. A half-page side-bar in a different visual style; the format established here is what subsequent chapters will mirror (Meet the Searcher already exists in Ch 4 and uses VitePress's
::: infocontainer — the format is portable to print via a pandoc filter at MANUSCRIPT.md assembly time). - Do not preview Chapter 4. A reader who has not yet read Chapter 4 should be able to finish Chapter 2 without needing it. A reader who has read Chapter 4 should find one or two satisfying back-references (the LP role; the aggregator).
- The chain-specific convergence story is the chapter's argument. Solana → AMMs because high throughput, low fees, and composability favour pool-based liquidity. Hyperliquid → CLOB because the design target was professional traders willing to pay for tight spreads and the custom-consensus stack made on-chain matching feasible. Ethereum → both because the platform is permissionless and the gas-cost regime favours different architectures at different size bands. This is not a value judgment; it is a structural observation.
Open questions for the agent's Phase 1 research
Number these in the research note. Treat them as research targets, not as exhaustive.
- LP P&L on Uniswap V3 in 2026. The Topaze Labs / Bancor-style "passive LPs lose to informed flow" measurement series — what's the most recent published instalment? Has the 2025 IRA Sigmadex / Crocswap work been updated for 2026 conditions?
- HLP returns, Q1/Q2 2026. Hyperliquid publishes the HLP vault's return profile. What does it look like in 2026? Specifically: is HLP earning enough to compensate for the adverse selection it absorbs?
- On-chain CLOB activity on Solana. Phoenix, Open Book, dexalot — what's the actual volume picture in 2026? Are any of these above noise, or has the AMM-plus-aggregator stack won definitively?
- Aggregator market share by chain in 2026. Jupiter dominates Solana; on Ethereum the 1inch / CoW / 0x / Paraswap split is more even. Latest numbers.
- RFQ retail flow share, Ethereum 2026. CoW Swap publishes a "share of retail flow filled by solvers vs. AMM pools" metric. What is it in 2026?
- Concentrated liquidity utilisation. What fraction of Uniswap V3 TVL is in active (in-range) positions versus out-of-range? This number is the strongest single signal for "concentrated liquidity has not solved passive LP risk."
- Adverse selection economics on Hyperliquid. Is there public data on how Hyperliquid MMs price the risk of CEX-first prints? HLP's existence is a partial answer; the active MMs' behaviour is the rest.
- The 2025–2026 SVM order-book attempts. dFlow, Manifest, and similar — any of them gaining traction, or all stuck below the AMM-aggregator equilibrium?
Out of scope for this chapter
- Specific MEV attacks against LPs and MMs (Chapter 4, already drafted)
- Mempool dynamics and pre-trade visibility (Chapter 3)
- Validator and builder economics (Chapter 5)
- Cross-chain liquidity bridges and the L2-fragmentation thesis (Chapter 10)
- Specific memecoin launchpads, token-launch mechanics, or Pump.fun-style primary issuance (footnote only if at all; not the chapter's subject)
- The full mechanics of perpetuals or futures funding rates (Chapter 9 touches them in the Hyperliquid context; not here)
Keep this chapter focused on liquidity architectures and the actors who provide liquidity. Everything else is a cameo or a forward link.