eevm

Ethereum Virtual Machine implementation in Elixir.

A from-scratch EVM built for learning — both Ethereum internals and the Elixir language. Implements the full execution engine with hardfork-aware gas, all precompiles, transaction processing, and an MPT-backed state root — verified against the official ethereum/tests suite.

Getting Started

git clone https://github.com/mw2000/eevm.git &&cd eevm
mix compile
mix test
iex -S mix

Requires Elixir 1.18+ and Erlang/OTP 28+.

Usage

# Execute raw bytecode: PUSH1 10, PUSH1 20, ADD, STOPiex>EEVM.execute(<<0x60,10,0x60,20,0x01,0x00>>)|>EEVM.stack_values()[30]# Disassembleiex>EEVM.disassemble(<<0x60,0x01,0x60,0x02,0x01,0x00>>)[{0,"PUSH1","0x01"},{2,"PUSH1","0x02"},{4,"ADD",nil},{5,"STOP",nil}]

Official State Tests

The repo includes a harness for ethereum/testsGeneralStateTests, the same fixture format used by other EVM implementations.

# Initialize the pinned ethereum/tests submodule
git submodule update --init test/fixtures/state_tests/ethereum-tests
# Run the checked-in smoke fixture
mix test test/state_test_test.exs
# Run a focused official subset
EEVM_STATE_TEST_GLOB='test/fixtures/state_tests/ethereum-tests/GeneralStateTests/stExample/*.json' \
mix test test/state_test_test.exs

• Smoke fixtures live in test/fixtures/state_tests/smoke/.
• Official fixtures are in the ethereum-tests submodule at a pinned snapshot.
• Add entries to test/fixtures/state_tests/skip.txt to skip known unsupported cases.
• The default glob runs smoke only; use EEVM_STATE_TEST_GLOB to target official folders.

License

MIT