README.md

metadata

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