ReserveGrid OS is a miner-facing Stratum V2 gateway with Noise NX encrypted transport, template verification, fail-closed prevhash switching, and a two-event share lifecycle. Every decision carries a machine-readable reason code.
Stratum V2 lets miners propose their own block templates. Pools gain encrypted transport and reduced bandwidth, but lose visibility into what miners submit. Without verification, a pool has no way to detect malformed templates, fee policy violations, or stale prevhash references before distributing work.
ReserveGrid OS sits between miners and the pool as a standard job server. It verifies every template against operator policy, switches prevhash references with fail-closed safety, tracks shares through a two-event lifecycle, and emits structured reason codes for every decision.
From miner handshake to upstream share submission, every hop is observable.
Shadow audits templates without miners. Observe logs verdicts without gating. Inline enforces policy with fail-closed safety. One binary, one config key.
See modesEvery share produces share_accepted at ACK time and share_forward_result after upstream POST. Joined by share_id with a 1:1 invariant.
When a new block arrives, miners hold on stale work until the verifier responds. 50ms verdict timeout, 5s stale hold, deterministic disconnect on expiry.
See timing| Capability | Traditional pool | SV2 without ReserveGrid | SV2 + ReserveGrid |
|---|---|---|---|
| Miner transport encryption | ✗ Plaintext | ✓ Noise NX | ✓ Noise NX |
| Template verification | ○ Pool-side only | ✗ None | ✓ Policy-driven, 34 reason codes |
| Prevhash safety | ○ Implicit | ✗ No verification gate | ✓ Fail-closed, 50ms + 5s hold |
| Share audit trail | ✗ Pool internal | ✗ None at gateway | ✓ Two-event lifecycle with HMAC |
| Reject traceability | ✗ Opaque | ✗ SV2 wire codes only | ✓ reason_code + policy context |
| Operator config surface | ○ Varies | ✗ Minimal | ✓ 51 TOML keys + env overrides |
| Observability | ○ Custom | ✗ Not built in | ✓ Prometheus + event stream + Grafana |
Every verdict is structured, machine-readable, and carries the policy context that caused it.
{
"accepted": false,
"reason_code": "avg_fee_below_minimum",
"reason_detail": "avg_fee=141 < min_avg_fee_used=200",
"policy_context": {
"fee_tier": "mid",
"min_avg_fee_used": 200
}
}
Shadow mode costs nothing. Observe mode builds trust. Inline mode protects revenue.