Chia Puzzles

This is a collection of the standard Chia puzzles. These are the puzzles which are deployed on chain and therefore cannot change.

This repository tracks the source code, the compiled hex, and a hash of the compiled hex to ensure continuity.

All puzzles are kept in the puzzles folder as both a .clsp and .clsp.hex file.

The Python and Rust bindings are created by running generate_chialisp_constants.py

Adding Bindings for a New Puzzle

Add the .clsp and .clsp.hex files into the programs folder.
Add the puzzle name, path, and shatree hash into the list in generate_chialisp_constants.py.
Run generate_chialisp_constants.py.
Commit your changes, including to the outputted programs.py and programs.rs.

Testing

This project is managed with poetry for Python and cargo for Rust.

To run the Python tests:

python -m venv venv

pip install poetry
. ./venv/bin/activate
poetry install
pytest chia_puzzles_py/tests

If you're on Windows activate the venv with . venv\Scripts\activate instead

To run the Rust tests:

cargo test --all

Metadata

Release files for chia-puzzles-py 0.20.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for chia-puzzles-py 0.20.3
File	Size	Uploaded
chia_puzzles_py-0.20.3.tar.gz	22.4 kB	Oct 14, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for chia-puzzles-py 0.20.3
File	Interpreter	ABI	Platform	Reset
chia_puzzles_py-0.20.3-py3-none-any.whl 24.4 kB Oct 14, 2025	Python 3	none	any	Details

Total release size: 46.9 kB

Release files / chia_puzzles_py-0.20.3.tar.gz

Download URL	chia_puzzles_py-0.20.3.tar.gz
Size	22.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`059c314c8ac6bb8f6f89bdb9855e55b716475b61ba953801e5fff22683534193`
BLAKE2b-256 checksum How to use checksums	`44b8fdc2e185eef288ebb79d148f12bfa71d83ebe6ff3b8d3093203c288b99b5`
Upload date	Oct 14, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Chia-Network/chia_puzzles
Publishing commit: github.com/Chia-Network/chia_puzzles/tree/d122456feeef55708d354a065623037bfa010714

Workflow

Publishing configuration: github.com/Chia-Network/chia_puzzles/blob/d122456feeef55708d354a065623037bfa010714/.github/workflows/build-wheels.yml
Publishing logs: github.com/Chia-Network/chia_puzzles/actions/runs/18497004524/attempts/1

Artifact

Subject: chia_puzzles_py-0.20.3.tar.gz
SHA-256 checksum: 059c314c8ac6bb8f6f89bdb9855e55b716475b61ba953801e5fff22683534193 Verifying attestations

Release files / chia_puzzles_py-0.20.3-py3-none-any.whl

Download URL	chia_puzzles_py-0.20.3-py3-none-any.whl
Size	24.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`cf55c342ec7827d244aea9f3d3e2fc7079807de6ab6c82d93c5d612c7f2ac1d2`
BLAKE2b-256 checksum How to use checksums	`fbd2c1e0f0600eb4fd87869c5c0341b4ee1825e3dbd1567100b650d3a0c71153`
Upload date	Oct 14, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Chia-Network/chia_puzzles
Publishing commit: github.com/Chia-Network/chia_puzzles/tree/d122456feeef55708d354a065623037bfa010714

Workflow

Publishing configuration: github.com/Chia-Network/chia_puzzles/blob/d122456feeef55708d354a065623037bfa010714/.github/workflows/build-wheels.yml
Publishing logs: github.com/Chia-Network/chia_puzzles/actions/runs/18497004524/attempts/1

Artifact

Subject: chia_puzzles_py-0.20.3-py3-none-any.whl
SHA-256 checksum: cf55c342ec7827d244aea9f3d3e2fc7079807de6ab6c82d93c5d612c7f2ac1d2 Verifying attestations