veil-privacy

name	veil-privacy
description	ZK privacy layer on Base via Veil Cash (veil.cash). Deposit ETH/USDC into shielded pools using Bankr as the signing layer. Check private + queue balances. Withdraw to any address without linking back to origin. Uses Groth16 ZK proofs, UTXO model. Bankr wallet is the funding source — must be set up first. Use when smolting needs private treasury moves, unlinkable payouts, or shielded transfers.
metadata	{"clawdbot":{"emoji":"🕵️","homepage":"https://veil.cash","requires":{"auth":"VEIL_PRIVATE_KEY env var (generate from EOA signature or import directly)"}}}

Veil Privacy

Zero-knowledge shielded transactions on Base. ETH and USDC enter a private pool, transfers and withdrawals are relayed so no gas is needed and nothing links back to the deposit.

Architecture

Bankr wallet (0x8d7437597...)
    ↓ deposit tx (signed by Bankr)
Veil Entry contract (0xc2535c547B64b997A4BD9202E1663deaF11c78a5)
    ↓ compliance queue (auto-approved if verified)
ETH Pool (0x293dCda114533FF8f477271c5cA517209FFDEEe7)
USDC Pool (0x5c50d58E49C59d112680c187De2Bf989d2a91242)
    ↓ private balance (ZK-encrypted, only VEIL_PRIVATE_KEY can read)
    ↓ relay (no gas needed)
Any external address (withdrawal)

Contracts (Base mainnet — audited Sherlock Mar 2026)

Contract	Address
Veil Entry	0xc2535c547B64b997A4BD9202E1663deaF11c78a5
ETH Pool	0x293dCda114533FF8f477271c5cA517209FFDEEe7
USDC Pool	0x5c50d58E49C59d112680c187De2Bf989d2a91242
ETH Queue	0xA4a926A2E7a22c38e8DFC6744A61a6aA8b06B230
USDC Queue	0x5530241b24504bF05C9a22e95A1F5458888e6a9B
Hasher	0x2460da3AcdA8A3BDbB2149c948363233D3453ac2
Verifier2	0x69013e62EF76BF1A7B980957607c944C9BD4FDF5
Verifier16	0xB5e025044b09cAe75bace1c8dB9701aE383792e4
Onchain Verify	0xb5B3C6192E1871c613e0C415108Ba3934237F360
VEIL Token	0x767A739D1A152639e9Ea1D8c1BD55FDC5B217D7f

Python API (smolting-telegram-bot/veil_client.py)

from veil_client import VeilClient

veil = VeilClient()

# Check balances
info = await veil.get_balance()
# → {"eth_private": 0.05, "eth_queue": 0.0, "usdc_private": 0.0, "address": "0x..."}

# Deposit ETH via Bankr
result = await veil.deposit_eth("0.05")
# → {"success": True, "txHash": "0x...", "queued": True}

# Deposit USDC via Bankr
result = await veil.deposit_usdc("100")

# Withdraw ETH to any address (relayed, private)
result = await veil.withdraw_eth("0x_recipient", "0.04")
# → {"success": True, "relayed": True}

Environment Variables

Variable	Required	Description
BANKR_API_KEY	✅	Bankr wallet signs deposits — must be set
VEIL_PRIVATE_KEY	✅	Veil private key (hex) — controls shielded funds
BASE_RPC_URL	optional	Base RPC endpoint (default: public)

Key Concepts

Veil Keypair:

• Deposit key (public) — published on-chain, lets others send you private transfers
• Private key (secret) — decrypts incoming deposits, authorizes spending. VEIL_PRIVATE_KEY in env.

Compliance queue:

• All deposits screened before entering pool
• Auto-approved if verified: Coinbase EAS, Binance BABT, or Ethos reputation
• Unverified: 6-hour 0xbow screening window

Minimums: 0.01 ETH or 20 USDC (after 0.3% fee)

Sub accounts: Up to 3 deterministic deposit addresses for enhanced privacy (sweep → pool)

Deposit Flow (Bankr → Veil)

1. Build calldata for VeilEntry.deposit(depositKey, amount)
2. Submit via bankr_wallet.transfer_eth() or Bankr agent prompt
3. Monitor queue until approved → balance appears in private pool
4. Private key never leaves the agent

Withdrawal Flow (Veil → any address)

1. Generate ZK proof locally using VEIL_PRIVATE_KEY
2. Submit to Veil relay (no gas required)
3. Relay delivers funds to recipient address
4. No on-chain link between deposit and withdrawal

Security

• VEIL_PRIVATE_KEY never logged or transmitted — read from env only
• Deposits signed by Bankr (key never in Veil layer)
• Start with small test amounts — Veil is experimental
• Audit: Sherlock collaborative audit, March 2026

Dependency graph

veil-privacy
    ← funded by
bankr-wallet (BANKR_API_KEY)
    ← also used by
near-intents (cross-chain → Base → Bankr → Veil)