Gödel is designed to help users recover lost cryptocurrency wallet seed phrases and private keys. This Go-based tool scans files and directories on your local filesystem, external drives, and supported cloud storage (Dropbox, Google Drive) to locate and verify potential wallet recovery information.
Gödel searches for:
- BIP39 Seed Phrases: Typically 12-24 words used by cryptocurrency wallets.
- Private Keys: For major cryptocurrencies such as Bitcoin, Ethereum, Solana, etc.
- Wallet-related Information and Keywords.
- Deep File Scanning with Recursive Directory Support: Ensures no potential recovery information is overlooked.
- Handles Common File Formats: Includes
.txt,.md,.doc,.rtf, and others. - BIP39 Seed Phrase Validation: Confirms the validity of found seed phrases.
- Private Key Detection and Verification: Identifies private keys with cryptographic validation.
- Smart Context Matching: Reduces false positives by analyzing the context of matches.
- Probability Scoring for Match Confidence: Provides a confidence level for each match.
# Basic help
godel
# Help with all options
godel -help
# Scan a directory
godel -dir /path/to/scan
# Scan a single directory without recursion
godel -dir /path/to/scan -r=falseEach match includes:
Match #4: Type: Wallet Keyword
Content: Seed Phrase
Line: 5
Associated Keys: - Seed Phrase: abandon ability able about above absent absorb abstract absurd abuse access accidentResults Show:
- Match type: Seed Phrase, Private Key, or Wallet Keyword.
- Found content.
- Line location within the scanned file.
- Related keys found nearby (within 5 lines).
# Clone the repository
git clone https://github.com/HunterR0se/godel.git
# Navigate to the directory
cd godel
# Build the tool
go build -o godel
# Run the tool
./godel
# Alternatively, use the build script to compile and install
./build.shContributions to Gödel are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Gödel/
├── internal/ # Application-specific internal packages
│ ├── cli/ # Command-line interface functionality
│ ├── scanner/ # Core file scanning and processing logic
│ └── wallet/ # Wallet derivation and validation utilities
├── pkg/ # Reusable packages
│ ├── crypto/ # Cryptographic utilities for validating wallets
│ ├── fileutil/ # File scanning and reading utilities
│ ├── matcher/ # Pattern matching logic
│ ├── patterns/ # Pattern definitions and word lists
│ └── ui/ # User interface and display formatting
├── test_samples/ # Sample files for testing
├── build.sh # Build script
├── main.go # Application entry point
└── README.md # Project documentationMIT
This tool is intended solely for recovering your own wallet information. Use it responsibly and respect data privacy.
When scanning for sensitive credentials:
- Handle seed phrases and private keys with extreme care.
- Store results securely.
- Use isolated or encrypted systems when possible.