Struct ContentChunk 

pub struct ContentChunk<const BODY_SIZE: usize = DEFAULT_BODY_SIZE> { /* private fields */ }

A content-addressed chunk with configurable body size.

This type represents a chunk of data whose address is derived from the hash of its contents. It is immutable once created.

Implementations

impl<const BODY_SIZE: usize> ContentChunk<BODY_SIZE>

pub fn new(data: impl Into<Bytes>) -> Result<Self>

Create a new content chunk with the given data.

This function automatically calculates the span based on the data length.

Arguments

• data - The raw data content to encapsulate in the chunk.

Returns

A Result containing the new ContentChunk, or an error if creation fails.

pub fn with_address( data: impl Into<Bytes>, address: ChunkAddress, ) -> Result<Self>

Create a new ContentChunk with a pre-computed address.

This function is useful when the address is already known, for example when retrieving a chunk from a database.

Arguments

• data - The raw data content to encapsulate in the chunk.
• address - The pre-computed address of the chunk.

Returns

A Result containing the new ContentChunk, or an error if creation fails.

pub const fn from_body(body: BmtBody<BODY_SIZE>) -> Self

Create a ContentChunk from a pre-existing BmtBody.

This is an advanced method for when you already have a BmtBody, such as when reconstructing chunks from storage or building intermediate nodes in a merkle tree.

pub fn from_body_with_address( body: BmtBody<BODY_SIZE>, address: ChunkAddress, ) -> Self

Create a ContentChunk from a pre-existing BmtBody with a known address.

This is an advanced method for when you already have both the body and know the chunk’s address (e.g., when reconstructing from storage).

Trait Implementations

impl<'a, const BODY_SIZE: usize> Arbitrary<'a> for ContentChunk<BODY_SIZE>

Available on crate features arbitrary only.

fn arbitrary(u: &mut Unstructured<'a>) -> Result<Self>

Generate an arbitrary value of Self from the given unstructured data.

fn arbitrary_take_rest(u: Unstructured<'a>) -> Result<Self, Error>

Generate an arbitrary value of Self from the entirety of the given unstructured data.

fn size_hint(depth: usize) -> (usize, Option<usize>)

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

fn try_size_hint( depth: usize, ) -> Result<(usize, Option<usize>), MaxRecursionReached>

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

impl<const BODY_SIZE: usize> BmtChunk for ContentChunk<BODY_SIZE>

fn span(&self) -> u64

Get the span of the chunk data

impl<const BODY_SIZE: usize> Chunk for ContentChunk<BODY_SIZE>

type Header = ContentChunkHeader

The header type for this chunk

fn address(&self) -> &ChunkAddress

Get the address of this chunk

fn data(&self) -> &Bytes

Get the raw data contained in this chunk

fn size(&self) -> usize

Get the total size of this chunk in bytes

fn header(&self) -> &Self::Header

Get the header for this chunk

fn verify(&self, expected: &ChunkAddress) -> Result<()>

Verify that this chunk matches an expected address

impl<const BODY_SIZE: usize> ChunkEncrypt for ContentChunk<BODY_SIZE>

Available on crate feature encryption only.

fn encrypt_with( &self, key: &EncryptionKey, ) -> Result<EncryptedContentChunk<BODY_SIZE>>

Encrypt this chunk with a caller-provided key.

The returned EncryptedContentChunk contains:

• chunk: a new ContentChunk whose data is the ciphertext
• encrypted_ref: the 64-byte reference (new address + decryption key)

let chunk = ContentChunk::<DEFAULT_BODY_SIZE>::new(b"secret data".to_vec()).unwrap();
let encrypted = chunk.encrypt().unwrap();

// The encrypted chunk has a different address
assert_ne!(chunk.address(), encrypted.chunk().address());

type Encrypted = EncryptedContentChunk<BODY_SIZE>

The encrypted output type.

fn encrypt(&self) -> Result<Self::Encrypted>

Encrypt with a randomly generated key.

impl<const BODY_SIZE: usize> ChunkType for ContentChunk<BODY_SIZE>

const TYPE_ID: ChunkTypeId = super::type_id::ChunkTypeId::CONTENT

The wire-level type identifier for this chunk type.

const TYPE_NAME: &'static str = "content"

Human-readable name for this chunk type.

impl<const BODY_SIZE: usize> Clone for ContentChunk<BODY_SIZE>

fn clone(&self) -> ContentChunk<BODY_SIZE>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<const BODY_SIZE: usize> Debug for ContentChunk<BODY_SIZE>

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

Formats the value using the given formatter.

impl<const BODY_SIZE: usize> Display for ContentChunk<BODY_SIZE>

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

Formats the value using the given formatter.

impl<const BODY_SIZE: usize> Eq for ContentChunk<BODY_SIZE>

impl<const BODY_SIZE: usize> From<ContentChunk<BODY_SIZE>> for AnyChunk<BODY_SIZE>

fn from(chunk: ContentChunk<BODY_SIZE>) -> Self

Converts to this type from the input type.

impl<const BODY_SIZE: usize> From<ContentChunk<BODY_SIZE>> for Bytes

fn from(chunk: ContentChunk<BODY_SIZE>) -> Self

Converts to this type from the input type.

impl<const BODY_SIZE: usize> PartialEq for ContentChunk<BODY_SIZE>

fn eq(&self, other: &Self) -> 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<const BODY_SIZE: usize> TryFrom<&[u8]> for ContentChunk<BODY_SIZE>

type Error = PrimitivesError

The type returned in the event of a conversion error.

fn try_from(bytes: &[u8]) -> Result<Self>

Performs the conversion.

impl<const BODY_SIZE: usize> TryFrom<Bytes> for ContentChunk<BODY_SIZE>

type Error = PrimitivesError

The type returned in the event of a conversion error.

fn try_from(bytes: Bytes) -> Result<Self>

Performs the conversion.