Pass your bitcoin on.
Not lose it.
Free, open-source tools to help your family inherit your bitcoin. No custodian, no KYC, no token. Your seed stays offline, split into encrypted shares only your heirs can put back together.
Help review the codeView on GitHubHow it works
Four steps, all offline where it matters.
Create shares offline
Run vault.js on Tails with networking off. Your seed is split 3-of-5 with Shamir, and each share is encrypted with AES-256-GCM using an Argon2id key from your passphrase.
Store 5 shares apart
Keep the shares in different places or with different trusted people. One or two shares alone reveal nothing.
Heirs recover with 3
Any 3 shares plus the passphrase rebuild the seed, offline on Tails, following the plain-English heir runbook.
Restore to a hardware wallet
The recovered seed goes onto a new hardware wallet, and the funds are moved under the heir's own control.
Works now / Not yet
Honest about where it is.
Works now
- 3-of-5 Shamir shares of a BIP39 seed
- Argon2id + AES-256-GCM encryption
- Fully offline use on Tails
- Heir runbook in plain English
- Timelocked heir recovery on signet: a vault.js seed as the Liana heir key, spent alone after the timelock (test results)
- Own archival Bitcoin Core node (proofs)
- Private, LAN-only Mempool explorer
Not yet
- Multisig
- Timelocks built into vault.js itself
- PSBT signing built into vault.js
- Miniscript inheritance on mainnet
- Independent review completed
vault.js is an unaudited prototype. Do not trust real funds to it yet. Test with fake data only.
Milestones
Proven on signet test coins with no value. Each claim links to its evidence.
24-word heir key signs in Bitcoin Core
6 Nov 2026. A 24-word heir seed made offline by vault.js was imported into Bitcoin Core with a split descriptor. Core signed the Liana recovery alone after the timelock and broadcast it. No single app needed.
6d0560d0a24bdde008bea957cccc885bfd53a53b0ab694081f610b57b3a6bcf3
Heir spends alone after a timelock
2 Nov 2026. A 12-word seed made offline by vault.js create --words 12 was used as the heir key in a Liana inheritance wallet. After the 3-block timelock, the heir alone signed and broadcast the recovery.
3f066cece5a0a3dad0156625fdc3a70986a1102a06a84b993b3c4a13c0e42c7c
First timelock recovery
1 Nov 2026. The heir2 test key signed alone through the CSV recovery path in Liana on signet.
3114c3e5fa76f995be731e1d6e328296c37e6cc1607f1a6489e6f8deae38bcbe
Tests from a contributor
The first outside pull request added an offline fake-data test suite for vault.js. All 86 tests pass on Tails.
Results written up
The method, the dead ends and the lessons are in miniscript-signet-test.md.
Signet only. This is a functional test, not an audit. Do not use real funds.
How it compares
Great projects already exist. Here is where this one fits.
| Project | Custody | KYC | Inheritance approach | Cost | Status |
|---|---|---|---|---|---|
| BTCGuardiansHQ | Non-custodial | None | Off-chain: seed split 3-of-5 (Shamir), Argon2id + AES-256-GCM, offline on Tails | Free, MIT open source | Unaudited prototype, volunteer review wanted |
| Liana | Non-custodial | None stated | On-chain: multisig + timelock recovery path | Varies | Released wallet |
| Nunchuk | Non-custodial | Zero KYC | On-chain: multisig with timelocks | Varies | Released platform |
| Bitcoin Keeper | Non-custodial | No signups (desktop) | On-chain: multisig, wallet timelock, inheritance tools | Free desktop app, open source | Released wallet |
| Casa | Non-custodial | Varies | Multisig with inheritance features | Varies | Commercial service |
| Unchained | Collaborative multisig; also offers qualified custody | Varies | Multisig plus trust / legal setups | Varies | Commercial service |
On-chain tools such as Liana, Nunchuk and Keeper enforce inheritance rules in Bitcoin itself. BTCGuardiansHQ does not do that yet: it protects the seed off-chain. Each approach has trade-offs; pick what fits you.
Why it matters
A lot of bitcoin is lost because nobody planned for what happens next. Free, open, verifiable tools mean any family can plan an inheritance without handing their keys or identity to a company.
Credits
BTCGuardiansHQ stands on the work of others. Thank you.
Liana by Wizardsardine
The open-source miniscript wallet behind every timelocked inheritance test here. Huge thanks to the Wizardsardine team 🙏
Sparrow Wallet
Used to read and check heir keys and their fingerprints.
mempool.space
The open-source explorer behind our private LAN explorer, and how we check our node's block hashes.
Bitcoin Core
Runs our own archival node.
Tails
The offline, amnesic system where vault.js runs.
Bitcoin Stack Exchange
Thanks to Loïc for the Bitcoin Core PSBT method that proved our 24-word heir recovery.
Contributors
Everyone who opened a pull request, filed an issue or reviewed code. See them on GitHub.
These projects are credited for the tools we use. They do not endorse BTCGuardiansHQ.
Get involved
Report a security issue
Please report privately. See SECURITY.md.
Read the heir runbook
Step-by-step recovery for non-technical heirs.
Sponsor
Keeps the work free. No perks, just thanks. GitHub Sponsors, or send bitcoin to:1sXyCoMdHmPi2axsmXqLeNSkRi7RXkfPQ