Skip to content

docs: add getting started guide for EEST opcode minilang #1818

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 10 commits into from
Jul 7, 2025

Conversation

MozirDmitriy
Copy link
Contributor

@MozirDmitriy MozirDmitriy commented Jun 29, 2025

  • Added a new section to docs/writing_tests/writing_a_new_test.md with a small guide for using the Python-based EEST opcode minilang to write smart contracts in execution-spec-tests.
  • Included examples for using the Opcodes class to generate bytecode, and described higher-level constructs such as Switch and Case for advanced control flow.
  • Added references to the evm_bytes CLI tool for converting EVM bytecode to the Python minilang.
  • Clearly stated that Yul source is no longer allowed in Python test cases (see PR refactor(fill,deps): forbid yul code in python tests; remove solc-select dependency #1779).
  • Linked to relevant code and documentation sections for further reading.

Fixes #1809

@danceratopz
Copy link
Member

@MozirDmitriy as-is, this is a drive-by PR that creates more work for us than if we'd done it ourselves. Can you read the issue, check the docs and put this somewhat in a relevant place?

@MozirDmitriy
Copy link
Contributor Author

MozirDmitriy commented Jun 30, 2025

@MozirDmitriy as-is, this is a drive-by PR that creates more work for us than if we'd done it ourselves. Can you read the issue, check the docs and put this somewhat in a relevant place?

Yes, sorry, done.

Copy link
Member

@danceratopz danceratopz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks. Please find a few comments below on how to link to the relevant data structures.

@MozirDmitriy MozirDmitriy requested a review from danceratopz July 4, 2025 14:48
@MozirDmitriy
Copy link
Contributor Author

Thanks. Please find a few comments below on how to link to the relevant data structures.

done

Copy link
Member

@danceratopz danceratopz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the drive on this one @MozirDmitriy gg!

@danceratopz danceratopz merged commit 99720a4 into ethereum:main Jul 7, 2025
13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

docs: add a page to help users get started with the EEST opcode minilang
2 participants