Kroma SP1 Prover

This project provides WitnessGenerator for users attempting to assert the validity of a specific block on Optimism.

Since the order of all transactions included in an Optimism block is finalized when they are uploaded to L1, verifying the validity of an L2 block starts with downloading the transactions it includes from L1 and then executing them. This procedure, known as the derivation process, utilizes the Kona implementation.

The witness refers to all the external data required during the execution of the derivation process. This witness can be passed to the zkvm-prover-proxy to generate the sp1 proof.

Run a Witness Generator

Environment Variables

The 4 RPC endpoints must be set to run WitnessGenerator. It is recommended to fill in the following environment variables in the .env file.

L1_RPC=
L1_BEACON_RPC=
L2_RPC=
L2_NODE_RPC=
MAX_BATCH_POST_DELAY_MIN=<Integer - According to the Sequencer's spec>
SKIP_SIMULATION=<Boolen - if `true`, it returns the generated witness without simulating it>

Run

> cargo run --bin witness-gen-server --release -- --endpoint <IP_WITH_PORT> --data <DB_PATH>

# example
> cargo run --bin witness-gen-server --release -- --endpoint 0.0.0.0:3030 --data /data/witness_store

API Overview

requestWitness method

Register a request to generate a witness.

{
    "jsonrpc": "2.0",
    "method": "requestWitness",
    "params": [<0xL2Hash>, <0xL1HeadHash>],
    "id": 0
}

getWitness method

It returns the witness after finishing to generate it.

{
    "jsonrpc": "2.0",
    "method": "getWitness",
    "params": [<0xL2Hash>, <0xL1HeadHash>],
    "id": 0
}

Test

This online test requests generating Witness to the WitnessGenerator. The test requires the .env file.

> just test-all

Build Docker Images

> docker build -f docker/Dockerfile.witnessgen.ubuntu -t kromanetwork/kroma-sp1-witness-gen .
> docker run -itd --env-file .env -p 3030:3030 kromanetwork/kroma-sp1-witness-gen