{"id":21036,"library":"chia-puzzles-py","title":"chia-puzzles-py","description":"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.","status":"active","version":"0.20.3","language":"python","source_language":"en","source_url":"https://github.com/Chia-Network/chia-puzzles-py","tags":["chia","blockchain","clvm","puzzles","chialisp"],"install":[{"cmd":"pip install chia-puzzles-py","lang":"bash","label":"Default install"}],"dependencies":[{"reason":"Required for puzzle compilation and CLVM operations.","package":"clvm","optional":false},{"reason":"Required for higher-level puzzle tools and debugging.","package":"clvm_tools","optional":true}],"imports":[{"wrong":"from chia_puzzles_py import load_clvm","symbol":"load_clvm","correct":"from chia_puzzles_py import load_clvm"}],"quickstart":{"code":"from chia.puzzles.load_clvm import load_clvm\nfrom chia.types.blockchain_format.program import Program\n\n# Load a standard puzzle\npuzzle = load_clvm('p2_delegated_puzzle_or_hidden_puzzle.clvm')\nprint(puzzle)\n\n# Optionally export to hex\nprint(bytes(puzzle).hex())","lang":"python","description":"Loads a CLVM puzzle from the bundled .clvm files and prints it."},"warnings":[{"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 ...'.","message":"In 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'.","severity":"breaking","affected_versions":">=0.20.0,<0.21.0"},{"fix":"Clear the cache by calling 'load_clvm.cache_clear()' (Python 3.8+) or reload the module.","message":"The '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.","severity":"gotcha","affected_versions":"all"},{"fix":"Use the full name 'p2_delegated_puzzle_or_hidden_puzzle' for new code.","message":"Some 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.","severity":"deprecated","affected_versions":">=0.20.0"}],"env_vars":null,"search_vec":"'0.20.3':27 '3.8':30 '4.0':31 'blockchain':16,33 'cat':20 'chia':2,15,32 'chia-puzzles-pi':1 'chialisp':11,36 'clvm':34 'collect':6 'current':9 'deploy':10 'did':21 'includ':17 'puzzl':3,12,24,35 'py':4 'python':29 'standard':18 'support':28 'transact':19 'type':25 'use':13 'version':26","created_at":"2026-04-27T16:57:45.480868+00:00","updated_at":"2026-04-27T16:57:45.480868+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\nImportError: cannot import name 'load_clvm' from 'chia_puzzles_py' (/tmp/tmpforwo0w9/venv/lib/python3.12/site-packages/chia_puzzles_py/__init__.py)"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"0.20.3","cli_name":"","cli_version":null,"type":"library","homepage":"https://www.chia.net","github":null,"docs":null,"changelog":null,"pypi":"https://pypi.org/project/chia-puzzles-py/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["serialization","data"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}