Struct WriteObjectLayout 

pub struct WriteObjectLayout { /* private fields */ }

Sealed layout cursor, retaining header metadata rather than object bytes. Writers start at the header. Readers start after opening the header with WriteObjectPrefix::opened_header. Hash each encoded piece, including the prefix and length fields, before the final signature.

Implementations

impl WriteObjectLayout

pub fn new( prefix: WriteObjectPrefix, header: &[u8], part_lengths: Vec<u64>, ) -> Result<Self, Error>

Begin producing a write from its header bytes and declared part lengths. Exactly one key is required for every part; lengths come from the header’s plaintext codec, which remains responsible for validating its fields.

pub fn prefix(&self) -> Result<Vec<u8>, Error>

Encode the cleartext prefix before supplying sealed chunks.

pub fn next_chunk(&self) -> Option<ObjectChunk>

Coordinates for the next sealed chunk, or None when only the signature remains.

pub fn chunk_length(&self, prefix: &[u8]) -> Result<usize, Error>

Validate a chunk length prefix against the next exact boundary before allocating.

pub fn encode_chunk(&mut self, bytes: &[u8]) -> Result<Vec<u8>, Error>

Write the next length-prefixed sealed chunk, advancing only on success.

pub fn decode_chunk<'a>( &mut self, piece: &'a [u8], ) -> Result<(ObjectChunk, &'a [u8]), Error>

Read the next complete piece without opening or copying it. A reader lacking this part’s key can skip the returned bytes while hashing them.

pub fn tail(&mut self, tail: &HeaderTail) -> Result<Vec<u8>, Error>

Write the part roots and header signature, only right after the header.

pub fn signature(&mut self, signature: &Signature) -> Result<[u8; 64], Error>

Write a signature only after every declared chunk.

pub fn read_signature(&mut self, bytes: &[u8]) -> Result<Signature, Error>

Read the final 64-byte signature. Crypto verifies it against the author, path and accumulated digest; this method only checks layout.

pub fn finish(&self, trailing: &[u8]) -> Result<(), Error>

Check EOF after the signature. No additional bytes may follow it.