This crate contains the Miden VM prover, which proves correct execution of Miden VM. Internally, the prover uses Miden processor to execute the programs, and then relies on the Winterfell prover to generate STARK proofs.
This crate exposes a prove()
function which can be used to execute Miden VM programs and generate proofs of their execution. The function takes the following parameters:
program: &Program
- a reference to a Miden program to be executed.stack_inputs: StackInputs
- a set of public inputs with which to execute the program.advice_provider: AdviceProvider
- an instance of an advice provider that yields secret, non-deterministic inputs to the prover.options: &ProofOptions
- config parameters for proof generation. The default options target 96-bit security level.
If the program is executed successfully, the function returns a tuple with 2 elements:
outputs: StackOutputs
- the outputs generated by the program.proof: ExecutionProof
- proof of program execution.ExecutionProof
can be easily serialized and deserialized usingto_bytes()
andfrom_bytes()
functions respectively.
Here is a simple example of executing a program which pushes two numbers onto the stack and computes their sum:
use miden_assembly::Assembler;
use miden_prover::{prove, ProofOptions, StackInputs, MemAdviceProvider};
// instantiate the assembler
let assembler = Assembler::default();
// this is our program, we compile it from assembly code
let program = assembler.compile("begin push.3 push.5 add end").unwrap();
// let's execute it and generate a STARK proof
let (outputs, proof) = prove(
&program,
StackInputs::default(), // we won't provide any stack inputs
MemAdviceProvider::default(), // we won't provide any advice values
&ProofOptions::default(), // we'll be using default options
)
.unwrap();
// the output should be 8
assert_eq!(Some(&8), outputs.stack().first());
Miden prover can be compiled with the following features:
std
- enabled by default and relies on the Rust standard library.concurrent
- impliesstd
and also enables multi-threaded proof generation.no_std
does not rely on the Rust standard library and enables compilation to WebAssembly.
To compile with no_std
, disable default features via --no-default-features
flag.
When compiled with concurrent
feature enabled, the prover will generate STARK proofs using multiple threads. For benefits of concurrent proof generation check out these benchmarks.
Internally, we use rayon for parallel computations. To control the number of threads used to generate a STARK proof, you can use RAYON_NUM_THREADS
environment variable.
This project is MIT licensed.