Struct Envelope 

pub struct Envelope {
    pub payload: String,
    pub payload_type: String,
    pub signatures: Vec<Signature>,
}

A DSSE envelope. This is the portable artifact unit — everything Treeship stores, transmits, and verifies is an Envelope.

The payload field is base64url-encoded statement bytes. The signatures are over PAE(payloadType, decode(payload)). The outer JSON is never signed — only the PAE construction is.

Fields

payload: String

base64url-encoded statement bytes (compact JSON).

payload_type: String

MIME type of the statement. Format: "application/vnd.treeship.<type>.v1+json"

signatures: Vec<Signature>

Signatures over PAE(payloadType, decode(payload)). v1: always exactly one Ed25519 signature.

Implementations

impl Envelope

pub fn payload_bytes(&self) -> Result<Vec<u8>, EnvelopeError>

Decodes the base64url payload back to raw bytes.

pub fn unmarshal_statement<T: DeserializeOwned>( &self, ) -> Result<T, EnvelopeError>

Deserializes the payload into type T.

pub fn sig_bytes(sig: &Signature) -> Result<Vec<u8>, EnvelopeError>

Decodes a single Signature’s sig field to raw bytes.

pub fn to_json(&self) -> Result<Vec<u8>, EnvelopeError>

Serializes the envelope to compact JSON bytes.

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

Parses an envelope from JSON bytes, validating required fields.

Trait Implementations

impl Clone for Envelope

fn clone(&self) -> Envelope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Envelope

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Envelope

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Envelope

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

where __S: Serializer,

Serialize this value into the given Serde serializer.