Skip to main content

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​

FlagShortDefaultDescription
--elf <ELF>-eauto-detectedPath of the program ELF whose cache should be cleaned. If omitted, the ELF is auto-detected from the current project.
--all-afalseClean 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