Skip to main content

Module stream_provenance

Module stream_provenance 

Source
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§

ProvenanceSigner
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 provenance field cleared (#321). Byte-identical to the publisher’s pre-provenance crate::streaming::encode_stream_block.
verify_provenance
Verify a StreamBlock’s provenance (#321), fail-closed.