Skip to content

Latest commit

Β 

History

History
55 lines (38 loc) Β· 1.48 KB

File metadata and controls

55 lines (38 loc) Β· 1.48 KB

Obscura πŸ•΅οΈ – Shielded Pool on Starknet

Obscura is a privacy-focused shielded pool for Starknet, enabling private deposits, transfers, and withdrawals using zero-knowledge proofs and a UTXO-based model.

It looks like magic, right? It’s not magic β€” it’s just math and UTXOs. 🧠


βš™οΈ How It Works

  • πŸ’° Shielded deposits & withdrawals
  • πŸ” Encrypted shielded transfers
  • 🌳 Merkle tree for commitments
  • πŸ“Ÿ Nullifiers to prevent double-spends
  • πŸ”Ž ZK proofs verified on-chain (Honk + Noir)

πŸ‚οΈ Project Structure

contracts/obscura       # Core Cairo contracts (shielded pool logic)
contracts/obscura       # Verifier Cairo contracts (Garaga generated contract)
circuit/                 # Noir circuit
app/                    # Frontend UI (React + Vite)

πŸ§ͺ Run Locally

yarn install             # Install deps
yarn chain               # Start Starknet devnet
make declare-verifier
make declare-contract
yarn test:e2e            # Run full test suite

Configure .env from .env.example.


πŸ”— Links


πŸͺͺ License

MIT