Struct SingleOwnerChunk 

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

A single-owner chunk with configurable body size.

This type represents a chunk of data that belongs to a specific owner and includes a digital signature proving ownership.

Implementations

impl<const BODY_SIZE: usize> SingleOwnerChunk<BODY_SIZE>

pub fn new( id: B256, data: impl Into<Bytes>, signer: &impl SignerSync, ) -> Result<Self>

Create a new single-owner chunk with the given ID, data, and signer.

This function automatically calculates the span based on the data length and signs the chunk using the provided signer.

Arguments

• id - The unique identifier for this chunk.
• data - The raw data content to encapsulate in the chunk.
• signer - The signer to use for signing the chunk.

Returns

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

pub fn with_signature( id: B256, signature: Signature, data: impl Into<Bytes>, ) -> Result<Self>

Create a new SingleOwnerChunk with a pre-signed signature.

This function is useful when the signature is already known, for example when retrieving a chunk from a database or when reconstructing after verification.

Arguments

• id - The unique identifier for this chunk.
• signature - The pre-computed signature.
• data - The raw data content to encapsulate in the chunk.

Returns

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

pub fn new_dispersed_replica( mined_byte: u8, body: BmtBody<BODY_SIZE>, ) -> Result<Self>

Create a new SingleOwnerChunk as a dispersed replica.

Arguments

• mined_byte - The first byte of the chunk’s ID.
• body - The underlying BMT body containing the data and metadata.

pub const fn from_parts( id: B256, signature: Signature, body: BmtBody<BODY_SIZE>, ) -> Self

Create a SingleOwnerChunk from pre-computed parts.

This is an advanced method for reconstructing chunks from storage when you have all the individual components.

Arguments

• id - The chunk’s unique identifier.
• signature - The digital signature.
• body - The BMT body containing the data.

pub fn from_parts_with_caches( id: B256, signature: Signature, body: BmtBody<BODY_SIZE>, address: ChunkAddress, owner: Address, ) -> Self

Create a SingleOwnerChunk from pre-computed parts with cached address and owner.

This is an advanced method for reconstructing chunks when you also know the chunk address and owner address.

pub fn owner(&self) -> Result<Address, ChunkError>

Get the owner’s address, derived from the signature.

This computes the owner’s address by recovering it from the signature and the signed data (the chunk’s ID and body hash). The result is cached on success for subsequent calls.

Returns

The owner’s address as a 20-byte fixed array, or an error if signature recovery fails.

Errors

Returns ChunkError::Signature if the signature recovery fails.

pub const fn id(&self) -> B256

Get the ID of this chunk.

pub const fn signature(&self) -> &Signature

Get the signature of this chunk.

Trait Implementations

impl<'a, const BODY_SIZE: usize> Arbitrary<'a> for SingleOwnerChunk<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 SingleOwnerChunk<BODY_SIZE>

fn span(&self) -> u64

Get the span of the chunk data

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

type Header = SingleOwnerChunkHeader

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> ChunkType for SingleOwnerChunk<BODY_SIZE>

const TYPE_ID: ChunkTypeId = super::type_id::ChunkTypeId::SINGLE_OWNER

The wire-level type identifier for this chunk type.

const TYPE_NAME: &'static str = "single_owner"

Human-readable name for this chunk type.

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

fn clone(&self) -> SingleOwnerChunk<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 SingleOwnerChunk<BODY_SIZE>

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

Formats the value using the given formatter.

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

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

Formats the value using the given formatter.

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

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

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

Converts to this type from the input type.

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

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

Converts to this type from the input type.

impl<const BODY_SIZE: usize> PartialEq for SingleOwnerChunk<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 SingleOwnerChunk<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 SingleOwnerChunk<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.