fix little arrows

Author: sirdeggen

docs/assets/diagrams/brc100-wallet-flows.svg

@@ -20,7 +20,7 @@ Utility libraries and helper tools for common BSV operations. Includes high-leve
 |---------|---------|
 | [@bsv/simple](simple.md) | High-level wallet API for browser and server — manage payments, tokens, inscriptions, DIDs, and credentials |
 | [@bsv/wallet-helper](wallet-helper.md) | Fluent transaction builder for explicit wallet-backed transactions, BRC-29 derivation, and ordinal support |
-| [@bsv/templates](templates.md) | Low-level script templates (OpReturn, MultiPushDrop, P2MSKH) with lock/unlock patterns |
+| [@bsv/templates](templates.md) | Predefined ScriptTemplate examples for protocol engineers, including OpReturn, MultiPushDrop, and P2MSKH lock/unlock patterns |
 | [@bsv/did-client](did-client.md) | DID client for creating, revoking, and querying on-chain DIDs with overlay broadcast |
 | [@bsv/amountinator](amountinator.md) | Multi-currency converter (SATS↔BSV↔15+ fiat) with exchange rate caching |
 | [@bsv/fund-wallet](fund-wallet.md) | CLI faucet for funding wallets from Metanet Desktop during development and testing |

docs/assets/diagrams/stack-layers.svg

@@ -3,8 +3,8 @@ id: packages-index
 title: Packages
 kind: meta
 version: "n/a"
-last_updated: "2026-04-28"
-last_verified: "2026-04-28"
+last_updated: "2026-04-30"
+last_verified: "2026-04-30"
 review_cadence_days: 30
 status: stable
 tags: ["packages"]
@@ -27,7 +27,7 @@ ts-stack contains 27 production-ready packages organized into 7 domains. Each do
 **Key management, balance tracking, signing — local or via wallet service.**
 
 - [@bsv/wallet-toolbox](./wallet/wallet-toolbox.md) — BRC-100 wallet client library
-- [@bsv/btms](./wallet/btms.md) — Binary Token Management System (token issuance and transfer)
+- [@bsv/btms](./wallet/btms.md) — Basic Token Management System for token issuance, transfer, receiving, burning, and ownership proofs
 - [@bsv/btms-permission-module](./wallet/btms-permission-module.md) — Token permission checking
 - [@bsv/wallet-relay](./wallet/wallet-relay.md) — Broadcast and query wrapper for wallet synchronization
 
@@ -59,17 +59,22 @@ ts-stack contains 27 production-ready packages organized into 7 domains. Each do
 
 ### Middleware
 
-**Drop-in Express middleware for payment-gating and identity verification.**
+**HTTP authentication and payment-gating packages.**
+
+Authenticated Express middleware stack:
 
 - [@bsv/auth-express-middleware](./middleware/auth-express-middleware.md) — Verify identity signatures in Express
-- [@bsv/payment-express-middleware](./middleware/payment-express-middleware.md) — Gate routes behind payment requirements
-- [@bsv/402-pay](./middleware/402-pay.md) — HTTP 402 payment handler
+- [@bsv/payment-express-middleware](./middleware/payment-express-middleware.md) — Gate authenticated Express routes behind payment requirements; requires `@bsv/auth-express-middleware`
+
+Independent HTTP 402 flow:
+
+- [@bsv/402-pay](./middleware/402-pay.md) — HTTP 402 payment handler designed to work without auth middleware
 
 ### Helpers
 
 **Shared utilities, codecs, templates, and adapters.**
 
-- [@bsv/templates](./helpers/templates.md) — Template system for OP_RETURN inscriptions
+- [@bsv/templates](./helpers/templates.md) — Predefined `ScriptTemplate` examples for protocol engineers; `OpReturn` is one template among several
 - [@bsv/did-client](./helpers/did-client.md) — DID resolver (Decentralized Identifiers)
 - [@bsv/simple](./helpers/simple.md) — Simplified API for common operations
 - [@bsv/wallet-helper](./helpers/wallet-helper.md) — Wallet utility functions

docs/packages/helpers/index.md

@@ -2,7 +2,7 @@
 id: domain-middleware
 title: Middleware
 kind: reference
-last_updated: "2026-04-28"
+last_updated: "2026-04-30"
 version: "n/a"
 last_verified: "2026-04-28"
 review_cadence_days: 90
@@ -12,12 +12,12 @@ tags: [packages, middleware]
 
 # Middleware Domain
 
-Express.js middleware and client utilities for adding cryptographic authentication and micropayment gating to HTTP services. Implements BRC-103 mutual authentication over HTTP (BRC-104) and HTTP 402 Payment Required (BRC-121) for monetizing APIs with Bitcoin SV micropayments.
+Express.js middleware and client utilities for adding cryptographic authentication and micropayment gating to HTTP services. There are two distinct payment paths: `@bsv/payment-express-middleware` layers payment requirements on top of authenticated Express routes, while `@bsv/402-pay` is an independent HTTP 402 flow that can work without auth middleware.
 
 ## Packages
 
 | Package | Purpose |
 |---------|---------|
 | **@bsv/auth-express-middleware** | Express middleware implementing BRC-103 peer-to-peer mutual authentication via BRC-104 HTTP transport. Verify request signatures, attach verified identity to req.auth, and optionally exchange verifiable certificates. |
-| **@bsv/payment-express-middleware** | Express middleware for HTTP 402 Payment Required micropayment gating. Builds on top of BRC-103 auth middleware to require BSV satoshi payments derived using BRC-29 key derivation. |
-| **@bsv/402-pay** | Client-side and server-side HTTP 402 payment handler. Auto-pay 402 responses on the client; validate and accept payments on the server with caching and replay protection. |
+| **@bsv/payment-express-middleware** | Express middleware for HTTP 402 Payment Required micropayment gating. Requires `@bsv/auth-express-middleware` first, then derives payment requirements from the authenticated identity context. |
+| **@bsv/402-pay** | Independent client-side and server-side HTTP 402 payment handler. Auto-pay 402 responses on the client; validate and accept payments on the server with caching and replay protection, without requiring auth middleware. |