cashu-fault-lab
v0.3.0
Published
Deterministic Cashu payment delivery fault injection and recovery evidence
Downloads
364
Readme
Cashu Fault Lab CLI
Test Cashu payment retries and collect redacted recovery evidence without cloning the repository.
Requirements
- Node.js 24
- Docker with Docker Compose
Quick start
npx --yes [email protected] doctor
npx --yes [email protected] demoThe demo retries a lost HTTP response and checks for one durable credit. It writes redacted
JSON/HTML evidence and removes its isolated stack unless you pass --keep.
Useful commands:
npx --yes [email protected] ls
npx --yes [email protected] inspect retry/response-lost
npx --yes [email protected] adapter init --language typescript --name my-wallet
npx --yes [email protected] adapter preflight --adapters adapter-manifest.json
npx --yes [email protected] adapter preview --adapters adapter-manifest.json --sender my-wallet --receiver my-wallet
npx --yes [email protected] wallet-doctor check artifacts/wallet-doctor/capture.json
npx --yes [email protected] nutzap run crash-after-swap --seed demoAdapter preflight and preview accept loopback HTTP origins only. Preview runs response-loss and duplicate-delivery checks for one exact pair, starts its local fault gateway automatically, and writes a redacted feedback bundle. The bundle is diagnostic evidence, not release qualification.
Version 0.3 adds NIP-61/NIP-60 recovery, key rotation, NIP-65 routing and NUT-26 checks. Nutzap runs simulate a mint by default; funded CDK cases need separately built Rust binaries. Strict conformance exposes known SDK gaps.
Cashu Fault Lab 0.3 is an experimental developer preview, not a certification that a wallet is production-safe.
Full documentation: https://www.cashulabs.online/
Source and issues: https://github.com/GautamBytes/cashu-fault-lab
