Struct NoEnvelope 

pub struct NoEnvelope;

Pass-through envelope used when transport-layer signing is not required.

It is zero-cost. seal and open return the Bytes they were given, the same allocation, through a std::future::Ready, so the unsigned path neither copies nor allocates (tests/no_envelope_alloc.rs asserts this with a counting allocator). open records no signer, because an unsigned body proves nothing about who sent it. Adopting the async trait therefore changes nothing for an existing service.

media_type is None for every shape. The previous implementation answered "application/octet-stream", which was wrong for a CBOR body. Nothing called it, so nothing noticed.

Trait Implementations

impl Clone for NoEnvelope

fn clone(&self) -> NoEnvelope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl CratestackEnvelope for NoEnvelope

fn media_type(&self, _shape: BodyShape) -> Option<&'static str>

The Content-Type of a sealed body of this shape. None means this envelope adds no framing for shape, so the body keeps the payload’s own media type (the codec’s CONTENT_TYPE, or application/cbor-seq) and content negotiation is unchanged.

fn seal<'a>( &'a self, payload: Bytes, _bind: &'a Binding<'a>, ) -> impl Future<Output = Result<Bytes, CratestackError>> + Send + 'a

Wrap payload, the codec’s output byte for byte, for the peer that will rebuild bind. It runs after codec.encode.

fn open<'a>( &'a self, body: Bytes, _bind: &'a Binding<'a>, _ctx: &'a mut CratestackContext, ) -> impl Future<Output = Result<Bytes, CratestackError>> + Send + 'a

Verify body against bind, run the replay checks, and return the payload for codec.decode. The result should be a zero-copy slice of body, because the verifier checks exactly the bytes it received and nothing is re-serialized (§1).

fn stream_sealer( &self, _bind: Binding<'static>, ) -> Option<Box<dyn StreamSealer>>

A sealer for one outgoing stream, or None when this envelope does not sign streams (plain cbor-seq passes through). It takes Binding<'static> because the sealer outlives the request borrow: chain mode’s h₀ = SHA-256(external_aad) needs the binding (§6).

fn stream_opener( &self, _bind: Binding<'static>, ) -> Option<Box<dyn StreamOpener>>

An opener for one incoming stream, or None when this envelope does not verify streams. See stream_sealer.

fn seal_value<'a, C, T>( &'a self, codec: &'a C, value: &'a T, bind: &'a Binding<'a>, ) -> impl Future<Output = Result<Bytes, CratestackError>> + Send + 'a

where C: CratestackCodec, T: Serialize + Sync + ?Sized,

Encode value with codec and seal the result for bind: the same bytes as codec.encode followed by seal, which is exactly what the default does.

impl Debug for NoEnvelope

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

Formats the value using the given formatter.

impl Default for NoEnvelope

fn default() -> NoEnvelope

Returns the “default value” for a type.