https://github.com/hunterr0se/godel
Gödel - Recover Your Keys. Recover Your Coins.
https://github.com/hunterr0se/godel
bitcoin cryptocurrency ethereum litecoin monero recovery-crypto
Last synced: 23 days ago
JSON representation
Gödel - Recover Your Keys. Recover Your Coins.
- Host: GitHub
- URL: https://github.com/hunterr0se/godel
- Owner: HunterR0se
- License: mit
- Created: 2025-03-21T18:32:04.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-04-11T21:27:48.000Z (23 days ago)
- Last Synced: 2025-04-12T04:59:31.308Z (23 days ago)
- Topics: bitcoin, cryptocurrency, ethereum, litecoin, monero, recovery-crypto
- Language: Go
- Homepage: https://x.com/HunterR0se
- Size: 232 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Gödel - The Crypto Seed Phrase Recovery Tool
[](LICENSE)
## Recover Your Keys. Recover Your Coins.
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.
---
## **What Does It Do?**
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**.
---
## **Screenshot**
---
## **Key Features**
- **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.
---
## **Quick Start**
```bash
# 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=false
```
### **Reading the Results**
Each match includes:
```md
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 accident
```
**Results 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).
---
## **Installation**
```bash
# 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.sh
```
## **Contributing**
Contributions to Gödel are welcome! Please feel free to submit a Pull Request.
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
---
## **Code Structure**
```md
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 documentation
```
---
## **License**
MIT
---
## **Important Notes**
This tool is intended solely for recovering your own wallet information. Use it responsibly and respect data privacy.
---
## **Security Best Practices**
When scanning for sensitive credentials:
- **Handle seed phrases and private keys with extreme care**.
- **Store results securely**.
- **Use isolated or encrypted systems when possible**.