@bsv/wallet-toolbox-examples

Reference wallet implementations built with @bsv/wallet-toolbox. Demonstrates common wallet construction patterns across different storage backends and deployment contexts.

Run from the workspace

This is a private examples workspace, not a supported npm installation target. Follow the workspace README for setup and safety requirements.

Backup example coverage

The SQLite backup example copies sensitive wallet data. It does not back up the root key, establish a retention policy or prove device-loss recovery. Use the complete recovery guide and drill checklist.

Purpose

This package provides runnable example wallets that show how to assemble @bsv/wallet-toolbox's modular components into a complete BRC-100-compliant wallet. Use it to:

• Understand the WalletStorageManager + storage provider composition pattern
• See how to wire Monitor, Services (ARC, Chaintracks), and key managers together
• Copy patterns for your own wallet implementation

When to use this

• Learning how @bsv/wallet-toolbox components fit together
• Bootstrapping a custom wallet implementation from a working reference

When NOT to use this

• Production wallets — use @bsv/wallet-toolbox directly and compose your own setup
• App development — use @bsv/simple/server for automated agents or @bsv/simple/browser for browser apps

Related packages

• @bsv/wallet-toolbox — The modular toolkit these examples use
• @bsv/simple — High-level wrapper for app developers