Struct EncryptedMode 

pub struct EncryptedMode;

Encrypted chunk mode.

JoinMode (decryption) is always available. SplitMode (encryption) requires the encryption feature because key generation depends on rand.

Trait Implementations

impl Debug for EncryptedMode

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

Formats the value using the given formatter.

impl JoinMode for EncryptedMode

const REF_SIZE: usize = ENCRYPTED_REF_SIZE

Size of a single reference in bytes (32 plain, 64 encrypted).

type RootRef = EncryptedChunkRef

Root reference type: ChunkAddress (plain) or EncryptedChunkRef (encrypted).

type JoinerContext = EncryptionKey

Per-chunk context carried through tree traversal: () (plain) or EncryptionKey.

fn root_address(input: &EncryptedChunkRef) -> ChunkAddress

Extract the chunk address from a root reference (for fetching).

fn init_from_chunk<const BS: usize>( root_ref: EncryptedChunkRef, chunk: ContentChunk<BS>, ) -> Result<(ChunkAddress, u64, EncryptionKey)>

Initialize joiner from a root ref and pre-fetched root chunk.

fn decode_body<const BS: usize>( chunk: ContentChunk<BS>, key: &EncryptionKey, span: u64, ) -> Result<Bytes>

Decode a fetched chunk into body bytes (decrypting if needed).

fn parse_child_ref( body: &[u8], ref_start: usize, ) -> Result<(ChunkAddress, EncryptionKey)>

Parse a child reference from body bytes at offset. Returns (address, child_context).

fn refs_per_chunk(body_size: usize) -> usize

Number of child references per intermediate chunk.

fn levels(length: u64, chunk_size: usize) -> usize

Tree depth for the given file length.

fn subspan_size<const BS: usize>(span: u64) -> u64

Subspan size for a given parent span.

fn child_span<const BS: usize>( parent_span: u64, subspan: u64, child_index: usize, ) -> u64

Compute the span covered by a child at child_index within a parent of parent_span.

impl SplitMode for EncryptedMode

Available on crate feature encryption only.

type RefBytes = [u8; 64]

Fixed-size byte array for a reference: [u8; 32] or [u8; 64].

fn prepare_chunk<const BS: usize>( data: Vec<u8>, ) -> Result<(ContentChunk<BS>, [u8; 64])>

Prepare chunk data (span + body) for storage, returning chunk and reference bytes. Takes ownership of the payload to avoid an extra allocation.

fn process_empty<const BS: usize, S: SyncChunkPut<BS>>( store: &S, ) -> Result<EncryptedChunkRef>

Process empty file, store chunk, return root ref.

fn extract_root(buffer: &[u8]) -> Result<EncryptedChunkRef>

Extract root reference from top of buffer.

fn process_chunk<const BS: usize, S: SyncChunkPut<BS>>( data: Vec<u8>, store: &S, ) -> Result<Self::RefBytes>

Process chunk data (span + body), store it, return reference bytes. Takes ownership of the payload to avoid an extra allocation.