Expand description
Relay-visible speculative-messaging commitments.
The relay chain sees only the commitments in the UMPSignal::Provides / Requires signals:
Provides(StreamsRoot): the root of the sender’s keyed stream commitment tree, one per sender block, recorded into the relay’s provides window.Requires(RequiresSet): a receiver’s expected(source, StreamsRoot)entries, matched against each source’s window.
These live here because UMPSignal is defined in polkadot-primitives::v9 and the relay chain
decodes them. The parachain-side types that build them are in
cumulus-primitives-spec-messaging.
Structs§
- Requires
Set - A receiver’s
requirescommitment: a bounded set of(ParaId, StreamsRoot)entries, one per source parachain, sorted by strictly increasingParaId. The order is enforced at decode so the encoding is canonical. The relay matches each entry against that source’s provides window. - Streams
Root - Root of a sender’s stream commitment tree: a compact binary trie keyed by the 8-byte
StreamIdencoding, with the streams’ MMR roots as leaves.
Enums§
- Commitment
Error - Errors that can occur when constructing a
RequiresSet.
Constants§
- MAX_
COMMITMENT_ ENTRIES - Maximum number of source parachains a receiver can consume from in one block; bounds the
requirescommitment. The design’sMaxCommitmentEntries: today’s parachain count rounded up. Consensus-relevant, since decode rejects larger sets.