c8be9d7414
- Add Prometheus metrics for marketplace API throughput and error rates with new dashboard panels - Implement confidential transaction models with encryption support and access control - Add key management system with registration, rotation, and audit logging - Create services and registry routers for service discovery and management - Integrate ZK proof generation for privacy-preserving receipts - Add metrics instru
3.2 KiB
3.2 KiB
AITBC ZK Circuits
Zero-knowledge circuits for privacy-preserving receipt attestation in the AITBC network.
Overview
This project implements zk-SNARK circuits to enable privacy-preserving settlement flows while maintaining verifiability of receipts.
Quick Start
Prerequisites
- Node.js 16+
- npm or yarn
Installation
cd apps/zk-circuits
npm install
Compile Circuit
npm run compile
Generate Trusted Setup
# Start phase 1 setup
npm run setup
# Contribute to setup (run multiple times with different participants)
npm run contribute
# Prepare phase 2
npm run prepare
# Generate proving key
npm run generate-zkey
# Contribute to zkey (optional)
npm run contribute-zkey
# Export verification key
npm run export-verification-key
Generate and Verify Proof
# Generate proof
npm run generate-proof
# Verify proof
npm run verify
# Run tests
npm test
Circuit Design
Current Implementation
The initial circuit (receipt.circom) implements a simple hash preimage proof:
- Public Inputs: Receipt hash
- Private Inputs: Receipt data (job ID, miner ID, result, pricing)
- Proof: Demonstrates knowledge of receipt data without revealing it
Future Enhancements
- Full Receipt Attestation: Complete validation of receipt structure
- Signature Verification: ECDSA signature validation
- Arithmetic Validation: Pricing and reward calculations
- Range Proofs: Confidential transaction amounts
Development
Circuit Structure
receipt.circom # Main circuit file
├── ReceiptHashPreimage # Simple hash preimage proof
├── ReceiptAttestation # Full receipt validation (WIP)
└── ECDSAVerify # Signature verification (WIP)
Testing
# Run all tests
npm test
# Run specific test
npx mocha test.js
Integration
The circuits integrate with:
- Coordinator API: Proof generation service
- Settlement Layer: On-chain verification contracts
- Pool Hub: Privacy options for miners
Security
Trusted Setup
The Groth16 setup requires a trusted setup ceremony:
- Multi-party participation (>100 recommended)
- Public documentation
- Destruction of toxic waste
Audits
- Circuit formal verification
- Third-party security review
- Public disclosure of circuits
Performance
| Metric | Value |
|---|---|
| Proof Size | ~200 bytes |
| Prover Time | 5-15 seconds |
| Verifier Time | 3ms |
| Gas Cost | ~200k |
Troubleshooting
Common Issues
- Circuit compilation fails: Check circom version and syntax
- Setup fails: Ensure sufficient disk space and memory
- Proof generation slow: Consider using faster hardware or PLONK
Debug Commands
# Check circuit constraints
circom receipt.circom --r1cs --inspect
# View witness
snarkjs wtns check witness.wtns receipt.wasm input.json
# Debug proof generation
DEBUG=snarkjs npm run generate-proof
Resources
Contributing
- Fork the repository
- Create feature branch
- Submit pull request with tests
License
MIT