# meridianalgo/unigroth architecture

> Architecture diagram of the GitHub repository meridianalgo/unigroth, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/meridianalgo/unigroth
- Repository: https://github.com/meridianalgo/unigroth

## Overview

UniGroth is a Rust Groth16 library with faster proving, hardened verification, batching, circuit utilities, and experimental proof-system extensions. Its main workflow is to define a circuit, generate setup keys, create a proof, and verify it; optional branches support batched proofs, compressed keys, and generated verifiers. The repository also contains a separate JavaScript reference implementation that carries the full witness and is explicitly not zero-knowledge. Research modules are shown as distinct capabilities, not as a single execution pipeline. Several Rust modules were not excerpted, so their internal call relationships are omitted unless documented in the README.

Main entry points: [`src/circuit.js`](https://github.com/meridianalgo/unigroth/blob/main/src/circuit.js) (JS Circuit), [`src/index.js`](https://github.com/meridianalgo/unigroth/blob/main/src/index.js) (JS API), [`UniGroth/src/prover.rs`](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/prover.rs) (Groth16 Prover), [`src/verifier.js`](https://github.com/meridianalgo/unigroth/blob/main/src/verifier.js) (Constraint Verifier)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Groth16 Core"]
  node_r1cs["R1CS to QAP<br/>[r1cs_to_qap.rs]"]
  node_setup["Key Setup<br/>[generator.rs]"]
  node_prover["Groth16 Prover<br/>[prover.rs]"]
  node_verifier["Groth16 Verifier<br/>[verifier.rs]"]
  node_optimization["Prover Optimizations<br/>[optimizations.rs]"]
  node_config["Protocol Config<br/>[config.rs]"]
end

subgraph group_circuits["Circuit Tools"]
  node_circuitlib["Circuit Library<br/>[circuits.rs]"]
  node_gadgets["Circuit Gadgets<br/>[gadgets.rs]"]
  node_builder["Circuit Builder<br/>[circuit_builder.rs]"]
  node_auth["Auth Circuit<br/>[auth.rs]"]
  node_zkvm["RISC-V zkVM<br/>[zkvm.rs]"]
end

subgraph group_extensions["Verification Extensions"]
  node_aggregation["Proof Aggregation<br/>[aggregation.rs]"]
  node_batch["Batch Proving<br/>[batch.rs]"]
  node_compression["VK Compression<br/>[key_compression.rs]"]
  node_solidity["Solidity Generator<br/>[solidity.rs]"]
  node_wasmgen["WASM Generator<br/>[wasm_verifier.rs]"]
  node_pok["Input PoK"]
end

subgraph group_research["Research Systems"]
  node_commitment["Polynomial Commitments<br/>[commitment.rs]"]
  node_kzg["KZG<br/>[kzg.rs]"]
  node_folding["Folding<br/>[folding.rs]"]
  node_lookup["Lookup Arguments<br/>[lookup.rs]"]
  node_lasso["Lasso<br/>[lasso.rs]"]
  node_plonkish["Plonkish Gates<br/>[gates.rs]"]
  node_pq["PQ Inner Scaffold<br/>[pq_inner.rs]"]
  node_security["Security Extensions<br/>[security.rs]"]
end

subgraph group_reference["JavaScript Reference"]
  node_jsapi["JS API<br/>[index.js]"]
  node_jscircuit["JS Circuit<br/>[circuit.js]"]
  node_jsfield["BN254 Field<br/>[field.js]"]
  node_jsprover["Witness Prover<br/>[prover.js]"]
  node_jsverifier["Constraint Verifier<br/>[verifier.js]"]
end

node_developer(("Library User"))

node_developer -->|"defines circuit"| node_circuitlib
node_developer -->|"generates keys"| node_setup
node_developer -->|"requests proof"| node_prover
node_developer -->|"checks proof"| node_verifier
node_prover -->|"reduces circuit"| node_r1cs
node_prover -.->|"uses optimized proving"| node_optimization
node_developer -->|"batch proves"| node_batch
node_developer -->|"aggregates proofs"| node_aggregation
node_developer -->|"compresses key"| node_compression
node_developer -->|"generates verifier"| node_solidity
node_developer -->|"generates verifier"| node_wasmgen
node_developer -->|"proves input knowledge"| node_pok
node_developer -->|"uses commitments"| node_commitment
node_commitment -->|"provides KZG"| node_kzg
node_developer -->|"experiments with folding"| node_folding
node_developer -->|"uses lookup arguments"| node_lookup
node_developer -->|"uses Lasso"| node_lasso
node_developer -.->|"uses gates"| node_plonkish
node_developer -->|"experiments with PQ"| node_pq
node_developer -->|"uses security extensions"| node_security
node_jsapi -->|"creates circuits"| node_jscircuit
node_jsapi -->|"computes witness"| node_jscircuit
node_jsapi -->|"creates proof"| node_jsprover
node_jsapi -->|"verifies proof"| node_jsverifier
node_jscircuit -->|"uses arithmetic"| node_jsfield
node_jsprover -->|"checks witness"| node_jscircuit
node_jsverifier -->|"checks constraints"| node_jscircuit
node_jsverifier -->|"checks protocol"| node_jsprover

click node_r1cs "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/r1cs_to_qap.rs"
click node_setup "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/generator.rs"
click node_prover "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/prover.rs"
click node_verifier "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/verifier.rs"
click node_optimization "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/optimizations.rs"
click node_config "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/config.rs"
click node_circuitlib "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/circuits.rs"
click node_gadgets "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/gadgets.rs"
click node_builder "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/circuit_builder.rs"
click node_auth "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/auth.rs"
click node_zkvm "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/zkvm.rs"
click node_aggregation "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/aggregation.rs"
click node_batch "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/batch.rs"
click node_compression "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/key_compression.rs"
click node_solidity "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/solidity.rs"
click node_wasmgen "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/wasm_verifier.rs"
click node_pok "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/public_input_pok.rs"
click node_commitment "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/commitment.rs"
click node_kzg "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/kzg.rs"
click node_folding "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/folding.rs"
click node_lookup "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/lookup.rs"
click node_lasso "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/lasso.rs"
click node_plonkish "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/gates.rs"
click node_pq "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/pq_inner.rs"
click node_security "https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/security.rs"
click node_jsapi "https://github.com/meridianalgo/unigroth/blob/main/src/index.js"
click node_jscircuit "https://github.com/meridianalgo/unigroth/blob/main/src/circuit.js"
click node_jsfield "https://github.com/meridianalgo/unigroth/blob/main/src/field.js"
click node_jsprover "https://github.com/meridianalgo/unigroth/blob/main/src/prover.js"
click node_jsverifier "https://github.com/meridianalgo/unigroth/blob/main/src/verifier.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_r1cs,node_setup,node_prover,node_verifier,node_optimization,node_config,node_developer toneBlue
class node_circuitlib,node_gadgets,node_builder,node_auth,node_zkvm toneAmber
class node_aggregation,node_batch,node_compression,node_solidity,node_wasmgen,node_pok toneMint
class node_commitment,node_kzg,node_folding,node_lookup,node_lasso,node_plonkish,node_pq,node_security toneRose
class node_jsapi,node_jscircuit,node_jsfield,node_jsprover,node_jsverifier toneIndigo
```

## Components

### Groth16 Core

- [R1CS to QAP](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/r1cs_to_qap.rs): `UniGroth/src/r1cs_to_qap.rs`
- [Key Setup](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/generator.rs): `UniGroth/src/generator.rs`
- [Groth16 Prover](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/prover.rs): `UniGroth/src/prover.rs`
- [Groth16 Verifier](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/verifier.rs): `UniGroth/src/verifier.rs`
- [Prover Optimizations](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/optimizations.rs): `UniGroth/src/optimizations.rs`
- [Protocol Config](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/config.rs): `UniGroth/src/config.rs`

### Circuit Tools

- [Circuit Library](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/circuits.rs): `UniGroth/src/circuits.rs`
- [Circuit Gadgets](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/gadgets.rs): `UniGroth/src/gadgets.rs`
- [Circuit Builder](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/circuit_builder.rs): `UniGroth/src/circuit_builder.rs`
- [Auth Circuit](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/auth.rs): `UniGroth/src/auth.rs`
- [RISC-V zkVM](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/zkvm.rs): `UniGroth/src/zkvm.rs`

### Verification Extensions

- [Proof Aggregation](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/aggregation.rs): `UniGroth/src/aggregation.rs`
- [Batch Proving](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/batch.rs): `UniGroth/src/batch.rs`
- [VK Compression](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/key_compression.rs): `UniGroth/src/key_compression.rs`
- [Solidity Generator](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/solidity.rs): `UniGroth/src/solidity.rs`
- [WASM Generator](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/wasm_verifier.rs): `UniGroth/src/wasm_verifier.rs`
- [Input PoK](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/public_input_pok.rs): `UniGroth/src/public_input_pok.rs`

### Research Systems

- [Polynomial Commitments](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/commitment.rs): `UniGroth/src/commitment.rs`
- [KZG](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/kzg.rs): `UniGroth/src/kzg.rs`
- [Folding](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/folding.rs): `UniGroth/src/folding.rs`
- [Lookup Arguments](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/lookup.rs): `UniGroth/src/lookup.rs`
- [Lasso](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/lasso.rs): `UniGroth/src/lasso.rs`
- [Plonkish Gates](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/gates.rs): `UniGroth/src/gates.rs`
- [PQ Inner Scaffold](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/pq_inner.rs): `UniGroth/src/pq_inner.rs`
- [Security Extensions](https://github.com/meridianalgo/unigroth/blob/main/UniGroth/src/security.rs): `UniGroth/src/security.rs`

### JavaScript Reference

- [JS API](https://github.com/meridianalgo/unigroth/blob/main/src/index.js): `src/index.js`
- [JS Circuit](https://github.com/meridianalgo/unigroth/blob/main/src/circuit.js): `src/circuit.js`
- [BN254 Field](https://github.com/meridianalgo/unigroth/blob/main/src/field.js): `src/field.js`
- [Witness Prover](https://github.com/meridianalgo/unigroth/blob/main/src/prover.js): `src/prover.js`
- [Constraint Verifier](https://github.com/meridianalgo/unigroth/blob/main/src/verifier.js): `src/verifier.js`

### Other components

- **Library User**

## Connections

- Library User → Circuit Library: defines circuit (evidence: `README.md`)
- Library User → Key Setup: generates keys (evidence: `README.md`)
- Library User → Groth16 Prover: requests proof (evidence: `README.md`)
- Library User → Groth16 Verifier: checks proof (evidence: `README.md`)
- Groth16 Prover → R1CS to QAP: reduces circuit (evidence: `UniGroth/src/prover.rs`)
- Groth16 Prover → Prover Optimizations: uses optimized proving
- Library User → Batch Proving: batch proves (evidence: `README.md`)
- Library User → Proof Aggregation: aggregates proofs (evidence: `README.md`)
- Library User → VK Compression: compresses key (evidence: `README.md`)
- Library User → Solidity Generator: generates verifier (evidence: `README.md`)
- Library User → WASM Generator: generates verifier (evidence: `README.md`)
- Library User → Input PoK: proves input knowledge (evidence: `README.md`)
- Library User → Polynomial Commitments: uses commitments (evidence: `README.md`)
- Polynomial Commitments → KZG: provides KZG (evidence: `UniGroth/src/commitment.rs`)
- Library User → Folding: experiments with folding (evidence: `README.md`)
- Library User → Lookup Arguments: uses lookup arguments (evidence: `README.md`)
- Library User → Lasso: uses Lasso (evidence: `README.md`)
- Library User → Plonkish Gates: uses gates
- Library User → PQ Inner Scaffold: experiments with PQ (evidence: `README.md`)
- Library User → Security Extensions: uses security extensions (evidence: `README.md`)
- JS API → JS Circuit: creates circuits (evidence: `src/index.js`)
- JS API → JS Circuit: computes witness (evidence: `src/index.js`)
- JS API → Witness Prover: creates proof (evidence: `src/index.js`)
- JS API → Constraint Verifier: verifies proof (evidence: `src/index.js`)
- JS Circuit → BN254 Field: uses arithmetic (evidence: `src/circuit.js`)
- Witness Prover → JS Circuit: checks witness (evidence: `src/prover.js`)
- Constraint Verifier → JS Circuit: checks constraints (evidence: `src/verifier.js`)
- Constraint Verifier → Witness Prover: checks protocol (evidence: `src/verifier.js`)
