| --- |
| title: Solana Key Generator & Live Miner |
| emoji: 🔐 |
| colorFrom: purple |
| colorTo: green |
| sdk: gradio |
| sdk_version: "4.44.0" |
| app_file: app.py |
| pinned: false |
| license: mit |
| --- |
| |
| # 🔐 Solana Key Generator & Live Miner |
|
|
| A comprehensive Solana wallet mining application that generates Ed25519 Base-58 keys and mines Solana addresses in real-time with advanced Discord notifications and multi-platform support. |
|
|
| ## 🌟 Complete Feature Overview |
|
|
| ### 🎲 Single Key Generation |
| - **Secure Keypair Generation**: Creates cryptographically secure Ed25519 keypairs |
| - **Base58 Encoding**: Private keys encoded in standard Solana Base58 format |
| - **Multiple Format Support**: Provides both Base58 and hexadecimal representations |
| - **Key Validation**: Automatic validation of generated keypairs |
| - **Copy-to-Clipboard**: One-click copying for all generated keys |
| - **Key Information Display**: Shows key length, format validation, and technical details |
|
|
| ### 📦 Bulk Key Generation |
| - **High-Volume Generation**: Generate up to 1,000 keys in a single batch |
| - **Progress Tracking**: Real-time progress updates for large batches |
| - **Error Handling**: Robust error recovery and reporting |
| - **Batch Export**: All keys provided in easy-to-copy format |
| - **Performance Optimized**: Efficient generation with CPU throttling prevention |
| - **Memory Management**: Optimized for large key batches without memory issues |
|
|
| ### 🪙 Advanced Wallet Mining System |
|
|
| #### ⛏️ Core Mining Features |
| - **Real-Time Mining**: Continuous background mining with 100 wallets per batch |
| - **30-Minute Cycle Management**: Intelligent mining cycles (30 min active, 30 min break) |
| - **Multi-RPC Support**: Automatic failover between 4+ Solana RPC endpoints |
| - **Balance Detection**: Configurable minimum SOL threshold for "funded" wallets |
| - **Live Performance Metrics**: Real-time statistics and performance tracking |
| - **Auto-Recovery**: Automatic error recovery and RPC endpoint switching |
|
|
| #### 📊 Comprehensive Statistics |
| - **Mining Performance**: Wallets per second, batch processing times |
| - **Success Tracking**: Total mined, funded wallets found, success rates |
| - **Streak Monitoring**: Current and best finding streaks |
| - **Uptime Tracking**: Total runtime and activity monitoring |
| - **RPC Performance**: Individual endpoint response time tracking |
| - **Error Analytics**: Comprehensive error counting and categorization |
|
|
| #### 🔄 Cycle Management |
| - **30-Minute Active Mining**: Intensive mining periods |
| - **30-Minute Break Periods**: Resource conservation and rate limit management |
| - **Cycle Progress Tracking**: Visual progress indicators for current cycle |
| - **Total Cycle Counting**: Historical cycle completion tracking |
| - **Automatic Transitions**: Seamless switching between mining and break modes |
|
|
| ### 💬 Discord Integration System |
|
|
| #### 🚨 Instant Notifications |
| - **Funded Wallet Alerts**: Immediate @everyone pings when funded wallets are discovered |
| - **Rich Embeds**: Detailed wallet information with private keys (spoiler tags) |
| - **Miner Identification**: Multi-miner support with unique IDs and names |
| - **Startup Notifications**: Automatic notifications when miners come online |
| - **Status Updates**: Regular mining status updates with comprehensive metrics |
|
|
| #### 📈 Advanced Discord Features |
| - **Live Status Embeds**: Self-updating status messages every 60 seconds |
| - **Performance Metrics**: Detailed mining statistics in Discord |
| - **RPC Health Monitoring**: Network status and endpoint performance |
| - **Error Reporting**: Automatic error notifications and recovery status |
| - **Multi-Miner Support**: Support for multiple miners with unique identification |
|
|
| #### 🛡️ Discord Reliability |
| - **Isolated Processing**: Discord operations never block mining operations |
| - **Retry Logic**: Automatic retry with exponential backoff |
| - **Rate Limit Handling**: Intelligent Discord API rate limit management |
| - **Fallback Systems**: Graceful degradation when Discord is unavailable |
| - **Queue Management**: Message queuing to prevent loss during outages |
|
|
| ### 📡 Live Feed System |
| - **Real-Time Updates**: Continuous feed of mining activity |
| - **Funded Wallet Highlighting**: Special formatting for successful finds |
| - **Empty Wallet Sampling**: Representative sampling of checked wallets |
| - **Timestamp Tracking**: Precise timing information for all activities |
| - **Feed Management**: Automatic cleanup and size management |
| - **Color Coding**: Visual distinction between funded and empty wallets |
|
|
| ### ⚙️ Configuration & Customization |
|
|
| #### 🔧 Environment Variables |
| - `DISCORD_WEBHOOK`: Discord webhook URL for notifications |
| - `MIN_SOL`: Minimum SOL balance threshold (default: 0.00001) |
| - `RPC_BATCH_SIZE`: Wallets per RPC call (max: 100) |
| - `MINER_SLEEP`: Delay between mining cycles (default: 1.0s) |
| - `MINER_ID`: Unique miner identifier |
| - `MINER_NAME`: Human-readable miner name |
| - `MINER_LOCATION`: Geographic or logical location identifier |
| - `PORT`: Application port (auto-configured for platform) |
|
|
| #### 🌐 Multi-Platform Support |
| - **Replit Optimization**: Automatic port and host configuration for Replit |
| - **Hugging Face Spaces**: Full compatibility with HF Spaces environment |
| - **Local Development**: Complete local development support |
| - **Docker Ready**: Container deployment support |
| - **Cloud Platform**: AWS, Google Cloud, DigitalOcean compatibility |
|
|
| ### 🚀 Performance & Reliability |
|
|
| #### ⚡ Performance Features |
| - **Batch Processing**: Efficient 100-wallet batches for optimal RPC usage |
| - **Connection Pooling**: Persistent RPC connections with health monitoring |
| - **Memory Optimization**: Efficient memory usage even during extended mining |
| - **CPU Throttling**: Prevents system overload during intensive operations |
| - **Background Processing**: Non-blocking operations for all mining activities |
|
|
| #### 🛡️ Reliability Systems |
| - **Error Recovery**: Automatic recovery from network and RPC failures |
| - **Health Monitoring**: Continuous system health and performance monitoring |
| - **Graceful Degradation**: Continues operation even when some features fail |
| - **State Management**: Persistent mining state across connection issues |
| - **Logging System**: Comprehensive logging for debugging and monitoring |
|
|
| ### 🎨 User Interface |
|
|
| #### 📱 Responsive Web Interface |
| - **Gradio Framework**: Modern, responsive web interface |
| - **Mobile Friendly**: Full functionality on mobile devices and tablets |
| - **Real-Time Updates**: Live statistics and feed updates |
| - **Copy Functions**: One-click copying for all generated content |
| - **Color Coding**: Intuitive color schemes for different wallet states |
|
|
| #### 🖥️ Control Features |
| - **Start/Stop Controls**: Easy mining control with instant response |
| - **Feed Management**: Clear and manage live mining feed |
| - **Statistics Display**: Comprehensive real-time performance metrics |
| - **Status Indicators**: Clear visual status of all system components |
|
|
| ### 🔒 Security & Best Practices |
|
|
| #### 🛡️ Security Features |
| - **Secure Key Generation**: Cryptographically secure random number generation |
| - **Environment Variable Protection**: Secure handling of sensitive configuration |
| - **Input Validation**: Comprehensive validation of all user inputs |
| - **Error Isolation**: Isolated error handling prevents system compromise |
| - **Rate Limiting**: Built-in rate limiting for external API calls |
|
|
| #### 📋 Best Practices |
| - **Educational Purpose**: Clearly documented educational and research use |
| - **Responsible Mining**: Cycle-based mining to prevent excessive resource usage |
| - **Privacy Considerations**: Guidelines for handling discovered private keys |
| - **Network Etiquette**: Respectful use of public RPC endpoints |
|
|
| ### 🔧 Technical Specifications |
|
|
| #### 📚 Dependencies |
| - **Python 3.8+**: Core runtime requirement |
| - **Gradio 4.44.0+**: Web interface framework |
| - **Solana SDK**: Official Solana Python libraries |
| - **Solders**: High-performance Solana operations |
| - **Base58**: Standard Base58 encoding/decoding |
| - **Requests**: HTTP client for Discord and RPC operations |
| - **Pydantic**: Data validation and settings management |
|
|
| #### 🏗️ Architecture |
| - **Multi-Threading**: Separate threads for mining, Discord, and UI |
| - **Queue Systems**: Thread-safe communication between components |
| - **State Management**: Centralized state management with thread safety |
| - **Modular Design**: Clear separation of concerns and functionality |
| - **Extensible Framework**: Easy to extend with additional features |
|
|
| ## 🚀 Quick Start Guide |
|
|
| ### For Replit (Recommended) |
| 1. **Fork/Import**: Import this repository to your Replit account |
| 2. **Environment Setup**: Add Discord webhook in Secrets tab (optional) |
| 3. **Run**: Click the Run button - mining starts automatically |
| 4. **Monitor**: Watch real-time statistics and live feed |
| 5. **Control**: Use the web interface to start/stop and generate keys |
|
|
| ### Environment Configuration |
| Add these optional secrets in Replit's Secrets tab: |
| ``` |
| DISCORD_WEBHOOK=your_webhook_url_here |
| MIN_SOL=0.00001 |
| RPC_BATCH_SIZE=100 |
| MINER_SLEEP=1.0 |
| MINER_NAME=MyMiner |
| MINER_LOCATION=Replit |
| ``` |
|
|
| ### Discord Setup |
| 1. Create a Discord webhook in your server |
| 2. Copy the webhook URL |
| 3. Add it to your Replit secrets as `DISCORD_WEBHOOK` |
| 4. Start mining and receive notifications automatically |
|
|
| ## 📈 Mining Statistics Explained |
|
|
| - **Total Mined**: Total number of wallets generated and checked |
| - **Funded Found**: Number of wallets discovered with SOL balance |
| - **Success Rate**: Percentage of funded wallets vs total checked |
| - **Speed**: Current wallets per second processing rate |
| - **Uptime**: Total time the miner has been running |
| - **Cycle Info**: Current 30-minute cycle status and progress |
| - **RPC Performance**: Response times for different endpoints |
| - **Streak Tracking**: Current and best consecutive find streaks |
|
|
| ## 🎯 Use Cases |
|
|
| ### Educational & Research |
| - Cryptocurrency key generation education |
| - Blockchain probability demonstrations |
| - Cryptographic security research |
| - Academic blockchain projects |
|
|
| ### Development & Testing |
| - Solana development key generation |
| - Testing wallet functionalities |
| - Blockchain application development |
| - Security testing and validation |
|
|
| ### Mining & Discovery |
| - Probabilistic wallet discovery |
| - Network analysis and research |
| - Performance benchmarking |
| - System stress testing |
|
|
| ## ⚠️ Important Notes |
|
|
| ### Responsibility & Ethics |
| - This tool is for educational and research purposes |
| - Found private keys should be handled responsibly |
| - Respect network resources and rate limits |
| - Follow applicable laws and regulations |
|
|
| ### Technical Limitations |
| - Finding funded wallets is extremely rare (probabilistic) |
| - RPC endpoints may rate limit requests |
| - Discord notifications require webhook setup |
| - Performance varies based on network conditions |
|
|
| ### Privacy & Security |
| - Private keys are displayed in the interface |
| - Discord messages contain sensitive information |
| - Use private channels for Discord notifications |
| - Keep webhook URLs confidential |
|
|
| ## 🔗 Platform Support |
|
|
| This application is optimized for: |
| - ✅ **Replit** (Recommended - Auto-configured) |
| - ✅ **Hugging Face Spaces** (Full compatibility) |
| - ✅ **Local Development** (Windows, macOS, Linux) |
| - ✅ **Docker Containers** (Ready for containerization) |
| - ✅ **Cloud Platforms** (AWS, GCP, DigitalOcean) |
|
|
| --- |
|
|
| **Built with ❤️ for the Solana community | Educational purposes only** |
|
|
