Resources
CTU metering test vectors
Run your meter against these cases.
DraftVersion 0.2.0Drafted 12 November 2026Owner: Systems Engineering (role being recruited; interim owner to be named, Q4)Licence: [to be confirmed]Side of the line: published
A draft (0.x): read it, build to it and comment on it; it may change without notice. Drawn from the CTU book and the Sovereign Stack page. Changelog · Comment on this specification
In short
Run your meter against these cases. A meter conforms at a level when it gives the expected result for every vector at that level. All values are examples. No meter has been tested against them yet; when one has, the changelog will say so.
| # | Level | Case | Expected | Fields checked |
|---|---|---|---|---|
| V1 | 1 | A passing cycle on one device | One record; all fields present | Outcome, Energy |
| V2 | 1 | A cycle rejected at the gate | One record; outcome reject; energy counted | Outcome, Energy |
| V3 | 1 | A cycle that fails before the gate | One record; outcome failed; energy counted | Outcome, Energy |
| V4 | 2 | Two cycles sharing a node | Two records; allocations sum to the node meter | Allocation rule, Energy |
| V5 | 2 | Missing meter readings for part of a cycle | Record marked unverified; no silent estimate | Energy |
| V6 | 2 | A correction for a calibration error | A new record pointing back; the original unchanged | Corrects |
| V7 | 1 | No CTU definition yet | Conversion: none; CTU empty; raw values present | Conversion, CTU, Energy, Compute |
| V8 | 1 | A record with a personal name in it | Rejected | Deployment |
From data. All values are examples. No meter has been tested against these vectors yet.
Levels
| Level | A meter at this level | Needed for |
|---|---|---|
| 1 Record | Emits one complete record per cycle, with every required field and unit, including failed cycles | Testnet cycles |
| 2 Verified | Level 1, plus signed records that pass the five checks, with T1 measured | Partner reports |
| 3 Facility | Level 2, plus T2 metered rather than estimated, and raw logs kept for audit | Benefit-report figures |
