Obsqra.fi Docs
Demo

Quick Start Guide

Get up and running with Obsqra.fi in under 5 minutes. This guide walks you through connecting your wallet, getting test tokens, and making your first private deposit.

Prerequisites

Before you start, make sure you have:

  • Wallet
    MetaMask or compatible wallet

    Any EVM-compatible wallet that supports custom networks

  • Browser
    Modern browser

    Chrome, Firefox, or Brave with WebAssembly support

  • Testnet
    Local Anvil testnet running

    Or access to obsqra.fi demo site with hosted testnet

1

Connect Your Wallet

Click the "Connect Wallet" button in the top-right corner of the demo page. Select your wallet provider from the list. If you're using MetaMask, you'll be prompted to add the Anvil network.

Anvil Network Configuration

Network Name:Anvil (Local)
Chain ID:31337
RPC URL:http://localhost:8545
Currency:ETH
ℹ️
Using the Hosted Demo?
If you're using obsqra.fi/demo, the network is automatically configured. The RPC is proxied through https://obsqra.fi/rpc. Just connect your wallet and approve the network switch.
2

Get Test wETH

Obsqra.fi uses wETH (Wrapped Ether) for deposits. On the testnet, you can mint free test wETH using the faucet button in the demo interface.

  1. 1.Look for the "Mint wETH" button in the demo header
  2. 2.Click it to receive 10 test wETH
  3. 3.Confirm the transaction in your wallet
  4. 4.Wait for confirmation (instant on Anvil)
⚠️
Testnet Only
The faucet only works on the Anvil testnet. These are not real tokens and have no value. On mainnet, you would need to wrap ETH into wETH using a DEX or the WETH contract directly.
3

Make Your First Deposit

Deposits in Obsqra.fi are private. When you deposit, the system generates a cryptographic commitment that only you can redeem. Here's what happens:

Generate Secret

Random 256-bit number

Create Commitment

Poseidon hash

Deposit wETH

Funds + commitment

Save Note

Encrypted locally

  1. 1.
    Enter deposit amount

    Type the amount of wETH you want to deposit (e.g., 1.0)

  2. 2.
    Approve wETH spending

    First transaction: Allow the pool to spend your wETH

  3. 3.
    Confirm deposit

    Second transaction: Deposit funds with your commitment

  4. 4.
    Backup your deposit note

    A modal will appear with backup options - this is critical!

❌
Critical: Save Your Deposit Note
Your deposit note contains the secret needed to withdraw. It's encrypted and stored in your browser, but if you clear browser data or switch devices, you'll need a backup. Without the note, your funds are permanently locked.
4

Withdraw Your Funds

Withdrawals use zero-knowledge proofs to verify you own a deposit without revealing which one. The proof generation happens in your browser and takes about 5 seconds.

Select Note

Choose deposit to withdraw

Generate Proof

~5 seconds in browser

Verify On-chain

Groth16 verification

Receive Funds

To any address

  1. 1.
    Select a deposit to withdraw

    Your deposits are listed in the withdrawal panel

  2. 2.
    Enter recipient address

    Can be any address - doesn't have to match the depositor

  3. 3.
    Generate ZK proof

    Click "Withdraw" and wait ~5 seconds for proof generation

  4. 4.
    Confirm transaction

    The proof is submitted to the contract for verification

✅
Privacy Achieved
After withdrawal, there's no on-chain link between your deposit and withdrawal. An observer can see that someone deposited and someone withdrew, but cannot prove they're the same person.

What's Next?

Understand Privacy Pools

Learn how commitments and nullifiers work

Explore the AI Engine

See how AI manages allocations

Technical Deep Dive

Code-level walkthrough of flows

ZK Circuit Details

Understand the cryptography