Setup Instructions

This guide explains how to set up the ZK circuits and keys required for the ZK Identity System.

Validators: You must use the verification keys committed in the repository to ensure consensus compatibility.

Prerequisites

Bun runtime
Dependencies installed (bun install)

Quick Setup

Run the automated setup script to download the Powers of Tau ceremony file, compile circuits, and generate keys:

bun run zk:setup

This process will:

Download Powers of Tau file (~140MB)
Compile Circom circuits
Generate proving (.zkey) and verification keys

Directory Structure

The ZK files are located in src/features/zk/:

src/features/zk/
├── circuits/           # Source .circom files
├── keys/               # Generated keys (.zkey, .json)
├── proof/              # Proof generation logic
└── scripts/            # Setup scripts

Git Policy

Strict Commit Rules

✅ COMMIT: circuits/*.circom, keys/verification_key.json
❌ DO NOT COMMIT: keys/*.zkey, keys/*.ptau, *.r1cs, *.wasm

The verification_key.json is the trust anchor. All nodes must use the exact same file to verify proofs correctly.

Manual Steps

If you need to run steps manually:

1. Download Powers of Tau

cd src/features/zk/keys/
curl -L -o powersOfTau28_hez_final_14.ptau \
  https://storage.googleapis.com/zkevm/ptau/powersOfTau28_hez_final_14.ptau

2. Compile Circuits

bun run zk:compile

3. Generate Keys

# Generate proving key
npx snarkjs groth16 setup \
  src/features/zk/circuits/identity.r1cs \
  src/features/zk/keys/powersOfTau28_hez_final_14.ptau \
  src/features/zk/keys/identity_0000.zkey

# Export verification key
npx snarkjs zkey export verificationkey \
  src/features/zk/keys/identity_0000.zkey \
  src/features/zk/keys/verification_key.json

Internal Mechanisms

Validator Lifecycle

Network Governance

Global Change Registry

Consensus Mechanism

Network Forks

L2PS Privacy Subnets

ZK Identity

Architecture

Communications Stack

API Reference

Operations

Incentives

MCP Server

Bridges

Developers Testbed

Miscellaneous

ZK Setup Guide

Setup Instructions

Prerequisites

Quick Setup

Directory Structure

Git Policy

Manual Steps

1. Download Powers of Tau

2. Compile Circuits

3. Generate Keys

​Setup Instructions

​Prerequisites

​Quick Setup

​Directory Structure

​Git Policy

​Manual Steps

​1. Download Powers of Tau

​2. Compile Circuits

​3. Generate Keys

Setup Instructions

Prerequisites

Quick Setup

Directory Structure

Git Policy

Manual Steps

1. Download Powers of Tau

2. Compile Circuits

3. Generate Keys