Skip to content

Latest commit

 

History

History
166 lines (135 loc) · 5.15 KB

README.md

File metadata and controls

166 lines (135 loc) · 5.15 KB
Raw

LostWord

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.

How to use it

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 page https://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
    2. 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_UNKNOWN
1AcuLxsQSMTi6fLEbJ6F6sNsZ4NyqnUNSo
6
brother
medal
remove
pitch
hill
  2. KNOWN_POSITION
    3. 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_POSITION
bc1q8ctl93aqztw8z3jsfhzcl0hlukq9pc7jclmmt0
6
?
?
?
home
car
test

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

    KNOWN_POSITION
bc1q04v0u7sy29tu3g6a0zwldlthjms2u00p0ucq7q
6
?ability
?
?
home
car
that
  3. ONE_UNKNOWN_CHECK_ALL
    4. 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_ALL
anyAddress
6
brother
canal
remove
pitch
hill
m/0/0'
  4. PERMUTATION_CHECK
    5. 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_CHECK
1NzWRF78WKHGCNvSjvRB5cU9WzjpYF1RMb
6
hill
canal
brother
medal
pitch
remove
m/1/4
  5. PERMUTATION
    6. Worker displays and writes to file all the possible (correct) seeds from the given list of words. Configuration file example (seed with 6 words): 
    PERMUTATION
anyAddress
6
brother
canal
medal
remove
pitch
hill
  6. POOL
    7. 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): 
    POOL
bc1q0v5q36eaculyrykjnjsyuey6ctd3802ft4jdcc
6
brother
window master canal cat
?
black master remove cat
pitch
hill
  7. PRINT_SEEDS
    8. 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_SEEDS
anyText
6
brother
canal
?
remove
pitch
hill

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_UNKNOWN
bc1qg3m687gpwljqnzja233sf99aex79cmwr5ewhxh
6
brother
canal
remove
pitch
hill
m/0/2-7'

Contact

Contact email: [email protected] If you found this program useful, consider making a donation, I will appreciate it! BTC: bc1qz2akvlch75rqdfg8pv7chqvz3m8jsl49k0kszc