Skip to content

Chapter 1 Spec — What Is a Trade, On-Chain

Status: STRAWMAN (drafted by agent, 2026-05-13 — Nick edits before Phase 1) Production order: Third chapter to draft, after Ch 4 and Ch 2

⚠️ This SPEC is a strawman, like the Ch 2 SPEC was. 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, Tone notes specific to this chapter, and Open questions for the agent's Phase 1 research.


Learning objective

By the end of this chapter, the reader can:

  1. Describe the three phases that every trade — on-chain or off — passes through: intent, settlement, finality.
  2. Distinguish what each phase looks like on a centralised exchange versus on-chain, and articulate which differences are mechanical versus economic.
  3. Define "the mempool" in plain terms (cameo here; full treatment in Ch 3) and explain why its existence is the precondition for the rest of the book.
  4. Walk a single trade end-to-end and identify each phase as it happens.

Why this chapter

Chapter 1 is the first chapter the reader meets after the prologue. Its job is to install the vocabulary and the mental model the rest of the book runs on.

The book has been drafted out of order. Chapter 4 (the searcher) and Chapter 2 (where liquidity lives) are complete; each of them assumes the reader already knows what a trade is and what a mempool is, and each carries a one-or-two-sentence inline fallback for the case where Ch 1 isn't ready. Chapter 1 lands that vocabulary properly, so the fallbacks in Ch 2 §3 and Ch 4 §3 can be retired in a future revision pass.

The chapter is structural, not adversarial. The Bible's voice rules still apply (show the dollar, name the actor, no hype/doom) but the verdict is necessarily lighter than Chapters 2 or 4. The reader needs the board before they see the moves.

Key questions answered

  • What does it mean to "make a trade," in plain terms?
  • How does the same trade look different on Binance (centralised) versus on Solana or Ethereum (on-chain), and which of those differences actually matter?
  • What is the public mempool, and why is its existence the precondition for everything in the rest of this book?
  • What are the costs of trading on-chain — fees, gas, slippage — and who collects each one?
  • What does "finality" mean, and why does it differ across chains in ways a business reader needs to know about?

Characters introduced

The chapter is light on actors — most full sidebars happen in later chapters. What appears here:

  • The trader (Alice from the Prologue, returning). She is the chapter's "you," with the second-person framing the Bible's Sample B uses; she will be re-named in later chapters when the perspective shifts from her to her counterparties.
  • The validator / sequencer (cameo only — full sidebar in Ch 5). One paragraph: the actor who decides which transactions go into the next block and in what order.
  • The wallet (concept, not actor). One inline definition.
  • The mempool (concept, not actor). One inline definition. The reader needs to know what it is before Ch 3 develops the implications.

No "Meet the actor" sidebar appears in this chapter. That's deliberate — the chapter's job is to set the stage. Ch 2 has the first sidebar (Meet the Market Maker); Ch 4 has the second (Meet the Searcher); Ch 5 will have Validator and Builder; etc.

Worked example candidates

The agent should consider all three and pick one to anchor:

  1. Alice's $10,000 USDC→SOL swap on Solana, broken into the three phases. The reader watches: she clicks (intent); her transaction is broadcast and sits in the public path briefly; it lands in a block (settlement); a few seconds and a confirmation count later, the block is irrevocable (finality). Pros: continuity with the prologue and Chapter 4; the dollar number is already in the reader's head; the three phases are clean. Cons: forces a Solana-first frame in Chapter 1, and the chapter is supposed to be chain-agnostic.

  2. The same trade on Coinbase, contrasted phase-by-phase. Alice clicks "Buy SOL" on Coinbase. Intent reaches Coinbase's matching engine; the trade fills internally against Coinbase's order book; the position appears in her account. Compared to on-chain: no public pending state, no gas, instant finality, fully proprietary order matching. Pros: gives the reader the TradFi-fluent control comparison the Bible asks for. Cons: a pure-CEX example as the anchor would feel off-topic; the chapter is about on-chain trading.

  3. Both, side-by-side. Alice does the same swap twice — once on Coinbase, once on Solana — and the chapter walks both through the three phases in parallel. Pros: gives the reader the comparison the chapter's argument depends on; demonstrates "the distinction matters less than people think" by showing where the two are mechanically identical (intent + settlement + finality all happen in both) and where they differ (visibility, gas, finality time). Cons: more complex to thread.

Agent's recommendation (Nick edits): Option 3 (side-by-side). The chapter's argument is precisely that on-chain trading has the same shape as off-chain trading; the side-by-side framing is the cleanest way to land that. Option 1 then becomes the natural anchor for §5 ("The mechanics, in detail" — what happens on-chain at each phase), and Option 2 fades into the comparison box at §6.

Glossary terms this chapter introduces

Defined in full:

  • Trade — the act of exchanging one asset for another at an agreed price.
  • Transaction — the on-chain instruction that, when executed, settles a trade (or transfers funds, or interacts with a contract).
  • Intent — the trader's stated desire to make a trade, before the trade is matched or executed.
  • Settlement — the moment the trade is finalised at the venue level (matched on a CEX; included in a block on-chain).
  • Finality — the moment the trade is irrevocable; can be instant (on a CEX) or probabilistic (on-chain, depending on the chain's consensus).
  • Wallet — the user-facing software that holds the trader's private keys and signs transactions on their behalf.
  • Gas — the unit of compute work a transaction consumes, priced by the chain in its native token.
  • Block — the unit of transaction batching on most chains; transactions are included in blocks and then validated together.

Cameo only (one inline sentence; full treatment elsewhere):

  • Mempool — full treatment in Ch 3.
  • Validator / Sequencer — full treatment in Ch 5.
  • Slippage, Spread, LP, AMM, CLOB — already defined in Ch 2; referenced here in passing.

Diagrams needed

2–3 diagrams. (Bible budget 2–5; this chapter is light.)

  1. D1 — The three phases of a trade (sequence diagram). Two parallel tracks: Alice trading on Coinbase, Alice trading on Solana. Each track shows intent → settlement → finality with the participants involved at each step. The visible difference: on-chain there is a public pending state between intent and settlement; on Coinbase there isn't. Mermaid sequence diagram works.

  2. D2 — Where Alice's dollar goes on the on-chain side (small breakdown). Of her $10,000 swap, $X goes to network fees (gas + base fee), $Y goes to the validator who included her transaction (priority fee), $Z is the slippage she paid against the pool, $W actually buys SOL. Sets up the "where does the dollar go" thread that runs through the rest of the book. Markdown table or static SVG.

  3. (Optional) D3 — On-chain vs CEX comparison table. Three columns: intent, settlement, finality. Three rows: Coinbase, Solana, Ethereum. Each cell describes the mechanic at that phase. Useful if the prose runs short.

Backward:

  • Prologue (not yet drafted). Alice's $10K swap is introduced. If the prologue is not yet drafted when Ch 1 enters Phase 3, the chapter must briefly establish Alice and her swap inline. The chapter's opening can stand alone with one paragraph of context.

Forward:

  • Chapter 2 (Where Liquidity Lives, drafted). The pool Alice's swap routes into is the subject of Ch 2. The chapter can reference the §5d prop-AMM finding as one example of "where the trade actually lands."
  • Chapter 3 (Mempool, not yet drafted). The mempool cameo in §3 of this chapter is the lead-in. Ch 3 develops the public-pending-state surface in detail.
  • Chapter 4 (The Searcher, drafted). The reader will meet the searchers who watch the mempool in Ch 4. Ch 1 can plant the visibility concept (one sentence) but does not develop it.
  • Chapter 5 (Validator and Builder). The validator who included Alice's transaction is named here in cameo; full treatment in Ch 5.

Tone notes specific to this chapter

  • Resist the urge to be adversarial. The chapter's job is to install vocabulary and a mental model. The dollar-extraction story is reserved for Chapter 4. If a sentence here implies that on-chain trading is worse than CEX trading, rewrite it neutrally.
  • TradFi parallels are the chapter's main asset. Every concept gets a Coinbase / NYSE / NASDAQ / FIX-protocol comparison. The Bible says "TradFi parallels are your best friend" — this chapter is where that lands hardest.
  • The reader has zero crypto background. Every term is defined inline before it carries load. No acronyms without expansion. The word "transaction" gets one sentence of definition before it appears a second time.
  • Diagrams replace prose, they don't supplement it. The three-phases sequence diagram should carry the structural mechanics; the surrounding text says what the diagram means.
  • Sentences earn their length. The chapter is structural, so it is at higher risk of padding. If a sentence restates the previous sentence in different words, cut it.

Open questions for the agent's Phase 1 research

Number these in the research note.

  • Finality times by chain in 2026. Solana (theoretical TPS, slot times, optimistic confirmation, real-world wall-clock confirmation for an average swap); Hyperliquid (≈70ms claimed; how is this measured); Ethereum L1 (12-second slots, finality via epochs, Casper FFG); major L2s (Base, Arbitrum, Optimism) — sequencer-claimed time vs settlement-on-L1 time.
  • Median gas / transaction cost in 2026. Real numbers for a swap, broken down by chain. Helius, Etherscan, Arbiscan, Basescan, Hyperliquid stats.
  • The "on-chain vs CEX" mechanical comparison. Where each side actually differs and where it doesn't, for a typical retail swap. Coinbase's actual order matching, time to fill, payment-for-order-flow flows (this is also in Ch 7's space — Ch 1 just touches it).
  • Mempool basics in 2026. Public mempool on Ethereum; Solana's TPU and gossip pathways (no global mempool but functionally similar); Hyperliquid's no-mempool design — one paragraph each, just enough for the cameo.
  • Settlement vs finality terminology. Is the chapter using these terms correctly? In TradFi, "settlement" often means T+2 fund transfer; in crypto, "settlement" can mean inclusion-in-block. The chapter needs a tight, consistent definition.
  • The "transactions don't always succeed" angle. Failed transaction rates by chain in 2026. Solana has historically had higher failed-transaction rates; what's the current number?

Out of scope for this chapter

  • Specific MEV mechanics (Chapter 4, already drafted)
  • Liquidity venue architecture (Chapter 2, already drafted)
  • Mempool extraction surfaces (Chapter 3)
  • Validator / builder economics (Chapter 5)
  • Wallet security, key management, UX (not a book topic)
  • Token economics, governance, staking (not a book topic)
  • Specific tokens or token launches (not a book topic; the chapter uses SOL only because Alice is swapping for it)

Keep this chapter focused on what a trade is and how it differs across venues. Everything else is a cameo or a forward link.