Struct Mock

pub struct Mock { /* private fields */ }

Mock ethereum node.

This struct implements a virtual ethereum node with a limited number of supported RPC calls. You can interact with it via the standard transport from web3.

The main feature of this struct is deploying mocked contracts and interacting with them. Create new mocked contract with a call to deploy function. Then use the returned struct to set up expectations on contract methods, get deployed contract’s address and Instance and make actual calls to it.

Deploying contracts with an RPC call is not supported at the moment.

Implementations

impl Mock

pub fn new(chain_id: u64) -> Self

Creates a new mock chain.

pub fn web3(&self) -> DynWeb3

Creates a Web3 object that can be used to interact with the mocked chain.

pub fn transport(&self) -> DynTransport

Creates a Transport object that can be used to interact with the mocked chain.

pub fn deploy(&self, abi: Abi) -> Contract

Deploys a new mocked contract and returns an object that allows configuring expectations for contract methods.

pub fn deploy_with_address(&self, abi: Abi, address: Address) -> Contract

Deploys a new mocked contract with specified address and returns an object that allows configuring expectations for contract methods.

pub fn update_gas_price(&self, gas_price: u64)

Updates gas price that is returned by RPC call eth_gasPrice.

Mock node does not simulate gas consumption, so this value does not affect anything if you don’t call eth_gasPrice.

pub fn checkpoint(&self)

Verifies that all expectations on all contracts have been met, then clears all expectations.

Sometimes its useful to validate all expectations mid-test, throw them away, and add new ones. That’s what checkpoints do. See mockall documentation for more info.

Note that all expectations returned from Contract::expect method become invalid after checkpoint. Modifying them will result in panic.

Trait Implementations

impl Clone for Mock

fn clone(&self) -> Mock

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Mock

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

Formats the value using the given formatter.