Stratum v1 mining server core

[Boblepointu]

Summary

Embedded Stratum v1 mining server for doged, enabling pool-less solo mining directly from the node.

This is the foundational PR — later PRs will add upstream proxy routing, AuxPoW merge-mining RPCs, and multi-chain support on top.

What's included

Layer	Files	Description
Protocol	stratumprotocol.{h,cpp}	Stratum JSON-RPC message types, line-buffered parser, serializers
Config	stratumconfig.{h,cpp}	-stratum, -stratumbind, -stratumport, -stratumpassword, -stratumdiff, -coinbaseaddr CLI args
Worker	stratumworker.{h,cpp}	Per-connection session state machine: subscribe → authorize → mining, variable difficulty retarget
Job	stratumjob.{h,cpp}	Job manager: polls getblocktemplate, splits coinbase for extranonce, builds merkle branches
Submit	stratumsubmit.{h,cpp}	Share validation via scrypt PoW hash, duplicate detection, difficulty check
Stats	stratumstats.{h,cpp}	Connection count, hashrate estimate, accepted/rejected share counters, JSON formatter
Server	stratum.{h,cpp}	libevent TCP listener, accept/read/dispatch loop, thread-safe worker management
Lifecycle	init.cpp	Start/stop stratum in the node init sequence (after chainstate is loaded)
Logging	logging.{h,cpp}	BCLog::STRATUM category
Build	CMakeLists.txt	Compile stratum modules into libserver, wire Boost unit test suite
Unit tests	src/stratum/test/*.cpp	Protocol parsing, config edge cases, worker lifecycle, job creation, share validation, stats output
Functional test	stratum_basic.py	End-to-end: start node with -stratum=1, TCP connect, subscribe, authorize

Architecture

┌─────────────────────────────────┐
│           doged node            │
│  ┌───────────────────────────┐  │
│  │     StratumServer         │  │
│  │  libevent TCP :9334       │  │
│  │  ┌─────────────────────┐  │  │
│  │  │  StratumWorker[]    │  │  │
│  │  │  subscribe/auth/    │  │  │
│  │  │  vardiff/sessions   │  │  │
│  │  └────────┬────────────┘  │  │
│  │           │               │  │
│  │  ┌────────▼────────────┐  │  │
│  │  │  StratumJobManager  │  │  │
│  │  │  getblocktemplate   │  │  │
│  │  │  coinbase split     │  │  │
│  │  │  merkle branches    │  │  │
│  │  └────────┬────────────┘  │  │
│  │           │               │  │
│  │  ┌────────▼────────────┐  │  │
│  │  │  ValidateShare()    │  │  │
│  │  │  scrypt PoW check   │  │  │
│  │  │  submitblock on hit │  │  │
│  │  └─────────────────────┘  │  │
│  └───────────────────────────┘  │
└─────────────────────────────────┘

Usage

doged -stratum=1 -stratumport=9334 -coinbaseaddr=DYourDogeAddress

Follow-up PRs (stacked)

• PR2: Upstream proxy connector + tiered routing (local → proxy → failover)
• PR3: AuxPoW merge-mining RPCs (createauxblock, submitauxblock)
• PR4: Multi-chain merge-mine manager with pluggable IAuxChainModule
• PR5: Independent per-chain target checking + AuxPoW proof construction

Test plan

• ninja check-stratum — 6 Boost unit test suites pass
• test/functional/stratum_basic.py — e2e subscribe + authorize
• Manual: start doged with -stratum=1, connect with any Stratum v1 miner, verify jobs received
• Verify no regressions: ninja check on existing test suites