Phone and desktop apps
Release notes
What changed in each release of SpiffyVault, newest first. From 0.4.2, the phone and desktop apps come from the same release. Get the latest release.
SpiffyVault 1.0.1
Build 23 (1.0.0) released 16 November 2026 on TestFlight and Google Play. Build 24 for macOS, Windows and Linux released 17 November 2026.
BSV mainnet
- SpiffyVault now runs on the BSV mainnet, with real money. Wallets you made on the testnet in an earlier release stay on your device, untouched, but this release does not show them.
- The Terms and the Privacy Policy no longer describe a testnet beta. The Terms have a new section 17 for apps downloaded from Apple's App Store.
Getting ready faster
- A new install starts from the block headers built into the app, so it is ready in minutes. The older headers are downloaded afterwards, in the background.
- On a phone, the older headers are downloaded on Wi-Fi only, unless you turn on Download block history on mobile data in Settings.
- Settings > Advanced > Block headers shows how far your wallet's copy of the block headers has got, and where it comes from.
- The banner shown while the app got ready is gone. The status line shows Synced when the app has caught up, and progress counts from where the app started, so it no longer stops at 99%.
Other changes
- Money that waits for the next block now says waiting for a block, not on the way. On the desktop, click a balance for an explanation.
- Connections to other devices no longer drop after 5 quiet minutes.
- If the wallet's background process stops unexpectedly, the app starts it again.
- An offline payment that its wallet no longer knows is no longer followed.
- The macOS app needs macOS 13 or later.
Known limits
- Use each identity on one device only.
- A backup holds the data of the current identity only.
SpiffyVault 1.0.0
Builds 20 and 21 released 25 October 2026, build 22 on 6 November 2026, on TestFlight and Google Play. Build 22 for macOS, Windows and Linux released 7 November 2026.
Getting paid
- Scan on an address you shared finds a payment as soon as it is sent. It shows as on the way until the next block. Before, it showed only once a block held it.
- A payment someone sent you that the network does not know is sent to the network again. If the network refuses it, it no longer counts as on the way.
- A payment from a wallet built on the BSV SDK, such as a shop's till, is accepted when the payments before it were in the same block.
- When two people pay you at once, each gets their own invoice.
- A payment left in your mailbox is recorded with the amount that arrived, not the amount the payer wrote.
Paying
- A payment that you made but that never reached the payee is released, and the app pays another way.
- A direct payment that your wallet still holds can be reclaimed from its details.
- A payment link with no mailbox key for the payee is paid by PeerPay, when the link has the payee's BRC-100 key.
- A payment link that opens the app waits until your wallet is ready.
- The pay screen says a link is Unchanged since the payee made it when its signature checks out.
- A link that starts with
http://is shown as a broken link, not as a payment.
Sign in with SpiffyVault
- Each website gets its own key, and every step is signed. You type the 6-digit code that the website shows in your browser.
- A sign-in can start from the scanner on Home. In the sign-in sheet, the code's last digit puts the keyboard away, and Done approves.
Safety and privacy
- Report and Block other people from the ⋮ menu on their contact page, a directory result or the pay screen. Settings > Blocked people lists the people you blocked.
- Payments left in a mailbox are sealed with a new scheme, one session for each payment, checked by an outside cryptography review.
Other changes
- After a restore, the wallet that was active before is active again.
- Share link and Share key open the share sheet on iPad and on iOS 26.
- The network screens are together under Settings > Advanced.
Known limits
- Testnet only.
- Use each identity on one device only.
- A backup holds the data of the current identity only.
SpiffyVault 0.4.2
Released 23 October 2026
Lock coins
- Lock coins (wallet menu): lock an amount until a block that you choose. The coins stay in your wallet, but nobody can spend them before that block, not even you.
- The wallet shows a Locked coins card: how much is locked, when the next lock opens, and how much you can unlock now. Tap it to see every lock.
- Unlock sends an open lock back to your wallet. A lock that holds less than the fee to unlock it is shown apart, without an Unlock button.
- A wallet that you import from its recovery phrase finds the coins that it locked with HODLocker, also the ones locked to a RelayX paymail key.
Importing a wallet
- A wallet with many transactions imports to the end. Before, the import could stop on a transaction with many inputs.
- The import gets the earlier transactions it needs in parallel, so it is faster.
- New installs keep their wallet history in about one eighth of the space.
15 languages
- Settings > Language: English, Afrikaans, Arabic, Simplified Chinese, Hindi, Indonesian, Japanese, Korean, Brazilian Portuguese, Latin American Spanish, Thai, Urdu, Vietnamese, isiXhosa and isiZulu.
- Arabic and Urdu read from right to left. Dates, times, numbers and amounts follow your language.
- When something fails, the screen says what failed and why. The full error text is under Details.
Wallets
- The home carousel has an Add wallet card after your last wallet.
- Transaction history shows each payment's status as a badge above the amount.
- Transaction details show a lock's address and the block it opens at.
Connections
- A new network transport: connections recover from short gaps in mobile coverage instead of closing, and larger messages get through on mobile networks.
- A device behind a carrier's NAT can be reached again soon after its relay connection drops. Before, this could take up to an hour.
Known limits
- Testnet only.
- The Windows installer is not code-signed.
- Linux needs
libsecret(installed on most desktops) for the app to keep its keys. - Use each identity on one device only.
- A backup holds the data of the current identity only.
SpiffyVault 0.4.1
Released 20 October 2026
Get paid to an address
- Get paid > Get paid to a bitcoin address shows a new address each time, for payers whose wallet only pays to an address.
- After you share an address, the wallet offers to Scan it for coins that arrived.
Balances
- Each balance shows what you can spend now, and what is still on the way: payments with no proof yet, and the change from your last payment. You can spend them after the next block.
- A payment from one of your wallets to the same wallet shows what it moved, not a loss.
Payments
- A payment that the payee broadcast elsewhere is settled when its proof arrives.
- A payment that you reclaimed reads Reclaimed. A restore gives your wallets back the keys of the payments they made.
- Testnet payments are broadcast through the BSV Association's Arcade.
SpiffyVault 0.4.0
Released 14 October 2026
Make a new backup on a Mac
Backups made on a Mac with SpiffyVault 0.2.3 to 0.3.2 do not hold your wallet keys. After you update, open Settings > Back up and make a new backup. The Back up screen now names any wallet whose key is missing.
Backups
- Back up asks where to keep the copy: save it to a folder, or send it to another app.
- A backup now keeps the payment keys you published and the offline payments you sent, so a restore can still receive and reclaim them.
- On macOS, backups hold the wallet keys again.
- If the app's data is deleted but the keychain still holds your identity, the app opens with Welcome back: restore from a backup, continue without one, or start fresh.
Paying
- Pay first asks how: a contact, another of your wallets, a BRC-100 payment key, or a BSV address.
- Payments send their change in parts, to new addresses, and spend smaller coins first, so one payment shows less of your balance.
- Receive in parts (wallet menu): a payment from a contact can arrive split over several one-time addresses. Off, automatic, or 2 to 5 parts, set per wallet.
- Coins (wallet menu): see how the balance is spread over coins, and split the ones that stand out.
- Transaction details: Copy BEEF copies the transaction with its proof chain, mined or not.
- An offline payment to a payment key that this device did not know about now finds the wallet that issued the key.
BRC-100 wallets
- The default message box is now
messagebox.bsvblockchain.tech, the one BRC-100 wallets use. Payments that wait on the old message box are still collected until 14 November. - Settings > Network > BRC-100 message box: see the message box in use, or choose another. A message box used before is still read for 30 days.
- Advertise my message box (Directory & privacy) tells BRC-100 wallets where to find your message box, through the BSV overlay. It works on mainnet only, so it is not available in this testnet beta.
Desktop
- Dialogs are no wider than 480 px. Export identity and Get paid open as dialogs.
- A deleted wallet leaves the wallet list at once.
Under the hood
- The wallet library is now libspiffy 5.5.0, used only through its public interface.
- The Privacy Policy is updated (effective 14 October 2026): backups, payment links, agent access and the BRC-100 message box.
Known limits
- Testnet only.
- The Windows installer is not code-signed.
- Linux needs
libsecret(installed on most desktops) for the app to keep its keys. - Use each identity on one device only.
- A backup holds the data of the current identity only.
SpiffyVault 0.3.2
Released 7 October 2026
A readable recovery phrase for a new wallet
- After you create a wallet, its recovery phrase is hidden until you click to reveal it, as in Export Mnemonic. The 12 words are numbered and use your theme's colours, so they can be read in every theme. Before, the phrase could be white text on a light box.
- I Have Backed It Up works once you have seen the phrase.
Payments
- The payment screen checks your amount against the wallet's current balance, also when the balance changes while the screen is open.
- Offline payments: a reclaim that loses a race against the payee's own broadcast no longer leaves the payment stuck as "being reclaimed".
Under the hood
- Updated peer-to-peer networking (libp2p 4.5.0). The app now finds out whether its network uses a symmetric NAT; behind one, it tries a direct connection once instead of three times, which saves data.
- The wallet library is now libspiffy 4.1.0. All libraries come from their published releases.
Known limits
- Testnet only.
- The Windows installer is not code-signed.
- Linux needs
libsecret(installed on most desktops) for the app to keep its keys. - Use each identity on one device only.
SpiffyVault 0.3.1
Released 7 October 2026
Fixed: a new install could not be paid until it was restarted
- After a fresh install, the first wallet you created did not become the active wallet. Until the app was restarted, other SpiffyVault users could not pay you: they saw "your contact's app has not published an offline payment key yet". The first wallet is now active at once.
- If you are on 0.3.0 and nobody can pay you, open All wallets and click Make active on your wallet, or restart the app.
Fixed: making a wallet active again
- After you made another wallet active (for example your Agent wallet), the previous wallet could not be made active again until you restarted. The Active label and Set as Active now follow the active wallet everywhere.
Rename a wallet
- Click a wallet's name at the top of its page, type the new name, and press Enter. Esc keeps the old name. You can also choose Rename in the wallet's ⋯ menu.
- The new name is kept in the wallet and in your backups.
Known limits
- Testnet only.
- The Windows installer is not code-signed.
- Linux needs
libsecret(installed on most desktops) for the app to keep its keys. - Use each identity on one device only.
SpiffyVault 0.3.0
Released 6 October 2026
AI agents can use a wallet you give them
- Mark a wallet as an Agent wallet (when you create it, or from the wallet menu: Wallet kind). Only an Agent wallet can be given to agents; your other wallets stay out of reach.
- Settings > Agent access runs a local MCP server on this computer only. Each agent gets its own key and one of three levels: Read, Prepare (it drafts payments, you send them) or Pay.
- Limits you set on the Agent wallet: the most per payment, per day, per week and per hour, who it may pay (your contacts, approved keys, or anyone), and when you are asked first (above an amount, or the first payment to someone).
- When you are asked, the agent waits while you decide. You have 10 minutes; the limits are checked again before it pays.
- Agents can ask to be paid: a payment link with a short reference, an expiry, and a status the agent can follow (open, paid, expired, cancelled). A payment that quotes the reference goes into the Agent wallet, also when it waits in your mailbox while this computer is off. The link does not name your wallet.
- An agent paying a link with an amount pays exactly that amount.
- A new Agents section in the sidebar:
- Requests: what waits for you (approvals and drafts), and every payment request with its progress, QR code and timeline.
- Activity: everything agents did, in plain words, with the rule that allowed, asked or refused each payment. Filter by agent and period, export as CSV, or pause all agents at once.
- Connect Claude Desktop with the downloadable
SpiffyVault.mcpb, or other agents with the presets in the connect dialog.
Move money between your wallets
- Move money on a wallet sends coins to another of your wallets, without a contact or a code.
Payments
- Payments arrive at once: the app reads the right mailbox folder when it is told a payment is there, and reconnects to the server as soon as a connection closes.
- The payer's note now travels with every payment, and shows in the transaction details, the inspector and the chat.
- Amounts can be typed in sats or BSV.
- Offline payments: the reclaim list asks the network first, offers Reclaim only after 3 days, and shows the result on each row. A payment the recipient already has shows as Collected. A payment whose coin was already spent fails at once, with nothing held.
- Safer across networks: an invoice names its network and the payer refuses one for the other network; payment keys and mailbox folders are kept apart per network.
Contacts
- Advanced networking at the foot of a contact page shows how you are linked (direct or relayed), with the network tests.
Under the hood
- On macOS, the app's databases no longer grow far past the space their data needs.
- Updated peer-to-peer networking (libp2p 4.3.0). The app checks how other peers can reach it once a minute instead of every 5 seconds, and no longer runs those checks for other peers.
Known limits
- Testnet only.
- The Windows installer is not code-signed.
- Linux needs
libsecret(installed on most desktops) for the app to keep its keys. - Use each identity on one device only.
- Agent access runs on the desktop app only.
SpiffyVault 0.2.3
Released 4 October 2026
Backup and restore
- Settings > Back up makes one backup file with everything needed to get your vault back: every wallet with its keys and full history, payments received through PeerPay and offline payments (with the details needed to spend them), your contacts, and your profile with its photos. Block headers are left out; the app downloads them again.
- The file is locked with your identity phrase. Keep the two apart: anyone with both holds every wallet. Save the file wherever you like (Files, Drive, a USB stick). It is never sent to us.
- Settings > Restore from a backup brings it back. Wallets come back exactly as they were, beside any wallets already on the device.
- A backup opens only with the phrase of the identity that made it. On a device that already has an identity, import that identity and switch to it first.
A first start that asks first
- A new install no longer makes an identity on its own. It shows a Welcome screen: Create a new vault, or Restore. Nothing is created or sent anywhere until you choose.
- Restore takes your identity phrase and your backup file, shows what the backup holds, restores it before anything starts, and then shows what came back.
- A new startup screen shows what the app is doing, and starts faster.
Wallets and payments
- You can create a wallet while the first block-header download is still running. A banner says when that download is in progress and wallet features are limited.
- "Synced" now means caught up with the network.
- Offline payments that are still waiting can be reviewed and reclaimed from the start, and only for the current network.
- A payment to a contact on the other network says so.
- The wallet and databases shut down cleanly when you quit.
Identities
- Deleting an identity now removes it completely: the app switches away from it first, then deletes its keys and data. Destroying an identity also deletes everything it published.
- An imported identity shows in the list at once.
Known limits
- Testnet only.
- The Windows installer is not code-signed.
- Linux needs
libsecret(installed on most desktops) for the app to keep its keys. - Back up once after updating: backups from earlier versions don't hold your wallet keys or PeerPay and offline payments.
SpiffyVault 0.2.2
Released 3 October 2026
Update notices
- SpiffyVault now tells you when a newer version is out: a banner on Overview (and the home screen), with a link to the download page. Dismiss it and it stays dismissed for that version.
- The check is private by design. Once a day, at a random time, the app reads the release information on download.spiffyvault.net. The request is the same from every copy of the app: no identifier, no version, nothing about your device. The release information is signed, and the app ignores any that doesn't check out. The app never downloads or installs anything itself.
- Settings > Updates shows your version and the latest release, checks on demand, and turns the check off. On macOS, SpiffyVault > Check for Updates… does the same.
Also
- The About screen shows the real version.
- The in-app Privacy Policy describes the update check.
Known limits
- Testnet only.
- The Windows installer is not code-signed.
- Linux needs
libsecret(installed on most desktops) for the app to keep its keys. - 0.2.1 and earlier don't have the update check, so they won't announce this release.
SpiffyVault 0.2.1
Released 3 October 2026
Secure messaging keys and offline payments
- Looking up a contact's secure messaging keys could report "no prekeys published" when they were there. Fixed, and when a lookup does find nothing, the contact screen now says why.
- Your secure messaging keys stay readable by contacts: they are no longer left unreadable after the app reconnects, and an unreadable set is repaired the next time they are published.
- Switching identity no longer lets the previous identity's keys be published under the new one.
Staying findable
- If the server loses what you published (your profile, payment key, payment anchor, directory listing or secure messaging keys), the app puts it back by itself, within a minute of starting and every 30 minutes after.
- The app reaches its server as ricochet.spiffyvault.net instead of a fixed IP address.
Profile
- Remove your profile photo or banner: a delete button beside the photo's camera, and labelled Remove banner / Change banner buttons. Contacts on 0.2.1 see the removal too.
- On the desktop, the profile editor opens as a dialog instead of filling the window.
- An identity that is not the active one now shows its photo, banner and name.
Known limits
- Testnet only.
- The Windows installer is not code-signed.
- Linux needs
libsecret(installed on most desktops) for the app to keep its keys. - Contacts still on 0.2.0 keep showing a photo or banner you removed until they update.
SpiffyVault 0.2.0
Released 3 October 2026
A desktop app, not a phone app in a window
- A unified toolbar and a sidebar of Overview, Activity, Contacts, Wallets, Profile and Settings, with back and forward history.
- Contacts as a payment chat: pick a contact and see, and send, every payment between you.
- Wallets as a three-pane view with filters, keyboard navigation and a transaction inspector; a split Send button.
- A ⌘K / Ctrl+K command palette over actions, wallets, contacts and payments; a full menu bar and keyboard shortcuts; right-click, Control-click or the ⋯ button for row actions.
- Desktop layouts for transaction, profile and contact detail, settings in a sidebar, and dialogs in place of phone sheets.
- On macOS, a small startup window that grows into the main window, which remembers its size and position.
Payments
- Send to a BSV address, as well as to contacts.
- BRC-100 interoperability: a BRC-100 payment key, PeerPay payments to and from BRC-100 wallets, and BRC-100 keys as conversations in Contacts.
- Your payment key can be published to your profile, signed by your identity and by the key itself, so contacts can pay it over PeerPay from the normal payment screen. Turn it off under Settings > Directory & privacy.
- Offline payments land in the active wallet: the payment anchor is republished the moment you switch wallets. Payments a payee never collects can be reclaimed.
- Wallet lists, badges and the home ledger refresh as payments arrive; a new payment shows in the wallet at once.
Also
- New SpiffyVault icons on every platform; in-app Terms of Use and Privacy Policy; theme previews.
- Mainnet and regtest are switched off for the beta.
Known limits
- Testnet only.
- The Windows installer is not code-signed.
- Linux needs
libsecret(installed on most desktops) for the app to keep its keys.