Struct ResearchWireEnvelopeV1 

pub struct ResearchWireEnvelopeV1 {
    pub schema: String,
    pub version: u16,
    pub kind: ResearchWireKindV1,
    pub payload: Value,
}

A strict, versioned envelope carrying one research contract value.

The envelope uses a JSON Value for the payload so the same transport can cross Node, Python, and Go without requiring those SDKs to instantiate Rust types. Self::validate immediately decodes the value into the closed payload type selected by kind, preserving Rust-side validation and rejecting unknown payload fields.

Fields

schema: String

version: u16

kind: ResearchWireKindV1

payload: Value

Implementations

impl ResearchWireEnvelopeV1

pub fn new( kind: ResearchWireKindV1, payload: Value, ) -> Result<Self, ResearchProtocolError>

Construct and validate an envelope from an arbitrary JSON payload.

pub fn from_slice(bytes: &[u8]) -> Result<Self, ResearchProtocolError>

Decode and validate a bounded JSON wire message.

pub fn from_value(value: Value) -> Result<Self, ResearchProtocolError>

Decode and validate a JSON value at the process boundary.

pub fn to_vec(&self) -> Result<Vec<u8>, ResearchProtocolError>

Encode a validated envelope with the process-boundary size limit.

pub fn validate(&self) -> Result<(), ResearchProtocolError>

Validate envelope identity, bounded encoding, and the selected payload.

pub const fn kind(&self) -> ResearchWireKindV1

Return the payload kind without exposing a second string authority.

pub fn payload(&self) -> &Value

Borrow the raw JSON payload for a host transport adapter.

pub fn from_research_event( payload: ResearchEventV1, ) -> Result<Self, ResearchProtocolError>

Construct a research-event envelope.

pub fn from_reproducibility_manifest( payload: ResearchReproducibilityManifestV1, ) -> Result<Self, ResearchProtocolError>

Construct a reproducibility-manifest envelope.

pub fn payload_as<T>( &self, expected: ResearchWireKindV1, ) -> Result<T, ResearchProtocolError>

where T: DeserializeOwned,

Decode a typed payload after checking that the envelope kind matches.

Trait Implementations

impl Clone for ResearchWireEnvelopeV1

fn clone(&self) -> ResearchWireEnvelopeV1

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ResearchWireEnvelopeV1

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ResearchWireEnvelopeV1

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ResearchWireEnvelopeV1

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ResearchWireEnvelopeV1

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 ResearchWireEnvelopeV1