Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ZKShield Logo

🛡️ ZKShield

A Zero-Knowledge Identity & Governance Platform for the Web3 Era

License: MIT Midnight React


🏆 The Problem

Traditional identity verification and DAO voting systems permanently expose user data on public blockchains. Users are forced to trade privacy for participation, leading to doxxing, voter coercion, and data harvesting.

🚀 Our Solution: ZKShield

ZKShield leverages the Midnight Network's privacy-preserving smart contract capabilities to provide a seamless, full-stack identity platform. We issue Zero-Knowledge credentials that allow users to:

  1. Prove Identity Without Revealing Data: Users can prove they hold specific credentials (e.g., KYC verified, employee status) without exposing their real-world identity to verifiers.
  2. Anonymous Voting: DAOs and organizations can host verifiable votes where the voter's identity is mathematically decoupled from their choice.
  3. Frictionless UX: A premium, futuristic dashboard built with Framer Motion and Tailwind CSS ensures enterprise-grade usability.

🏗️ Architecture

ZKShield is architected as a modern, containerized monorepo.

graph TD;
    A[Frontend: React + Tailwind + Recharts] -->|REST API + ZK Proofs| B(Backend: Express Node.js);
    B -->|Commitments & Verification| C{Midnight Network / ZK Contracts};
    C -->|On-chain State| D[(Ledger)];
    B -->|Mock / Simulations| E[Local Dev Database];
Loading

✨ Features

  • 🔐 Privacy-First Credentials: Issue verifiable credentials that are stored as hashes on-chain.
  • 🎟️ Zero-Knowledge Access Passes: Generate ZK proofs on the client side to authenticate without sending passwords or seeds.
  • 📊 Real-time Anonymous Governance: Integrated voting system where tallying is public, but voter identity remains strictly anonymous.
  • 🐳 Docker-Ready: Instant setup with Zero Configuration via docker-compose.

💻 Running the Project (Judges / Reviewers)

We've made it incredibly easy to review our project. You don't need to configure complex toolchains or install the Compact compiler. Everything runs seamlessly in Docker.

Requirements:

  • Docker & Docker Compose
  • Node.js (if not using Docker)

Quick Start (Dockerized)

Since the Midnight proof generation and verifications are pre-configured, simply run:

# Start the full stack (Frontend & Backend)
docker compose up --build
  • Frontend Dashboard: http://localhost:5173
  • Backend API: http://localhost:4000

Manual Setup

npm install
# Terminal 1:
npm run dev:frontend
# Terminal 2:
npm run dev:backend

📂 Project Structure

Module Description Tech Stack
frontend The stunning user dashboard facing verifiers and issuees React, Tailwind, Framer Motion
backend Core API for handling simulated issuer flows and proof routing Node.js, Express, CORS
contracts Midnight Compact smart contracts defining the application logic compactc

🔮 Future Roadmap

  • Mainnet Deployment: Porting our local simulating logic to Midnight Mainnet.
  • Mobile SDK: Allowing seamless ZK-proof generation on iOS/Android.
  • Lace Wallet Deep Integration: Removing the need for manual seed phrases in local environments.

Built with ❤️ for the $1200 Midnight Innovation Hackathon.

About

ZKShield — A privacy-first zero-knowledge identity and governance platform enabling anonymous verification and voting without exposing user data.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages