ff5486fe08
chore: refactor logging module, update genesis timestamp, remove model relationships, and reorganize routers - Rename logging.py to logger.py and update import paths in poa.py and main.py - Update devnet genesis timestamp to 1766828620 - Remove SQLModel Relationship declarations from Block, Transaction, and Receipt models - Add SessionDep type alias and get_session dependency in coordinator-api deps - Reorganize coordinator-api routers: replace explorer/registry with exchange, users, marketplace
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