Struct Frame 

pub struct Frame {
    pub kind: FrameKind,
    pub topic: String,
    pub timestamp_ns: u64,
    pub correlation_id: u64,
    pub payload: Vec<u8>,
    pub content_hash: Option<[u8; 32]>,
}

A side-channel frame.

Frames are auditable (Zero-Principle Pillar 6 zero-context-loss): content_hash is SHA-256 over (kind, topic, timestamp_ns, correlation_id, payload). Phase-1: the hash field is optional and defaults to None; in Phase-2 the hash is set during server-side dispatch.

Fields

kind: FrameKind

Which layer emitted the frame.

topic: String

Topic name (or empty when a transport layer without a TypeObject).

timestamp_ns: u64

Wall-clock timestamp in nanoseconds since the UNIX epoch.

correlation_id: u64

Sequence number / sample-identity GUID prefix for cross- layer correlation (R-077).

payload: Vec<u8>

Sample payload as bytes (layer-specific encoding).

content_hash: Option<[u8; 32]>

Optional content hash (Zero-Principle Foundation 2). Set by the server when audit streams are active. Phase-1 defaults to None.

Implementations

impl Frame

pub fn dcps( topic: String, timestamp_ns: u64, correlation_id: u64, payload: Vec<u8>, ) -> Self

Creates a DCPS frame.

pub fn rtps( topic: String, timestamp_ns: u64, correlation_id: u64, payload: Vec<u8>, ) -> Self

Creates an RTPS frame.

pub fn transport( timestamp_ns: u64, correlation_id: u64, payload: Vec<u8>, ) -> Self

Creates a transport frame.

pub fn with_content_hash(self) -> Self

Computes the content hash and stores it.

Hash input: kind tag + topic + timestamp_ns + correlation_id + payload. Idempotent — repeated calls change nothing as long as the content stays the same.

pub fn verify_content_hash(&self) -> bool

Verifies that the stored hash matches the one computed from the current frame content.

Trait Implementations

impl Clone for Frame

fn clone(&self) -> Frame

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Frame

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Frame

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Frame

impl PartialEq for Frame

fn eq(&self, other: &Frame) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Frame

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Frame