proof-aggregation/gnark-wrapper

GNARK-Plonky2 Verifier CLI

This repository provides a Go-based CLI for compiling, proving, and verifying Plonky2-wrapped circuits using GNARK (either Plonk or Groth16). It automates:

• Compilation of the plonky2 verifier circuit (R1CS, PK, VK).
• Proof generation for compiled circuits.
• Proof verification.

---

Prerequisites

• Go 1.22+ installed.

---

Installation

Clone this repository:

git clone https://github.com/codex-storage/proof-aggregation.git
cd proof-aggregation/gnark-wrapper
go mod tidy
chmod +x compile.sh prove.sh verify.sh test.sh

Building the Verifier Binary

go build -o verifier .

CLI Usage

The verifier binary has three modes:

-compile: Compiles circuit (outputs R1CS, PK, VK, Solidity contract).

-prove: Generates a proof for the compiled circuit.

-verify: Verifies an existing proof.

Flags:

Flag	Description	Default
-circuit	Directory containing Plonky2 JSON files	./testdata/dummy
-data	Output directory	./gnark_output
-proof-system	"plonk" or "groth16"	"groth16"
-dummy	Dummy setup (Groth16 only)	"false"
-contract	Generate Solidity verifier	"true"

Workflow

1. Prepare your Plonky2 JSON folder This folder testdata/dummy must contain:

• verifier_only_circuit_data.json
• proof_with_public_inputs.json
• common_circuit_data.json

2. Compile:

./compile.sh ./testdata/dummy ./gnark_output groth16 false

Produces ./gnark_output/groth16/r1cs.bin, pk.bin, vk.bin, and Verifier.sol.

3. Prove:

./prove.sh ./testdata/dummy ./gnark_output groth16 false

Produces ./gnark_output/groth16/proof.json and public_witness.bin.

4. Verify:

./verify.sh ./testdata/dummy ./gnark_output groth16 false

Checks proof.json + vk.bin + public_witness.bin.

5. (Optional) Full end-to-end

./test.sh ./testdata/dummy ./gnark_output groth16 false

Calls compile → prove → verify in sequence.