Reference Wallet Overview

packages/direct-spend-wallet is the reference wallet integration for the bounded direct-spend lane.

It is not the protocol definition.

Wallet Responsibilities

• runtime invocation and host-side checks
• transaction assembly/sign/broadcast orchestration
• continuation source selection and persistence
• receive-path candidate scan/decrypt/validate/persist
• truthful evidence and observability artifact output

Canonical Boundary Files

• packages/direct-spend-wallet/src/live/chipnet_runner_v1.ts
• packages/direct-spend-wallet/src/live/chipnet_runner_cli_v1.ts
• packages/direct-spend-wallet/src/evidence/chipnet_run_artifacts_v1.ts
• packages/direct-spend-wallet/src/recovery/receive_path_v1.ts
• packages/direct-spend-wallet/src/state/sender_entry_state_v1.ts

Integrator Examples

• Integration Example (TypeScript)
• Supplemental Economics Example
• Direct-Spend Sequence