open-standards/mesh/conformance/v1/reference/receipt.json
Transaction Science 5784eba46e Add Mesh — energy-accounted inference serving + routing standard
New open standard (open-standards/mesh): the serving/routing fabric in front
of many models and many backends. A request declares a joule ceiling and a
fidelity floor; the mesh routes it cheapest-sufficient, meters the decode, and
seals a mesh/1 JCR-1 receipt whose headline figure is microjoules per accepted
token (measured at the meter, not estimated). Rides on JCP grants + JCR-1
receipts + the family energy meter; dispatches to JouleClaw; routes across
EOC/Sandbox. No new cryptography.

mesh-rs reference workspace:
- mesh-schema   content-addressed ServeRequest (joule ceiling + fidelity
                floor), F0–F4 fidelity, honest two-part Energy, model-as-recipe,
                route-decision audit + outcome counters
- mesh-router   energy-weighted cheapest-sufficient routing with full candidate
                audit (admit iff fidelity >= floor AND estimate <= ceiling)
- mesh-engine   ServingEngine trait + deterministic, weights-free ReferenceEngine
- mesh-engine-gguf  real backend over the family's pure-Rust GGUF/safetensors
                substrate (feature `gguf`); proven serving a real Falcon-H1
                decode end-to-end (authorise -> route -> meter -> seal -> chain)
- mesh-meter    meter window; estimator + optional RAPL/NVML/Apple bridge
- mesh-receipt  mesh/1 receipt (canonical det-CBOR + COSE_Sign1/EdDSA),
                uj_per_accepted_token sealed in, refuses dishonest HwShunt,
                hash-chained log
- mesh-core     orchestration: authorise JCP grant -> route -> meter -> seal;
                prompt payload passed to the engine, never sealed (hash only)
- mesh-openai   OpenAI-compatible ingest: /v1/chat/completions <-> ServeRequest,
                std-only reference server returning the sealed receipt in
                usage.energy (feature `server`)
- mesh-conformance  deterministic reference serve + field-by-field checks +
                gen-vectors; published v1 vectors

SPEC.md (CC-BY-4.0), README, CONTRIBUTING, conformance/v1; registered in the
repo standards index. cargo test --workspace green; clippy --all-targets clean.

Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-06-27 04:40:58 -04:00

22 lines
680 B
JSON

{
"backend": "tiny",
"cache_hit_tokens": 0,
"energy_provenance": "HwShunt",
"estimated_uj": 3200000,
"fidelity_floor": 1,
"fidelity_met": 1,
"measured_uj": 3200000,
"mesh_receipt": "mesh/1",
"nonce": "3adc393e8a5a2053",
"recipe": "ssm-1b",
"request_id": "3adc393e8a5a2053049e46650e1f15ffc529c0d5ae6872f2d19d2ea8abfa364e",
"route": "cheapest-sufficient: tiny at 3550000 µJ, fidelity F1 ≥ floor F1 (weighed 4 backend(s))",
"sequence": 0,
"spec_accepted": 0,
"spec_proposed": 0,
"steward": "did:key:z6MkvDqGT54cXesYGvABpF1UapVNwjCqRcafi4Px6Thv5T3Z",
"tokens_accepted": 64,
"tokens_in": 7,
"tokens_out": 64,
"uj_per_accepted_token": 50000
}