OpenMinerOS

OpenMinerOS is an open mining OS prototype for Antminer S19-class hardware.

The project is published as GPL-3.0-only open source.

Build 0.1.0 is a safe development baseline:

• Rust workspace bootstrapped for runtime modules.
• Board identity support for Xilinx/Zynq, BeagleBone Black, Amlogic, and CVitek.
• S19-class model matrix with explicit support levels.
• Simulated ASIC backend for local API and UI development.
• REST endpoints for system info, health, miner status, chains, contribution status, and Prometheus metrics.
• Placeholder reproducible image artefact flow for s19-xil, s19-bb, and s19-aml.
• Optional, transparent development contribution defaults to 0.0 % and is capped at 3.0 %.

This build does not flash hardware or ship low-level ASIC drivers yet.

Quick Start

make test
make run-control-plane BOARD=s19-xil MODEL=s19j-pro

Open http://127.0.0.1:8080 for the local status UI.

Board Builds

make image BOARD=s19-xil MODEL=s19j-pro
make image BOARD=s19-bb MODEL=s19j-pro
make image BOARD=s19-aml MODEL=s19j-pro
make verify-repro BOARD=s19-xil MODEL=s19j-pro

The generated files are metadata-only development artefacts in dist/. They are intentionally not flashable firmware images.

API

• GET /api/v1/system/info
• GET /api/v1/system/health
• GET /api/v1/miner/status
• GET /api/v1/chains
• GET /api/v1/contribution/status
• GET /metrics

Development Contribution

OpenMinerOS does not ship a mandatory devfee. The optional contribution target is public and auditable in DEVFEE.md. Hidden wallet addresses, obfuscated pool URLs, and silent redirects are out of scope for this project.