Awesome Ethereum Virtual Machine

A curated list of resources on the Ethereum Virtual Machine (EVM), which is the virtual machine executed on the Ethereum network.

Not listed there yet, but in the spirit of

Here is how to contribute.

Table of Contents generated with DocToc

• Specification
• Illustration
• Tutorials
• Tests
• EVM Implementations
• Programming Languages that Compile into EVM
• Debuggers
• Code Analyzers
• Improvement Proposals
• Related Resources
• License of This List

Specification

• Yellow Paper
  • A terse specification of EVM and Ethereum blocks

Illustration

• A detailed illustration of the Ethereum Virtual Machine
  • The illustration shows the contents of blocks and block headers faithfully

Tutorials

• CoinCulture's Guide to the EVM
  • A hands on guide to understanding how the EVM works, with examples written in raw byte-code and solidity
• Diving Into The Ethereum Virtual Machine
  • An article series examining different aspects of the EVM by walking you through Solidity's assembly output

Tests

• Consensus test suite
  • EVM implementations can be tested against this test suite

EVM Implementations

Live on Main Network

• go-ethereum
  • A popular Ethereum client with its own EVM implementation (core/vm directory)
• Parity in Rust
  • Another popular Ethereum client with its own EVM implementation (ethcore directory)
• cpp-ethereum
  • An Ethereum client that generates the consensus test suite (libevm/VM.cpp)
• Pyethereum in Python
  • A mostly deprecated client (ethereum/vm.py)
• Py-EVM in Python
  • A Python implementation designed to be highly configurable and modular and compliant with the Ethereum test suite, work is in progress on it to run a full node and develop sharding.
• EthereumJ in Java
  • A client with its own EVM implementation
• For more, see here.

Other Implementations

• SputnikVM in Rust for Ethereum Classic
  • A standalone EVM featuring a developer environment, a browser through wasm32-unknown-emscripten target, and for embedded devices
• Modeling EVM in the K framework (whitepaper)
  • An EVM implementation for K framework
• hevm
  • An EVM implementation written in Haskell with debugging in mind
• eth-isabelle
  • An EVM implementation for theorem provers
• Burrow
  • An EVM implementation in Go extended with a native name registry and permissioning layer
• Ethereumjs-VM
  • Implements Ethereum's VM in JS
• ruby-ethereum
  • An EVM implementation in Ruby (passed all tests in ethereum tests)
• sputter
  • An EVM implementation in Clojure (so far passes VM tests)
• solevm
  • An EVM implementation in Solidity
• eth-acl2
  • An EVM implementation in ACL2 (work in progress)
• mana
  • An EVM implementation in Elixir (work in progress)

Programming Languages that Compile into EVM

• Solidity
  • The most popular programming language for Ethereum contracts
  • Awesome Solidity
  • The LLL compiler is also in the same repository
• Vyper
  • A language with overflow-checking, numeric units but without unlimited loops
• Pyramid Scheme (experimental)
  • A Scheme compiler into EVM that follows the SICP compilation approach
  • ceagle compiles C into Pyramid Scheme
• Flint
  • A language with several security features: e.g. asset types with a restricted set of atomic operations
• LLLL
  • An LLL-like compiler being implemented in Isabelle/HOL
• HAseembly-evm
  • An EVM assembly implemented as a Haskell DSL
• Bamboo (experimental)    - A language without loops but with explicit constructor invocation at the end of every call

Programming Languages that Compile zk-SNARK Circuits and Proofs

• Zokrates
  • A toolbox for zkSNARKs on Ethereum
  • a third-party tutorial
• snarky
  • An OCaml front-end for writing R1CS SNARKs (parametrized over the backend SNARK libraries)
  • Shallowly embedded DSL that can be compiled into SNARK circuits
  • The verifier is an OCaml function, so some more work is necessary before using it on Ethereum
• jsnark
  • A Java front-end for writing R1CS SNARKs

Debuggers

• REMIX
  • An IDE containing an EVM code debugger
• debug_traceTransaction method
  • An instruction-wise trace information provided by go-ethereum
• Ethereum Function Signature Database
  • A database for deciphering 0x165ffd10 into restart(bytes32,bytes32).

Code Analyzers

• Echidna
  • A fuzzer on EVM that also takes Solidity input
  • Able to fuzz a program with sequences of multiple transactions
• MAIAN
  • An automatic tool that detects trace vulnerabilities (Greedy, Prodigal and Suicidal) with depth-first search of symbolic execution of multiple invocations
• Mythril
  • A blockchain exploration tool that indexes all contracts on the network, containing a disassembler, an ABI function detector and a control flow analyzer
  • Comes with a --fire-laser option
  • Powered by laser-ethereum
• porosity
  • A reverse enginering tool, a disassembler, an ABI function detector and a decompiler that also highlights vulnerabilities
• Manticore
  • A symtolic execution engine that can generate inputs to cover codepaths (asciicast), which also comes with a Python API
• evmdis
  • A disassembler for EVM code
• ethersplay
  • An EVM plugin for Binary Ninja
• Securify
  • A tool that strives to achieve no false-negatives
  • The implementation seems not public as of now
• Oyente
  • An automatic EVM code analyzer based on symbolic execution and Z3 SMT solver
• Dr. Y's Ethereum Contract Analyzer
  • A symbolic executor for EVM code

Improvement Proposals

• Ethereum Improvement Proposals
  • A portal for EVM & Ethereum improvements
  • The soonest changes are listed in the README
• EVM 1.5
  • A proposal to tame jumps so that a linear-time scan can determine stack layouts
• eWASM
  • A proposal to use a WebAssembly for Ethereum contract execution

Related Resources

• Awesome Ethereum

License of This List

Awesome Ethereum Virtual Machine

Written in 2017 by Yoichi Hirai [email protected]

[other author/contributor lines as appropriate]

To the extent possible under law, the author(s) have dedicated all copyright and related and neighboring rights to this software to the public domain worldwide. This software is distributed without any warranty.

You should have received a copy of the CC0 Public Domain Dedication along with this software. If not, see http://creativecommons.org/publicdomain/zero/1.0/.