ZK Raffle POC with SP1

Structure

• Per Raffle Proof

Note that we have chosen the per raffle proof approach. Previous commits include a different per user proof approach.

Requirements

• Rust
• SP1

Running the Project

There are four main ways to run this project: build a program, execute a program, generate a core proof, and generate an EVM-compatible proof.

Build the Program

To build the program, run the following command in the program directory:

cd programs/per-raffle-proof/program
cargo prove build

Execute the Program

To run the program without generating a proof:

cd programs/per-raffle-proof/script
cargo run --release -- --execute

This will execute the program and display the output.

Generate a Core Proof

To generate a core proof for your program:

cd programs/per-raffle-proof/script
cargo run --release -- --prove

Generate an EVM-Compatible Proof

Warning

You will need at least 128GB RAM to generate a PLONK or Groth16 proof.

To generate a proof that is small enough to be verified on-chain and verifiable by the EVM:

cd programs/per-raffle-proof/script
cargo run --release --bin evm -- --system plonk

this will generate a PLONK proof. If you want to generate a Groth16 proof, run the following command:

cargo run --release --bin evm -- --system groth16

These commands will also generate fixtures that can be used to test the verification of SP1 zkVM proofs inside Solidity.

Retrieve the Verification Key

To retrieve your programVKey for your on-chain contract, run the following command:

cargo prove vkey --elf elf/riscv32im-succinct-zkvm-elf

Using the Prover Network

We highly recommend using the Succinct prover network for any non-trivial programs or benchmarking purposes. For more information, see the setup guide.

To get started, copy the example environment file:

cp .env.example .env

Then, set the SP1_PROVER environment variable to network and set the SP1_PRIVATE_KEY environment variable to your whitelisted private key.

For example, to generate an EVM-compatible proof using the prover network, run the following command:

SP1_PROVER=network SP1_PRIVATE_KEY=... cargo run --release --bin evm