ZkWhistleBlowing 🔒

차세대 익명 내부고발 플랫폼 - Zero-Knowledge Proof 기반 안전한 제보 시스템

ZkWhistleBlowing은 Zero-Knowledge 증명 기술을 활용하여 완전한 익명성을 보장하는 혁신적인 내부고발 플랫폼입니다. 블록체인과 암호학적 증명을 통해 제보자의 신원을 완벽하게 보호하면서도 제보의 진위성을 검증할 수 있습니다.

✨ 주요 특징

🛡️ 완전한 익명성

• Zero-Knowledge Proof: 신원을 노출하지 않고도 직원임을 증명
• Merkle Tree 기반 인증: 사용자 데이터베이스를 암호화하여 관리
• Nullifier 시스템: 중복 제보 방지 및 개인정보 보호

🔐 최첨단 보안

• Noir Language: 고성능 ZK-SNARK 회로 구현
• UltraHonk Backend: 효율적인 증명 생성 및 검증
• Arbitrum 검증: 블록체인 상에서 증명 검증

📡 분산 저장

• IPFS 통합: Pinata를 통한 탈중앙화 파일 저장
• 불변성 보장: 제보 내용의 위변조 방지
• 영구 보존: 검열 저항성 확보

🏗️ 기술 스택

Frontend

• Next.js 15: React 기반 풀스택 프레임워크
• Turbopack: 고속 개발 환경
• Tailwind CSS: 모던 UI 스타일링

Zero-Knowledge

• Noir: ZK 회로 프로그래밍 언어
• @aztec/bb.js: UltraHonk 백엔드
• Poseidon Hash: 암호학적 해시 함수

Blockchain

• Ethers.js: 이더리움 블록체인 상호작용
• Arbitrum: L2 솔루션으로 검증 비용 절감
• Hardhat: 스마트 컨트랙트 개발 환경

Database & Storage

• Better-sqlite3: 로컬 사용자 데이터베이스
• IPFS/Pinata: 분산 파일 저장
• Indexed Merkle Tree: 효율적인 멤버십 증명

🚀 시작하기

필요사항

• Node.js 18+
• npm 또는 yarn
• Git

설치 및 실행

1. 저장소 클론

git clone https://github.com/Zk-Whistleblowing/front-end.git
cd zkwhistle

2. 의존성 설치

npm install

3. 환경변수 설정

cp .env.local.example .env.local

필요한 환경변수:

ARBITRUM_RPC_URL=https://sepolia-rollup.arbitrum.io/rpc
VERIFIER_CONTRACT_ADDRESS=0x...
PINATA_JWT=your_pinata_jwt_token
PINATA_GATEWAY=your_pinata_gateway_url

4. 데이터베이스 초기화

node db/initDB.js

5. 개발 서버 실행

npm run dev

브라우저에서 http://localhost:3000을 열어 확인하세요.

📁 프로젝트 구조

zkwhistle/
├── app/                    # Next.js 앱 라우터
│   ├── api/               # API 엔드포인트
│   │   ├── auth/          # 인증 시스템
│   │   ├── generate-zk-proof/ # ZK 증명 생성
│   │   └── submit-report/ # 제보 제출
│   ├── dashboard/         # 대시보드 페이지
│   ├── sign-in/          # 로그인 페이지
│   └── page.js           # 메인 홈페이지
├── circuit/              # Noir ZK 회로
│   └── circuit.json      # 컴파일된 회로
├── db/                   # 데이터베이스
│   └── initDB.js         # DB 초기화 스크립트
├── utils/                # 유틸리티 함수
│   ├── calculate_nullifier.js # Nullifier 계산
│   └── merkleProof.js    # Merkle 증명 생성
├── public/               # 정적 파일
└── package.json          # 프로젝트 설정

🔧 사용 가능한 스크립트

개발

npm run dev          # 개발 서버 시작 (Turbopack)
npm run build        # 프로덕션 빌드
npm run start        # 프로덕션 서버 실행
npm run lint         # ESLint 검사

Hardhat (스마트 컨트랙트)

npm run hardhat:compile          # 컨트랙트 컴파일
npm run hardhat:test             # 테스트 실행
npm run hardhat:node             # 로컬 네트워크 실행
npm run hardhat:deploy           # 컨트랙트 배포
npm run hardhat:deploy:arbitrum  # Arbitrum에 배포

Noir (Zero-Knowledge)

npm run noir:compile    # ZK 회로 컴파일

🔄 작동 원리

1. 사용자 인증

• 직원이 이메일과 직원 ID로 로그인
• 시스템이 Merkle Tree에서 사용자 위치 확인
• 세션 생성 및 쿠키 저장

2. Zero-Knowledge 증명 생성

// 1. Merkle Proof 생성
const proofData = await generateMerkleProofs(user);

// 2. Noir 회로로 증명 생성
const noir = new Noir(circuitJSON, backend);
const proof = await backend.generateProof(witness);

// 3. Arbitrum에서 검증
const verified = await contract.verify(proof.proof, proof.publicInputs);

3. 제보 제출

• IPFS에 제보 내용 업로드 (Pinata)
• ZK 증명과 함께 제출
• 블록체인에서 검증 후 저장

4. 익명성 보장

• Nullifier: 동일인 재제보 방지하되 신원 비공개
• Merkle Tree: 전체 직원 목록 없이 멤버십 증명
• Zero-Knowledge: 신원 정보 완전 분리

🔐 보안 특징

Privacy by Design

• 신원 정보와 제보 내용 완전 분리
• 클라이언트 사이드 암호화
• 메타데이터 최소화

Cryptographic Guarantees

• Soundness: 거짓 증명 불가능
• Zero-Knowledge: 신원 정보 누출 없음
• Completeness: 정당한 직원의 증명 항상 성공

Blockchain Security

• 불변의 검증 기록
• 탈중앙화된 증명 저장
• 검열 저항성

🤝 기여하기

1. Fork 프로젝트
2. Feature 브랜치 생성 (git checkout -b feature/AmazingFeature)
3. 변경사항 커밋 (git commit -m 'Add some AmazingFeature')
4. 브랜치에 Push (git push origin feature/AmazingFeature)
5. Pull Request 생성

📄 라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

📞 지원

• 이슈 리포트: GitHub Issues
• 문서: 프로젝트 위키
• 이메일: support@zkwhistle.org

🎯 로드맵

• 다중 서명 검증 시스템
• 모바일 앱 개발
• 다국어 지원
• 고급 분석 대시보드
• 통합 신고 워크플로우

---

ZkWhistleBlowing: 진실을 보호하는 기술, 안전을 보장하는 암호학