Practical overview
When it fits
Use Braidpool to explore or develop a self-hosted, peer-to-peer Bitcoin mining-pool design, inspect its dashboard, or work with its documented CPUnet test setup. Check the implementation progress before relying on pool behavior: the README lists important block-connection and validation work as incomplete.
Who it is for
- Independent Bitcoin miners evaluating a peer-to-peer pool design intended to reduce payout variance.
- Developers studying decentralized mining-pool protocols or building local mining-pool test environments.
- Users who want a dashboard for Braidpool and Bitcoin-related data.
Documented uses
- Build and run a Braidpool node connected to a Bitcoin RPC node with hashblock ZMQ notifications.
- Connect additional Braidpool nodes to a seed node using the documented peer settings.
- View Braidpool and Bitcoin-related data in the included dashboard.
- Set up a CPUnet environment for testing Braidpool-related behavior.
Requirements & limits
The project is available as a public GitHub repository under the AGPL-3.0 license.
- The node depends on a Bitcoin RPC node with hashblock ZMQ notifications enabled.
- The documented node build and run process uses Cargo; the dashboard has separate npm-based commands.
- The repository lists connecting braid algorithms to CPUnet blocks and validating received blocks and shares as incomplete.
- The hashrate futures market is a stated design goal, not a documented finished product.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up the Braidpool node against a Bitcoin RPC node
Build and start a Braidpool node connected to a Bitcoin node with hashblock ZMQ notifications enabled.
Before you start
- A running Bitcoin node with RPC access and hashblock ZMQ notifications enabled.
- Rust Cargo tooling.
Steps
Configure the Bitcoin node with RPC settings and a hashblock ZMQ endpoint.
Change to the repository's node directory and run cargo build.
Start a seed node with the Bitcoin RPC and ZMQ connection settings.
Start additional nodes using the seed node address and their own bind ports.
Expected outcome
A Braidpool node process configured to connect to the Bitcoin node, with additional nodes able to point to the seed node.
Guide limitations
- The README describes the node's current peer-to-peer broadcast as simple.
- Connecting braid algorithms to CPUnet blocks and validating received blocks and shares are listed as incomplete.
Run the dashboard locally
Start the Braidpool dashboard's development server or create and preview its production build.
Before you start
- The repository dashboard directory.
- npm.
Steps
Change to the dashboard directory.
Run npm install to install dependencies.
Run npm run dev to start the development server, or npm run build to create the production build.
Run npm run preview to preview the production build locally.
Expected outcome
A locally served dashboard for visualizing Braidpool and Bitcoin-related data, or a production dashboard build with a local preview.
Guide limitations
- The dashboard is a visualization interface; the README does not describe it as the mining-pool node.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 13 October 2026
- Original website title
- braidpool/braidpool · Official homepage title · retained in its source language