š Demo Purpose: This page demonstrates WebMiner's consent-first approach to browser mining.
All mining operations require explicit user permission with full transparency about resource usage.
š Quick Start Integration
WebMiner can be integrated with a simple script tag:
<!-- Development version (webminer.js) -->
<script src="webminer.js"
data-pool="wss://pool.example.com"
data-wallet="YOUR_MONERO_ADDRESS"
data-throttle="0.25">
</script>
<!-- Production version (webminer.min.js) - 40% smaller -->
<script src="webminer.min.js"
data-pool="wss://pool.example.com"
data-wallet="YOUR_MONERO_ADDRESS"
data-throttle="0.25">
</script>
š Recommendation: Use webminer.js for development and webminer.min.js for production.
See production.html and advanced.html for detailed examples.
š§ Interactive Controls
Test the consent system and mining controls:
Status: Ready for testing
ā Ethical Mining Features
Explicit Consent
Users must actively agree to mining. No hidden or automatic mining.
Transparent Usage
Clear information about CPU usage, battery impact, and expected earnings.
One-Click Stop
Mining can be stopped instantly via persistent indicator or controls.
Resource Limits
Configurable CPU throttling (10-50%) protects user devices.
Mobile Protection
Battery level detection and thermal protection for mobile devices.
Preference Memory
User choices are remembered across visits via localStorage.
ā ļø Important Notes
Development Phase: This is Phase 2 (Core Mining Architecture) - now with REAL mining functionality!
The WebAssembly RandomX implementation and pool connection system are fully functional.
You can test real mining operations (though you'll need a real pool URL and wallet address for actual mining).
Browser Requirements: Modern browsers with Web Workers, WebSocket,
and localStorage support. Target: Chrome 70+, Firefox 65+, Safari 14+, Edge 79+.
š Current Implementation Status
ā Phase 1: Consent & Ethics Framework
ā User consent system with transparent dialogs
ā Persistent mining indicator with controls
ā Preference storage and memory
ā Mobile-responsive design
ā Accessibility features (ARIA labels, keyboard navigation)
ā Phase 2: Core Mining Architecture (NEW!)
ā WebAssembly RandomX implementation with JavaScript fallback
ā Real-time hash rate calculation and monitoring
ā WebSocket pool connection with Stratum protocol
ā Share submission system with auto-reconnect
ā Mining settings dialog with throttle control
ā Tab visibility handling (pause when hidden)
ā Enhanced error handling and recovery
ā Phase 3: Optimization (NEW!)
ā Comprehensive performance monitoring and device capability detection
ā Adaptive throttling based on device performance and thermal conditions
ā Battery protection with Navigator Battery API integration
ā Mobile optimizations with touch-friendly UI and reduced power consumption
ā Automatic thermal protection and frame rate monitoring
ā Connection type detection and data usage optimization
ā³ Phase 4: Single-File Build (Next)
š² Phase 5: Documentation & Security Audit