Arduino IDE Friendly Stratum V2 Bitcoin Mining Open Source

OpenSV2 Miner is an open-source firmware project built to bring native Stratum V2 Bitcoin mining directly into embedded miner firmware.

The project is focused on making real SV2 mining simple, accessible, and practical for builders, developers, and home miners. Instead of hiding the protocol behind complex tooling, OpenSV2 Miner keeps the firmware-first experience at the center: easy to read, easy to modify, easy to flash, and as simple as possible to compile from source using the Arduino IDE.

The goal is to create a more inclusive path into Bitcoin mining firmware development by allowing anyone to build from source, connect firmware directly to a real Stratum V2 pool/server, and mine over encrypted SV2 transport.

Simplicity does not mean compromise. OpenSV2 Miner is being developed to use the full power of Stratum V2. The experience should feel simple for the user while still respecting the deeper security, transparency, and protocol-level advantages that Stratum V2 was designed to provide.

The goal is simple:

OpenSV2 Miner is being developed around Hashdisk V3 and Bitaxe 602, combining native Stratum V2 firmware with a Solo.Cat-style non-custodial mining architecture.

The goal is not only to mine over Stratum V2, but to make the mining path visible and verifiable to the miner. OpenSV2 Miner is being built so miners can inspect the work they are receiving, understand the active block template, and verify that the Bitcoin block reward is routed exactly where it is supposed to go.

In the intended Solo.Cat payout model, there is:

• No custodial pool wallet holding the reward
• No manual payout ledger
• No delayed withdrawal process
• No hidden payout path

Instead, the payout path is built directly into the block itself through the coinbase transaction.

OpenSV2 Miner is being designed around two core mining modes:

• Solo Mining Mode
• Faction Mining Mode

Both modes are built around the same core principle:

Solo Mining Mode is the most direct and self-sovereign mining path in OpenSV2 Miner.

In this mode, a miner connects using their own Bitcoin payout address and worker name:

Example:

The goal is for the miner to receive real Stratum V2 mining jobs where the coinbase transaction pays directly to that miner’s Bitcoin address if they find a valid Bitcoin block.

There is:

• No shared custodial pool wallet
• No delayed payout system
• No manual payout accounting
• No pool-controlled withdrawal process

The intended reward path is:

Miner connects with their own BTC address
        ↓
Server builds work for that miner
        ↓
Miner finds a valid Bitcoin block
        ↓
Coinbase transaction pays the miner directly

Solo Mining Mode is designed for miners who want the cleanest possible mining setup:

• One miner
• One payout address
• One direct coinbase reward path
• Maximum independence
• Maximum payout transparency
• Miner-side verification of the block template and payout path

Faction Mining Mode is a cooperative mining mode unique to OpenSV2 Miner.

A faction is a group of miners who choose to mine together and split the Bitcoin block reward if their faction finds a block.

The idea is simple:

Faction Mining Mode is designed for home miners, friends, small crews, families, communities, and open-source mining groups who want to mine together without handing custody of the reward to a traditional pool wallet.

Instead of one miner receiving the full coinbase reward, the reward is split equally among the faction miners who are currently eligible based on active valid-share participation.

The intended faction reward path is:

Miners join a faction
        ↓
Faction members contribute valid shares
        ↓
Faction finds a valid Bitcoin block
        ↓
Coinbase transaction pays eligible faction members directly

Faction Mining Mode is not meant to reward inactive members forever.

A key design goal is that faction members should only remain eligible for payout if they are actively contributing valid shares. This helps prevent free-riding and keeps the reward split fair for the miners who are actually helping the faction mine.

Faction Mining Mode is intended to support:

• Public and private factions
• Equal reward splits between eligible active members
• Recent-share-based payout eligibility
• Miner-side visibility into faction status
• Miner-side visibility into payout eligibility
• Coinbase transaction verification
• Template explorer support
• Exclusion of inactive or non-contributing members
• Transparent faction mining without a custodial payout wallet

OpenSV2 Miner is being built to make Bitcoin mining more transparent, more accessible, and more verifiable for small miners.

Solo Mining Mode gives an individual miner a direct path to the block reward.

Faction Mining Mode gives small miners a way to work together without relying on a custodial pool wallet.

Both modes are designed around the same values:

• Native Stratum V2 mining
• Encrypted firmware-to-pool communication
• Real jobs and real shares
• Miner-side visibility
• Coinbase payout verification
• No hidden payout path
• No unnecessary custody
• More power and clarity for the miner

The architecture described in this repository represents the intended firmware, server, payout, mining, and verification model currently being built, tested, and refined. It should not be interpreted as a finished, audited, production-ready, or safety-certified system.

OpenSV2 Miner is provided for research, development, education, and experimental Bitcoin mining firmware testing only. Features may be incomplete, unstable, unverified, insecure, or subject to major changes without notice.

Use this firmware, source code, documentation, hardware guidance, server configuration, mining architecture, and related materials entirely at your own risk.

By using, modifying, flashing, running, connecting to, redistributing, or relying on OpenSV2 Miner in any way, you understand and accept that:

• This project is experimental and may contain bugs, security issues, protocol issues, payout-routing issues, firmware defects, documentation errors, or incomplete functionality.
• Mining results are not guaranteed.
• Shares may be accepted, rejected, lost, delayed, duplicated, misreported, or submitted against stale or invalid jobs.
• Stale jobs, invalid jobs, network failures, pool/server failures, firmware bugs, hardware faults, misconfiguration, Bitcoin network conditions, or user error may result in lost mining opportunities, lost rewards, misdirected payouts, or invalid block submissions.
• Coinbase payout verification, direct coinbase payout routing, non-custodial solo mining, faction mining, payout splitting, eligibility tracking, and template verification are active development goals and must be independently verified before relying on them.
• Faction mining, solo mining, reward routing, payout eligibility, template inspection, and coinbase-output verification should not be treated as production-safe unless independently reviewed, tested, and confirmed by the user.
• Hardware operation may involve electrical, thermal, fire, power-supply, overclocking, firmware-flashing, and permanent device-damage risks.
• You are solely responsible for verifying your own firmware build, configuration, payout address, mining endpoint, server behavior, pool behavior, coinbase transaction, payout routing, hardware safety, electrical setup, thermal setup, and legal or regulatory obligations in your jurisdiction.

OpenSV2 Miner is provided “as is” and “as available”, without warranties or guarantees of any kind, whether express, implied, statutory, or otherwise. This includes, without limitation, any implied warranties of merchantability, fitness for a particular purpose, title, non-infringement, security, accuracy, reliability, uptime, compatibility, or suitability for mining.

To the maximum extent permitted by law, the authors, contributors, maintainers, affiliated projects, related entities, sponsors, hardware partners, and service operators shall not be liable for any direct, indirect, incidental, special, consequential, exemplary, punitive, financial, technical, physical, or other damages arising from or related to the use, misuse, inability to use, modification, redistribution, flashing, configuration, or reliance on OpenSV2 Miner or any related materials.

This includes, but is not limited to:

• Lost mining rewards
• Lost profits
• Lost Bitcoin
• Misdirected payouts
• Rejected shares
• Invalid shares
• Invalid block submissions
• Downtime
• Data loss
• Hardware damage
• Electrical damage
• Thermal damage
• Fire risk
• Pool/server issues
• Configuration mistakes
• Firmware defects
• Security vulnerabilities
• Reliance on incomplete, experimental, or beta functionality

Do not use OpenSV2 Miner with hardware, funds, mining infrastructure, payout expectations, or operational assumptions you are not prepared to lose, damage, or risk.

Before using this project in any real mining environment, you should independently review the source code, test the firmware, verify server behavior, inspect the coinbase transaction, confirm payout routing, validate hardware safety, and fully understand the risks involved.