Prerequisites

Required Tools

Tool	Version	Purpose
Node.js	>= 24	Runtime for all services
pnpm	>= 10.30.1	Package manager for web monorepo
Nargo	>= 1.0.0-beta.18	Noir circuit compiler
bb	>= 3.0.0-nightly.20260102	Barretenberg prover

Optional Tools

Tool	Purpose
Caddy	Local HTTPS reverse proxy (required for frontend)
mkcert	Generate trusted local SSL certificates

Quick Start

# 1. Build circuits (generates Solidity verifiers + TS bindings)
./build-circuits.sh

# 2. Start the Hardhat node
cd contracts
npm install && npm run start

# 3. Deploy contracts (separate terminal)
cd contracts
npm run deploy

# 4. Start all web services
cd web
pnpm install
pnpm dev                              # All apps & services

# 5. Set up HTTPS (separate terminal)
caddy run --config ~/Caddyfile

The frontend will be available at https://nullmask.local.dev (requires HTTPS setup — see Local Setup).