Toolchain
Manages the cargo-zisk Rust toolchain, the patched compiler that targets the ZisK zkVM. Documents the build subcommand for compiling the toolchain from source and the install subcommand for fetching a prebuilt release.
Manage the cargo-zisk Rust toolchain, the patched compiler that
targets the ZisK zkVM. toolchain exposes two subcommands: build
to compile the toolchain from source, and install to fetch a
prebuilt release.
cargo-zisk toolchain <COMMAND>
| Command | Purpose |
|---|---|
build | Build the toolchain from source. Useful when targeting a custom branch or tag. |
install | Install a prebuilt toolchain. The fast path for most users. |
build
Compile the cargo-zisk toolchain from source and register it with
rustup. Useful for development against a custom branch or tag, or
when no prebuilt release matches your platform.
cargo-zisk toolchain build [OPTIONS]
Flags
| Flag | Short | Default | Description |
|---|---|---|---|
--name <NAME> | -n | Name registered with rustup toolchain for the built toolchain. | |
--branch <BRANCH> | -b | zisk | Git branch to check out before building. |
--tag <TAG> | -t | Git tag to check out before building. Takes precedence over --branch when both are set. |
Examples
Build the default zisk branch and register it with rustup under
a custom name:
cargo-zisk toolchain build --name zisk-dev
Build from a specific tag, pinning the toolchain to a release:
cargo-zisk toolchain build --tag v0.17.0 --name zisk-v0.17
Build from a feature branch:
cargo-zisk toolchain build --branch experimental --name zisk-exp
install
Download and install a prebuilt cargo-zisk toolchain. This is the fast path — no source checkout, no compile time.
cargo-zisk toolchain install [OPTIONS]
Flags
| Flag | Short | Default | Description |
|---|---|---|---|
--toolchain-version <TOOLCHAIN_VERSION> | -t | latest | Version of the toolchain to install. |
--name <NAME> | -n | zisk | Name assigned to the installed toolchain in rustup. |
Examples
Install the latest toolchain under the default zisk rustup name:
cargo-zisk toolchain install
Install a specific toolchain version:
cargo-zisk toolchain install --toolchain-version v0.17.0
Install under a custom rustup name (useful when keeping multiple versions side-by-side):
cargo-zisk toolchain install --toolchain-version v0.17.0 --name zisk-v0.17