Struct ObjectDescriptor 

pub struct ObjectDescriptor { /* private fields */ }

Complete object plus exact ordered block hashes. A digest is not authenticity. Deployment must authenticate this descriptor before admitting a transfer.

Implementations

impl ObjectDescriptor

pub fn new( object_hash: String, total_bytes: u64, block_bytes: u32, block_hashes: Vec<String>, limits: TransferLimits, ) -> TransferResult<Self>

Constructs a version-one descriptor with strict lowercase SHA-256 identities.

pub fn from_reader( reader: impl Read, total_bytes: u64, block_bytes: u32, limits: TransferLimits, ) -> TransferResult<Self>

Reads an exact bounded object incrementally; no complete-object allocation. Callers own source I/O deadlines and authenticity of the resulting descriptor.

pub fn validate(&self, limits: TransferLimits) -> TransferResult<()>

Validates version, arithmetic and all resource/identity bounds.

pub fn from_json(bytes: &[u8], limits: TransferLimits) -> TransferResult<Self>

Strict bounded JSON; unknown fields/versions fail at this boundary.

pub fn to_json(&self) -> TransferResult<Vec<u8>>

Deterministic descriptor serialization, bounded by the validated hash inventory.

pub fn object_hash(&self) -> &str

Full object SHA-256 identity.

pub fn total_bytes(&self) -> u64

Exact complete object bytes.

pub fn block_bytes(&self) -> u32

Maximum block length; the last block may be shorter.

pub fn block_count(&self) -> usize

Number of complete/incomplete blocks.

pub fn block_len(&self, index: usize) -> TransferResult<usize>

Exact length for a valid block index.

pub fn block_offset(&self, index: usize) -> TransferResult<u64>

Offset for a validated block index.

pub fn verify_block(&self, index: usize, bytes: &[u8]) -> TransferResult<()>

Verifies length and digest against the trusted inventory.

Trait Implementations

impl Clone for ObjectDescriptor

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ObjectDescriptor

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ObjectDescriptor

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ObjectDescriptor

impl PartialEq for ObjectDescriptor

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ObjectDescriptor

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 ObjectDescriptor