Skip to content

Commit 07f95de

Browse files
Update ReadMe and ChangeLog
1 parent 15c2291 commit 07f95de

File tree

2 files changed

+22
-19
lines changed

2 files changed

+22
-19
lines changed

CHANGELOG.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,13 @@
11
### Next Release (future ideas)
2-
[Commits after previous release](https://github.com/Coding-Enthusiast/FinderOuter/compare/v0.19.1.0...master)
2+
[Commits after previous release](https://github.com/Coding-Enthusiast/FinderOuter/compare/v0.20.0.0...master)
33
[RoadMap](https://github.com/Coding-Enthusiast/FinderOuter/issues/47)
44

5+
### Release 0.20.0 (2024-11-13)
6+
[Full Changelog](https://github.com/Coding-Enthusiast/FinderOuter/compare/v0.19.1.0...v0.20.0.0)
7+
* **New feature:** new copy and paste buttons for all search-spaces to be able to copy over lists
8+
* **New feature:** recovering encryption password used for bitcoin core wallet.dat files
9+
* Some bug fixes and code improvements
10+
511
### Release 0.19.1 (2024-01-24)
612
[Full Changelog](https://github.com/Coding-Enthusiast/FinderOuter/compare/v0.19.0.0...v0.19.1.0)
713
* Fix a bug in VMs where FinderOuter crashed if user entered an invalid input

README.md

Lines changed: 15 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -36,9 +36,10 @@ Contribution is always welcome. Please report any bugs you find or any improveme
3636
![Preview](/Doc/Images/MainPreview.jpg)
3737

3838
## Available recovery options
39-
#### 1. Message signature verification
40-
User can enter a message signature here to verify it. In case there is a problem with the message (except being an
41-
actually invalid signature), the code can search to find the common issues that some signing tools have and fix them.
39+
#### 1. Missing Base-16 characters
40+
This option is similar to previous feature but works for base-16 (hexadecimal) private keys. Since there is no checksum in this
41+
encoding it requires an additional input to check each permutation against. It accepts any address type and public keys.
42+
This option is slower in comparison because it uses ECC and that is not yet optimized.
4243

4344
#### 2. Missing Base-58 characters
4445
This option can be used to recover any base-58 encoded string with a checksum that is missing some characters. For example
@@ -47,36 +48,32 @@ It works for (1) [WIFs](https://en.bitcoin.it/wiki/Wallet_import_format) (Base-5
4748
(2) [Addresses](https://en.bitcoin.it/wiki/Address) (Base-58 encoded P2PKH or P2SH address)
4849
(3) [BIP-38](https://github.com/bitcoin/bips/blob/master/bip-0038.mediawiki) (Base-58 encoded encrypted private key).
4950

50-
There is also a "special case" for private keys missing 1, 2 or 3 characters at _unknown_ positions.
51-
52-
#### 3. Missing Base-16 characters
53-
This option is similar to previous feature but works for base-16 (hexadecimal) private keys. Since there is no checksum in this
54-
encoding it requires an additional input to check each permutation against. It accepts any address type and public keys.
55-
This option is slower in comparison because it uses ECC and that is not yet optimized.
56-
57-
#### 4. Missing mini-privatekey characters
51+
#### 3. Missing mini-privatekey characters
5852
This option is similar to 2 and 3 but works for [mini-privatekeys](https://en.bitcoin.it/wiki/Mini_private_key_format)
5953
(eg. SzavMBLoXU6kDrqtUVmffv). It requires the corresponding address or public key of the minikey to check
6054
each possible key against, as a result it is also slower since it depends on ECC and has 2 additional hashes.
6155

62-
#### 5. Missing mnomonic (seed) words
56+
#### 4. Missing BIP-38 password
57+
This option can recover passwords used in encrypting bitcoin private keys using the
58+
[BIP-38](https://github.com/bitcoin/bips/blob/master/bip-0038.mediawiki) proposal. The available password recovery modes
59+
are the same as mnemonic passphrase option.
60+
61+
#### 5. Missing bitcoin core wallet.dat password
62+
This option can recover passwords used to encrypt the bitcoin core wallet files.
63+
64+
#### 6. Missing mnomonic (seed) words
6365
This option works for both [BIP-39](https://github.com/bitcoin/bips/blob/master/bip-0039.mediawiki) and Electrum mnemonics
6466
that have some missing words. It requires knowing one child (private/public) key or address created from that seed and the
6567
exact derivation path of it.
6668

67-
#### 6. Missing mnemonic passphrase
69+
#### 7. Missing mnemonic passphrase
6870
This option is used to recover the extension words (aka passphrase) used in mnemonics. It works for both
6971
[BIP-39](https://github.com/bitcoin/bips/blob/master/bip-0039.mediawiki) and Electrum mnemonics algorithms. The available
7072
passphrase recovery modes are:
7173
a. Alphanumeric: This is when the passphrase consists of letter, numbers and symbols and is random. Example: `OT!pA?8i`
7274
b. CustomChars: This mode allows user to define their own set of characters to be used in the passphrase.
7375
c. _soon_
7476

75-
#### 7. Missing BIP-38 password
76-
This option can recover passwords used in encrypting bitcoin private keys using the
77-
[BIP-38](https://github.com/bitcoin/bips/blob/master/bip-0038.mediawiki) proposal. The available password recovery modes
78-
are the same as mnemonic passphrase option.
79-
8077
#### 8. Missing BIP-32 derivation path
8178
This option could be used to find derivation path of a child key (private key, public key or the address) by having the mnemonic
8279
or the extended master keys (xprv or xpub). It only checks a hard-coded list of popular derivation paths.

0 commit comments

Comments
 (0)