[mikemaccana]

Follow-up to #12, which is already merged. Eleven commits of review fixes.

Structure

Part I is renamed from "The Foundations" to "The Fundamentals", which no longer reads as the Solana Foundation.

Part II is reordered into three triads. The Betting Market opened by calling itself "the escrow chapter with many parties", and that is its only prerequisite, yet it sat sixth, wedged inside the market-making arc. It moves to third:

11–13 Escrow, Fundraiser, Betting Market	custody and pooling
14–16 Order Book, Constant-Product AMM, Prop AMM	market making
17–19 Lending, Vault Strategy, Perpetual Futures	credit and leverage

The three market-making chapters chain forward through each other's opening lines, so they stay contiguous. The move also puts the simple form of the offchain-truth question, an admin signing a result, before the oracle-fed form. Prose cross-references use chapter names rather than numbers, so the cost was the table of contents plus four headings, and two handoff sentences whose adjacency changed.

Chapter 20: Where to Go From Here is new. Every chapter ended with What You Learnt except the book, which stopped on Perpetual Futures. The Introduction makes five promises and nothing closed that loop. The chapter covers the six pieces every program here is built from, what those promises now cash out to, what the book left out on purpose and where to look instead, how to get a first build to something shippable, and how to send corrections back.

Acknowledgements move to a new postlude. Technical reviewers stay at the front, because visible peer review is a credibility signal a reader wants before committing. The thank-you list is for the people named, and it grows with every edition and errata contributor.

Accuracy

• Cross-border payment costs were two flavours of average. Now a range with its scope and source stated: under 1% through a digital service to over 20% in cash on the worst corridors, cited to the World Bank, which counted thirteen corridors above 20% in Q3 2025. A US-only reader should be able to check the number rather than conclude it was invented.
• ATA seed labels named the wrong program in 40 figures, 239 labels. They listed the Associated Token Program, which derived the address, instead of the token program, which is one of the three seeds. Now OWNER'S ADDRESS + TOKEN PROGRAM + MINT, with a lint rule so it cannot come back.
• Chapter 8's opening fact was "What is NVIDIA trading at?", which a reader can answer from an onchain order book in this book's own chapters. Replaced with a rate decision, which has no onchain source.
• The cluster paragraph implied mainnet was a test target. Now localnet then devnet, with mainnet as where a finished program goes live.

Figures

• The fundraiser thermometer spread one sentence across seven slices stacked upward, so reading down gave "backers more seven". Those are now seven named backers, each slice as tall as what that person gave.
• The constant-product curve is three panels, one per 100 USDC buy, so the same money visibly buys 40.0 then 32.7 then 27.3 ACME. The three trades sum to exactly the single jump the old figure drew.
• The stranded-deposit path was a crossed-out empty box; it is now an ordinary account holding tokens and rent that no handler can return.
• Instruction-routing arrows are gone from both transaction figures. Arrows in this book mean value moving, and the instruction row already names its program.

Language

• PDA and account had drifted into synonyms ("market PDA" eight times against "market account" twice, same thing). A PDA is an address, an account is the data at it, and each usage now follows its sentence.
• Setup handlers are initialize_x(), matching Name every setup handler initialize_x() solana-program-examples#117. Domain verbs keep the domain's word.
• "bytecode" is gone from the prose in favour of "program" and "code".
• The instruction versus instruction handler rule is now a boxout, naming where readers meet the collision.
• "ingredients" became "seeds", glossed as "(the inputs)" at first use.
• The PDAs chapter opens from ATAs, generalising from what the reader already uses.

Typography

Justified text absorbed long unbreakable identifiers into the word spaces of the line before, and the book has 127 inline code spans of 24+ characters. The worst measured about eight times the normal word space. Inline code now carries a break opportunity after underscores, using <wbr> so copied identifiers stay whole and no hyphen appears. A break must leave eight characters behind and carry five over, so test_ never strands.

Also adds npm run preview, which rasterises the page carrying a given phrase, so typography can be looked at rather than argued about.

Verification

npm run lint and npm run build-pdf clean, 162 pages. Every handler and test name the manuscript cites was re-checked against the companion repository after the renames: all present, with transfer_checked the one expected outsider since it belongs to SPL.

One caveat worth a human eye: the World Bank figures come from search results reporting their Remittance Prices Worldwide publication rather than from the PDF itself, which returns 403 to automated requests. Consistent across several independent summaries, but worth confirming before print.