Struct BlockBuilder

pub struct BlockBuilder<'a, Block: BlockT, A: ProvideRuntimeApi<Block>, B> { /* private fields */ }

Utility for building new (valid) blocks from a stream of extrinsics.

Implementations

impl<'a, Block, A, B> BlockBuilder<'a, Block, A, B>

where Block: BlockT, A: ProvideRuntimeApi<Block> + 'a, A::Api: BlockBuilderApi<Block> + ApiExt<Block>, B: Backend<Block>,

pub fn new( api: &'a A, parent_hash: Block::Hash, parent_number: NumberFor<Block>, record_proof: RecordProof, inherent_digests: Digest, backend: &'a B, extrinsics: VecDeque<Block::Extrinsic>, maybe_inherent_data: Option<InherentData>, ) -> Result<Self, Error>

Create a new instance of builder based on the given parent_hash and parent_number.

While proof recording is enabled, all accessed trie nodes are saved. These recorded trie nodes can be used by a third party to prove the output of this block builder without having access to the full storage.

pub fn prepare_storage_changes_before( &self, extrinsic_index: usize, ) -> Result<StorageChanges<Block>, Error>

Returns the state before executing the extrinsic at given extrinsic index.

pub fn prepare_storage_changes_before_finalize_block( &self, ) -> Result<StorageChanges<Block>, Error>

Returns the state before finalizing the block.

pub fn build(self) -> Result<BuiltBlock<Block>, Error>

Consume the builder to build a valid Block containing all pushed extrinsics.

Returns the build Block, the changes to the storage and an optional StorageProof supplied by self.api, combined as BuiltBlock. The storage proof will be Some(_) when proof recording was enabled.

pub fn create_inherents( parent_hash: Block::Hash, api: &ApiRef<'_, A::Api>, inherent_data: InherentData, ) -> Result<VecDeque<Block::Extrinsic>, Error>

Create the inherents for the block.

Returns the inherents created by the runtime or an error if something failed.

pub fn estimate_block_size(&self, include_proof: bool) -> usize

Estimate the size of the block in the current state.

If include_proof is true, the estimated size of the storage proof will be added to the estimation.