midnight-tooling:compact-cli

What problem does it solve?

This skill removes friction from installing, configuring, and troubleshooting the Compact CLI and compiler toolchain used to build Midnight Compact smart contracts. It addresses PATH and installer issues, missing or mismatched compiler versions, slow compilation due to proving key generation, formatting and fixup failures, and GitHub API rate limits that block version queries.

Core Features & Use Cases

• Installation and PATH guidance: First-time installer usage, verifying binary location, and uninstall steps.
• Compiler version management: Install, list, pin, switch, and use project-local compiler versions or compile with an explicit +VERSION without changing defaults.
• Compile, format, and fixup workflows: Run compile with flags like --skip-zk, configure import search paths, run format and fixup in check mode for CI, and interpret compiler output structure.
• Troubleshooting and recovery: Diagnose exit codes and parse errors, handle network and GitHub rate limits, recover from corrupt artifacts, and speed up development builds.
• Use Case: Set up a new developer machine, add the CLI to PATH, download a specific compiler version for a project, and run a fast development compile that skips proving-key generation.

Quick Start

Install the Compact CLI, add its binary directory to your PATH, run compact update 0.30.0 to download and set a compiler, and then confirm the compiler with compact compile --version.