Expand description
Job Declaration Server (JDS) for the Stratum V2 protocol.
This crate implements a server that validates custom mining jobs declared by downstream clients via the Job Declaration Protocol (JDP). It manages token allocation, coinbase and merkle path validation, and delegates block-level validation to a modular Job Validation Engine.
The primary entry point is job_declarator::JobDeclarator, which provides:
JobDeclarator::new— creates the engine with a validation backend (e.g. Bitcoin Core IPC).JobDeclarator::start— launches the JDP message processing loop.JobDeclarator::start_downstream_server— listens for JDC connections on a Noise-encrypted TCP socket.JobDeclarator::handle_set_custom_mining_job— validates a Mining ProtocolSetCustomMiningJobmessage (for use when embedded in Pool).
When used as a library (embedded in Pool), the caller is responsible for owning the
CancellationToken and
TaskManager.
Modules§
- config
- Configuration Module
- error
- Error types and recovery actions for the Job Declaration Server.
- io_task
- Low-level Noise I/O tasks.
- job_
declarator - Core Job Declaration engine.