Ethereum Yellow Paper

The Ethereum Yellow Paper, written by Gavin Wood, is a formal mathematical specification focused on Ethereum’s execution rules and the EVM. Its own repository now labels the document outdated, so it should be read as an important historical specification rather than the sole current reference; see the Ethereum Virtual Machine.

Protocol documentation Project documentation
Directories Ethereum Whitepapers & Research

In-Depth Explanation

The paper formalizes execution concepts such as transactions, state transitions, EVM operations, and gas accounting. It is dense and uses mathematical notation, which made it useful as a precise implementation reference but difficult for many developers to read. Ethereum has changed through later fork specifications and EIPs, and the Yellow Paper does not serve as a complete specification for every execution and consensus-layer rule in today’s network.

The Ethereum Foundation introduced EELS, a Python reference specification that follows network forks and is designed to be more readable and easier to execute in tests. EELS complements the Yellow Paper’s historical role; readers implementing current clients should follow current fork specifications and tests.

History

  • 2013 — Vitalik Buterin published the Ethereum whitepaper. It introduced the project’s broad design.
  • 2014 — Gavin Wood wrote the Yellow Paper. It supplied a more formal account of Ethereum execution.
  • 2021–2023 — Work on EELS began, and the Ethereum Foundation introduced it publicly in 2023. The project described EELS as a more readable, up-to-date execution-layer reference.

Related Terms

See Also

Sources