Struct StateBuilder

pub struct StateBuilder<DB> {
    database: DB,
    with_state_clear: bool,
    with_bundle_prestate: Option<BundleState>,
    with_cache_prestate: Option<CacheState>,
    with_bundle_update: bool,
    with_background_transition_merge: bool,
    with_block_hashes: BTreeMap<u64, FixedBytes<32>>,
}

Allows building of State and initializing it with different options.

Fields

database: DB

with_state_clear: bool

with_bundle_prestate: Option<BundleState>

with_cache_prestate: Option<CacheState>

with_bundle_update: bool

with_background_transition_merge: bool

with_block_hashes: BTreeMap<u64, FixedBytes<32>>

Implementations

impl StateBuilder<EmptyDBTyped<Infallible>>

pub fn new() -> StateBuilder<EmptyDBTyped<Infallible>>

Create a new builder with an empty database.

If you want to instantiate it with a specific database, use new_with_database.

impl<DB> StateBuilder<DB>

where DB: Database,

pub fn new_with_database(database: DB) -> StateBuilder<DB>

Create a new builder with the given database.

pub fn with_database<ODB>(self, database: ODB) -> StateBuilder<ODB>

where ODB: Database,

Set the database.

pub fn with_database_ref<ODB>( self, database: ODB, ) -> StateBuilder<WrapDatabaseRef<ODB>>

where ODB: DatabaseRef,

Takes DatabaseRef and wraps it with WrapDatabaseRef.

pub fn with_database_boxed<Error>( self, database: Box<dyn Database<Error = Error> + Send + '_>, ) -> StateBuilder<Box<dyn Database<Error = Error> + Send + '_>>

With boxed version of database.

pub fn without_state_clear(self) -> StateBuilder<DB>

By default state clear flag is enabled but for initial sync on mainnet we want to disable it so proper consensus changes are in place.

pub fn with_bundle_prestate(self, bundle: BundleState) -> StateBuilder<DB>

Allows setting prestate that is going to be used for execution. This bundle state will act as additional layer of cache. and State after not finding data inside StateCache will try to find it inside BundleState.

On update Bundle state will be changed and updated.

pub fn with_bundle_update(self) -> StateBuilder<DB>

Make transitions and update bundle state.

This is needed option if we want to create reverts and getting output of changed states.

pub fn with_cached_prestate(self, cache: CacheState) -> StateBuilder<DB>

It will use different cache for the state. If set, it will ignore bundle prestate. and will ignore without_state_clear flag as cache contains its own state_clear flag.

This is useful for testing.

pub fn with_background_transition_merge(self) -> StateBuilder<DB>

Starts the thread that will take transitions and do merge to the bundle state in the background.

pub fn with_block_hashes( self, block_hashes: BTreeMap<u64, FixedBytes<32>>, ) -> StateBuilder<DB>

pub fn build(self) -> State<DB>

Trait Implementations

impl<DB> Clone for StateBuilder<DB>

where DB: Clone,

fn clone(&self) -> StateBuilder<DB>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<DB> Debug for StateBuilder<DB>

where DB: Debug,

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

Formats the value using the given formatter.

impl<DB> Default for StateBuilder<DB>

where DB: Database + Default,

fn default() -> StateBuilder<DB>

Returns the “default value” for a type.

impl<DB> PartialEq for StateBuilder<DB>

where DB: PartialEq,

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

where DB: Eq,

impl<DB> StructuralPartialEq for StateBuilder<DB>

Layout

Note: Unable to compute type layout, possibly due to this type having generic parameters. Layout can only be computed for concrete, fully-instantiated types.