Registry / serialization / chia-puzzles-py

chia-puzzles-py

library0.20.3pypypiunverified

A collection of the currently deployed ChiaLisp puzzles used in Chia blockchain, including standard transactions, CATs, DIDs, and other puzzle types. Version 0.20.3 supports Python >=3.8,<4.0.

serialization data

pip install chia-puzzles-py

package ↗homepage ↗

INSTALL

IMPORT

SIG · CHIA-PUZZLES-PY

chia-puzzles-py

serializationpythonv0.20.3

Install

2.9s avg

Import

—

Disk

35MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.20.3 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 2.9s · import 0.000s · 36MB

35MB installed

● package 35MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

load_clvm

✓ from chia_puzzles_py import load_clvm

✗ from chia_puzzles_py import load_clvm

Loads a CLVM puzzle from the bundled .clvm files and prints it.

from chia.puzzles.load_clvm import load_clvm from chia.types.blockchain_format.program import Program # Load a standard puzzle puzzle = load_clvm('p2_delegated_puzzle_or_hidden_puzzle.clvm') print(puzzle) # Optionally export to hex print(bytes(puzzle).hex())

Debug

Known issues

breakingIn version 0.20.x, the puzzle module structure was reorganized. Imports from 'chia.puzzles' directly may break. Use full submodule paths like 'chia.puzzles.p2_delegated_puzzle_or_hidden_puzzle'.

fix

Update imports to use the new nested module layout. For example, change 'from chia.puzzles import p2_delegated' to 'from chia.puzzles.p2_delegated_puzzle_or_hidden_puzzle import ...'.

affects: >=0.20.0,<0.21.0

gotchaThe 'load_clvm' function caches compiled puzzles. If you modify a .clvm file at runtime, the cached version is used; restart the interpreter to see changes.

fix

Clear the cache by calling 'load_clvm.cache_clear()' (Python 3.8+) or reload the module.

affects: all

deprecatedSome legacy puzzle names (e.g., 'p2_delegated_puzzle') are deprecated in favor of 'p2_delegated_puzzle_or_hidden_puzzle'. The old names may be removed in a future release.

fix

Use the full name 'p2_delegated_puzzle_or_hidden_puzzle' for new code.

affects: >=0.20.0

Upgrade

Version history

0.20.3latest on PyPI · released Oct 14, 2025

Audit

Dependencies

clvmrequiredRequired for puzzle compilation and CLVM operations.

clvm_toolsoptionalRequired for higher-level puzzle tools and debugging.

Agent activity

27 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://pypi.org/project/chia-puzzles-py/ ↗

homepagehttps://www.chia.net ↗