Obsqra.fi Documentation
v0.2.6Obsqra.fi is a privacy-preserving DeFi treasury protocol that combines zero-knowledge proofs, verifiable AI, and DAO governance to enable trustless capital management. This documentation covers the technical architecture, smart contracts, and integration guides.
What is Obsqra.fi?
Traditional DeFi protocols face a fundamental tension: users want yield optimization, but on-chain transparency exposes their positions to front-running, copy-trading, and privacy violations. DAOs managing treasuries face an additional challenge: how do you delegate capital allocation to AI systems while maintaining verifiable governance?
Obsqra.fi solves these problems through three integrated innovations:
ZK Privacy Pools
Break deposit→withdrawal links with ZK proofs. Commitments stored on-chain, ownership proven cryptographically without revealing which deposit is yours.
Technical details →Verifiable AI
AI commits allocation decisions on-chain before execution. Every rebalance has an immutable audit trail. Can't change reasoning after the fact.
How it works →DAO Constraints
Hard limits enforced by smart contracts. Safe recommendations auto-execute. Risky ones require governance vote. AI can't override DAO policy.
View constraints →System Architecture
Obsqra.fi is a layered system where each layer has specific responsibilities. The frontend handles user interactions and ZK proof generation. Smart contracts manage state and verification. The AI service provides risk analysis and allocation recommendations.
How It Works
Deposit Flow
When you deposit, your funds enter a privacy pool where they become indistinguishable from other deposits. The system generates a cryptographic commitment that only you can redeem.
Generates secret + nullifier
Creates commitment
Stores commitment
Funds deployed to DeFi
Generates secret + nullifier
Creates commitment
Stores commitment
Funds deployed to DeFi
Withdrawal Flow
To withdraw, you generate a ZK proof that you know the secret for a valid commitment, without revealing which one. The contract verifies the proof and releases funds.
Provides secret + nullifier
Generates Groth16 proof
Validates proof on-chain
Funds sent to recipient
Provides secret + nullifier
Generates Groth16 proof
Validates proof on-chain
Funds sent to recipient
Privacy Model
Obsqra.fi provides transaction privacy, not total anonymity. The goal is to break the link between deposits and withdrawals while maintaining protocol transparency for auditing and compliance.
| Data | Visibility | Reason |
|---|---|---|
| Deposit amount | Public | On-chain event for TVL tracking |
| Depositor address | Hidden | Only commitment hash stored |
| Withdrawal recipient | Public | Required for fund transfer |
| Deposit-withdrawal link | Hidden | ZK proof provides unlinkability |
| Pool TVL | Public | Aggregate balance visible |
| AI recommendations | Public | Committed on-chain for audit |
| Individual positions | Hidden | Cannot determine who owns what |
Current Status
Quick Links
Connect your wallet, get test tokens, and make your first deposit in under 5 minutes.
See how ZK privacy, verifiable AI, and DAO constraints work together as an integrated system.
Understand the full stack: frontend, smart contracts, AI service, and DeFi protocols.
Contract addresses, ABIs, error codes, and integration examples.