Huff Puzzles: Practice EVM bytecode with Foundry tests

Understand the project

Practical overview

Use it when you want a code-based sequence of Huff exercises and can work in a local command-line environment with the Huff compiler and Foundry.

Developers learning Huff and EVM bytecode through hands-on coding.
Solidity learners who want practice with low-level contract behavior and test-driven exercises.

Practice writing Huff macros and reasoning about EVM operations.
Use tests to check an exercise implementation.
Work through topics such as calldata, memory, arithmetic, reverts, arrays and contract interactions.

Before you choose

The repository is public and open source under GPL-3.0. The README describes local command-line prerequisites: the Huff compiler and Foundry.

This is a repository-based exercise set, not a browser lesson interface.
The README suggests an order for exercises and names the test associated with its introductory Return1 example.
Huff compilation and Foundry testing are separate parts of the documented workflow.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Edit the introductory Huff macro and run its corresponding Foundry test.

Open src/Return1.huff in the repository.
Edit the MAIN macro to store 1 in memory at offset 0 and return 32 bytes from offset 0, following the README example.
Run forge test -vvv --mc Return1Test.

The matching test reports whether the Return1 implementation passes.

The guide covers this example exercise only; the repository lists additional exercises separately.
The commands and expected test output are from the project README, not execution verification.

Evidence and transparency

Source record details

Source availability: Active
Sources checked: 14 October 2026
Original website title: RareSkills/huff-puzzles · Official homepage title · retained in its source language