Skip to content

ARCHITECTURE.md

Latest commit

 

History

History
69 lines (54 loc) · 2.88 KB

ARCHITECTURE.md

File metadata and controls

69 lines (54 loc) · 2.88 KB
Raw

ZK-based Proof of Personhood for Online Forum

This repo aims for exploring the PoC of ZK-based proof of personhood for online forum platforms. The tech is targeting for using OpenAC and its implementation from PSE's zkID team to verify Taiwan's Citizenship Certificate.

System Architecture for OpenAC Integration

Proof Requirements

One-time per credential proof for online forum server

  • Verify the user holds a valid mobile citizenship certificate
    • no need extra check on age and nationalities since holding the certificate proves that
  • Verify the mobile citizenship certificate has not been registered before

Web-based Approach

more common for both physical citizenship certificate (physical card) and mobile citizenship certificate (mobile app)

mobile citizenship certificate for web app
mobile citizenship certificate (mobile app)
physical citizenship certificate for web app
physical citizenship certificate (physical card), requires a card reader

Flow

  1. User → Issuer: apply mobile citizenship certificate
  2. User → Web App: use API to fetch mobile citizenship certificate, and wrap it into JWT-format VC
  3. Web App: Generate ZKP
  4. Web App → online forum server: Submit ZKP with API
  5. Online forum server: verify ZKP
    • if pass, update user DB with user.vcVerified = true
    • if failed, update user DB with user.vcVerified = failed

Frontend

  • Fetch mobile citizenship certificate data with APIs
  • Wrap raw data into JWT-format VC
  • Generate ZKP using OpenAC
    • (OpenAC → wasm-bindgen → WASM)
  • Send ZKP to online forum for verification

Backend

Mobile-based Approach

mobile citizenship certificate for mobile app
mobile citizenship certificate (mobile app)

Flow

  1. Online forum mobile app → API to fetch mobile citizenship certificate and wrap it into JWT-format VC
  2. within mobile app: generate ZKP (with mopro-ffi bindings)
  3. mobile app → online forum server: submit ZKP with API
  4. Online forum server: verify ZKP
    • if pass, update user DB with user.vcVerified = true
    • if failed, update user DB with user.vcVerified = failed

Frontend

Integrate with existing official mobile app for specific online forum

  • Fetch mobile citizenship certificate data with APIs
  • Wrap raw data into JWT-format VC
  • Generate ZKP using OpenAC with mopro-ffi bindings
  • Send ZKP to online forum for verification

Backend