Developers
Build on SpiffyVault
SpiffyVault is a BSV wallet that pays people, not addresses. Each user has an identity key on their phone, a payment link, and a BRC-100 payment key. Your web site, web wallet or app can use all three today, with no SDK and no account with us.
What you can build now
| You want to | Use | You need |
|---|---|---|
| Let people sign in with their phone, with no password | Sign in with SpiffyVault (OIAP-v2) | An HTTPS endpoint and an Ed25519 check |
| Take a payment on a page, an invoice or a printed QR code | Payment links and QR codes | The payee's link; nothing on a server |
| Pay SpiffyVault users from a web page, Node.js or Electron, or be paid by them in a page or a service: live, by mailbox while you are away, or by PeerPay | Live payments in JavaScript | npm install @spiffyvault/payments |
| Put the payment step on your checkout page: QR code, app button, progress and paid view | Checkout widget | npm install @spiffyvault/payments and a payee on your server |
| Pay a SpiffyVault user from a web wallet or a BRC-100 wallet, or get paid by one | BRC-100 PeerPay | A BRC-100 wallet and @bsv/message-box-client |
| Let an AI agent on the user's computer check and spend one wallet | AI agents (MCP) | The desktop app, with agent access turned on |
All of these work with the SpiffyVault app as it is in the stores and on the download page now. @spiffyvault/payments and @spiffyvault/sign-in are on npm (payments 0.3.0, sign-in 0.1.0): a beta for review, testnet only for now. The Payments reference has every detail of the payments package: errors, limits, timers, and the services you trust.
Networks
SpiffyVault releases run on the BSV mainnet, so payments to and from them are real. A payment link names its network, and SpiffyVault refuses to pay a link or a payment key from the other network. Sign-in does not depend on the network.
Coming next
@spiffyvault/payments is ready to try (Live payments in JavaScript), and so is @spiffyvault/sign-in (Sign in with SpiffyVault). @go-ricochet/ricochet, a client for any Ricochet server, is on npm: use it as a relay and as store-and-forward for your web app (mailboxes, documents, collections and feeds). @spiffyvault/payments uses it. Still to come, for browsers, Node.js and Electron:
@spiffyvault/connect: pair a web page with the SpiffyVault app on a phone, for payment approvals and more.
For now, each package's README, on npm and on GitHub, is its reference.
Questions
Write to hello@spiffyvault.net. Tell us what you are building: it helps us choose what comes first.