revm - Rust Ethereum Virtual Machine

Is EVM written in rust that is focused on speed and simplicity. It has fast and flexible implementation with simple interface and embedded Host. It is passing all ethereum/tests test suits

Here is a list of things that I would like to use as guide in this project:

• EVM compatibility and stability - this goes without saying but it is nice to put it here. In the blockchain industry, stability is the most desired attribute of any system.
• Speed - is one of the most important things and most decisions are made to complement this.
• Simplicity - simplification of internals so that it can be easily understood and extended, and interface that can be easily used or integrated into other projects.
• interfacing - [no_std] so that it can be used as wasm lib and integrate with JavaScript and cpp binding if needed.

Project

structure:

• crates
  • revm -> main EVM library.
  • revm-primitives -> Primitive data types.
  • revm-interpreter -> Execution loop with instructions
  • revm-precompile -> EVM precompiles
• bins:
  • revme: cli binary, used for running state test json
  • revm-test: test binaries with contracts, used mostly to check performance

Last checked revm requires rust v1.65 or higher for core::error::Error

There were some big efforts on optimization of revm:

• Optimizing interpreter loop: bluealloy#7
• Introducing Bytecode format (and better bytecode analysis): bluealloy#121
• Unification of instruction signatures: bluealloy#283

Running eth tests

go to cd bins/revme/

Download eth tests from (this will take some time): git clone https://github.com/ethereum/tests

run tests with command: cargo run --release -- statetest tests/GeneralStateTests/ tests/LegacyTests/Constantinople/GeneralStateTests

GeneralStateTests contains all tests related to EVM.

Running benchmarks

cargo run --package revm-test --release --bin snailtracer

cargo flamegraph --root --freq 4000 --min-width 0.001 --package revm-test --bin snailtracer

Running example

cargo run -p revm --features ethersdb --example fork_ref_transact

Used by:

• Foundry: https://github.com/foundry-rs/foundry
• Helios: https://github.com/a16z/helios
• Hardhat (transitioning to it): https://github.com/NomicFoundation/hardhat/tree/rethnet/main
• Reth: https://github.com/paradigmxyz/reth
• Arbiter: https://github.com/primitivefinance/arbiter

(If you want to add your project to the list, ping me or open the PR)

Documentation

To serve the mdbook documentation, ensure you have mdbook installed (if not install it with cargo) and then run:

mdbook serve documentation

Contact

There is public telegram group: https://t.me/+Ig4WDWOzikA3MzA0

Or if you want to hire me or contact me directly, here is my email: [email protected] and telegram: https://t.me/draganrakita