docs-codeblock-audit.md

Docs Code Block Audit

Archived manual evidence. This 312-block snapshot is not a current compiler or freshness guarantee. Current documentation is gated by frontmatter/link/render checks, generated fact checks, package artifact consumers, and the package README contract. New executable example checks must be automated rather than marked complete in this file.

Generated from fenced code blocks under docs/. Total blocks: 312.

Status key: ✅ = checked against local source/package docs/tests and patched if needed.

docs/about/contributing.md

• ✅ CB-0001 (bash) [30-33] 1. Clone the Repository — git clone https://github.com/bsv-blockchain/ts-stack
• ✅ CB-0002 (bash) [37-39] 2. Install Dependencies — pnpm install
• ✅ CB-0003 (plain) [45-52] 3. Explore the Structure — ts-stack/
• ✅ CB-0004 (bash) [58-60] Create a Feature Branch — git checkout -b feature/your-feature-name
• ✅ CB-0005 (typescript) [81-92] Make Changes — /**
• ✅ CB-0006 (bash) [96-108] Run Tests — # Unit tests
• ✅ CB-0007 (bash) [112-118] Lint Code — # Check linting
• ✅ CB-0008 (bash) [124-130] Build Packages — # Build all packages
• ✅ CB-0009 (bash) [138-155] Adding Conformance Vectors — # Create vector file
• ✅ CB-0010 (bash) [161-163] 1. Push Your Branch — git push origin feature/your-feature-name
• ✅ CB-0011 (markdown) [176-198] 2. Create PR on GitHub — ## Description
• ✅ CB-0012 (typescript) [208-215] Imports — // Good — import specific exports from the top-level or subpath
• ✅ CB-0013 (typescript) [219-231] Naming — // Good
• ✅ CB-0014 (typescript) [235-246] Error Handling — // Good
• ✅ CB-0015 (bash) [258-262] Testing Requirements — pnpm test
• ✅ CB-0016 (markdown) [276-294] Reporting Issues — ## Bug Report
• ✅ CB-0017 (plain) [314-319] Commit Message Format — type(scope): subject
• ✅ CB-0018 (plain) [333-338] Commit Message Format — feat(brc100): add getBalance method

docs/about/doc-agent.md

• ✅ CB-0019 (yaml) [21-33] Frontmatter Schema — ---
• ✅ CB-0020 (yaml) [69-78] Version Management — # For package docs
• ✅ CB-0021 (bash) [84-93] Version Checking — # Check workspace cross-package versions
• ✅ CB-0022 (yaml) [99-101] Review Cadence — review_cadence_days: 30 # Review monthly
• ✅ CB-0023 (plain) [114-116] Staleness Calculation — stale_date = last_verified + review_cadence_days
• ✅ CB-0024 (plain) [119-123] Staleness Calculation — last_verified: "2026-04-28"
• ✅ CB-0025 (bash) [133-136] Update Package Version — pnpm sync-versions
• ✅ CB-0026 (bash) [144-150] Verify Documentation — pnpm --filter docs-site validate
• ✅ CB-0027 (bash) [162-167] Extract API Docs — pnpm --filter @bsv/sdk doc
• ✅ CB-0028 (yaml) [184-193] GitHub Actions — - name: Check doc staleness
• ✅ CB-0029 (markdown) [207-223] Edit a Doc Page — ---
• ✅ CB-0030 (markdown) [235-251] Create a New Page — ---
• ✅ CB-0031 (bash) [257-263] Frontmatter Validation — # Validate frontmatter and relative links
• ✅ CB-0032 (yaml) [276-288] Spec Page — ---
• ✅ CB-0033 (yaml) [292-304] Package Page — ---
• ✅ CB-0034 (yaml) [308-320] Guide Page — ---

docs/about/versioning.md

• ✅ CB-0035 (plain) [19-23] Version Format — MAJOR.MINOR.PATCH
• ✅ CB-0036 (plain) [34-38] Stable Packages (status: stable) — @bsv/sdk@1.2.3
• ✅ CB-0037 (plain) [46-49] Beta Packages (status: beta) — @bsv/wab-server@0.2.1
• ✅ CB-0038 (plain) [64-69] Support Windows — @bsv/sdk@1.x.x — Supported (bug fixes)
• ✅ CB-0039 (yaml) [77-84] Documentation Versioning — ---
• ✅ CB-0040 (plain) [97-102] Staleness — last_verified: "2026-04-28"
• ✅ CB-0041 (json) [126-133] Dependencies — {
• ✅ CB-0042 (bash) [150-153] Publishing — npm install @bsv/sdk@latest # Stable
• ✅ CB-0043 (plain) [165-176] Changelog — ## [1.2.0] - 2026-04-28

docs/architecture/beef.md

• ✅ CB-0044 (plain) [31-36] Wire Format — [0100BEEF version header]
• ✅ CB-0045 (typescript) [74-89] Usage in @bsv/sdk — import { Beef, MerklePath, Transaction, WhatsOnChain } from '@bsv/sdk'

docs/architecture/conformance.md

• ✅ CB-0046 (text) [31-48] Pipeline Flow — TypeScript reference behavior
• ✅ CB-0047 (bash) [70-72] Running The Pipeline — pnpm conformance
• ✅ CB-0048 (bash) [76-78] Running The Pipeline — pnpm conformance --validate-only
• ✅ CB-0049 (bash) [82-84] Running The Pipeline — pnpm conformance --vectors conformance/vectors/wallet/brc100
• ✅ CB-0050 (bash) [88-90] Running The Pipeline — pnpm --filter @bsv/conformance-runner-ts test

docs/architecture/identity.md

• ✅ CB-0051 (plain) [40-50] BRC-31 — HTTP Mutual Authentication Handshake — Client request:

docs/conformance/contributing-vectors.md

• ✅ CB-0052 (json) [36-60] File Format — {
• ✅ CB-0053 (text) [68-73] Naming Rules — sdk.crypto.ecdsa
• ✅ CB-0054 (text) [81-92] Directory Selection — conformance/vectors/
• ✅ CB-0055 (bash) [105-107] Adding A Vector To An Existing File — pnpm conformance --validate-only
• ✅ CB-0056 (bash) [111-113] Adding A Vector To An Existing File — pnpm --filter @bsv/conformance-runner-ts test

docs/conformance/index.md

• ✅ CB-0057 (json) [56-78] Vector Format — {

docs/conformance/runner-ts.md

• ✅ CB-0058 (bash) [21-23] Structural Runner — pnpm conformance
• ✅ CB-0059 (text) [27-29] Structural Runner — conformance/runner/src/runner.js
• ✅ CB-0060 (bash) [48-52] Structural Runner — pnpm conformance --validate-only
• ✅ CB-0061 (bash) [58-60] TypeScript/Jest Behavior Runner — pnpm --filter @bsv/conformance-runner-ts test
• ✅ CB-0062 (text) [64-66] TypeScript/Jest Behavior Runner — conformance/runner/ts/runner.test.ts
• ✅ CB-0063 (bash) [86-88] Debugging A Vector — pnpm conformance --vectors conformance/vectors/wallet/brc100
• ✅ CB-0064 (bash) [92-94] Debugging A Vector — sed -n '1,220p' conformance/vectors/wallet/brc100/getpublickey.json
• ✅ CB-0065 (yaml) [100-114] CI Use — - name: Validate conformance vectors

docs/conformance/vectors.md

• ✅ CB-0066 (text) [21-32] Repository Layout — conformance/vectors/
• ✅ CB-0067 (json) [38-56] Vector Format — {
• ✅ CB-0068 (bash) [121-123] Running Vectors — pnpm conformance
• ✅ CB-0069 (bash) [127-129] Running Vectors — pnpm conformance --validate-only
• ✅ CB-0070 (bash) [133-135] Running Vectors — pnpm conformance --vectors conformance/vectors/wallet/brc100
• ✅ CB-0071 (bash) [139-141] Running Vectors — pnpm conformance --report conformance/runner/reports/results.xml

docs/get-started/choose-your-stack.md

• ✅ CB-0072 (text) [17-32] Choose Your Stack — Browser app using a user's wallet?
• ✅ CB-0073 (bash) [38-40] Browser App — npm install @bsv/simple
• ✅ CB-0074 (typescript) [42-53] Browser App — import { createWallet } from '@bsv/simple/browser'
• ✅ CB-0075 (bash) [63-65] Transaction Builder — npm install @bsv/wallet-helper
• ✅ CB-0076 (bash) [77-79] Server Agent — npm install @bsv/simple
• ✅ CB-0077 (typescript) [81-89] Server Agent — import { ServerWallet } from '@bsv/simple/server'
• ✅ CB-0078 (bash) [97-99] Wallet Builder — npm install @bsv/wallet-toolbox
• ✅ CB-0079 (bash) [113-115] Protocol Engineer — npm install @bsv/sdk

docs/get-started/index.md

• ✅ CB-0080 (bash) [19-21] Step 1: Install — npm install @bsv/simple
• ✅ CB-0081 (typescript) [31-38] Step 2: Connect to a User Wallet — import { createWallet } from '@bsv/simple/browser'
• ✅ CB-0082 (typescript) [46-54] Step 3: Do Something Useful — const recipientIdentityKey = '025706528f0f6894b2ba505007267ccff1133e004452a1f6b72ac716f246216366'
• ✅ CB-0083 (typescript) [58-66] Step 3: Do Something Useful — const created = await wallet.createToken({
• ✅ CB-0084 (typescript) [70-80] Step 3: Do Something Useful — const client = wallet.getClient()
• ✅ CB-0085 (typescript) [86-96] Server Agents — import { ServerWallet } from '@bsv/simple/server'

docs/get-started/install.md

• ✅ CB-0086 (bash) [25-27] Install @bsv/simple — npm install @bsv/simple @bsv/sdk
• ✅ CB-0087 (typescript) [40-43] Browser — import { createWallet, Certifier, DID, Overlay } from '@bsv/simple/browser'
• ✅ CB-0088 (typescript) [47-49] Server — import { ServerWallet, FileRevocationStore } from '@bsv/simple/server'
• ✅ CB-0089 (typescript) [53-55] Server — const { ServerWallet } = await import('@bsv/simple/server')
• ✅ CB-0090 (typescript) [61-64] TypeScript — import type { BrowserWallet } from '@bsv/simple/browser'
• ✅ CB-0091 (typescript) [72-77] Next.js — const nextConfig = {
• ✅ CB-0092 (bash) [93-95] Protocol-Level Work — npm install @bsv/sdk

docs/guides/http-402-payments.md

• ✅ CB-0093 (bash) [41-53] Step 1 — Create server and client projects — # Server
• ✅ CB-0094 (json) [57-66] Client (in separate directory) — {
• ✅ CB-0095 (typescript) [72-138] Step 2 — Set up server wallet and payment middleware — import express from 'express'
• ✅ CB-0096 (typescript) [159-178] Step 4 — Set up client wallet and create 402-pay wrapper — import { create402Fetch } from '@bsv/402-pay/client'
• ✅ CB-0097 (typescript) [190-213] Step 5 — Make authenticated requests with auto-payment — export async function accessFreeContent(fetch402: any) {
• ✅ CB-0098 (typescript) [228-249] Step 6 — Manual payment construction (advanced) — import { constructPaymentHeaders } from '@bsv/402-pay/client'
• ✅ CB-0099 (typescript) [262-311] Putting it all together — import express from 'express'
• ✅ CB-0100 (typescript) [315-346] Putting it all together — import { create402Fetch } from '@bsv/402-pay/client'
• ✅ CB-0101 (bash) [350-358] Putting it all together — # Terminal 1: Server

docs/guides/peer-to-peer-messaging.md

• ✅ CB-0102 (bash) [43-48] Step 1 — Install messaging packages — mkdir my-p2p-app && cd my-p2p-app
• ✅ CB-0103 (typescript) [54-68] Step 2 — Set up a wallet for identity — import { WalletClient } from '@bsv/sdk'
• ✅ CB-0104 (typescript) [76-106] Step 3 — Send a message via MessageBox (HTTP store-and-forward) — import { MessageBoxClient } from '@bsv/message-box-client'
• ✅ CB-0105 (typescript) [118-143] Step 4 — Retrieve messages from inbox — export async function listInboxMessages(
• ✅ CB-0106 (typescript) [155-173] Step 5 — Acknowledge (delete) messages after reading — export async function acknowledgeMessages(
• ✅ CB-0107 (typescript) [181-208] Step 6 — Listen for live messages via WebSocket — export async function listenForLiveMessages(
• ✅ CB-0108 (typescript) [220-246] Step 7 — Use Authsocket for custom WebSocket messaging — import { AuthSocketClient } from '@bsv/authsocket-client'
• ✅ CB-0109 (typescript) [259-327] Putting it all together — import { WalletClient } from '@bsv/sdk'
• ✅ CB-0110 (bash) [331-333] Putting it all together — npx ts-node main.ts

docs/guides/run-overlay-node.md

• ✅ CB-0111 (bash) [43-49] Step 1 — Create Express app and install packages — mkdir my-overlay-node && cd my-overlay-node
• ✅ CB-0112 (json) [53-63] Step 1 — Create Express app and install packages — {
• ✅ CB-0113 (bash) [69-77] Step 2 — Set up environment and configuration — SERVER_PRIVATE_KEY=<your-32-byte-hex-private-key>
• ✅ CB-0114 (bash) [81-83] Step 2 — Set up environment and configuration — node -e "console.log(require('@bsv/sdk').PrivateKey.fromRandom().toHex())"
• ✅ CB-0115 (typescript) [89-126] Step 3 — Initialize OverlayExpress with basic configuration — import OverlayExpress from '@bsv/overlay-express'
• ✅ CB-0116 (typescript) [138-171] Step 4 — Register topic managers — import {
• ✅ CB-0117 (typescript) [183-234] Step 5 — Configure GASP sync and health checks — async function configureAdvanced(server: OverlayExpress) {
• ✅ CB-0118 (typescript) [246-275] Step 6 — Build engine and start the server — async function main() {
• ✅ CB-0119 (bash) [287-292] Step 7 — Advertise via SHIP/SLAP (optional) — # Using curl to trigger advertisement sync (requires admin token)
• ✅ CB-0120 (typescript) [300-374] Putting it all together — import OverlayExpress from '@bsv/overlay-express'
• ✅ CB-0121 (bash) [378-381] Putting it all together — npm install

docs/guides/wallet-aware-app.md

• ✅ CB-0122 (bash) [36-38] Step 1 - Install — npm install @bsv/sdk @bsv/simple
• ✅ CB-0123 (typescript) [44-54] Step 2 - Connect To The User Wallet — import { WalletClient } from '@bsv/sdk'
• ✅ CB-0124 (typescript) [60-67] Step 3 - Use The Simple Browser Helper — import { createWallet } from '@bsv/simple/browser'
• ✅ CB-0125 (typescript) [71-73] Step 3 - Use The Simple Browser Helper — const rawWallet = appWallet.getClient()
• ✅ CB-0126 (typescript) [79-87] Step 4 - Create A Payment — const result = await appWallet.pay({
• ✅ CB-0127 (typescript) [91-111] Step 4 - Create A Payment — import { P2PKH, WalletClient } from '@bsv/sdk'
• ✅ CB-0128 (typescript) [119-130] Step 5 - Create And List Basket Outputs — const token = await appWallet.createToken({
• ✅ CB-0129 (typescript) [134-142] Step 5 - Create And List Basket Outputs — const outputs = await appWallet.getClient().listOutputs({
• ✅ CB-0130 (typescript) [155-163] Step 6 - Choose The Right Runtime — import { ServerWallet } from '@bsv/simple/server'

docs/index.md

• ✅ CB-0131 (typescript) [39-50] Minimal App Example — import { createWallet } from '@bsv/simple/browser'

docs/infrastructure/chaintracks-server.md

• ✅ CB-0132 (plain) [39-46] API — GET /blockHeaderForHeight?height=100
• ✅ CB-0133 (bash) [52-58] Configuration — # Bootstrap from another Chaintracks server

docs/infrastructure/message-box-server.md

• ✅ CB-0134 (bash) [76-91] Run locally — # Install dependencies
• ✅ CB-0135 (bash) [95-110] Deploy to production — # Build Docker image
• ✅ CB-0136 (bash) [118-120] Migrations — npm run migrate

docs/infrastructure/overlay-server.md

• ✅ CB-0137 (bash) [67-82] Run locally — # Install dependencies
• ✅ CB-0138 (bash) [86-106] Deploy to production — # Multi-stage build: Node builder → production runtime

docs/infrastructure/uhrp-server-basic.md

• ✅ CB-0139 (bash) [66-78] Run locally — # Install dependencies
• ✅ CB-0140 (bash) [84-96] Deploy to production — # Build and start

docs/infrastructure/uhrp-server-cloud-bucket.md

• ✅ CB-0141 (bash) [73-85] Run locally — # Install dependencies
• ✅ CB-0142 (bash) [91-104] Deploy to production — # Multi-stage build: pinned Node 24 alpine builder → production runtime

docs/infrastructure/wab.md

• ✅ CB-0143 (bash) [77-95] Run locally — # Install dependencies
• ✅ CB-0144 (bash) [101-132] Deploy to production — # Build Docker image
• ✅ CB-0145 (bash) [138-140] Migrations — npm run migrate

docs/infrastructure/wallet-infra.md

• ✅ CB-0146 (bash) [68-83] Run locally — # Install dependencies
• ✅ CB-0147 (bash) [87-113] Deploy to production — # Multi-stage Docker build: pinned Node 24 alpine → production

docs/packages/helpers/amountinator.md

• ✅ CB-0148 (bash) [24-26] Install — npm install @bsv/amountinator
• ✅ CB-0149 (typescript) [30-43] Quick start — import { CurrencyConverter } from '@bsv/amountinator'
• ✅ CB-0150 (typescript) [59-62] Initialize with auto-refresh — const converter = new CurrencyConverter() // 5-min interval
• ✅ CB-0151 (typescript) [65-69] Convert with auto-detection — const formatted = await converter.convertAmount('5000') // "5000" or "0.1" or "10 USD"
• ✅ CB-0152 (typescript) [72-74] Convert between specific currencies — const usdAmount = converter.convertCurrency(0.1, 'BSV', 'USD') // 6.2 (if rate = 62)
• ✅ CB-0153 (typescript) [77-79] Get preferred currency symbol — const symbol = converter.getCurrencySymbol() // "$" if USD, "€" if EUR
• ✅ CB-0154 (typescript) [82-85] Convert user currency to satoshis — const sats = await converter.convertToSatoshis(10) // If preferred = 'USD', USD→SATS
• ✅ CB-0155 (typescript) [88-93] Static converter (no auto-refresh) — const staticConverter = new CurrencyConverter(0) // refreshInterval = 0

docs/packages/helpers/did-client.md

• ✅ CB-0156 (bash) [24-26] Install — npm install @bsv/did-client
• ✅ CB-0157 (typescript) [30-54] Quick start — import { DIDClient } from '@bsv/did-client'
• ✅ CB-0158 (typescript) [69-80] Create a DID token — const createResult = await didClient.createDID(
• ✅ CB-0159 (typescript) [83-96] Find DID tokens on overlay — const foundDIDs = await didClient.findDID(
• ✅ CB-0160 (typescript) [99-103] Query by outpoint — const byOutpoint = await didClient.findDID({
• ✅ CB-0161 (typescript) [106-114] Revoke DID by serial number — const revokeResult = await didClient.revokeDID({
• ✅ CB-0162 (typescript) [117-125] Pagination and filtering — const page1 = await didClient.findDID({

docs/packages/helpers/fund-wallet.md

• ✅ CB-0163 (bash) [24-26] Install — npm install @bsv/fund-wallet
• ✅ CB-0164 (bash) [30-52] Quick start — # Check balance only
• ✅ CB-0165 (bash) [68-72] Check balance only (no Metanet Desktop needed) — npx fund-metanet \
• ✅ CB-0166 (bash) [75-80] Fund wallet (Metanet Desktop must be running) — npx fund-metanet \
• ✅ CB-0167 (bash) [83-89] Using custom storage provider — npx fund-metanet \
• ✅ CB-0168 (bash) [92-95] Interactive mode — npx fund-metanet

docs/packages/helpers/simple.md

• ✅ CB-0169 (bash) [24-26] Install — npm install @bsv/simple
• ✅ CB-0170 (typescript) [30-43] Quick start — import { createWallet } from '@bsv/simple/browser'
• ✅ CB-0171 (typescript) [60-67] Check wallet balance — const balance = await wallet.getBalance()
• ✅ CB-0172 (typescript) [70-77] Register for MessageBox and send payment — // Register identity handle
• ✅ CB-0173 (typescript) [80-98] Create and transfer tokens — const recipientIdentityKey = '025706528f0f6894b2ba505007267ccff1133e004452a1f6b72ac716f246216366'
• ✅ CB-0174 (typescript) [101-116] Direct payments (BRC-29 derivation) — // Server generates payment request

docs/packages/helpers/templates.md

• ✅ CB-0175 (bash) [24-26] Install — npm install @bsv/templates
• ✅ CB-0176 (typescript) [30-40] Quick start — import { OpReturn } from '@bsv/templates'
• ✅ CB-0177 (typescript) [53-60] Create and decode an OP_RETURN script — import { OpReturn } from '@bsv/templates'
• ✅ CB-0178 (typescript) [63-95] Create MultiPushDrop token with 2 trusted owners — import { SecurityLevel, Utils, type WalletInterface } from '@bsv/sdk'
• ✅ CB-0179 (typescript) [98-124] Create 2-of-3 multisig — import { PublicKey, type WalletInterface } from '@bsv/sdk'

docs/packages/helpers/wallet-helper.md

• ✅ CB-0180 (bash) [28-30] Install — npm install @bsv/wallet-helper
• ✅ CB-0181 (typescript) [34-50] Quick start — import { TransactionBuilder } from '@bsv/wallet-helper'
• ✅ CB-0182 (typescript) [67-75] Multi-output payment with wallet-managed change — const aliceAddress = '1EvmsbpAY7nESLkN4ajLTMbvsaQ1HpJPGX'
• ✅ CB-0183 (typescript) [82-88] Self-controlled output with BRC-29 automatic derivation — await new TransactionBuilder(wallet, "Self-controlled output")
• ✅ CB-0184 (typescript) [91-98] Spend UTXOs and send to recipient — const recipientAddress = '1EvmsbpAY7nESLkN4ajLTMbvsaQ1HpJPGX'
• ✅ CB-0185 (typescript) [101-113] Create 1-sat ordinal with inscription and metadata — const ordResult = await new TransactionBuilder(wallet, "Mint ordinal")

docs/packages/index.md

• ✅ CB-0186 (bash) [96-98] Installation — npm install @bsv/sdk
• ✅ CB-0187 (bash) [102-104] Installation — npm install @bsv/wallet-toolbox @bsv/overlay @bsv/authsocket

docs/packages/messaging/authsocket-client.md

• ✅ CB-0188 (bash) [24-26] Install — npm install @bsv/authsocket-client
• ✅ CB-0189 (typescript) [30-49] Quick start — import { AuthSocketClient } from '@bsv/authsocket-client'
• ✅ CB-0190 (typescript) [65-80] Basic authenticated connection — import { AuthSocketClient } from '@bsv/authsocket-client'
• ✅ CB-0191 (typescript) [84-94] With custom manager options — const socket = AuthSocketClient('http://localhost:3000', {

docs/packages/messaging/authsocket.md

• ✅ CB-0192 (bash) [24-26] Install — npm install @bsv/authsocket
• ✅ CB-0193 (typescript) [30-50] Quick start — import { AuthSocketServer } from '@bsv/authsocket'
• ✅ CB-0194 (typescript) [66-88] Server setup with certificate requests — import { AuthSocketServer } from '@bsv/authsocket'
• ✅ CB-0195 (typescript) [92-102] Receiving authenticated messages — io.on('connection', async (socket) => {

docs/packages/messaging/message-box-client.md

• ✅ CB-0196 (bash) [24-26] Install — npm install @bsv/message-box-client
• ✅ CB-0197 (typescript) [30-57] Quick start — import { MessageBoxClient } from '@bsv/message-box-client'
• ✅ CB-0198 (typescript) [74-87] Listening for live messages — const msgBoxClient = new MessageBoxClient({
• ✅ CB-0199 (typescript) [91-109] Peer-to-peer payments — import { PeerPayClient } from '@bsv/message-box-client'

docs/packages/messaging/paymail.md

• ✅ CB-0200 (bash) [24-26] Install — npm install @bsv/paymail
• ✅ CB-0201 (typescript) [30-46] Quick start — import { PaymailClient, PublicProfileCapability } from '@bsv/paymail'
• ✅ CB-0202 (typescript) [63-101] Server setup — import express from 'express'
• ✅ CB-0203 (typescript) [105-125] Client capability discovery — import { PaymailClient, PublicProfileCapability } from '@bsv/paymail'

docs/packages/middleware/402-pay.md

• ✅ CB-0204 (bash) [24-26] Install — npm install @bsv/402-pay
• ✅ CB-0205 (typescript) [30-64] Quick start — // ===== SERVER SIDE =====
• ✅ CB-0206 (typescript) [89-108] Server low-level API — import express from 'express'
• ✅ CB-0207 (typescript) [112-123] Client manual headers — import { constructPaymentHeaders } from '@bsv/402-pay/client'
• ✅ CB-0208 (typescript) [127-139] Client with cache management — const fetch402 = create402Fetch({

docs/packages/middleware/auth-express-middleware.md

• ✅ CB-0209 (bash) [24-26] Install — npm install @bsv/auth-express-middleware
• ✅ CB-0210 (typescript) [30-52] Quick start — import express from 'express'
• ✅ CB-0211 (typescript) [69-82] Global auth requirement — import express from 'express'
• ✅ CB-0212 (typescript) [86-105] Certificate handling — function onCertificatesReceived(senderPublicKey, certs, req, res, next) {
• ✅ CB-0213 (typescript) [109-113] Per-route protection — app.post('/secure-endpoint', createAuthMiddleware({ wallet }), (req, res) => {

docs/packages/middleware/payment-express-middleware.md

• ✅ CB-0214 (bash) [24-26] Install — npm install @bsv/payment-express-middleware @bsv/auth-express-middleware @bsv/simple
• ✅ CB-0215 (typescript) [30-63] Quick start — import express from 'express'
• ✅ CB-0216 (typescript) [80-100] Basic payment gating — import express from 'express'
• ✅ CB-0217 (typescript) [104-113] Dynamic pricing — const paymentMiddleware = createPaymentMiddleware({
• ✅ CB-0218 (typescript) [117-136] Chained with auth middleware — const app = express()

docs/packages/network/teranode-listener.md

• ✅ CB-0219 (bash) [20-22] Install — npm install @bsv/teranode-listener
• ✅ CB-0220 (typescript) [26-44] Quick start — import { TeranodeListener } from '@bsv/teranode-listener'
• ✅ CB-0221 (typescript) [61-70] Subscribe with callbacks — const listener = new TeranodeListener({
• ✅ CB-0222 (typescript) [74-87] Custom configuration — const listener = new TeranodeListener(
• ✅ CB-0223 (typescript) [91-111] Dynamic topic management — const listener = new TeranodeListener({
• ✅ CB-0224 (typescript) [115-120] Graceful shutdown — const listener = new TeranodeListener(callbacks, config)

docs/packages/overlays/btms-backend.md

• ✅ CB-0225 (bash) [26-28] Install — npm install @bsv/btms-backend
• ✅ CB-0226 (typescript) [32-54] Quick start — import { BTMSTopicManager, BTMSLookupServiceFactory } from '@bsv/btms-backend'
• ✅ CB-0227 (typescript) [70-83] Register in OverlayExpress — import OverlayExpress from '@bsv/overlay-express'
• ✅ CB-0228 (typescript) [87-92] Query tokens by owner — const ownerResults = await lookupService.lookup({
• ✅ CB-0229 (typescript) [96-101] Retrieve metadata — const manager = new BTMSTopicManager()

docs/packages/overlays/gasp.md

• ✅ CB-0230 (bash) [24-26] Install — npm install @bsv/gasp
• ✅ CB-0231 (typescript) [30-101] Quick start — import {
• ✅ CB-0232 (typescript) [117-164] Implement GASPRemote for HTTP communication — import {
• ✅ CB-0233 (typescript) [168-182] Unidirectional (pull-only) sync — const gaspPullOnly = new GASP(
• ✅ CB-0234 (typescript) [186-200] Sequential sync for DB safety — const gaspSequential = new GASP(

docs/packages/overlays/overlay-discovery-services.md

• ✅ CB-0235 (bash) [20-22] Install — npm install @bsv/overlay-discovery-services
• ✅ CB-0236 (typescript) [26-86] Quick start — import { Engine, type LookupService, type Storage, type TopicManager } from '@bsv/overlay'
• ✅ CB-0237 (typescript) [101-106] Validate URIs and names — import { isAdvertisableURI, isValidTopicOrServiceName } from '@bsv/overlay-discovery-services'
• ✅ CB-0238 (typescript) [110-127] Use WalletAdvertiser for publishing — import { WalletAdvertiser } from '@bsv/overlay-discovery-services'
• ✅ CB-0239 (typescript) [131-148] Discover peers via SHIP/SLAP — // After Engine is initialized with tracker URLs

docs/packages/overlays/overlay-express.md

• ✅ CB-0240 (bash) [20-22] Install — npm install @bsv/overlay-express
• ✅ CB-0241 (typescript) [26-46] Quick start — import OverlayExpress from '@bsv/overlay-express'
• ✅ CB-0242 (typescript) [62-71] Basic server setup — const server = new OverlayExpress(
• ✅ CB-0243 (typescript) [75-86] Register multiple topics — server.configureTopicManager('tm_helloworld', new HelloWorldTopicManager())
• ✅ CB-0244 (typescript) [90-106] Configure health checks — server.configureHealth({
• ✅ CB-0245 (typescript) [110-122] Advanced engine options — server.configureEngineParams({

docs/packages/overlays/overlay-topics.md

• ✅ CB-0246 (bash) [20-22] Install — npm install @bsv/overlay-topics
• ✅ CB-0247 (typescript) [26-40] Quick start — import { HelloWorldTopicManager, createHelloWorldLookupService } from '@bsv/overlay-topics'
• ✅ CB-0248 (typescript) [55-78] Register multiple topics in OverlayExpress — import OverlayExpress from '@bsv/overlay-express'
• ✅ CB-0249 (typescript) [82-103] Query by topic — // DID query
• ✅ CB-0250 (typescript) [107-111] Manual topic manager use — const manager = new DIDTopicManager()

docs/packages/overlays/overlay.md

• ✅ CB-0251 (bash) [20-22] Install — npm install @bsv/overlay @bsv/overlay-topics
• ✅ CB-0252 (typescript) [26-60] Quick start — import { Engine } from '@bsv/overlay'
• ✅ CB-0253 (typescript) [76-97] Implementing a TopicManager — import type { TopicManager } from '@bsv/overlay'
• ✅ CB-0254 (typescript) [101-134] Implementing a LookupService — import type { LookupService } from '@bsv/overlay'
• ✅ CB-0255 (typescript) [138-141] Configuring storage with Knex — const storage = new KnexStorage(knex)

docs/packages/sdk/bsv-sdk.md

• ✅ CB-0256 (bash) [24-26] Install — npm install @bsv/sdk
• ✅ CB-0257 (typescript) [30-57] Quick start — import { PrivateKey, P2PKH, Transaction } from '@bsv/sdk'
• ✅ CB-0258 (typescript) [80-106] Build a P2PKH transaction — import { PrivateKey, P2PKH, Transaction } from '@bsv/sdk'
• ✅ CB-0259 (typescript) [110-133] Connect to a BRC-100 wallet — import { P2PKH, WalletClient } from '@bsv/sdk'
• ✅ CB-0260 (typescript) [139-167] Verify SPV with merkle proof — import { Transaction, WhatsOnChain } from '@bsv/sdk'
• ✅ CB-0261 (typescript) [171-191] Encode data on-chain with PushDrop — import { PushDrop, Utils, WalletClient } from '@bsv/sdk'

docs/packages/sdk/index.md

• ✅ CB-0262 (typescript) [58-88] Quick Example — import { PrivateKey, P2PKH, Transaction } from '@bsv/sdk'

docs/packages/wallet/btms-permission-module.md

• ✅ CB-0263 (bash) [25-27] Install — npm install @bsv/btms-permission-module
• ✅ CB-0264 (typescript) [31-51] Quick start — import { createBtmsModule } from '@bsv/btms-permission-module'
• ✅ CB-0265 (typescript) [65-85] Simple prompt with confirm dialog (vanilla JS) — import { createBtmsModule } from '@bsv/btms-permission-module'
• ✅ CB-0266 (typescript) [89-99] Deny-all for programmatic use (no UI needed) — import { createBtmsModule } from '@bsv/btms-permission-module'
• ✅ CB-0267 (typescript) [103-123] Register with wallet permissions manager — import { WalletPermissionsManager } from '@bsv/wallet-toolbox'

docs/packages/wallet/btms.md

• ✅ CB-0268 (bash) [39-41] Install — npm install @bsv/btms
• ✅ CB-0269 (typescript) [45-68] Quick start — import { BTMS } from '@bsv/btms'
• ✅ CB-0270 (typescript) [83-93] Send tokens to recipient — const recipientIdentityKey = '025706528f0f6894b2ba505007267ccff1133e004452a1f6b72ac716f246216366'
• ✅ CB-0271 (typescript) [97-104] Accept incoming token payment — const incoming = await btms.listIncoming()
• ✅ CB-0272 (typescript) [108-115] Burn tokens (permanent destruction) — // Burn specific amount
• ✅ CB-0273 (typescript) [119-136] Prove token ownership for collateral or escrow — const verifierKey = '02c6047f9441ed7d6d3045406e95c07cd85c778e4b8cef3ca7abac09b95c709ee5'

docs/packages/wallet/wallet-relay.md

• ✅ CB-0274 (bash) [21-23] Install — npm install @bsv/wallet-relay
• ✅ CB-0275 (typescript) [29-55] Set up relay server (Express + Node.js) — import express from 'express'
• ✅ CB-0276 (tsx) [59-87] Create session and get QR code (frontend React) — import { useWalletRelayClient } from '@bsv/wallet-relay/react'
• ✅ CB-0277 (tsx) [122-142] Use WalletConnectionModal component — import { WalletConnectionModal } from '@bsv/wallet-relay/react'
• ✅ CB-0278 (typescript) [146-170] Send wallet RPC call from desktop to mobile — import { WalletRelayClient } from '@bsv/wallet-relay/client'
• ✅ CB-0279 (typescript) [174-192] Mobile wallet implementation — import { WalletPairingSession, parsePairingUri } from '@bsv/wallet-relay/client'

docs/packages/wallet/wallet-toolbox-examples.md

• ✅ CB-0280 (bash) [21-23] Install — npm install @bsv/wallet-toolbox-examples

docs/packages/wallet/wallet-toolbox.md

• ✅ CB-0281 (bash) [23-25] Install — npm install @bsv/wallet-toolbox
• ✅ CB-0282 (bash) [29-32] Install — npm install @bsv/wallet-toolbox-client
• ✅ CB-0283 (typescript) [52-66] Source-Backed Setup Pattern — import { Setup } from '@bsv/wallet-toolbox'
• ✅ CB-0284 (typescript) [74-98] Action Flow — export async function createP2pkhOutput(recipientAddress: string) {
• ✅ CB-0285 (typescript) [102-132] Action Flow — export async function finishCustomSpend(args: {

docs/reference/brc-index.md

• ✅ CB-0286 (bash) [143-149] Finding Implementations — # Packages implementing BRC-100

docs/specs/arc-broadcast.md

• ✅ CB-0287 (typescript) [82-106] Example: Submit transaction with SDK — import { Transaction, ARC } from '@bsv/sdk'
• ✅ CB-0288 (typescript) [112-127] Example: Submit transaction with SDK — // POST /arc-callback

docs/specs/authsocket.md

• ✅ CB-0289 (typescript) [77-113] Example: Server setup — import http from 'http'
• ✅ CB-0290 (typescript) [117-141] Example: Server setup — import { MessageBoxClient } from '@bsv/message-box-client'

docs/specs/brc-100-wallet.md

• ✅ CB-0291 (typescript) [54-56] createAction — const result = await wallet.createAction(args)
• ✅ CB-0292 (typescript) [102-112] createAction — const result = await wallet.createAction({
• ✅ CB-0293 (typescript) [118-120] signAction — const result = await wallet.signAction(args)
• ✅ CB-0294 (typescript) [148-156] signAction — await wallet.signAction({

docs/specs/brc-121-402.md

• ✅ CB-0295 (typescript) [75-109] Example: Monetized Express endpoint — import express from 'express'
• ✅ CB-0296 (typescript) [113-125] Example: Monetized Express endpoint — import { create402Fetch } from '@bsv/402-pay/client'

docs/specs/brc-29-peer-payment.md

• ✅ CB-0297 (typescript) [74-93] Example: Send peer-to-peer payment via message box — import { PeerPayClient } from '@bsv/message-box-client'
• ✅ CB-0298 (typescript) [97-112] Example: Send peer-to-peer payment via message box — import { PeerPayClient } from '@bsv/message-box-client'

docs/specs/brc-31-auth.md

• ✅ CB-0299 (typescript) [87-114] Example: Express middleware handshake — import express from 'express'
• ✅ CB-0300 (typescript) [118-130] Example: Express middleware handshake — import { AuthFetch } from '@bsv/sdk'
• ✅ CB-0301 (typescript) [134-157] Example: WebSocket with AuthSocket — import http from 'http'

docs/specs/gasp-sync.md

• ✅ CB-0302 (typescript) [93-194] Example: Sync two overlay nodes — import {

docs/specs/merkle-service.md

• ✅ CB-0303 (typescript) [79-90] Example: Monitor transaction — import { Transaction, WhatsOnChain } from '@bsv/sdk'
• ✅ CB-0304 (typescript) [94-110] Example: Monitor transaction — import { MerklePath, WhatsOnChain } from '@bsv/sdk'

docs/specs/message-box-http.md

• ✅ CB-0305 (typescript) [71-88] Example: Send encrypted message — import { MessageBoxClient } from '@bsv/message-box-client'
• ✅ CB-0306 (typescript) [92-106] Example: Send encrypted message — // 2. Retrieve all messages in inbox
• ✅ CB-0307 (typescript) [110-118] Example: Send encrypted message — // 4. Subscribe to real-time messages

docs/specs/overlay-http.md

• ✅ CB-0308 (typescript) [82-123] Example: Submit transaction to overlay — import { PushDrop, Utils, WalletClient } from '@bsv/sdk'
• ✅ CB-0309 (typescript) [127-139] Example: Submit transaction to overlay — const lookupResponse = await fetch('https://overlay.example.com/lookup', {

docs/specs/storage-adapter.md

• ✅ CB-0310 (typescript) [77-106] Example: Remote wallet over HTTPS — import { SetupClient } from '@bsv/wallet-toolbox'

docs/specs/uhrp.md

• ✅ CB-0311 (typescript) [79-106] Example: Upload and retrieve file — import { StorageUploader, StorageDownloader, WalletClient } from '@bsv/sdk'
• ✅ CB-0312 (typescript) [110-132] Example: Upload and retrieve file — import { LookupResolver } from '@bsv/sdk'