For an immediately usable, binary version of this software, see releases.

Windows support is coming soon(tm). See bitcoin/bitcoin#32387

The Stratum v2 spec is documented here: https://stratumprotocol.org/specification

For a general overview and how to get started, including the role of this repo, see https://stratumprotocol.org/developers.

cmake -B build
cmake --build build
ctest --test-dir build

See doc/build* for detailed instructions per platform, including dependencies.

Download or compile Bitcoin Core v30.0 or later. Start it with:

bitcoin -m node -ipcbind=unix

Then start the Template Provider, thorough logging is recommended:

build/bin/sv2-tp -debug=sv2 -loglevel=sv2:trace

(for the installed version you don't need build/bin/)

Now connect on of the other Stratum v2 roles to the Template Provider, such as the Job Declarator Client or (e.g. for solo mining) the Pool role. You'll need to provide the Auhority Key which sv2-tp prints in the log.

See https://github.com/stratum-mining/stratum.

The code for this project is originally based on Bitcoin Core, for historical reasons described here. The code is expected to diverge over time, with unused code being removed.

There is no test coverage for code that is identical to the upstream project and bugs there should be fixed upstream, with a pull request here if they're important.

There's still many places where text will simply refer to "Bitcoin Core". Only replace this text if the rest of the file differs from upstream.

• src/sv2: Stratum v2 noise protocol, transport, network and template provider
• test/sv2*: test coverage

The rest is original Bitcoin Core code, albeit stripped down. E.g. the functional testwork has been removed, as has the wallet, GUI, RPC, ZMQ and most p2p code.

Pull requests to strip out additional unused code are welcome. The main barrier to that is that sv2_template_provider_tests requires real node functionality. This should be replaced with a mock, after which the libbitcoin_node target can be dropped and many other things.