Practical overview
When it fits
Use it for coordinated mining and proof submission on the documented quip-validator chain, or as a starting point for adapting Ising-based mining infrastructure. Adapting the chain integration elsewhere requires modification.
Who it is for
- Operators running self-hosted quip-validator mining infrastructure.
- Rust developers extending the coordinator or solver integrations.
- Researchers evaluating classical and D-Wave approaches to Ising-based mining.
Documented uses
- Follow the chain head and stage mining problems.
- Coordinate miner subprocesses and check solutions against a difficulty gate.
- Submit accepted proofs through `QuantumPow.submit_proof`.
- Build and test the Rust coordinator workspace.
- Evaluate CPU, CUDA, Metal or D-Wave mining backends.
Requirements & limits
The repository is publicly visible on GitHub and is licensed under AGPL-3.0-or-later. The project describes itself as experimental and provides no production warranties.
- The documented coordinator integration targets quip-validator and
QuantumPow.submit_proof. - The workspace is Rust-based and uses separate miner binaries supervised over a local socket.
- Available backends include CPU, CUDA, Metal and D-Wave, with backend-specific hardware requirements.
- The repository includes offline workspace tests and separate ignored live-devnet integration tests.
- CUDA documentation covers NVIDIA compute capabilities 7.0 through 12.1 and requires a compatible driver and NVIDIA container runtime.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Build the Quip Miner workspace
Compile the coordinator and workspace components from the repository root.
Before you start
- A Rust toolchain matching the repository's pinned rust-toolchain.toml.
- A local checkout of the Quip Miner repository.
Steps
Open a shell at the repository root.
Run the command below.
cargo build --workspaceUse the resulting workspace build as the basis for running or testing the coordinator.
Expected outcome
The Rust workspace is built from the repository root.
Guide limitations
- This recipe documents compilation only; it does not establish a successful mining run or chain connection.
Run the coordinator with a configured setup
Start `quip-coordinator` using a configuration that lists miners and validators.
Before you start
- A built workspace.
- A coordinator configuration file containing the miners and validators.
- Configured chain access as described in the repository documentation.
Steps
Prepare a configuration file such as
./docker/config.tomlwith the miners and validators.Run
quip-coordinator --config ./docker/config.toml.Consult the repository's coordinator documentation for the run model and chain-access details.
Expected outcome
The coordinator is launched with the selected miner and validator configuration.
Guide limitations
- The evidence does not document a complete configuration example or confirm a successful live mining session.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 1 October 2026
- Original website title
- QuipNetwork/quip-miner · Official homepage title · retained in its source language

