Struct ExternalStateReference 

pub struct ExternalStateReference { /* private fields */ }

A bounded reference to a large component-state blob held outside the durable envelope’s inline metadata.

No adapter (S3, Azure, GCS, …) ships with this contract; #144 provides only the capability/model boundary an adapter would later implement against.

Implementations

impl ExternalStateReference

pub const fn new( content_id: ContentIdentity, encoded_len: u64, ) -> ExternalStateReference

Constructs a bounded external-state reference.

pub const fn content_id(&self) -> ContentIdentity

Returns the content identity of the referenced blob.

pub const fn encoded_len(&self) -> u64

Returns the declared encoded length of the referenced blob.

pub fn verify(&self, bytes: &[u8]) -> Result<(), ComponentStateError>

Verifies that resolved bytes match this reference’s declared content identity.

A caller resolving an external reference through an ExternalStateStore must call this before trusting the resolved bytes: missing content is ExternalStateError::ContentMissing from the store itself, while resolved-but-mismatched content is caught here rather than silently accepted.

Errors

Returns ComponentStateError::ExternalReferenceContentMismatch when bytes’s content identity does not match Self::content_id.

Trait Implementations

impl Clone for ExternalStateReference

fn clone(&self) -> ExternalStateReference

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ExternalStateReference

impl Debug for ExternalStateReference

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

Formats the value using the given formatter.

impl Eq for ExternalStateReference

impl PartialEq for ExternalStateReference

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ExternalStateReference