Professional Mining Software Built for Twin Jade™

Open-source daemon and CLI tools that make Bitcoin mining simple—install once, mine forever

Get Started View on GitHub

Complete Software Stack

Everything you need to mine Bitcoin with Twin Jade™—from kernel drivers to command-line tools

jaded Mining Software

High-Performance Mining Engine

Rust-powered async daemon manages your mining hardware, connects to pools, and monitors performance 24/7

Automatic device detection
Stratum pool protocol support
Real-time statistics tracking
REST API for integrations
Auto-recovery from errors

jade Control Tool

Simple Command-Line Control

Go-based CLI provides instant control over devices, pool settings, and real-time monitoring with interactive dashboard

Check status with one command
Change pools instantly
Interactive live dashboard
Fine-tune device settings
Device health monitoring

Open Source Drivers

GPL-2.0 Kernel Drivers

First open-source Bitcoin ASIC controller drivers targeting Linux kernel mainline with Windows support

GPL-2.0 licensed source code
Linux kernel mainline target
Windows 10/11 certified
Cross-platform support
Community contributions

What is jaded?

jaded is a high-performance mining program built with Rust that runs in the background like antivirus software. It manages your Twin Jade cards, connects to mining pools, and handles all the complex work automatically so you can just monitor and collect rewards.

Easy to Use

Automatic Device Detection

jaded finds your Twin Jade cards automatically—no manual configuration needed

Pool Connection Management

Connects to any Stratum mining pool with automatic reconnection if the connection drops

Real-Time Monitoring

Tracks hashrate, shares, and device health 24/7 with detailed statistics

Simple Configuration

Easy-to-edit TOML config file—just set your pool and wallet address to start mining

Runs 24/7

Works as a system service in the background like antivirus software—always mining, never in your way

Advanced Features

REST API

HTTP API on port 8080 for custom integrations and monitoring dashboards

http://localhost:8080/api/status

JSON-RPC 2.0 Interface

Inter-process communication via Unix socket for fast, local control

/var/run/jaded.sock

SQLite Statistics Database

Local database stores your mining history—see performance trends over days or weeks

/var/lib/jaded/stats.db

Health Monitoring

Automatic error detection and recovery—problematic devices are restarted automatically

Dynamic Frequency Tuning

Gradually increases device frequency for healthy ASICs, reduces frequency on errors

Multi-Device Orchestration

Manages multiple Twin Jade cards simultaneously with independent settings per device

Hashrate Splitting

Dedicate individual chips or groups of chips for different purposes—mine different pools simultaneously or allocate resources

Web Dashboard

Modern web interface accessible through luckyjademining.com with offline PWA capabilities for local monitoring

Built for Performance

1ms Nonce Polling

Checks for mining results every millisecond—faster share submission than ESP32-based miners

Lower pool latency, better luck variance

Async Architecture

Built with Rust and Tokio async runtime—handles multiple tasks simultaneously without slowdowns

Processes thousands of hash results per second

Low Latency Pools

Direct TCP connection to pools with typical latency of 20-100ms

Fast work updates, quick share submission

What is jade?

jade is a command-line control tool that works like Task Manager on Windows—it shows what's happening with your miner and lets you make changes instantly. Simple commands let you check status, change pools, or view detailed statistics.

Basic Commands

$ jade status

Show mining status and device overview

JX888 Miner Status
==================

Pool: stratum+tcp://solo.ckpool.org:3333 [Connected (latency: 45ms)]
Difficulty: 256.00

Hashrate: 50.50 GH/s (5m: 49.75 GH/s)
Shares: 42 accepted, 1 rejected, 0 errors
Efficiency: 98.5%
Best Share: 128.75

Devices:
ID  Type    Chips  Freq     Hashrate    Accepted  Errors  Status
0   BM1397  4      525 MHz  50.50 GH/s  42        0       Mining

$ jade pool show

See current pool configuration

Primary Pool:
  URL: stratum+tcp://solo.ckpool.org:3333
  User: bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh
  Status: Connected (latency: 45ms)

$ jade pool set stratum+tcp://solo.ckpool.org:3333 -u bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh

Change mining pool

Note: Pool will be updated immediately without restarting the daemon

$ jade device list

List all detected mining devices

ID  Type    Path                Chips  Freq     Status
0   BM1397  /dev/jx888_asic0    4      525 MHz  Mining
1   BM1397  /dev/jx888_asic1    4      525 MHz  Mining

Advanced Commands

$ jade device set-freq 0 525

Fine-tune device frequency for performance or efficiency

Higher frequencies increase power consumption and heat. Monitor temperatures closely.

Note: Typical range: 400-575 MHz. Start low and increase gradually.

$

Interactive dashboard with live updates

Real-time hashrate graphs
Device health indicators
Pool connection status
Temperature and power monitoring
Keyboard shortcuts for quick actions

Note: Press 'q' to quit, 'r' to refresh, 'h' for help

$ jade device restart 0

Restart individual device without stopping daemon

$ jade device info 0

Detailed information about a specific device

Device 0:
  Type: BM1397 (4 chips)
  Path: /dev/jx888_asic0
  Frequency: 525 MHz
  Voltage: 1200 mV
  Temperature: 62°C
  Hashrate: 50.50 GH/s (5m avg)
  Shares: 42 accepted, 1 rejected
  Hardware Errors: 0
  Uptime: 3h 24m
  Status: Mining

Why Choose Lucky Jade Software?

Professional mining software that's powerful yet simple to use

Easy to Use

Install once, mine forever—no complicated setup
No ESP32 firmware or web interfaces to manage
Works just like any system service (starts on boot)
Simple commands like 'jade status' show everything

High Performance

Built with Rust for reliability and speed
1ms nonce polling—faster than ESP32-based miners
Uses your computer's CPU for lower latency
Handles multiple devices without slowdowns

Open Source & Transparent

Inspect the code yourself—no hidden behavior
No vendor lock-in—switch pools or modify software freely
Community-driven improvements and bug fixes
Transparent security—all cryptography is auditable

Production Ready

Runs 24/7 without intervention
Automatic error recovery and health monitoring
Detailed logging and diagnostics
REST API for custom integrations

jade Web Dashboard

Monitor your miner from any device—desktop, tablet, or phone. Choose hosted mode for remote access or local mode for complete privacy.

Deployment Flexibility

Choose hosted mode at luckyjademining.com for instant remote access, or deploy locally for complete privacy. Use both together in hybrid mode.

Progressive Web App

Install on your phone like an app—no app store required. Works offline when on your local network with full PWA capabilities.

Real-Time Monitoring

Live hashrate graphs, device temperature tracking, pool statistics, and per-chip performance—all updated every 2 seconds.

Hashrate Splitting

Allocate chips to different pools with drag-and-drop UI. Test solo mining on one chip while pool mining on others—hedge your strategy.

Remote Configuration

Change pools, adjust frequency/voltage, and restart devices—all from your browser. No SSH or terminal required.

Privacy & Security

Local-only mode keeps all data on your network. Optional cloud sync requires your explicit consent. Your choice, your data.

jade Dashboard vs Competitors

jade Dashboard

✓ Hosted OR self-hosted (your choice)
✓ Progressive Web App (PWA)
✓ Privacy mode (100% local)
✓ Source code available
✓ Hashrate splitting UI

HiveOS

✓ Centralized cloud only
✓ Mobile app
✓ Fleet management
✗ Monthly fee ($3/rig)
✗ Third-party dependency

AxeOS (ESP32)

✓ Local web UI
✓ Simple setup
✗ ESP32 hardware limits
✗ No cloud option
✗ Single device only

Choose Your Deployment

Compare all deployment options and find the best fit for your mining operation

Feature	jade Web (Hosted)	jade Web (Local)	jade TUI	HiveOS	Standalone CLI
Access	Browser (anywhere)	Browser (LAN)	Terminal/SSH	HiveOS web/app	CLI commands only
Installation	None - web only	jade-dashboard package	jade CLI package	HiveOS OS + jaded	jade CLI package
Graphical	Yes - charts	Yes - charts	Text-based	Yes	No
Mobile	PWA	PWA	SSH apps	HiveOS mobile app	SSH apps
Privacy	Cloud with consent	100% local	100% local	HiveOS cloud	100% local
Hashrate Split UI	Visual drag-drop	Visual drag-drop	Config file	Manual config	Manual config
Cost	Free	Free	Free	$3/month/rig (2+)	Free
Best For	Remote monitoring	Privacy, home miners	Server admins, scripters	Large farms (5+ rigs)	Minimal setups, automation

Which Option is Right for You?

Choose jade Web (Hosted) if you:

• Need to monitor remotely (office, travel, phone)
• Want historical analytics beyond 24 hours
• Manage multiple rigs in different locations
• Don't mind opt-in cloud telemetry

Choose jade Web (Local) if you:

• Want complete privacy (no cloud)
• Need real-time device control
• Mine from home with local network access
• Prefer self-hosted solutions

Choose jade TUI if you:

• Are comfortable with terminal/SSH
• Run headless servers or minimal installs
• Want the lowest resource usage
• Script or automate your monitoring

Choose HiveOS if you:

• Manage 5+ mining rigs (large farm)
• Need team collaboration features
• Use mixed hardware (GPUs + ASICs)
• Want centralized cloud management

Technical Architecture

Understanding how the software stack works together

Mining Pool

Stratum V1 Protocol

↓ TCP Connection (20-100ms latency)

jaded Daemon

Work Queue, Nonce Polling (1ms), Stats

↓ ioctl System Calls

Kernel Driver

/dev/jx888_asic0, /dev/jx888_asic1

↓ PCIe Gen 2.0 x1

JX888 Bridge ASIC

PCIe ↔ UART Controller (25 Mbps)

↓ Serial UART @ 3.125 MHz

BM1370 ASIC

Chip 0

BM1370 ASIC

Chip 1

Mining Pool

Provides mining work via Stratum V1 protocol

Connection: TCP socket to jaded daemon

Latency: 20-100ms typically

jaded Daemon

Work distribution, nonce polling, share submission, statistics

Connection: Kernel driver via ioctl system calls

Performance: 1ms nonce polling, async multi-device handling

Kernel Driver

Hardware abstraction for JX888 bridge ASIC

Connection: PCIe to JX888 bridge controller

Interface: /dev/jx888_asic0, /dev/jx888_asic1, etc.

JX888 Bridge ASIC

PCIe-to-UART controller for ASIC communication

Connection: Dedicated high-speed UART to each ASIC

Throughput: Up to 25 Mbps per port

BM1370 ASICs (Dual Chip)

SHA-256 hash computation

Connection: Each ASIC has dedicated high-speed UART connection

Performance: ~600 GH/s per chip @ 525 MHz (1.2 TH/s total per ASIC)

Ready to Start Mining?

Get started with our comprehensive documentation and download the software

View Documentation Download on GitHub