Struct ArbEvmConfig 

pub struct ArbEvmConfig<ChainSpec = ChainSpec> {
    pub executor_factory: ArbBlockExecutorFactory<ArbReceiptBuilder, Arc<ChainSpec>, ArbEvmFactory>,
    pub block_assembler: ArbBlockAssembler<ChainSpec>,
    /* private fields */
}

Arbitrum EVM configuration.

Wraps the Ethereum EVM config and overrides environment construction to use ArbOS versioning from the mix_hash field.

Fields

executor_factory: ArbBlockExecutorFactory<ArbReceiptBuilder, Arc<ChainSpec>, ArbEvmFactory>

block_assembler: ArbBlockAssembler<ChainSpec>

Implementations

impl<ChainSpec> ArbEvmConfig<ChainSpec>

where ChainSpec: EthChainSpec + 'static,

pub fn new(chain_spec: Arc<ChainSpec>) -> Self

Creates a new Arbitrum EVM configuration with the given chain spec.

pub fn chain_spec(&self) -> &Arc<ChainSpec>

Returns a reference to the chain spec.

impl<ChainSpec> ArbEvmConfig<ChainSpec>

where ChainSpec: EthChainSpec + 'static,

pub fn arb_context_for_block( &self, header: &Header, parent_hash: B256, ) -> ArbBlockExecutionCtx

Build an ArbBlockExecutionCtx from a sealed block header.

pub fn arb_context_for_next_block( &self, parent: &SealedHeader<Header>, prev_randao: &B256, extra_data: &[u8], ) -> ArbBlockExecutionCtx

Build an ArbBlockExecutionCtx from next-block attributes.

Trait Implementations

impl<ChainSpec: Clone> Clone for ArbEvmConfig<ChainSpec>

fn clone(&self) -> ArbEvmConfig<ChainSpec>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<ChainSpec> ConfigureEngineEvm<ExecutionData> for ArbEvmConfig<ChainSpec>

where ChainSpec: EthExecutorSpec + EthChainSpec<Header = Header> + ArbitrumChainSpec + Hardforks + 'static,

fn evm_env_for_payload( &self, payload: &ExecutionData, ) -> Result<EvmEnvFor<Self>, Self::Error>

Returns an [crate::EvmEnv] for the given payload.

fn context_for_payload<'a>( &self, payload: &'a ExecutionData, ) -> Result<ExecutionCtxFor<'a, Self>, Self::Error>

Returns an [ExecutionCtxFor] for the given payload.

fn tx_iterator_for_payload( &self, payload: &ExecutionData, ) -> Result<impl ExecutableTxIterator<Self>, Self::Error>

Returns an [ExecutableTxIterator] for the given payload.

impl<ChainSpec> ConfigureEvm for ArbEvmConfig<ChainSpec>

where ChainSpec: EthExecutorSpec + EthChainSpec<Header = Header> + ArbitrumChainSpec + Hardforks + 'static,

type Primitives = ArbPrimitives

The primitives type used by the EVM.

type Error = Infallible

The error type that is returned by [Self::next_evm_env].

type NextBlockEnvCtx = NextBlockEnvAttributes

Context required for configuring next block environment.

type BlockExecutorFactory = ArbBlockExecutorFactory<ArbReceiptBuilder, Arc<ChainSpec>, ArbEvmFactory>

Configured [BlockExecutorFactory], contains [EvmFactory] internally.

type BlockAssembler = ArbBlockAssembler<ChainSpec>

A type that knows how to build a block.

fn block_executor_factory(&self) -> &Self::BlockExecutorFactory

Returns reference to the configured [BlockExecutorFactory].

fn block_assembler(&self) -> &Self::BlockAssembler

Returns reference to the configured [BlockAssembler].

fn evm_env(&self, header: &Header) -> Result<EvmEnv<SpecId>, Self::Error>

Creates a new [EvmEnv] for the given header.

fn next_evm_env( &self, parent: &Header, attributes: &NextBlockEnvAttributes, ) -> Result<EvmEnv<SpecId>, Self::Error>

Returns the configured [EvmEnv] for parent + 1 block.

fn context_for_block<'a>( &self, block: &'a SealedBlock<Block<ArbTransactionSigned>>, ) -> Result<EthBlockExecutionCtx<'a>, Self::Error>

Returns the configured [BlockExecutorFactory::ExecutionCtx] for a given block.

fn context_for_next_block( &self, parent: &SealedHeader<Header>, attributes: NextBlockEnvAttributes, ) -> Result<EthBlockExecutionCtx<'_>, Self::Error>

Returns the configured [BlockExecutorFactory::ExecutionCtx] for parent + 1 block.

fn tx_env( &self, transaction: impl IntoTxEnv<<<Self::BlockExecutorFactory as BlockExecutorFactory>::EvmFactory as EvmFactory>::Tx>, ) -> <<Self::BlockExecutorFactory as BlockExecutorFactory>::EvmFactory as EvmFactory>::Tx

Returns a [TxEnv] from a transaction.

fn evm_factory( &self, ) -> &<Self::BlockExecutorFactory as BlockExecutorFactory>::EvmFactory

Provides a reference to [EvmFactory] implementation.

fn evm_with_env<DB>( &self, db: DB, evm_env: EvmEnv<<<Self::BlockExecutorFactory as BlockExecutorFactory>::EvmFactory as EvmFactory>::Spec, <<Self::BlockExecutorFactory as BlockExecutorFactory>::EvmFactory as EvmFactory>::BlockEnv>, ) -> <<Self::BlockExecutorFactory as BlockExecutorFactory>::EvmFactory as EvmFactory>::Evm<DB, NoOpInspector>

where DB: Database,

Returns a new EVM with the given database configured with the given environment settings, including the spec id and transaction environment.

fn evm_for_block<DB>( &self, db: DB, header: &<Self::Primitives as NodePrimitives>::BlockHeader, ) -> Result<<<Self::BlockExecutorFactory as BlockExecutorFactory>::EvmFactory as EvmFactory>::Evm<DB, NoOpInspector>, Self::Error>

where DB: Database,

Returns a new EVM with the given database configured with cfg and block_env configuration derived from the given header. Relies on [ConfigureEvm::evm_env].

fn evm_with_env_and_inspector<DB, I>( &self, db: DB, evm_env: EvmEnv<<<Self::BlockExecutorFactory as BlockExecutorFactory>::EvmFactory as EvmFactory>::Spec, <<Self::BlockExecutorFactory as BlockExecutorFactory>::EvmFactory as EvmFactory>::BlockEnv>, inspector: I, ) -> <<Self::BlockExecutorFactory as BlockExecutorFactory>::EvmFactory as EvmFactory>::Evm<DB, I>

where DB: Database, I: InspectorFor<Self, DB>,

Returns a new EVM with the given database configured with the given environment settings, including the spec id.

fn create_executor<'a, DB, I>( &'a self, evm: <<Self::BlockExecutorFactory as BlockExecutorFactory>::EvmFactory as EvmFactory>::Evm<&'a mut State<DB>, I>, ctx: <Self::BlockExecutorFactory as BlockExecutorFactory>::ExecutionCtx<'a>, ) -> impl BlockExecutorFor<'a, Self::BlockExecutorFactory, DB, I>

where DB: Database, I: InspectorFor<Self, &'a mut State<DB>> + 'a,

Creates a strategy with given EVM and execution context.

fn executor_for_block<'a, DB>( &'a self, db: &'a mut State<DB>, block: &'a SealedBlock<<Self::Primitives as NodePrimitives>::Block>, ) -> Result<impl BlockExecutorFor<'a, Self::BlockExecutorFactory, DB>, Self::Error>

where DB: Database,

Creates a strategy for execution of a given block.

fn create_block_builder<'a, DB, I>( &'a self, evm: <<Self::BlockExecutorFactory as BlockExecutorFactory>::EvmFactory as EvmFactory>::Evm<&'a mut State<DB>, I>, parent: &'a SealedHeader<<Self::Primitives as NodePrimitives>::BlockHeader>, ctx: <Self::BlockExecutorFactory as BlockExecutorFactory>::ExecutionCtx<'a>, ) -> impl BlockBuilder<Primitives = Self::Primitives> + BlockExecutorFor<'a, Self::BlockExecutorFactory, DB, I>

where DB: Database, I: InspectorFor<Self, &'a mut State<DB>> + 'a,

Creates a [BlockBuilder]. Should be used when building a new block.

fn builder_for_next_block<'a, DB>( &'a self, db: &'a mut State<DB>, parent: &'a SealedHeader<<Self::Primitives as NodePrimitives>::BlockHeader>, attributes: Self::NextBlockEnvCtx, ) -> Result<impl BlockBuilder<Primitives = Self::Primitives> + BlockExecutorFor<'a, Self::BlockExecutorFactory, DB>, Self::Error>

where DB: Database + 'a,

Creates a [BlockBuilder] for building of a new block. This is a helper to invoke [ConfigureEvm::create_block_builder].

fn executor<DB>( &self, db: DB, ) -> impl Executor<DB, Primitives = Self::Primitives, Error = BlockExecutionError>

where DB: Database,

Returns a new [Executor] for executing blocks.

fn batch_executor<DB>( &self, db: DB, ) -> impl Executor<DB, Primitives = Self::Primitives, Error = BlockExecutionError>

where DB: Database,

Returns a new [BasicBlockExecutor].

impl<ChainSpec: Debug> Debug for ArbEvmConfig<ChainSpec>

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

Formats the value using the given formatter.