MizuPass

# MizuPass

Universal privacy first ticketing platform: ENS DID + ZKPassport verification + stealth JPYM payments + offline ZK proofs for seamless cross-border event access.

## Project description.

**MizuPass** solves the critical gap between privacy and regulatory compliance in event ticketing by creating the first universal identity system that bridges Japanese Mizuhiki SBT with international ZKPassport verification.

### 🚀 Key Innovations:

**1. Universal DID System**

- Verified SBT/ZKPassport users claim free `.mizupass.eth` subdomains

- Cross-platform identity that works with all ENS-compatible dApps

- Human-readable addresses for event networking and social features

**2. Privacy-Preserving Payments**

- Custom JPYM token with 1,000-10,000 airdrop for verified users

- EIP-5564 compatible stealth addresses for unlinkable transactions

- Direct JPYM payments without complex currency conversion

**3. Production ZK Circuits**

- 6.5ms witness generation optimized for mobile devices

- 3,300 constraint circuit with ~800 character QR codes

- Complete offline ticket verification without internet connectivity

**4. Cross-Border Compliance**

- Japanese FSA compliant with Mizuhiki ID integration

- International users access via ZKPassport zero-knowledge proofs

- Age verification (>18) without revealing personal data

- Nationality proof without exposing specific countries

### 🎯 Problem Solved:

- **Privacy vs Compliance**: First solution bridging Japanese regulations with user privacy

- **Cross-Border Access**: ZKPassport enables international users without traditional KYC

- **Ticket Fraud**: Cryptographically impossible to counterfeit ZK-verified tickets

- **Identity Portability**: ENS subdomains work across entire Web3 ecosystem

### 🌍 Target Users:

- **Japanese Users**: Seamless My Number Card → Mizuhiki SBT → ENS flow

- **International Tourists**: ZKPassport verification → Global event access

- **Event Organizers**: Advanced analytics with privacy-preserving insights

- **Venues**: Offline ticket verification scaling to massive events

## Technologies used

### **Frontend Stack**

- React 18 + TypeScript

- Next.js 14 with App Router

- Wagmi + Viem for Web3 integration

- Tailwind CSS + Framer Motion

- Mobile PWA optimization

### **Backend Services**

- Node.js + Express API server

- TypeScript for type safety

- PostgreSQL for user data

- snarkjs for ZK proof integration

### **Blockchain & Smart Contracts**

- Solidity 0.8.24+ contracts

- JSC Kaigan testnet deployment

- OpenZeppelin security standards

- EIP-5564 stealth address implementation

- Custom ERC20 JPYM token with airdrops

### **Zero-Knowledge Technology**

- Circom for ZK circuit development

- Groth16 proof system (production-ready)

- WASM compilation for mobile browsers

- snarkjs for proof generation/verification

### **Identity & Privacy**

- ENS (Ethereum Name Service) integration

- Mizuhiki SBT verification

- ZKPassport international identity proofs

- Elliptic curve cryptography for stealth addresses

### **Development & Testing**

- Hardhat for smart contract development

- Jest + React Testing Library

- Comprehensive ZK circuit test suite

- Mobile performance optimization

## Basic architecture

```

```

### **Component Architecture:**

**Frontend (mizu-fe/)**

- ENS subdomain claiming interface

- ZKPassport verification UI

- Stealth payment flows

- QR code generation and scanning

- Mobile-responsive PWA

**Backend (mizu-backend/)**

- ENS service with verification gating

- ZK ticket proof generation/verification APIs

- Identity verification (SBT + ZKPassport)

- JPYM airdrop management

**Smart Contracts (mizu-contracts/)**

- MizuPassIdentity.sol - Universal identity verification

- EventContract.sol - Ticketing with stealth payments

- MockJPYM.sol - Custom token with airdrops

- StealthAddressManager.sol - EIP-5564 privacy system

**ZK Circuits (mizu-circuit/)**

- ticket-verification.circom - Main privacy circuit

- 6.5ms witness generation performance

- Groth16 proofs with Solidity verifier

- WASM compilation for offline verification

## Source code

**Main Repository:** https://github.com/MizuPass

### **Repository Structure:**

- **Frontend**: [`mizu-fe/`](https://github.com/MizuPass/mizu-fe) - React + TypeScript web application

- **Backend**: [`mizu-backend/`](https://github.com/MizuPass/mizu-backend) - Node.js API server with ZK integration

- **Smart Contracts**: [`mizu-contracts/`](https://github.com/MizuPass/mizu-contracts) - Solidity contracts for JSC Kaigan

- **ZK Circuits**: [`mizu-circuit/`](https://github.com/MizuPass/mizu-circuit-zk) - Production Circom circuits

## Deployment

### **Live Demo:** https://mizupass.com

- Complete working platform with all features

- ENS subdomain claiming (real .mizupass.eth domains)

- ZKPassport verification system

- JPYM airdrop functionality (up to 10,000 JPYM)

- ZK proof generation and QR code creation

- Mobile-responsive PWA interface

### **Backend API:** https://services.mizupass.com

- Production-ready REST API

- ZK proof generation endpoints

- ENS service integration

- Identity verification services

- Real-time JPYM price feeds

### **Smart Contracts:** JSC Kaigan Testnet

MizuPassModule#MizuPassIdentity - 0x9fB07660c625E3819162Ba0a64334C4D7e139E15

MizuPassModule#MockJPYM - 0x5607DD40f7DFF4f88f504338D92354F7cFdFD178

MizuPassModule#StealthAddressManager - 0xE263174F9d3b96b5D697CEF79f7286FA91Ca040F

MizuPassModule#EventRegistry - 0xe4cdc2b610CF13584b884383bfEA3237009CA501

- All contracts deployed

- Event creation and management

- Stealth payment functionality

- JPYM token with airdrop system

- ZK proof verification capability

### **Demo Flow (3 minutes):**

1. **Visit mizupass.com** - Connect MetaMask wallet

2. **Identity Verification** - Demo ZKPassport or use test accounts

3. **Claim ENS Subdomain** - Get free .mizupass.eth domain

4. **JPYM Airdrop** - Receive testing tokens (1,000-10,000 JPYM)

5. **Purchase Ticket** - Buy demo event ticket with stealth payment

6. **Generate QR Proof** - Create ZK proof for offline verification

7. **Venue Entry** - Scan QR code for instant verification

---

**Built for ETH Tokyo 2025 - Ready for Production Scale**

*Revolutionizing events with Universal DID + Privacy + Compliance*