ZK Regex Registry is an app that pools together all community created ZK Regex patterns (most for ZK Email use-cases). Project is funded by the zk-email team.
Home Screen
Try out the pattern
- Users can upload ZK Regex Patterns using a simple JSON formatted markup (see example)
- Users can test their ZK Email Regex Patterns directly on the UI (with the option of directly pulling emails privately from their Google accounts)
- App generates the circom circuit and an example project for testing
- App generates the assets required for proving (e.g. r1cs, wasm, zkey, vkey) and provides an API to download them
- Includes a React SDK to embed into your application for proof generation (see SDK)
root
--- packages
------- app (NextJS application for the registry frontend)
------- sdk (React SDK)
--- scripts (Some helper scripts to help with testing)
Install dependencies required for building circuits
- circom - installation instructions
- zk-regex - installation instructions
Copy and rename the environment variables
cp .env.local.exmaple .env.local
# update the .env.local file
export $(cat .env.local | xargs)DATABASE_URL=postgres://postgres:[email protected]:5432/myapp
# Secret token used for admin endpoints
SECRET_TOKEN=zkregexregistry
# Gmail client ID for Oauth
NEXT_PUBLIC_GOOGLE_CLIENT_ID=
# Full path to the output dir that will store generated code and circuit
GENERATED_OUTPUT_DIR=
# Path to the ptau file used for circuit generation
PTAU_PATH=
# Private key for deploying contracts
PRIVATE_KEY=
# RPC URL for deploying contracts
RPC_URL=
# DKIM Registry address
DKIM_REGISTRY=
# Chain ID
CHAIN_ID=Run the database and seed it
# Using docker compose is the easiest
docker compose up -d db
yarn prisma db push
yarn tsx prisma/seed.tsSecond, run the development server:
cd packages/app
yarn install
yarn devThird, run the proof worker
yarn proof-genLastly, run the circuit generator
yarn circuit-genOpen http://localhost:3000 with your browser to see the result.