New Tutorial: Understanding the Yellow Paper's EVM Specifications #6178

qbzzt · 2022-05-01T01:26:02Z

Description

Explained in the issue. Basically, what the yellow paper means when it comes to EVM and how to understand it (including as practice for understanding the rest of it).

Preview deploy:
https://ethereumorgwebsitedev01-qbzztethereumorgwebsitedev.gtsb.io/en/developers/tutorials/yellow-paper-evm/

Related Issue

Article: Understanding the Yellow Paper #5890
Replaced due to technical difficulties by Yellow paper tutorial #6611

Update

gatsby-cloud · 2022-05-01T01:46:31Z

Gatsby Cloud Build Report

ethereum-org-website-dev

🎉 Your build was successful! See the Deploy preview here.

Build Details

View the build logs here.

🕐 Build time: 14m

Performance

Lighthouse report

Metric	Score
Performance	🔶 24
Accessibility	💚 100
Best Practices	💚 100
SEO	💚 92

🔗 View full report

src/content/developers/tutorials/yellow-paper-evm/index.md

samajammin · 2022-05-03T08:19:41Z

Nitpick but could we keep URLs all lowercase? i.e. /yellow-paper-berlin.pdf, not /yellow-paper-Berlin.pdf?

Co-authored-by: Sam Richards <sbrichards@gmail.com>

qbzzt · 2022-05-09T19:59:29Z

Nitpick but could we keep URLs all lowercase? i.e. /yellow-paper-berlin.pdf, not /yellow-paper-Berlin.pdf?

Done

Update

minimalsm

This looks great :-) it'll be a really great resource.

Is there any reason every sentence within a paragraph is on a new line (or any quick way to fix it)? This might cause some issues when it comes to translation.

src/content/developers/tutorials/yellow-paper-evm/index.md

minimalsm · 2022-05-23T11:49:45Z

src/content/developers/tutorials/yellow-paper-evm/index.md

+A [Turing machine](https://en.wikipedia.org/wiki/Turing_machine) is a computational model.
+Essentially, it is a simplified version of a computer, which is proved to have the same ability to run computations that a normal computer can (everything that a computer can calculate a Turing machine can calculate and vice versa).
+This model makes it easier to prove various theorems about what is and what isn't comnputable.


Suggested change

A [Turing machine](https://en.wikipedia.org/wiki/Turing_machine) is a computational model.

Essentially, it is a simplified version of a computer, which is proved to have the same ability to run computations that a normal computer can (everything that a computer can calculate a Turing machine can calculate and vice versa).

This model makes it easier to prove various theorems about what is and what isn't comnputable.

A [Turing machine](https://en.wikipedia.org/wiki/Turing_machine) is a computational model. Essentially, it is a simplified version of a computer, which is proven to have the same ability to run computations that a typical computer can (everything that a computer can calculate, a Turing machine can calculate and vice versa). This model makes it easier to prove various theorems about what is and isn't computable.

minimalsm · 2022-05-23T12:06:47Z

src/content/developers/tutorials/yellow-paper-evm/index.md

+
+
+
+## 9.4.3 (Jump Destination Validity)


Suggested change

## 9.4.3 (Jump Destination Validity)

## 9.4.3 (Jump Destination Validity) {#jump-destination-validity}

minimalsm · 2022-05-23T12:06:57Z

src/content/developers/tutorials/yellow-paper-evm/index.md

+As this is a [stack machine](https://en.wikipedia.org/wiki/Stack_machine), we need to keep track of the number of items popped out (*δ*) and pushed in (*α*) by each opcode.
+
+
+## 9.4.2 (Exceptional Halting)


Suggested change

## 9.4.2 (Exceptional Halting)

## 9.4.2 (Exceptional Halting) {#exceptional-halting}

minimalsm · 2022-05-23T12:07:09Z

src/content/developers/tutorials/yellow-paper-evm/index.md

+
+
+
+## 9.4 (Execution Overview) 


Suggested change

## 9.4 (Execution Overview)

## 9.4 (Execution Overview) {#execution-overview}

src/content/developers/tutorials/yellow-paper-evm/index.md

minimalsm · 2022-05-23T12:09:13Z

src/content/developers/tutorials/yellow-paper-evm/index.md

+Like almost everything else in Ethereum, the Yellow Paper evolves over time. 
+To be able to refer to a specific version, I uploaded [the current version at writing](yellow-paper-berlin.pdf).
+The section, page, and equation numbers I use will refer to that version.
+It is a good idea to have it open in a different window while reading this document.


Suggested change

Like almost everything else in Ethereum, the Yellow Paper evolves over time.

To be able to refer to a specific version, I uploaded [the current version at writing](yellow-paper-berlin.pdf).

The section, page, and equation numbers I use will refer to that version.

It is a good idea to have it open in a different window while reading this document.

Like almost everything else in Ethereum, the Yellow Paper evolves over time. To be able to refer to a specific version, I uploaded [the current version at writing](yellow-paper-berlin.pdf). The section, page, and equation numbers I use will refer to that version. It is a good idea to have it open in a different window while reading this document.

qbzzt · 2022-05-23T13:03:25Z

Is there any reason every sentence within a paragraph is on a new line (or any quick way to fix it)? This might cause some issues when it comes to translation.

Git makes it very easy to see which lines have changed, so it's easiest to know what sentences changed if every sentence is its own line. I can change it to one line per paragraph if you'd like, but that would make identifying future changes harder IMAO.

Co-authored-by: Joshua <62268199+minimalsm@users.noreply.github.com>

qbzzt · 2022-05-26T23:15:09Z

I didn't mean to close this PR, and it doesn't seem to be letting me reopen it. I'll probably have to open another one.

minimalsm · 2022-05-30T12:30:07Z

Hey @qbzzt could you check the comments here 🙏

qbzzt · 2022-05-30T12:39:29Z

The comments revolve around two issues:

The anchors. I answered in New Tutorial: Understanding the Yellow Paper's EVM Specifications #6178 (comment). Is the code going to change so that these anchor tags will be required again?
One line per sentence vs. one per paragraph. I answered in New Tutorial: Understanding the Yellow Paper's EVM Specifications #6178 (comment). I think my reasoning is sound, but if it isn't please tell me and I'll merge the changes.

minimalsm · 2022-06-08T12:41:00Z

Git makes it very easy to see which lines have changed, so it's easiest to know what sentences changed if every sentence is its own line. I can change it to one line per paragraph if you'd like, but that would make identifying future changes harder IMAO.

One paragraph per line is definitely preferable for our translator. Let's go with that approach plz 🙏

qbzzt · 2022-06-08T13:05:21Z

For some strange reason it isn't letting me update the PR. I'm going to make a new one with the necessary fixes.

…

On Wed, Jun 8, 2022 at 7:41 AM Joshua ***@***.***> wrote: Git makes it very easy to see which lines have changed, so it's easiest to know what sentences changed if every sentence is its own line. I can change it to one line per paragraph if you'd like, but that would make identifying future changes harder IMAO. One paragraph per line is definitely preferable for our translator. Let's go with that approach plz 🙏 — Reply to this email directly, view it on GitHub <#6178 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ADBCGGIRBHMN62G4V2DWPB3VOCIGPANCNFSM5UZDTWGA> . You are receiving this because you were mentioned.Message ID: ***@***.***>

qbzzt added 30 commits April 18, 2022 15:49

Merge pull request #11 from ethereum/dev

575ae7b

Update

Create index.md

8679dc8

Add files via upload

f120539

Update index.md

c791bf3

Update index.md

e63421a

Update index.md

526526b

Update index.md

ed15bc5

Update index.md

574d935

Add files via upload

92451bf

Update index.md

8141ccc

Update index.md

caab8ec

Update index.md

b921956

Update index.md

c349a4f

Update index.md

85ad466

Update index.md

ec24f5a

Update index.md

a1c27d5

Delete eq9-2-001.svg

3f5ffe5

Update index.md

95c8a38

Update index.md

50ce605

Update index.md

0e78764

Update index.md

0e7c14b

Update index.md

0d61206

Update index.md

c704a3e

Update index.md

872fc90

Update index.md

e43ea8c

Update index.md

89adcd2

Update index.md

236ca19

Update index.md

9015e3b

Update index.md

6303b83

Update index.md

02dad32

github-actions bot added the review needed 👀 label May 1, 2022

samajammin reviewed May 3, 2022

View reviewed changes

src/content/developers/tutorials/yellow-paper-evm/index.md Outdated Show resolved Hide resolved

samajammin reviewed May 3, 2022

View reviewed changes

src/content/developers/tutorials/yellow-paper-evm/index.md Outdated Show resolved Hide resolved

qbzzt and others added 2 commits May 6, 2022 04:04

Update src/content/developers/tutorials/yellow-paper-evm/index.md

ccccee4

Co-authored-by: Sam Richards <sbrichards@gmail.com>

fix(yellow-paper): Some Sam comments

587d9e9

qbzzt requested a review from samajammin May 6, 2022 02:14

Merge pull request #12 from ethereum/dev

33c8ac1

Update

minimalsm requested changes May 23, 2022

View reviewed changes

minimalsm removed the review needed 👀 label May 23, 2022

Apply suggestions from code review

6f30c44

Co-authored-by: Joshua <62268199+minimalsm@users.noreply.github.com>

github-actions bot added the review needed 👀 label May 23, 2022

qbzzt and others added 2 commits May 23, 2022 06:44

Apply suggestions from code review

9266d08

Co-authored-by: Joshua <62268199+minimalsm@users.noreply.github.com>

Update src/content/developers/tutorials/yellow-paper-evm/index.md

0201e8f

Co-authored-by: Joshua <62268199+minimalsm@users.noreply.github.com>

qbzzt requested a review from minimalsm May 23, 2022 13:58

Merge branch 'ethereum:dev' into dev

e8bb2e3

qbzzt mentioned this pull request May 26, 2022

New Tutorial: Understanding the Yellow Paper's EVM Specifications #6480

Closed

minimalsm reopened this May 27, 2022

minimalsm removed the review needed 👀 label May 30, 2022

qbzzt mentioned this pull request Jun 8, 2022

Yellow paper tutorial #6611

Merged

qbzzt closed this Jun 8, 2022

github-actions bot added the abandoned This has been abandoned or will not be implemented label Jun 8, 2022

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

New Tutorial: Understanding the Yellow Paper's EVM Specifications #6178

New Tutorial: Understanding the Yellow Paper's EVM Specifications #6178

qbzzt commented May 1, 2022 •

edited

Loading

gatsby-cloud bot commented May 1, 2022 •

edited

Loading

samajammin commented May 3, 2022

qbzzt commented May 9, 2022

minimalsm left a comment

minimalsm May 23, 2022

minimalsm May 23, 2022

minimalsm May 23, 2022

minimalsm May 23, 2022

minimalsm May 23, 2022

qbzzt commented May 23, 2022

qbzzt commented May 26, 2022

minimalsm commented May 30, 2022

qbzzt commented May 30, 2022

minimalsm commented Jun 8, 2022

qbzzt commented Jun 8, 2022 via email

	## 9.4.3 (Jump Destination Validity)
	## 9.4.3 (Jump Destination Validity) {#jump-destination-validity}

		As this is a [stack machine](https://en.wikipedia.org/wiki/Stack_machine), we need to keep track of the number of items popped out (δ) and pushed in (α) by each opcode.


		## 9.4.2 (Exceptional Halting)

	## 9.4.2 (Exceptional Halting)
	## 9.4.2 (Exceptional Halting) {#exceptional-halting}

	## 9.4 (Execution Overview)
	## 9.4 (Execution Overview) {#execution-overview}

New Tutorial: Understanding the Yellow Paper's EVM Specifications #6178

New Tutorial: Understanding the Yellow Paper's EVM Specifications #6178

Conversation

qbzzt commented May 1, 2022 • edited Loading

Description

Related Issue

gatsby-cloud bot commented May 1, 2022 • edited Loading

Gatsby Cloud Build Report

Build Details

Performance

Lighthouse report

samajammin commented May 3, 2022

qbzzt commented May 9, 2022

minimalsm left a comment

Choose a reason for hiding this comment

minimalsm May 23, 2022

Choose a reason for hiding this comment

minimalsm May 23, 2022

Choose a reason for hiding this comment

minimalsm May 23, 2022

Choose a reason for hiding this comment

minimalsm May 23, 2022

Choose a reason for hiding this comment

minimalsm May 23, 2022

Choose a reason for hiding this comment

qbzzt commented May 23, 2022

qbzzt commented May 26, 2022

minimalsm commented May 30, 2022

qbzzt commented May 30, 2022

minimalsm commented Jun 8, 2022

qbzzt commented Jun 8, 2022 via email

qbzzt commented May 1, 2022 •

edited

Loading

gatsby-cloud bot commented May 1, 2022 •

edited

Loading