Struct AppendableChain

pub struct AppendableChain { /* private fields */ }

A chain in the blockchain tree that has functionality to execute blocks and append them to itself.

Implementations

impl AppendableChain

pub const fn new(chain: Chain) -> AppendableChain

Create a new appendable chain from a given chain.

pub fn into_inner(self) -> Chain

Get the chain.

pub fn new_canonical_fork<N, E>( block: SealedBlockWithSenders, parent_header: &SealedHeader, canonical_block_hashes: &BTreeMap<u64, FixedBytes<32>>, canonical_fork: NumHash, externals: &TreeExternals<N, E>, block_attachment: BlockAttachment, block_validation_kind: BlockValidationKind, ) -> Result<AppendableChain, InsertBlockErrorKind>

where N: ProviderNodeTypes, E: BlockExecutorProvider,

Create a new chain that forks off of the canonical chain.

if BlockValidationKind::Exhaustive is specified, the method will verify the state root of the block.

Methods from Deref<Target = Chain>

pub fn blocks(&self) -> &BTreeMap<u64, SealedBlockWithSenders>

Get the blocks in this chain.

pub fn headers(&self) -> impl Iterator<Item = SealedHeader>

Returns an iterator over all headers in the block with increasing block numbers.

pub fn trie_updates(&self) -> Option<&TrieUpdates>

Get cached trie updates for this chain.

pub fn clear_trie_updates(&mut self)

Remove cached trie updates for this chain.

pub fn execution_outcome( &self, ) -> &ExecutionOutcome<<N as NodePrimitives>::Receipt>

Get execution outcome of this chain

pub fn execution_outcome_mut( &mut self, ) -> &mut ExecutionOutcome<<N as NodePrimitives>::Receipt>

Get mutable execution outcome of this chain

pub fn prepend_state(&mut self, state: BundleState)

Prepends the given state to the current state.

pub fn is_empty(&self) -> bool

Return true if chain is empty and has no blocks.

pub fn block_number(&self, block_hash: FixedBytes<32>) -> Option<u64>

Return block number of the block hash.

pub fn block(&self, block_hash: FixedBytes<32>) -> Option<&SealedBlock>

Returns the block with matching hash.

pub fn block_with_senders( &self, block_hash: FixedBytes<32>, ) -> Option<&SealedBlockWithSenders>

Returns the block with matching hash.

pub fn execution_outcome_at_block( &self, block_number: u64, ) -> Option<ExecutionOutcome<<N as NodePrimitives>::Receipt>>

Return execution outcome at the block_number or None if block is not known

pub fn inner( &self, ) -> (ChainBlocks<'_>, &ExecutionOutcome<<N as NodePrimitives>::Receipt>)

Destructure the chain into its inner components:

1. A reference to the blocks contained in the chain.
2. A reference to the execution outcome representing the final state.

pub fn block_receipts_iter( &self, ) -> impl Iterator<Item = &Vec<Option<<N as NodePrimitives>::Receipt>>>

Returns an iterator over all the receipts of the blocks in the chain.

pub fn blocks_iter(&self) -> impl Iterator<Item = &SealedBlockWithSenders>

Returns an iterator over all blocks in the chain with increasing block number.

pub fn blocks_and_receipts( &self, ) -> impl Iterator<Item = (&SealedBlockWithSenders, &Vec<Option<<N as NodePrimitives>::Receipt>>)>

Returns an iterator over all blocks and their receipts in the chain.

pub fn fork_block(&self) -> NumHash

Get the block at which this chain forked.

pub fn first(&self) -> &SealedBlockWithSenders

Get the first block in this chain.

Panics

If chain doesn’t have any blocks.

pub fn tip(&self) -> &SealedBlockWithSenders

Get the tip of the chain.

Panics

If chain doesn’t have any blocks.

pub fn len(&self) -> usize

Returns length of the chain.

pub fn range(&self) -> RangeInclusive<u64>

Returns the range of block numbers in the chain.

Panics

If chain doesn’t have any blocks.

pub fn receipts_by_block_hash( &self, block_hash: FixedBytes<32>, ) -> Option<Vec<&<N as NodePrimitives>::Receipt>>

Get all receipts for the given block.

pub fn receipts_with_attachment( &self, ) -> Vec<BlockReceipts<<N as NodePrimitives>::Receipt>>

Get all receipts with attachment.

Attachment includes block number, block hash, transaction hash and transaction index.

pub fn append_block( &mut self, block: SealedBlockWithSenders, execution_outcome: ExecutionOutcome<<N as NodePrimitives>::Receipt>, )

Append a single block with state to the chain. This method assumes that blocks attachment to the chain has already been validated.

pub fn append_chain( &mut self, other: Chain<N>, ) -> Result<(), BlockExecutionError>

Merge two chains by appending the given chain into the current one.

The state of accounts for this chain is set to the state of the newest chain.

Trait Implementations

impl Clone for AppendableChain

fn clone(&self) -> AppendableChain

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for AppendableChain

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

Formats the value using the given formatter.

impl Default for AppendableChain

fn default() -> AppendableChain

Returns the “default value” for a type.

impl Deref for AppendableChain

type Target = Chain

The resulting type after dereferencing.

fn deref(&self) -> &<AppendableChain as Deref>::Target

Dereferences the value.

impl DerefMut for AppendableChain

fn deref_mut(&mut self) -> &mut <AppendableChain as Deref>::Target

Mutably dereferences the value.

impl PartialEq for AppendableChain

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

impl StructuralPartialEq for AppendableChain

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 344 bytes