Struct WriteObjectPrefix 

pub struct WriteObjectPrefix {
    pub format: FormatVersion,
    pub store_key: KeyId,
    pub part_keys: Vec<KeyId>,
}

Cleartext key identities, authenticated by the object’s final signature.

Fields

format: FormatVersion

The format fixed with these keys before the first upload attempt.

store_key: KeyId

The store key sealing section 0, the header frame.

part_keys: Vec<KeyId>

Keys of the audience parts in header order; section i + 1 uses entry i.

Implementations

impl WriteObjectPrefix

pub const MAX_HEADER_END: usize

Greatest permitted end of the clear prefix, sealed header, part roots and header signature (D1/D2, D9).

pub fn header_end(bytes: &[u8]) -> Result<usize, Error>

Exact end of the header and its tail once its length field is available. A truncated prefix requires the caller’s second bounded read to use MAX_HEADER_END.

pub fn tail_length(parts: usize) -> usize

Bytes of the part roots and header signature for this many parts.

pub fn decode_tail(&self, bytes: &[u8]) -> Result<HeaderTail, Error>

Read exactly the part roots and header signature that follow the sealed header chunk.

pub fn encoded_length(parts: usize) -> Result<usize, Error>

Exact prefix size for this many parts, before their key ids are selected.

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

Encode kind, version, header key and the counted list of part keys.

pub fn length(bytes: &[u8]) -> Result<usize, Error>

Determine the complete prefix size from its first 23 bytes, before allocating the counted key list. This is not a plaintext frame prefix.

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

Decode exactly the complete prefix, refusing trailing bytes.

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

Bound the following header’s length prefix before fetching or allocating.

pub fn header_chunk(piece: &[u8]) -> Result<&[u8], Error>

Read the length-prefixed sealed header. Open it with store_key, the object’s path, section 0 and index 0, then call Self::opened_header.

pub fn opened_header( self, bytes: &[u8], part_lengths: Vec<u64>, ) -> Result<WriteObjectLayout, Error>

Begin part chunks after the caller authenticates and decodes the header and reads its tail. part_lengths must come from that header, in part order. This layer treats frame bytes as opaque; the header signature and the final signature still must be checked.

Trait Implementations

impl Clone for WriteObjectPrefix

fn clone(&self) -> WriteObjectPrefix

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WriteObjectPrefix

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

Formats the value using the given formatter.

impl PartialEq for WriteObjectPrefix

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for WriteObjectPrefix

impl StructuralPartialEq for WriteObjectPrefix