chia-puzzles-py

What it is and what it does

chia-puzzles-py is a Python library that exposes the standard Chia puzzles—the immutable ChiaLisp programs deployed on the Chia blockchain—as Python constants and bindings. It tracks the source code (.clsp files), compiled hex representations (.clsp.hex files), and cryptographic hashes to ensure integrity and continuity of these critical blockchain components. The puzzles are generated from a source repository and cannot change once deployed on chain, so this library serves as a stable reference implementation.

The package is primarily used by Chia ecosystem developers who need to interact with or verify these standard puzzles programmatically. It depends on clvm-rs and clvm-tools-rs for ChiaLisp compilation and execution, and pytest for testing. The library is maintained as a pure Python wheel with no compiled extensions of its own, making installation straightforward on supported Python versions (3.8 through 3.14).

Use it for:

• Reference the compiled hex and hash of standard Chia puzzles in blockchain transaction validation or wallet software.
• Verify puzzle integrity by comparing computed hashes against the bundled constants.
• Develop Chia smart contracts or dApps that need to interact with or call standard puzzles.
• Test ChiaLisp puzzle implementations against the canonical on-chain versions.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides Python bindings to the standard Chia puzzles—the on-chain ChiaLisp programs deployed in the Chia blockchain—with compiled hex representations and hash verification.

Yes, if you are developing on the Chia blockchain and need access to the standard puzzle definitions and their compiled forms. No, if you are not working with Chia or do not need to reference these specific puzzles. Caveat: verify the license terms before use, as they are not clearly stated in the package metadata; also note that the package is aging (304 days since last release) and may not receive updates for new puzzle deployments.

Install

chia-puzzles-py on PyPI

pip install chia-puzzles-py

uv add chia-puzzles-py

poetry add chia-puzzles-py

Installing chia-puzzles-py

Before you install

Low install friction; pure Python wheel with three runtime dependencies (clvm-rs, clvm-tools-rs, pytest). Package is aging—last release was 304 days ago—so expect no active maintenance or rapid updates.

License in practice

License status is unclear; no SPDX identifier or raw license text is recorded. Verify the actual license terms before using in production or redistribution.

Quickstart

pip install chia-puzzles-py

from chia_puzzles_py import programs

# Access compiled puzzle hex and hash constants
puzzle_hex = programs.PUZZLE_NAME  # e.g., standard_coin_clsp_hex

Requires Python 3.8 or later. Depends on clvm-rs and clvm-tools-rs, which may require a Rust toolchain or prebuilt binaries for your platform.

Verify before relying

• Whether the package is actively maintained or if it tracks a frozen set of puzzles only.
• Exact license terms and any redistribution constraints for the on-chain puzzle code.
• Whether pytest is a runtime dependency or only a dev/test dependency.

Package facts

Evidence: chia_puzzles_py-0.20.3-py3-none-any.whl

Tags

More Cryptography packages