Struct BlockOverrides

pub struct BlockOverrides {
    pub number: Option<U256>,
    pub difficulty: Option<U256>,
    pub time: Option<u64>,
    pub gas_limit: Option<u64>,
    pub coinbase: Option<Address>,
    pub random: Option<B256>,
    pub base_fee: Option<U256>,
    pub block_hash: Option<BTreeMap<u64, B256>>,
}

BlockOverrides is a set of header fields to override.

Fields

number: Option<U256>

Overrides the block number.

For eth_callMany this will be the block number of the first simulated block. Each following block increments its block number by 1

difficulty: Option<U256>

Overrides the difficulty of the block.

time: Option<u64>

Overrides the timestamp of the block.

gas_limit: Option<u64>

Overrides the gas limit of the block.

coinbase: Option<Address>

Overrides the coinbase address of the block.

random: Option<B256>

Overrides the prevrandao of the block.

base_fee: Option<U256>

Overrides the basefee of the block.

block_hash: Option<BTreeMap<u64, B256>>

A dictionary that maps blockNumber to a user-defined hash. It can be queried from the EVM opcode BLOCKHASH.

Implementations

impl BlockOverrides

pub const fn is_empty(&self) -> bool

Returns true if all fields are None, false if any field is not None

pub const fn with_number(self, number: U256) -> Self

Sets the block number override

pub const fn with_difficulty(self, difficulty: U256) -> Self

Sets the difficulty override

pub const fn with_time(self, time: u64) -> Self

Sets the timestamp override

pub const fn with_gas_limit(self, gas_limit: u64) -> Self

Sets the gas limit override

pub const fn with_coinbase(self, coinbase: Address) -> Self

Sets the coinbase (fee recipient) override

pub const fn with_random(self, random: B256) -> Self

Sets the randomness (prevRandao) override

pub const fn with_base_fee(self, base_fee: U256) -> Self

Sets the base fee override

pub fn append_block_hash(self, block_number: u64, hash: B256) -> Self

Adds a block hash override for a specific block number

pub fn with_block_hash_overrides<I>(self, hashes: I) -> Self

where I: IntoIterator<Item = (u64, B256)>,

Adds multiple block hash overrides from an iterator

Trait Implementations

impl Clone for BlockOverrides

fn clone(&self) -> BlockOverrides

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for BlockOverrides

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

Formats the value using the given formatter.

impl Default for BlockOverrides

fn default() -> BlockOverrides

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for BlockOverrides

where BlockOverrides: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for BlockOverrides

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for BlockOverrides

impl StructuralPartialEq for BlockOverrides