{"id":26829,"library":"chialisp-builder","title":"Chialisp Builder","description":"A Python tool for building Chialisp programs with recursive dependency resolution. Version 0.1.2 is the latest stable release. The library automatically identifies and includes dependencies when compiling .clsp files to .hex, maintaining compatibility with Chia's smart contract ecosystem.","status":"active","version":"0.1.2","language":"python","source_language":"en","source_url":"https://github.com/Chia-Network/chialisp-builder","tags":["chialisp","chia","smart-contracts","build-tool"],"install":[{"cmd":"pip install chialisp-builder","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"","wrong":"","symbol":"build","correct":"from chialisp_builder import build"}],"quickstart":{"code":"from chialisp_builder import build\n\n# Build a Chialisp file and its dependencies\n# The builder automatically resolves and includes recursive dependencies\nresult = build('path/to/smart_contract.clsp')\nprint(result.hex)  # Compiled hex output\nprint(result.includes)  # List of included dependency files","lang":"python","description":"This quickstart demonstrates the primary use case: compiling a .clsp file to hex with automatic dependency resolution."},"warnings":[{"fix":"Use the output .hex with a validator (e.g., clvm_tools) to check correctness.","message":"The build() function does not validate the Chialisp syntax; it only resolves dependencies and concatenates include files. Compilation errors may only surface when using a separate clvm compiler.","severity":"gotcha","affected_versions":"all versions"},{"fix":"Manually audit your include statements to avoid cycles.","message":"The builder may not handle circular dependencies gracefully; infinite recursion is possible. Ensure your include chain is acyclic.","severity":"gotcha","affected_versions":"all versions"},{"fix":"Call build() once per file, or iterate over a list of files.","message":"The function signature of build() expects a single file path argument; passing multiple files or additional arguments will raise a TypeError.","severity":"breaking","affected_versions":"all versions"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Install with 'pip install chialisp-builder' and import using 'import chialisp_builder', not 'import chialisp-builder'.","cause":"Package not installed or wrong import name (hyphen vs underscore).","error":"ModuleNotFoundError: No module named 'chialisp_builder'"},{"fix":"Call build() with only the file path: build('my_contract.clsp').","cause":"Passing extra arguments to the build() function.","error":"TypeError: build() takes 1 positional argument but 2 were given"},{"fix":"Use an absolute path or ensure the working directory matches.","cause":"The provided file path does not exist or is relative to a different directory.","error":"FileNotFoundError: [Errno 2] No such file or directory: '...'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}