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
- Does Ethereum TPS Include Layer 2 Transactions?
- What Is MEV — And Why Every Ethereum Transaction Is a Game
- What Are Zero-Knowledge Proofs — And Why Every Major Blockchain Is Building Around Them
Sources
- Ethereum Yellow Paper repository — The upstream repository identifies the document as Ethereum’s formal specification and states that its contents are outdated.
- Ethereum Execution Layer Specifications — The Ethereum Foundation repository tracks execution-layer specifications and network upgrades.
- Ethereum Foundation: Ethereum Execution Layer Specification — Introduces EELS as a readable Python reference specification intended to complement and succeed the older Yellow Paper.
- Ethereum.org: Understanding the Yellow Paper’s EVM Specifications — Explains the Yellow Paper’s EVM scope and clarifies that it is not a current description of every Ethereum layer.