#cairo-vm #hint #running #programs #build

cairo-program-runner-lib

Library for running Cairo programs on the Cairo VM with hint support

6 stable releases

new 1.2.2 Mar 31, 2026
1.2.1 Mar 30, 2026
1.1.0 Feb 22, 2026
1.0.0 Jan 27, 2026

#282 in Magic Beans

Download history 33/week @ 2026-02-18 81/week @ 2026-02-25 226/week @ 2026-03-04 47/week @ 2026-03-11

359 downloads per month
Used in 3 crates

Apache-2.0

4MB
8K SLoC

Proving Utils Workspace

This workspace contains multiple CLI binaries. Start here, then follow the links to each binary’s README for full usage.

Binaries

cairo_program_runner (crate: cairo-program-runner)

Runs a compiled Cairo program. Can optionally:

  • write a Cairo PIE (non-proof mode), or
  • in proof mode, generate AIR public/private inputs plus encoded trace/memory.

Docs: crates/cairo-program-runner/README.md

Quick start: cargo run -p cairo-program-runner --bin cairo_program_runner -- --help

stwo-vm-runner

Runs a compiled Cairo program in proof-mode config and adapts the result to stwo_cairo_adapter::ProverInput. Writes execution resources, and optionally prover input.

Docs: crates/vm_runner/README.md

Quick start: cargo run -p stwo-vm-runner -- --help

stwo-run-and-prove

Runs a compiled cairo program and generates a Stwo proof for it. Optionally verifies the proof, and saves the program output and data for debugging.

Docs: crates/stwo_run_and_prove/README.md

Quick start: cargo run -p stwo-run-and-prove -- --help

Build

cargo build --release

Dependencies

~54MB
~1M SLoC