Interpreter

The interpreter crate is concerned with the execution of the EVM opcodes and serves as the event loop to step through the opcodes. The interpreter is concerned with attributes like gas, contracts, memory, stack, and returning execution results. It is structured as follows:

Modules:

  • gas: Handles gas mechanics in the EVM, such as calculating gas costs for operations.
  • host: Defines the EVM context Host trait.
  • inner_models: Contains inner data structures used in the EVM implementation.
  • instruction_result: Defines results of instruction execution.
  • instructions: Defines the EVM opcodes (i.e. instructions).

External Crates:

  • alloc: The alloc crate is used to provide the ability to allocate memory on the heap. It's a part of Rust's standard library that can be used in environments without a full host OS.
  • core: The core crate is the dependency-free foundation of the Rust standard library. It includes fundamental types, macros, and traits.

Re-exports:

  • Several types and functions are re-exported for easier access by users of this library, such as Gas, Host, InstructionResult, OpCode, Interpreter, Memory, Stack, and others. This allows users to import these items directly from the library root instead of from their individual modules.
  • revm_primitives: This crate is re-exported, providing primitive types or functionality used in the EVM implementation.