Struct Piece

pub struct Piece(/* private fields */);

A piece of archival history.

This version is allocated on the heap, for stack-allocated piece see PieceArray.

Internally piece contains a record and corresponding proof that together with segment root of the segment this piece belongs to can be used to verify that a piece belongs to the actual archival history of the blockchain.

Implementations

impl Piece

pub const SIZE: usize = 1_048_896usize

Size of a piece (in bytes).

pub fn to_shared(self) -> Self

Ensure piece contains cheaply cloneable shared data.

Internally piece uses CoW mechanism and can store either mutable owned data or data that is cheap to clone, calling this method will ensure further clones will not result in additional memory allocations.

Methods from Deref<Target = PieceArray>

pub const SIZE: usize = 1_048_896usize

pub fn is_valid(&self, segment_root: &SegmentRoot, position: u32) -> bool

Validate proof embedded within a piece produced by the archiver

pub fn split(&self) -> (&Record, &RecordRoot, &RecordChunksRoot, &RecordProof)

Split piece into underlying components.

pub fn split_mut( &mut self, ) -> (&mut Record, &mut RecordRoot, &mut RecordChunksRoot, &mut RecordProof)

Split piece into underlying mutable components.

pub fn record(&self) -> &Record

Record contained within a piece.

pub fn record_mut(&mut self) -> &mut Record

Mutable record contained within a piece.

pub fn root(&self) -> &RecordRoot

Root contained within a piece.

pub fn root_mut(&mut self) -> &mut RecordRoot

Mutable root contained within a piece.

pub fn parity_chunks_root(&self) -> &RecordChunksRoot

Parity chunks root contained within a piece.

pub fn parity_chunks_root_mut(&mut self) -> &mut RecordChunksRoot

Mutable parity chunks root contained within a piece.

pub fn proof(&self) -> &RecordProof

Proof contained within a piece.

pub fn proof_mut(&mut self) -> &mut RecordProof

Mutable proof contained within a piece.

Trait Implementations

impl AsMut<[u8]> for Piece

fn as_mut(&mut self) -> &mut [u8]

Converts this type into a mutable reference of the (usually inferred) input type.

impl AsRef<[u8]> for Piece

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Piece

fn clone(&self) -> Piece

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Piece

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

Formats the value using the given formatter.

impl Decode for Piece

fn decode<I: Input>(input: &mut I) -> Result<Self, Error>

Attempt to deserialise the value from input.

fn decode_into<I>( input: &mut I, dst: &mut MaybeUninit<Self>, ) -> Result<DecodeFinished, Error>

where I: Input,

Attempt to deserialize the value from input into a pre-allocated piece of memory.

fn skip<I>(input: &mut I) -> Result<(), Error>

where I: Input,

Attempt to skip the encoded value from input.

fn encoded_fixed_size() -> Option<usize>

Returns the fixed encoded size of the type.

impl Default for Piece

fn default() -> Self

Returns the “default value” for a type.

impl Deref for Piece

type Target = PieceArray

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for Piece

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<'de> Deserialize<'de> for Piece

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Encode for Piece

fn size_hint(&self) -> usize

If possible give a hint of expected size of the encoding.

fn encode_to<O: Output + ?Sized>(&self, output: &mut O)

Convert self to a slice and append it to the destination.

fn encode(&self) -> Vec<u8>

Convert self to an owned vector.

fn using_encoded<R, F: FnOnce(&[u8]) -> R>(&self, f: F) -> R

Convert self to a slice and then invoke the given closure with it.

fn encoded_size(&self) -> usize

Calculates the encoded size.

impl From<&PieceArray> for Piece

fn from(value: &PieceArray) -> Self

Converts to this type from the input type.

impl From<Piece> for Vec<u8>

fn from(piece: Piece) -> Self

Converts to this type from the input type.

impl Hash for Piece

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Piece

fn eq(&self, other: &Piece) -> 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 Serialize for Piece

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<&[u8]> for Piece

type Error = ()

The type returned in the event of a conversion error.

fn try_from(slice: &[u8]) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Bytes> for Piece

type Error = ()

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<BytesMut> for Piece

type Error = ()

The type returned in the event of a conversion error.

fn try_from(bytes: BytesMut) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Vec<u8>> for Piece

type Error = ()

The type returned in the event of a conversion error.

fn try_from(vec: Vec<u8>) -> Result<Self, Self::Error>

Performs the conversion.

impl TypeInfo for Piece

type Identity = Piece

The type identifying for which type info is provided.

fn type_info() -> Type

Returns the static type identifier for Self.

impl EncodeLike for Piece

impl Eq for Piece

impl StructuralPartialEq for Piece