Expand description
Selected-wire identities, payload codecs, and metadata profiles.
Wire authors define a UWire marker and stable WireIdentity, associate
payload types through UWirePayload, and implement the codec traits the
payload family requires. Physical carriage does not belong here. The
adapter in wire_transport composes a wire and metadata codec over any
compatible encoded core.
Receive checks identity before profile decoding. A mismatch is an explicit
unknown-identity error, never fallback to another decoder
(req~selected-wire-explicit-rejection~1). The conformance and golden tests
under tests/wire_metadata_* plus external up-wire-xcdrv2-rust are the
implementation references.
Structs§
- Native
Prefix Frame Metadata Codec - Canonical native-prefix metadata codec carrying the clean UFrame metadata field block.
- Protobuf
Wire - Selected wire for Protocol Buffers application payloads.
- Stable
Container Wire Format - Selected wire for stable-container payloads.
- UProtocol
Native Wire - Default first-wave native wire for explicit native payload paths.
- UWire
Metadata Context - Selected-wire metadata context consumed by metadata codecs.
- Wire
Identity - Stable wire, payload-family, or metadata-layout identity.
Enums§
- UWire
Metadata Error - Errors returned by native-prefix selected-wire metadata handling.
- Wire
Compatibility - Compatibility decision between decoded metadata and a selected wire.
- Wire
Identity Ref - Identity reference decoded from native-prefix metadata bytes.
Constants§
- FORMAT_
VERSION - First supported native-prefix metadata byte-format version.
- INVALID_
ID_ FIXTURE_ COMPACT_ ID - Compact ID reserved for invalid-ID fixtures.
- LOCAL_
EXPERIMENTAL_ COMPACT_ ID_ END - Last compact ID reserved for local or experimental future tools.
- LOCAL_
EXPERIMENTAL_ COMPACT_ ID_ START - First compact ID reserved for local or experimental future tools.
- NATIVE_
EXPLICIT_ PAYLOAD_ FAMILY_ ID - Payload-family identity for explicit native payload bytes.
- NATIVE_
PREFIX_ METADATA_ LAYOUT_ ID - Identity for the first-wave native-prefix metadata layout.
- PROTOBUF_
PAYLOAD_ FAMILY_ ID - Payload-family identity for Protocol Buffers application payload bytes.
- PROTOBUF_
WIRE_ ID - Identity for the first-wave Protocol Buffers selected wire.
- STABLE_
CONTAINER_ PAYLOAD_ FAMILY_ ID - Payload-family identity for stable-container payloads.
- STABLE_
CONTAINER_ WIRE_ ID - Identity for the first-wave stable-container selected wire.
- UFRAME_
FIELDS_ METADATA_ LAYOUT_ ID - Metadata layout identity for the canonical UFrame metadata field block carried behind native-prefix framing.
- UPROTOCOL_
NATIVE_ WIRE_ ID - Identity for the first-wave uProtocol native selected wire.
- XCDR_
V2_ PAYLOAD_ FAMILY_ ID - Payload-family identity reserved for external XCDRv2 payload bytes.
- XCDR_
V2_ WIRE_ ID - Identity reserved for the external first-wave XCDRv2 selected wire.
Traits§
- UWire
- Static selected-wire contract.
- UWire
Decode - Wire-level borrowed decode helper alias for existing payload codecs.
- UWire
Decode Owned - Wire-level owned decode helper alias for existing payload codecs.
- UWire
Encode - Wire-level encode helper alias for existing payload codecs.
- UWire
Metadata Codec - Explicit metadata codec used by selected-wire transport adapters.
- UWire
Metadata Codec For - Metadata codec that is statically compatible with selected wire
W. - UWire
Payload - Selected-wire payload mapping for typed payloads.
- UWire
Read Decode - Wire-level reader decode helper alias for existing payload codecs.