Security

Keep the three pieces apart, and make your keywords unbreakable.

Legacy's safety rests on two things you control: keeping the three pieces separated, and choosing strong keywords. The cryptography is only as strong as these habits. This page is the checklist for both.

There are three pieces. Each one alone is useless; it takes all three to recover the Bitcoin:

  • The encrypted seed (the Legacy payload / QR)
  • The benefactor key
  • The beneficiary key

Any two of the three reveal nothing. The entire game is making sure no single person, device, account, or location ever holds all three at once.

Secure handling

1

Keep the three pieces in three different places

Never let all three land in one spot — one laptop, one cloud account, one password manager, one safe, one inbox. If a single breach can reach all three, the whole scheme is defeated. Two of three in one place is fine; three is game over.

2

Deliver the beneficiary key on a different channel than the deadman switch

The deadman switch holds two of the three pieces — the encrypted seed and the benefactor key — and releases them when it triggers. That's safe only because the beneficiary key travels separately.

So if your switch delivers by email, do not also email the beneficiary key to the same inbox. Years later both legs would converge there, and whoever compromises that one account would hold all three. Instead hand the beneficiary key over out of band: in person, on paper, through a different account, or by a messaging app the switch will never touch.

3

Beneficiary: get your key out of the inbox

If you receive your beneficiary key by email or chat, treat that message as temporary. Copy the key into durable, private storage — write it on paper, or put it in your password manager — and then delete the original message. Don't leave it sitting in the same inbox that may one day receive the rest of the inheritance.

4

Make many copies of the encrypted seed

The encrypted seed is inert — without both keys it's just noise, so it can't hurt you to duplicate it. Do: keep several copies (print the QR, save the text, store it in a couple of places). The piece most likely to simply get lost over the years is the one you have the fewest copies of, and this one is free to back up.

5

Understand the reliability trade-off, and plan for it

Legacy is strict 2-of-2: both keys are required, so if either key is permanently lost, the Bitcoin is locked forever. Mitigate it deliberately:

  • Keep redundant copies of each key (stored apart from each other and from the seed).
  • Consider a sealed break-glass fallback — e.g. both keys, or the plain seed, held by a lawyer or in a bank safe-deposit box, opened only on death. It's a second path if the primary one fails.
  • While you're alive you can always re-encrypt with fresh keys — do it if a key might have been exposed, or just to refresh the plan.

See Who It's For for where this fits and where multisig or SLIP-39 may suit you better.

6

Test the whole round trip before you rely on it

Right after you encrypt, decrypt it back with both keys and confirm you get your exact seed phrase — ideally in two places (the SeedSigner and Legacy-offline.html). A plan you've never tested is a plan you don't have. Rehearse the decrypt once with a throwaway seed so your beneficiary knows the steps too.

Choosing strong keywords

A Legacy payload has no backdoor and no rate limit — an attacker who gets a copy can guess keys offline, forever. So the keys are the whole fight. Each 600,000-round key-stretch makes every guess expensive, but that only buys you time; the number of guesses they need is set entirely by your word choices.

1

Use many words

Length beats cleverness. Each additional unrelated word multiplies the attacker's work. Aim for at least three words per key (six across the two). Four each is better. A short, punchy key is a weak key no matter how obscure the word.

2

Reach deep into the dictionary

Do use uncommon words — barbaric, flightless, crucible. Don't use the first words everyone's brain reaches for — happy, yellow, duck. Attackers try the common words first, so the deeper your vocabulary, the later in their list you sit.

3

Keep the two keys unrelated — this is the one that sinks people

Obscure words don't help if your two keys share a theme, come from one quote or song, or the second is guessable from the first. Correlation quietly destroys most of your protection. The two keys should look like they came from two different minds — no shared subject, no story connecting them.

4

Nothing personal

Avoid anything tied to you: pet names, birthdays, your town, your favorite book or character. A motivated attacker — especially if your use of Legacy is ever public — will profile you and build a wordlist from your life. Your keys should reveal nothing about you.

5

Best of all: let a generator pick

Human-chosen words are predictable in ways you can't feel — we cluster on common, related, meaningful words. A random word generator (diceware, or an EFF-wordlist tool) removes the bias entirely. You can keep a readable, memorable shape — adjective-adjective-noun, hyphenated — as long as each word is an independent random draw. Random guarantees the strength; picking from your head only hopes for it.

And no — a generator being public doesn't weaken you. The security is in the random selection, not in keeping the wordlist secret: a BIP-39 seed phrase is drawn from a list the whole world has, yet it's uncrackable because the choice is random. Knowing the list doesn't shrink the search by a single guess. (Just use a sizable list and a real random source.)

6

Symbols and punctuation add strength — just record them exactly

Beyond words, symbols are free entropy — use them. Put an unusual mark between your words instead of a plain hyphen (rusty~hollow*lantern), or drop one inside a word. Like a made-up or misspelled word, a symbol in an unexpected place knocks an attacker off the ready-made wordlists they start with. Legacy keeps your symbols and capitalization exactly as typed — it only tidies spacing and curly quotes — so what you choose is what protects you. A few things to keep in mind:

  • The benefit comes from the unexpected. Swaps everyone makes — 3 for e, @ for a, ! on the end — are already in every attacker's rulebook and add little. An unusual symbol in an unusual spot adds real entropy.
  • Stick to ordinary keyboard characters — letters, digits, spaces, and basic punctuation (no accents or emoji).
  • Every character is one more to reproduce exactly. Copy-paste carries almost no risk; a handwritten key does — as mellon taught us, one changed character and it never decrypts. So if you write a key down, set down every symbol unmistakably and steer clear of ones that blur by hand: O vs 0, l/1/I, ! vs l, ; vs :, rn vs m. Slash your zeros, annotate — leave the reader nothing to guess.
  • A deliberate made-up or misspelled word works the same way (attackers' dictionaries don't contain it) — again, only if it's stored as text and copied, never retyped from memory.
7

Don't reuse

These keys protect one thing. Don't reuse a password you use anywhere else, and don't reuse the same pair across different Legacy payloads. A key is only as safe as the most careless place you've ever used it.

Ready to put it together? Read How It Works, set up a SeedSigner, and test the full round trip on the demo first.