Unaudited prototype · volunteer review open

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 GitHub

How it works

Four steps, all offline where it matters.

01

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.

02

Store 5 shares apart

Keep the shares in different places or with different trusted people. One or two shares alone reveal nothing.

03

Heirs recover with 3

Any 3 shares plus the passphrase rebuild the seed, offline on Tails, following the plain-English heir runbook.

04

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.

How BTCGuardiansHQ compares (checked on each project's own site, Oct 2026)
ProjectCustodyKYCInheritance approachCostStatus
BTCGuardiansHQNon-custodialNoneOff-chain: seed split 3-of-5 (Shamir), Argon2id + AES-256-GCM, offline on TailsFree, MIT open sourceUnaudited prototype, volunteer review wanted
LianaNon-custodialNone statedOn-chain: multisig + timelock recovery pathVariesReleased wallet
NunchukNon-custodialZero KYCOn-chain: multisig with timelocksVariesReleased platform
Bitcoin KeeperNon-custodialNo signups (desktop)On-chain: multisig, wallet timelock, inheritance toolsFree desktop app, open sourceReleased wallet
CasaNon-custodialVariesMultisig with inheritance featuresVariesCommercial service
UnchainedCollaborative multisig; also offers qualified custodyVariesMultisig plus trust / legal setupsVariesCommercial 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

Review the code

Independent volunteer review is wanted. Scope is in REVIEW.md; start at issue #3.

Report a security issue

Please report privately. See SECURITY.md.

Read the heir runbook

Step-by-step recovery for non-technical heirs.

Spread the word

Follow @marcswrth for updates.

Share on X ➜

Sponsor

Keeps the work free. No perks, just thanks. GitHub Sponsors, or send bitcoin to:
1sXyCoMdHmPi2axsmXqLeNSkRi7RXkfPQ