GUIDE 01 / START HERE

Start with the right recovery path

Work out whether you need password, seed phrase, or BIP39 passphrase recovery before you run a search.

What do you still have?

A useful recovery plan starts with evidence: the wallet application, the original device, the files you still have, and what you remember. Make a working copy of wallet files and keep the originals unchanged.

Write down the wallet name and approximate creation date. A file extension alone does not reliably identify its format. Also record any receiving addresses that you know belonged to this wallet; they can help confirm a seed or passphrase result.

Choose one of three paths

Your situationWhere to begin
You have an encrypted wallet file and remember parts of its password.Password recovery
You have most of a seed phrase, with missing, wrong, or misplaced words.Seed recovery
Your seed phrase is correct, but the additional BIP39 passphrase is uncertain.BIP39 passphrase recovery

A device PIN, a wallet-file password, and a BIP39 passphrase are different things. A search configured for one will not automatically recover the others.

Keep the first experiment small

Install the maintained project and try a tiny example before using a real wallet copy. For password candidates, --listpass lets you inspect the generated guesses without opening a wallet. Our tokenlist tutorial starts with two invented candidates.

Expand one uncertainty at a time. If you change the wallet type, candidate rules, and derivation path all at once, you lose the ability to tell which change mattered.

Understand the limits

BTCRecover tests possibilities you describe. It cannot reconstruct an arbitrary strong password or a completely lost seed from a public address alone. Time depends on the wallet format, search size, and your hardware; a small change in the rules can multiply the search dramatically.

CONTINUE WITH THE PRIMARY SOURCES

Sources & further reading

Commands and capabilities can change. Check the maintained documentation for your wallet and installed revision.

NEXT GUIDEInstall & test BTCRecover→
WALLET RECOVERY HELP · KEYCHAINX

Stuck? Talk to KeychainX.

Tell us the wallet application, the type of backup you have, and where you are stuck.

For the first message, leave out seed phrases, private keys and passwords.

Email KeychainX for recovery helpVisit keychainx.io ↗