- Notifications
You must be signed in to change notification settings - Fork316
Fast Ethereum Virtual Machine implementation
License
ethereum/evmone
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
Fast Ethereum Virtual Machine implementation
evmone is a C++ implementation of the Ethereum Virtual Machine (EVM).Created by members of theIpsilon (ex-Ewasm) team, the project aims for clean, standalone EVM implementationthat can be imported as an execution module by Ethereum Client projects.The codebase ofevmone is optimized to provide fast and efficient execution of EVM smart contracts.
- Exposes theEVMC API.
- Requires C++20 standard.
- Theintx library is used to provide 256-bit integer precision.
- Theethash library is used to provide Keccak hash function implementationneeded for the special
KECCAK256
instruction. - Contains two interpreters:
- Baseline (default)
- Advanced (select with the
advanced
option)
- Provides relatively straight-forward but efficient EVM implementation.
- Performs only minimalistic
JUMPDEST
analysis.
- Theindirect call threading is the dispatch method used -a loaded EVM program is a table with pointers to functions implementing virtual instructions.
- The gas cost and stack requirements of block of instructions is precomputedand applied once per block during execution.
- Performs extensive and expensive bytecode analysis before execution.
evmone implements theEVMC API for Ethereum Virtual Machines.It can be used as a plugin replacing geth's internal EVM. But for that a modifiedversion of geth is needed. TheEwasm's forkof go-ethereum providesbinary releases of geth with EVMC support.
Next, download evmone fromReleases.
Start the downloaded geth with--vm.evm
option pointing to the evmone shared library.
geth --vm.evm=./libevmone.so
To build the evmone EVMC module (shared library), test, and benchmark:
Fetch the source code:
git clone --recursive https://github.com/ethereum/evmonecd evmone
Configure the project build and dependencies:
cmake -S . -B build -DEVMONE_TESTING=ON
cmake -S . -B build -DEVMONE_TESTING=ON -G "Visual Studio 16 2019" -A x64
Build:
cmake --build build --parallel
Run the unit tests or benchmarking tool:
build/bin/evmone-unittestsbuild/bin/evmone-bench test/evm-benchmarks/benchmarks
Ethereum Precompiled Contracts (precompiles for short) are only partly supported by evmone.
However, there are options to enable limited precompiles support for testing.
- For precompiles with missing implementation stubs are enabled by default.They will correctly respond to known inputs.
- The CMake option
EVMONE_PRECOMPILES_SILKPRE=1
enables building ofthesilkpre third party library with the implementation of the precompiles.This library also requiresGMP (e.g. libgmp-dev) library for building and execution.
Theevm-test executes a collection of unit tests onany EVMC-compatible Ethereum Virtual Machine implementation.The collection of tests comes from the evmone project.
evm-test ./evmone.so
Docker images with evmone are available on Docker Hub:https://hub.docker.com/r/ethereum/evmone.
Having the evmone shared library inside a docker is not very useful on its own,but the image can be used as the base of another one or you can run benchmarkswith it.
docker run --entrypoint evmone-bench ethereum/evmone /src/test/benchmarks
evmone supports EOFv1. Since EOF validation is done once during deploy-time, evmone does not revalidate during execution of bytecode. To force EOF revalidation, you can use thevalidate_eof
option, example:
evmc run --vm libevmone.so,validate_eof --rev 14 "EF00"
Paweł Bylica@chfast
Licensed under theApache License, Version 2.0.
About
Fast Ethereum Virtual Machine implementation