Expand description
Per-host provenance signing/verification for the mesh stream plane (#321).
The chained HMAC on StreamBlock proves “the producer held the DH key and
delivered blocks in order” — it does NOT prove “host-X computed this block”
(threat T3 / C-PROV in the authz threat-model). Provenance closes that gap:
each block is signed with the producing host’s per-host hybrid COSE
identity (Ed25519 + ML-DSA-65, #328 derive_mesh_mldsa_key), and the
consumer verifies the signature AND that the signer key is enrolled in the
mesh roster. This is a layer ON TOP of AEAD + HMAC.
§Canonical signed region
The signature covers the signed region: the StreamBlock serialized with the
provenance field left empty — i.e. exactly crate::streaming::encode_stream_block
over (prevMac, sequenceNumber, epoch, payloads). The publisher signs that
region, then attaches the provenance field; the consumer reconstructs the
same region from the parsed (provenance-cleared) block and verifies. The
signature therefore binds the post-AEAD payloads, the sequence number, and the
epoch — but is independent of the (circular) provenance bytes themselves.
Structs§
- Provenance
Signer - The producing host’s per-host hybrid signing identity (#328): the node’s Ed25519 mesh signer + its deterministically-derived ML-DSA-65 mesh key.
Functions§
- signed_
region_ from_ block - Reconstruct the canonical signed region from a parsed (wire) StreamBlock by
re-encoding it with the
provenancefield cleared (#321). Byte-identical to the publisher’s pre-provenancecrate::streaming::encode_stream_block. - verify_
provenance - Verify a StreamBlock’s provenance (#321), fail-closed.