Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit

* incorporate london EIPs

* fix README links

* various grammar and reference edits

* grammar edits and clarifications

* fix inconsistency with transaction type

* add footnote for priority fee

* missing period

* fix berlin branch reference in

* add arrow glacier and gray glacier forks

* get rid of extraneous text

* update README to reflect glacier fork support

* fix order of items in the transaction tuple

* address readme, branches guide comments

* clarify the division behavior for the change in base fee

* add floor to gas target calculation

* adjust gas limit verification at the London fork block

* fix typo in block header validity function

* add a footnote regarding the behavior of Tp as it relates to type 2 txs

* fix transaction verification for gas values

Git stats


Failed to load latest commit information.

Ethereum Yellow Paper

License: CC BY-SA 4.0 Gitter GitPOAP Badge

The Yellow Paper is a formal definition of the Ethereum protocol, originally by Gavin Wood, currently maintained by Nick Savers and with contributions from many people around the world.

It is a free culture work, licensed under Creative Commons Attribution Share-Alike (CC-BY-SA) Version 4.0.

Repository Currently Outdated

The Yellow Paper is out of date. It reflects the Ethereum specification up to the Gray Glacier network upgrade, activated on the Ethereum mainnet at block 15_050_000 (June 2022).

It does not contain changes introduced in Paris, or any post-merge upgrade.

An alternative Python Execution Layer specification is actively maintained and up to date.

If you would like to update the Yellow Paper to inlcude missing pre-merge network upgrades, you can apply for a grant here.


If you just want to read the paper, the latest version is generally available as a PDF at If you find that the borders for links block too much text when viewing the PDF in the browser, you can instead download it and open and view it with a PDF viewer application such as Adobe Acrobat or Evince, where the borders are less likely to display over text.

However, if you want to edit the paper, then read on. The paper comes as a single latex file Paper.tex.

It is recommended to use an IDE such as Visual Studio Code with the LaTeX Workshop extension, to edit the tex file, and show the PDF.

Another option is to separately edit the tex file and build as follows (you'll still need to clone the repo then open the yellowpaper folder):

git clone
cd yellowpaper

This will create a PDF version of the Yellow Paper. Following building, you can also use standard pdflatex tools for compiling/preview, like

Tips on editing

You can use TeX Stack Exchange; (e.g. Bibliography Management and Hyperlinks); and BibTeX editor.


The previous protocol versions are listed in

Other language versions

  • Chinese translated by YuanGe and GaoTianlu.
  • French translated by Asseth (checkout to branch 'french' ).