README.md

---
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**