Struct Piece 

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

A piece of archival history.

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

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 = InnerPiece::SIZE

Size of a piece (in bytes)

pub fn from_parts(header: &PieceHeader, record: &Record) -> Self

Create a piece from its header and record.

Contents are written into a new allocation directly, without zeroing it first or going through the stack.

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 = InnerPiece>

pub fn is_valid( &self, super_segment_root: &SuperSegmentRoot, num_segments: u32, position: PiecePosition, ) -> bool

Check whether the piece is valid against the matching super segment root

pub fn record_root(&self) -> RecordRoot

Root of the record contained within a piece.

It is re-derived on every call of this function.

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) -> Self

Returns a duplicate 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

Available on crate feature scale-codec only.

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

where I: Input,

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 = InnerPiece

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

Available on crate feature serde only.

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

Available on crate feature scale-codec only.

fn size_hint(&self) -> usize

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

fn encode_to<O>(&self, dest: &mut O)

where O: Output + ?Sized,

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>(&self, f: F) -> R

where F: FnOnce(&[u8]) -> R,

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

fn encoded_size(&self) -> usize

Calculates the encoded size.

impl EncodeLike for Piece

Available on crate feature scale-codec only.

impl Eq for Piece

impl From<&InnerPiece> for Piece

fn from(value: &InnerPiece) -> 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: &Self) -> bool

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Piece

Available on crate feature serde only.

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

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Piece

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.