UMBRELLA MINES $NIGHT MINER

A plug-and-play NIGHT mining solution built entirely on WordPress.

Mine Cardano Midnight NIGHT tokens with zero code required. One-click installation, one-click mining. Cross-platform support for Windows, Linux, and macOS. That's it.

---

IMPORTANT - BETA SOFTWARE & HOSTING REQUIREMENTS

This plugin is currently in BETA. While functional and production-ready, it has specific hosting requirements that determine whether it will work in your environment.

Confirmed Working Environments:

• Local by Flywheel - 100% compatibility (RECOMMENDED for easiest setup)
• Dedicated Servers - Full compatibility with proper PHP configuration
• VPS Hosting - 99% compatibility (DigitalOcean, Linode, Vultr, AWS, etc.)

Shared Hosting - Will Likely NOT Work:

Shared hosting providers typically block or kill long-running PHP processes to protect their infrastructure. Common issues:

• Process execution disabled or severely limited
• FFI extension disabled for security
• Memory limits too low (need 2GB+ for ROM)
• PHP CLI not available or restricted
• WP-CLI access blocked

Bottom line: If you're on shared hosting (GoDaddy, Bluehost, HostGator, etc.), this plugin will probably not work.

Easiest Way to Get Started:

Don't have a suitable environment? No problem!

1. Download Local by Flywheel (100% FREE)
2. Create a new WordPress site (takes 2 minutes)
3. Install this plugin
4. Start mining

You don't even need a real website - Local runs entirely on your machine. It's the fastest path from zero to mining.

System Requirements:

• Windows, Linux, or macOS
• PHP 8.0+ with FFI extension enabled
• IMPORTANT: PHP version MUST match between PHP-CLI and php.ini configuration
  • If using Local by Flywheel, ensure site's PHP version matches lightning-services PHP version
  • Mismatched versions will cause "Error establishing a database connection"
• 2GB+ available RAM
• WP-CLI access (included with Local by Flywheel)
• AshMaize library for your platform (Windows: .dll, Linux: .so, macOS: .dylib)

---

What Is This?

Umbrella Mines is a WordPress plugin that turns any WordPress site into a fully functional Midnight Scavenger Mine miner. It mines NIGHT tokens by solving cryptographic puzzles using the AshMaize hash function - the same challenge that powers the Midnight blockchain's proof-of-work system.

The catch? It's built entirely on WordPress. PHP. Old tech. The platform that powers 43% of the web.

The result? A mining solution that runs anywhere WordPress runs - shared hosting, VPS, local dev environments, even mobile devices. No Docker containers, no complex setup, no command-line kung-fu required.

---

Why WordPress?

Because WordPress is:

• Ubiquitous - Already installed on millions of servers worldwide
• Accessible - Anyone can set it up, regardless of technical background
• Free - No hosting costs if you're already running WordPress
• Battle-tested - Decades of stability and compatibility

This started as an experiment: "What can we build with old tech and lightweight code?" The answer turned out to be a competitive, production-ready mining solution that stands shoulder-to-shoulder with specialized Rust implementations.

---

Features

One-Click Mining

No configuration. No command-line. Just click "START MINING" and watch it work.

Smart Export System (NEW in v0.3.0)

• Export all your mining data (wallets, solutions, receipts) in one click
• Only exports completed work (submitted/confirmed solutions)
• Warns you if pending solutions need submission first
• Wallet-centric JSON structure with all critical data
• Contains private keys and crypto receipts for claiming NIGHT rewards
• Identical export functionality on Wallets and Solutions pages

System Requirements Checker (NEW in v0.3.0)

• Automatic validation of all dependencies on dashboard load
• Checks PHP version (8.0+), FFI extension, libraries, and permissions
• Collapsible panel with detailed status for each requirement
• Platform-specific installation instructions for missing dependencies
• Prevents wasted time troubleshooting - know what's missing instantly
• Special support for Linux/Ubuntu stripped installations

Auto-Submit Solutions

Toggle auto-submission to automatically send found solutions to the Midnight Scavenger API. Or review and submit them manually - your choice.

Enhanced UI/UX (NEW in v0.3.0)

• Matrix-themed design with floating umbrella icons
• Improved Start/Stop mining buttons with better spacing and visual feedback
• Color-matched export buttons to green theme
• Styled warning modals for better user experience
• Consistent cyberpunk aesthetic across all pages

Merge Address Management (NEW in v0.4.20)

Complete reward consolidation system for merging mining outputs from multiple wallets into a single payout address.

• Merge statistics dashboard with real-time wallet counts and eligibility status
• Bulk merge all eligible wallets in one operation
• Recent merge history showing last 10 operations with status and timestamps
• Export all merged wallet data for auditing and record-keeping
• Anti-daisy-chain protection enforces Midnight rules (wallets used as payout cannot be re-merged)
• CIP-8 signed merge transactions with crypto receipt proofs

Custom Wallet Import (NEW in v0.4.20)

Import existing Cardano wallets from other platforms (Eternl, Nami, Typhon) for use as payout addresses.

• Paste 24-word mnemonic from any BIP39-compatible wallet
• Optional custom derivation path (account/chain/address format)
• Automatic path detection scans common paths (0/0/0 through 0/0/9)
• Registration verification with Midnight Scavenger Mine API
• Smart fallback to user-provided path with warning if not found in database
• Encrypted mnemonic storage for secure wallet recovery

Encrypted Wallet Storage (NEW in v0.4.20)

All sensitive wallet data encrypted before database storage.

• 24-word mnemonic recovery phrases encrypted at-rest
• Extended private keys encrypted using symmetric encryption
• Database breach does not expose plaintext mnemonics
• Full wallet recovery capability from encrypted exports
• Enables secure merge transaction signing from stored payout wallet

Auto Wallet Selection (NEW in v0.4.20)

Intelligent payout wallet selection for merge operations.

• Priority system: imported payout wallet first, then auto-selected mining wallet
• Automatic detection of best payout candidate
• Status indicators show active payout wallet
• Prevents merge errors from missing payout configuration

Smart Start/Stop Controls

Graceful process management with real-time status updates. Stop mining instantly with proper cleanup - no orphaned processes.

Live Terminal Output

Watch your miner work in real-time with a cyberpunk-styled terminal showing hash rates, progress, and solutions found.

Comprehensive Management

• Solutions Tab - View all mined solutions, submission status, and receipts
• Wallets Tab - Track all generated Cardano wallets and their registration status
• Manual Submit - Submit solutions individually with full control
• Create Table - Initialize database tables with one click

High Performance

• PHP FFI integration with compiled Rust ashmaize_capi.dll for near-native hashing performance
• ~1000 hashes/second on consumer hardware
• Efficient wallet generation using native PHP crypto libraries

Battle-Tested Cryptography

• Full Cardano HD wallet derivation (BIP39/BIP32)
• CIP-8 message signing for address registration
• Ed25519 signature verification
• Secure random nonce generation

---

Installation

Requirements

• WordPress 5.0+
• PHP 8.0+ with FFI and BCMath extensions enabled
  • FFI Extension: Required for high-performance hashing via compiled libraries
  • BCMath Extension: Required for Ed25519 cryptographic signing (wallet registration and merge operations)
  • Installation: sudo apt-get install php-ffi php-bcmath (adjust version as needed, e.g., php8.2-bcmath)
  • CRITICAL: PHP executable version and php.ini configuration MUST match exactly
  • Common error: Using PHP 8.3.17 executable with PHP 8.2.27 ini file causes database connection failures
  • Solution: Update site's PHP version in Local to match your lightning-services PHP version
• Platform Support: Windows, Linux, macOS
• Pre-compiled Libraries: Included for Windows (.dll), Linux (.so), macOS (.dylib)

Steps

1. Download the plugin

   • Clone or download this repository
   • Place the umbrella-mines folder in your WordPress wp-content/plugins/ directory

2. Activate the plugin

   • Go to WordPress Admin > Plugins
   • Find "Umbrella Mines" and click "Activate"

3. Create database tables

   • Go to Umbrella Mines > Create Table
   • Click "Initialize Database Tables"
   • Tables will be created automatically

4. Start mining

   • Go to Umbrella Mines > Dashboard
   • (Optional) Check "Auto-submit solutions" to automatically submit found solutions
   • Click "START MINING"
   • That's it. Seriously.

---

Compiling Libraries (Optional)

Pre-compiled libraries for Windows, Linux, and macOS are included in the bin/ directory. However, if you need to compile them yourself:

Automatic Compilation (GitHub Actions)

Every push to the repository automatically compiles libraries for all platforms via GitHub Actions:

1. Libraries are built for Windows (.dll), Linux (.so), and macOS (.dylib)
2. Download from the latest GitHub Actions run artifacts
3. SHA256 hashes are generated for verification
4. Or grab from the latest GitHub Release

Manual Compilation

Requirements:

• Rust toolchain installed (rustup from https://rustup.rs)

Steps:

cd rust-wrapper
cargo build --release

# The compiled library will be at:
# Windows: target/release/ashmaize_capi.dll
# Linux:   target/release/libashmaize_capi.so
# macOS:   target/release/libashmaize_capi.dylib

# Copy to bin/ directory:
cp target/release/libashmaize_capi.{so,dylib,dll} ../bin/ashmaize_capi.{so,dylib,dll}

Cross-Platform Compilation:

Linux and macOS libraries can be cross-compiled from Windows using WSL or Docker, but the easiest method is to use GitHub Actions (automatic) or compile natively on each platform.

---

Usage

Dashboard

The main control center with a live terminal view:

• Max Attempts per Wallet - Number of nonces to try before generating a new wallet (default: 500,000)
• Derivation Path - Custom wallet derivation path in format account/chain/address (default: 0/0/0)
• START MINING - Begin mining with current settings
• STOP MINING - Gracefully stop the mining process
• Auto-submit solutions - Toggle to automatically submit solutions to the API

The terminal shows live output including:

• Configuration and derivation paths
• Challenge information (difficulty, ID, no_pre_mine ROM)
• Wallet generation and API registration
• Mining progress with hash rate and ETA
• Solutions found and submission status

Solutions Tab

View and manage all mined solutions:

• Solution details (nonce, preimage, hash, difficulty)
• Submission status (pending, submitted, confirmed, failed)
• Manual submission controls with one-click submit buttons
• Receipt viewing and management
• Reset status or delete solutions

Wallets Tab

Track all generated Cardano wallets:

• Wallet addresses and derivation paths
• Registration status and timestamps
• Payment public keys and key hashes
• Solution counts per wallet
• Network (mainnet/testnet)

Manual Submit

Submit individual solutions with full visibility:

• Select challenge and wallet from dropdowns
• Enter nonce and preimage manually
• Submit directly to the Midnight Scavenger API
• View real-time API responses (success or error messages)
• 3-minute timeout for slow API responses

Create Table

One-click database initialization:

• Creates all required tables
• Sets up indexes for performance
• Initializes configuration with default API URL
• Safe to run multiple times (checks for existing tables)

---

How It Works