🚀 Advanced Wallet Checker & High-Entropy Key Finder

A comprehensive cryptocurrency wallet validation system with intelligent key discovery capabilities. This tool efficiently checks Bitcoin and Ethereum wallets for balances while discovering high-entropy private keys and mnemonics from local directories.

🆓 FREE BETA ACCESS

⚡ Limited Time Offer: This is Version 1.0 Beta - FREE ACCESS for early adopters!

🎯 What This Means:

• Complete access to all premium features at no cost
• Beta testing period with community feedback integration
• Future versions will transition to a paid licensing model
• Current users get exclusive early access and potential discounts

📅 Timeline: Free access during beta testing phase (limited time)

🚀 Take Advantage Now: Download, test, and provide feedback while it's free!

✨ Features

🔍 Wallet Checking System

• Multi-Network Support: Bitcoin and Ethereum wallet validation
• API Integration: BlockCypher, Infura, and multiple fallback APIs
• Rate Limiting: Intelligent API management to avoid limits
• Progress Tracking: Auto-save progress with resume capability
• Background Processing: Runs seamlessly in the background

🎯 High-Entropy Key Finder

• Smart Discovery: Finds Bitcoin private keys, Ethereum keys, and BIP39 mnemonics
• Entropy Analysis: Calculates and ranks keys by entropy scores
• GUI Integration: Windows folder browser for easy directory selection
• Auto-Prioritization: Automatically reorders keys by entropy (highest first)
• File Type Support: Scans text, log, JSON, and code files

📊 Live Monitoring

• Real-time Dashboard: Live progress updates every 5 seconds
• Progress Tracking: Detailed statistics and time estimates
• API Status: Monitor API usage and rate limits
• Results Display: Instant alerts for wallets with balances

🚀 Quick Start

Prerequisites

• Node.js (v14 or higher)
• Windows (for GUI folder selection)
• API Keys (see setup section below)

Installation

1. Clone the repository

   git clone https://github.com/yourusername/wallet-checker-tool
   cd wallet-checker-tool

2. Install dependencies

   npm install

3. Setup environment variables

   copy .env.example .env
   # Edit .env with your API keys (see API Setup section)

4. Prepare your key list

   • Add private keys and mnemonics to high_entropy_keys.txt
   • Or use the Key Finder to discover keys from directories

🔑 API Setup

Required APIs

BlockCypher (Bitcoin Network)

• Free Tier: 100 requests/hour
• Paid Plans: Up to 5,000 requests/hour
• Setup: Visit BlockCypher.com
  1. Create account
  2. Generate API token
  3. Add to .env file

Infura (Ethereum Network)

• Free Tier: 100,000 requests/day
• Setup: Visit Infura.io
  1. Create account
  2. Create new project
  3. Copy Project ID
  4. Add to .env file

Optional APIs (Fallbacks)

• Blockstream (Bitcoin) - No key required
• Mempool.space (Bitcoin) - No key required
• Public Ethereum Nodes - No key required

Environment Configuration

Edit your .env file:

# BlockCypher API (Required for Bitcoin)
BLOCKCYPHER_TOKEN=your_blockcypher_token_here

# Infura API (Required for Ethereum)
INFURA_PROJECT_ID=your_infura_project_id_here

# Optional: Custom rate limits
RATE_LIMIT_PER_HOUR=95
RATE_LIMIT_PER_MINUTE=5

🎮 Usage

Control Panel (Recommended)

control.bat

Available Options:

1. START - Begin wallet checking in background
2. STATUS - Check current progress
3. DASHBOARD - Open live progress monitor
4. KEYFINDER - Launch entropy-based key discovery
5. LOG - View recent activity
6. RESULTS - Display any wallets found with balance
7. STOP - Stop background processing

Individual Commands

Start Processing

start.bat

Check Status

status.bat

Live Dashboard

dashboard.bat

Find High-Entropy Keys

key_finder.bat

Reorder Existing Keys

reorder_keys.bat

📁 File Structure

wallet-checker-tool/
├── 📋 Input Files
│   ├── high_entropy_keys.txt      # Your private keys and mnemonics
│   └── .env                       # API configuration
├── 🔧 Core Scripts
│   ├── optimized_checker.js       # Main wallet checker
│   ├── key_finder.js             # High-entropy key finder
│   ├── dashboard.js              # Live progress dashboard
│   └── progress_monitor.js       # Status checker
├── 🎮 Control Scripts
│   ├── control.bat               # Master control panel
│   ├── start.bat                # Start processing
│   ├── status.bat               # Check status
│   ├── dashboard.bat            # Launch dashboard
│   ├── key_finder.bat           # Launch key finder
│   └── stop.bat                 # Stop processing
├── 📊 Output Files
│   ├── optimized_results.json    # Detailed results
│   ├── wallet_checker.log        # Processing log
│   └── found_wallets.json        # Wallets with balance
└── 📚 Documentation
    └── README.md                 # This file

🎯 Key Input Format

Add entries to high_entropy_keys.txt:

Bitcoin Private Keys (WIF Format)

5HueCGU8rMjxEXxiPuD5BDku4MkFqeZyd4dZ1jvhTVqvbTLvyTJ
L4rK1yDtCWekvXuE6oXD9jCYfFNV2cWRpVuPLBcCU2z8TrisoyY1

Ethereum Private Keys

0xa1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456
b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456a1

BIP39 Mnemonics (12-24 words)

abandon ability able about above absent absorb abstract absurd abuse access accident
someone amazing stamp tree body damage shoot crop circle likely penalty guilt

📊 Expected Performance

Processing Speed

• With Infura: ~4,166 Ethereum checks/hour
• With BlockCypher: ~95 Bitcoin checks/hour
• Combined: Optimized based on entry types

Time Estimates (for 21,971 entries)

• Free APIs: 6-12 hours
• With Premium APIs: 2-4 hours

🔍 Key Finder Usage

Supported Key Types

• Bitcoin: 64-char hex keys, WIF format
• Ethereum: 0x-prefixed and plain hex keys
• BIP39: 12, 15, 18, 21, 24-word mnemonics

Supported File Types

• Text files: .txt, .log, .md, .csv
• Code files: .js, .py, .json, .sql
• Web files: .html, .htm, .xml

Entropy Scoring

• Minimum Threshold: 3.5
• Optimal Range: 4.0-5.0
• Auto-Sorting: Highest entropy keys checked first

📈 Dashboard Features

Real-Time Monitoring

• Progress Bar: Visual completion indicator
• Processing Rate: Entries per minute
• Time Estimates: Remaining time and completion
• API Status: Usage tracking for all APIs
• Balance Alerts: Immediate notification of funded wallets

Statistics Display

• Total Progress: Processed vs remaining
• Success Rate: Wallets found with balance
• Error Tracking: Failed API calls and issues
• Performance Metrics: Speed and efficiency data

⚠️ Important Notes

Security Considerations

• Private Keys: Never share your private keys or mnemonics
• API Keys: Keep your API credentials secure
• Local Processing: All wallet checking happens locally

Rate Limiting

• Free Tiers: Respect API rate limits to avoid blocks
• Premium Plans: Consider paid APIs for faster processing
• Smart Fallbacks: System automatically switches between APIs

Legal Compliance

• Permission Required: Only scan directories you own or have permission to access
• Educational Purpose: This tool is for educational and legitimate recovery purposes
• Responsible Use: Do not use for unauthorized access to others' wallets

🔧 Troubleshooting

Common Issues

"API Rate Limit Exceeded"

• Wait for the hourly limit to reset
• Consider upgrading to paid API plans
• Check your API key configuration

"No Directory Selected"

• Ensure you have permission to access the folder
• Try running as administrator
• Use the manual path input fallback

"Process Stuck"

• Use stop.bat to halt processing
• Check wallet_checker.log for errors
• Restart with start.bat

Performance Optimization

• Close unnecessary applications during processing
• Use SSD storage for faster file operations
• Stable internet connection for API reliability

📞 Support

Getting Help

• Issues: Report bugs via GitHub Issues
• Documentation: Check this README for common questions
• Community: Join discussions in GitHub Discussions

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

⚠️ Important Licensing Notice:

• Current Version (1.0 Beta): Free access during beta testing period
• Future Versions: Will require paid licensing for continued access
• Beta Users: May receive priority access and potential discounts for paid versions
• Commercial Use: Contact for licensing terms before commercial deployment

🙏 Acknowledgments

• BlockCypher for Bitcoin API services
• Infura for Ethereum infrastructure
• Community Contributors for testing and feedback

---

⚡ Quick Reference

Start Processing

# Launch control panel
control.bat

# Or start directly
start.bat

Monitor Progress

# Live dashboard
dashboard.bat

# One-time status
status.bat

Find New Keys

# Launch key finder
key_finder.bat

# Reorder existing keys
reorder_keys.bat

Check Results

# View found wallets
results.bat

# View processing log
log.bat

Happy wallet checking! 🚀