Repository files navigation

Tool for finding partially lost BIP39 seed.Program works with P2WPKH: BIP84, BIP141; P2PKH: BIP32, BIP44; P2WPKH nested in P2SH: BIP141.

Usage:java -jar lostWord.jar configurationFile

If your problem cannot be covered by any of modes below, please contact me, I will try to modify program accordingly or help you find a seed.

Please check files in /examples/ folder to see how to set up the configuration file.Configuration file expects: address, number of words, known words and additionally derivation path. If not specified, the default will be used (m/0/0).This version checks only one address - for the given path. In the future (or if requested) I will add possibility to verify all the addresses up to address number x. If you know the address but you do not know if it was first or second from the derivation path, you must launch program twice, using two different paths (for example m/0/0 and m/0/1).It is possible to launch tests against 'hardened' addresses, using ' (apostrophe) as the last character of path.Using pagehttps://iancoleman.io/bip39/ you may easily check what to expect for the given seed.By default program uses P2PKH script semantics for addresses like "1...", P2WPKH for addresses like "bc1..." and P2WPKH nested in P2SH for addresses like "3..." (BIP141).

If derivation path is not specified, by default program is using "m/0/0" (BIP32 for P2PKH and BIP141 for P2WPKH). For example: if you want to do calculations for BIP44 or BIP84, please use the proper derivation path, for example "m/44'/0'/0'/0/0" or "m/84'/0'/0'/0/0", where the last two digits are the most important (account & number of address).

Program supports also Ethereum (path m/44'/60'/0'/0/0)

Program could be launched in several modes:

1. ONE_UNKNOWN
Suitable for seeds where we know the number of words, we know order of words, but we do not know one word.Program checks seeds testing a 'lost' word on each position.Configuration file example (seed with 6 words, one word missing):

ONE_UNKNOWN1AcuLxsQSMTi6fLEbJ6F6sNsZ4NyqnUNSo6brothermedalremovepitchhill

2. KNOWN_POSITION
Suitable for seeds where we know the number of words, we know order of words, we do not know one or more words, but we know position of lost word(s).Program checks seeds testing a 'lost' word(s) on specified position(s).Configuration file example (seed with 6 words, three first words are missing):

KNOWN_POSITIONbc1q8ctl93aqztw8z3jsfhzcl0hlukq9pc7jclmmt06???homecartest

It is possible to resume search from the specific word on the first unknown position. For example:

KNOWN_POSITIONbc1q04v0u7sy29tu3g6a0zwldlthjms2u00p0ucq7q6?ability??homecarthat

3. ONE_UNKNOWN_CHECK_ALL
Suitable for seeds where we know the number of words, we know order of words, but we do not know one word.Program checks seeds testing a 'lost' word on each position.This worker generates 10 addresses for the created seed and checks the balance online (using blockchain.info API).Currently it works only with P2PKH

ONE_UNKNOWN_CHECK_ALLanyAddress6brothercanalremovepitchhillm/0/0'

4. PERMUTATION_CHECK
Worker creates all the possible (correct) seeds from the given list of words and checks them using given address and derivation path.Configuration file example (seed with 6 words):

PERMUTATION_CHECK1NzWRF78WKHGCNvSjvRB5cU9WzjpYF1RMb6hillcanalbrothermedalpitchremovem/1/4

5. PERMUTATION
Worker displays and writes to file all the possible (correct) seeds from the given list of words.Configuration file example (seed with 6 words):

PERMUTATIONanyAddress6brothercanalmedalremovepitchhill

6. POOL
Suitable for seeds where we know the number of words, we know order of words and we know potential candidates on each position.Still '?' could be used for the whole dictionary.Configuration file example (seed with 6 words, one word unknown, known possible words on two positions):

POOLbc1q0v5q36eaculyrykjnjsyuey6ctd3802ft4jdcc6brotherwindow master canal cat?black master remove catpitchhill

7. PRINT_SEEDS
Prints on screen and saves to file all the possible seeds generated from the given list of works (with 1 or more words missing).Configuration file example (seed with 6 words):

PRINT_SEEDSanyText6brothercanal?removepitchhill

For BTC only (not ETH):It is possible to specify the derivation path as a range. For example "m/0/0-4" if you want to launch search on the first five addresses or "m/0/1-2'" if you want to check second and third hardened addresses.Example of search with a range:

ONE_UNKNOWNbc1qg3m687gpwljqnzja233sf99aex79cmwr5ewhxh6brothercanalremovepitchhillm/0/2-7'

Contact email:pawgo@protonmail.comIf you found this program useful, consider making a donation, I will appreciate it!BTC:bc1qz2akvlch75rqdfg8pv7chqvz3m8jsl49k0kszc