A privacy-preserving liquidity provision system on Mantle Network.
Privy-Lips is a privacy-preserving liquidity protocol on Mantle Network that addresses DeFi privacy and compliance. It uses zero-knowledge proofs and cryptographic commitments to hide deposit amounts, enable unlinkable withdrawals via nullifiers, and support selective disclosure for tax reporting without revealing exact amounts. The protocol includes a three-tier ZK-KYC system (Anonymous, Pseudonymous, Institutional) for compliance without exposing identity. By combining ZK proofs, Pedersen commitments, and selective disclosure, Privy-Lips enables private liquidity provision while meeting regulatory requirements protecting users from on-chain surveillance and targeted attacks while maintaining full compliance capabilities.
PRIVY-LIPS HACKATHON PROGRESS SMART CONTRACTS (7 Contracts) - CommitmentRegistry: Stores commitments and prevents double-spending via nullifiers - PrivateLiquidityPool: Uniswap V2-style AMM with shielded deposits and unlinkable withdrawals - YieldAccumulator: Tracks yield accrual per commitment from trading fees - SelectiveDisclosure: Verifies yield proofs for tax compliance without revealing exact amounts - ZKKYCRegistry: Three-tier KYC system (Anonymous $10k, Pseudonymous $100k, Institutional unlimited) - SP1Verifier: Interface and adapter for SP1 zkVM proof verification - ERC20Mock: Mock tokens for testing ZERO-KNOWLEDGE PROOF PROGRAMS (4 SP1 Programs) - deposit-proof: Rust program to prove commitment validity - withdrawal-proof: Rust program to prove nullifier validity - yield-proof: Rust program to prove yield range for selective disclosure - kyc-proof: Rust program to prove KYC attributes without revealing identity FRONTEND APPLICATION (5 Pages + 6 Components) - Home page with project overview - Deposit page with shielded commitment generation - Withdraw page with unlinkable nullifier generation - Yield Proof page for selective disclosure and tax reporting - KYC page with tier selection and registration - Encrypted local storage using AES-GCM for commitment secrets BACKEND LIBRARIES (8 Modules) - commitments.ts: Commitment generation and management - contracts.ts: Smart contract interaction utilities - encryption.ts: AES-GCM encryption/decryption - kyc.ts: KYC tier management - pool.ts: Pool operations (deposit, withdraw, swap) - sp1-client.ts: SP1 proof generation (mocked for MVP) - storage.ts: Encrypted localStorage management - wallet.ts: Wallet connection utilities TESTING & DEPLOYMENT - 4 test suites covering all core contracts - 6 deployment scripts for Mantle Network - Hardhat configuration with TypeChain integration - Complete contract ABIs generated DOCUMENTATION & DESIGN - Comprehensive README with architecture and user flows - Custom logo design with privacy shield and liquidity pool elements - Professional UI/UX with blue/indigo gradient theme - SP1 program documentation KEY ACHIEVEMENTS - Shielded deposits using commitments - Unlinkable withdrawals using nullifiers - Selective disclosure for compliance - ZK-KYC without identity revelation