Wallet

Practical guides for integrating BRC-100 wallet authentication, transactions, keys, encryption, signatures, permissions, and certificates.

Wallet guides cover the practical BRC-100 integration points your app will use after the first quickstart.

Use WalletClient from @bsv/sdk as the normal app entry point:

1import { WalletClient } from '@bsv/sdk'
2
3const wallet = new WalletClient('auto')
4await wallet.waitForAuthentication()

Copied!

Then choose the guide for the capability you need.

Sign HTTP requests with AuthFetch and verify them server-side.

Create, sign, abort, list, and internalize wallet actions.

Request derived public keys and keep private keys inside the wallet.

Encrypt and decrypt app data with wallet-controlled keys.

Create and verify signatures for app protocols.

Design permission prompts that are narrow, understandable, and revocable.

Request, present, and verify selective identity proofs.

Test with more than one BRC-100 wallet path where possible.
Request only the minimum capability needed for the current feature.
Explain permissions in product UI before the wallet prompt appears.
Treat identity keys as stable technical identifiers, not human-readable names.
Never ask users to paste seed phrases, private keys, or recovery material into your app.
Link to the wallet reference for method-level details.