A Python tool to recover BIP39 seed phrases when you have one incorrect word. If you know your Ethereum wallet address but have a seed phrase with one wrong word, this tool will systematically test all possible word replacements to find the correct seed.

• You have a 12 or 24-word seed phrase with one word wrong
• You know the Ethereum address from that seed
• This tool finds which word is wrong and what it should be

git clone https://github.com/yourusername/seed-recovery.git
cd seed-recovery
pip install -r requirements.txt

1. Copy example files:

   cp examples/seed.txt.example seed.txt
   cp examples/address.txt.example address.txt

2. Edit the files:

   • seed.txt: Your incorrect seed phrase
   • address.txt: Your known Ethereum address

3. Run the recovery:

   python recovery.py

seed.txt:

abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon wrong

address.txt:

0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb

Output:

✓ MATCH FOUND!
Position 12: 'wrong' → 'about'
Recovered seed: abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about

• Never share your seed phrase
• Run on an offline computer if possible
• Delete seed.txt and address.txt after recovery
• These files are in .gitignore to prevent accidental commits

1. Validates your seed phrase words are in the BIP39 wordlist
2. For each position, tries replacing that word with all 2048 BIP39 words
3. Checks if the result has a valid checksum
4. Derives the Ethereum address and compares with your known address
5. Reports any matches found

Contributions welcome! Potential improvements:

• Support for multiple wrong words
• Bitcoin/other blockchain support
• Progress bars
• GUI interface

See CONTRIBUTING.md for details.

MIT License - see LICENSE