Struct BlockReader

pub struct BlockReader<'r>(/* private fields */);

Implementations

impl<'r> BlockReader<'r>

pub fn calc_header_hash(&self) -> Byte32

Calls HeaderReader.calc_header_hash() for self.header().

pub fn calc_proposals_hash(&self) -> Byte32

Calls ProposalShortIdVecReader.calc_proposals_hash() for self.proposals().

pub fn calc_uncles_hash(&self) -> Byte32

Calls UncleBlockVecReader.calc_uncles_hash() for self.uncles().

pub fn calc_extension_hash(&self) -> Option<Byte32>

Calculates the hash for the extension.

If there is an extension (unknown for now), calculate the hash of its data.

pub fn calc_tx_hashes(&self) -> Vec<Byte32>

Calculates transaction hashes for all transactions in the block.

pub fn calc_tx_witness_hashes(&self) -> Vec<Byte32>

Calculates transaction witness hashes for all transactions in the block.

impl<'r> BlockReader<'r>

pub fn extra_field(&self, index: usize) -> Option<&[u8]>

Gets the i-th extra field if it exists; i started from 0.

pub fn extension(&self) -> Option<BytesReader<'_>>

Gets the extension field if it existed.

Panics

Panics if the first extra field exists but not a valid BytesReader.

impl<'r> BlockReader<'r>

pub fn serialized_size_without_uncle_proposals(&self) -> usize

Calculates the serialized size of Block without uncle proposals.

Computational Steps

• Calculates the total serialized size of Block, marks it as B.
• Calculates the serialized size ProposalShortIdVec for each uncle block, marks them as P0, P1, ..., Pn.
• Even an uncle has no proposals, the ProposalShortIdVec still has a header contains its total size, the size is molecule::NUMBER_SIZE, marks it as h.
• So the serialized size of Block without uncle proposals is: B - sum(P0 - h, P1 - h, ..., Pn - h)

impl<'r> BlockReader<'r>

pub const FIELD_COUNT: usize = 4usize

pub fn total_size(&self) -> usize

pub fn field_count(&self) -> usize

pub fn count_extra_fields(&self) -> usize

pub fn has_extra_fields(&self) -> bool

pub fn header(&self) -> HeaderReader<'r>

pub fn uncles(&self) -> UncleBlockVecReader<'r>

pub fn transactions(&self) -> TransactionVecReader<'r>

pub fn proposals(&self) -> ProposalShortIdVecReader<'r>

Trait Implementations

impl<'r> CalcExtraHash for BlockReader<'r>

fn calc_extra_hash(&self) -> ExtraHashView

Calculates the extra hash, which is a combination of the uncles hash and the extension hash.

• If there is no extension, extra hash is the same as the uncles hash.
• If there is a extension, then extra hash it the hash of the combination of uncles hash and the extension hash.

impl<'r> Clone for BlockReader<'r>

fn clone(&self) -> BlockReader<'r>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'r> Debug for BlockReader<'r>

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

Formats the value using the given formatter.

impl<'r> Display for BlockReader<'r>

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

Formats the value using the given formatter.

impl<'r> LowerHex for BlockReader<'r>

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

Formats the value using the given formatter.

impl<'r> Reader<'r> for BlockReader<'r>

const NAME: &'static str = "BlockReader"

type Entity = Block

fn to_entity(&self) -> <BlockReader<'r> as Reader<'r>>::Entity

fn new_unchecked(slice: &'r [u8]) -> BlockReader<'r>

fn as_slice(&self) -> &'r [u8]

fn verify(slice: &[u8], compatible: bool) -> Result<(), VerificationError>

fn from_slice(slice: &'r [u8]) -> Result<Self, VerificationError>

fn from_compatible_slice(slice: &'r [u8]) -> Result<Self, VerificationError>

impl<'r> Copy for BlockReader<'r>