Utils
Utility subcommands for project maintenance, including clean-cache for clearing the ZisK cache (per-program setup artifacts) for one program or all programs so those steps regenerate on the next run.
Utility subcommands for project maintenance and development ergonomics.
cargo-zisk utils <subcommand>
clean-cache
Clean the ZisK cache directory for a specific program, or the entire
cache. The cache (~/.zisk/cache/, or ZISK_CACHE_DIR) holds the
per-program setup artifacts that setup, execute, and prove populate
on first use; clearing it forces those steps to regenerate on the next run.
For one program, clean-cache removes only the cache entries named by that
ELF's hash, plus the <elf-file-name>.assembly_hints marker. With --all it
removes the whole cache/ directory. Proving keys (~/.zisk/provingKey/)
and recurser setups (~/.zisk/recurser/) are never touched.
cargo-zisk utils clean-cache [OPTIONS]
Flags
| Flag | Short | Default | Description |
|---|---|---|---|
--elf <ELF> | -e | auto-detected | Path of the program ELF whose cache should be cleaned. If omitted, the ELF is auto-detected from the current project. |
--all | -a | false | Clean the cache for every program. Mutually exclusive with --elf. |
Examples
Clean the cache for the current project's guest:
cargo-zisk utils clean-cache
Clean the cache for a specific ELF outside the current project:
cargo-zisk utils clean-cache --elf ./dist/guest.elf
Wipe every cached program — useful after upgrading the toolchain or swapping between projects with stale state:
cargo-zisk utils clean-cache --all