Ecosystem Apps

Production-ready applications built on the ZK Privacy SDK.

Portfolio

The full-featured privacy wallet for end users.

🔗 portfolio.zkprivacy.dev

Features

• Wallet Connection - Connect with MetaMask, WalletConnect, or any EIP-1193 wallet
• Private Balances - View balances across zkUSD, zkEUR, zkPLN
• Shield - Convert public tokens to private
• Transfer - Send to any ZK address privately
• Unshield - Withdraw to any Ethereum address
• Swaps - Exchange tokens privately
• Transaction History - Track your private transactions
• Multi-Network - Support for local, testnet, and mainnet

User Flow

┌─────────────────────────────────────────────────────────┐
│                     Portfolio App                        │
├─────────────────────────────────────────────────────────┤
│                                                          │
│   1. Connect Wallet                                      │
│      └─► Sign EIP-712 message to derive ZK keys         │
│                                                          │
│   2. Sync                                                │
│      └─► Download and decrypt your notes                │
│                                                          │
│   3. Use                                                 │
│      ├─► Shield: Public → Private                       │
│      ├─► Transfer: Private → Private                    │
│      ├─► Unshield: Private → Public                     │
│      └─► Swap: Token → Token (private)                  │
│                                                          │
└─────────────────────────────────────────────────────────┘

Screenshots

Portfolio provides a clean, modern interface:

• Dashboard: Overview of all private balances
• Send: Transfer to ZK addresses with QR scanning
• Receive: Display your ZK address with QR code
• Activity: Full transaction history with status

---

Shield Portal

Simplified deposit-only interface for onboarding.

🔗 shield.zkprivacy.dev

Features

• Single Purpose - Shield tokens only, minimal UI
• No Wallet Required - Recipient provides ZK address
• Embeddable - Can be integrated into other sites
• Low Friction - Fastest path to private tokens

Use Cases

1. Merchant Onboarding - Customer shields payment to merchant's ZK address
2. Gift Cards - Generate ZK address, let anyone shield to it
3. Payroll - Employer shields directly to employee ZK addresses
4. Donations - Accept private donations

Integration

Embed Shield Portal in your site:

<iframe 
  src="https://shield.zkprivacy.dev?recipient=zks1..."
  width="400"
  height="500"
  frameborder="0"
></iframe>

Or use the SDK directly:

import { shieldTo } from '@zkprivacy/sdk/shield';

await shieldTo(config, {
  recipient: 'zks1...',
  amount: '1000',
  tokenAddress: tokenAddress,
  walletClient,
});

---

Scan (Block Explorer)

Privacy-aware block explorer.

🔗 scan.zkprivacy.dev

Features

• Transaction Browser - View all pool transactions
• Address Lookup - Search by commitment, nullifier, or EOA
• Token Stats - TVL, volume, transaction counts
• Pool Activity - Real-time shield/transfer/unshield events

What You Can See

Data	Visible
Transaction hashes	✅ Yes
Commitments	✅ Yes
Nullifiers	✅ Yes
Transaction type	✅ Yes
Amounts	❌ No
Sender/Recipient	❌ No
Linked transactions	❌ No

---

Devtools

Developer testing environment with multiple accounts.

🔗 devtools.zkprivacy.dev

Features

• Multiple Accounts - Test with different personas
• Debug Mode - Verbose logging and state inspection
• Quick Actions - Shield, transfer, unshield with one click
• Anvil Integration - Auto-mint tokens for testing

Use Cases

• Testing SDK integrations
• Debugging proof generation
• Simulating multi-party flows
• Manual QA testing

---

Dashboard

EMT issuer administration panel.

🔗 dashboard.zkprivacy.dev

Features

• Mint/Burn - Issue and redeem tokens
• Compliance - Freeze, blacklist, seize operations
• Analytics - Token supply, holder counts, volume
• Access Control - Manage roles and permissions

For Issuers Only

Dashboard requires issuer credentials (owner/minter/compliance role).

---

Regulator

Compliance officer interface for authorized viewing.

🔗 regulator.zkprivacy.dev

Features

• Warrant Submission - Request decryption of specific notes
• Guardian Approval - Multi-party decryption workflow
• Audit Trail - All compliance actions logged
• Chain Tracing - Follow transaction chains (with warrant)

Access Control

Requires guardian quorum approval for any decryption.

---

Running Locally

All apps can be run locally for development:

# Start local blockchain
just dev

# Run specific app
just portfolio   # Port 3101
just shield      # Port 3105
just scan        # Port 3102
just devtools    # Port 3100
just dashboard   # Port 3103
just regulator   # Port 3104

Architecture

All apps share common infrastructure:

┌─────────────────────────────────────────────────────────┐
│                    Frontend Apps                         │
│  Portfolio │ Shield │ Scan │ Devtools │ Dashboard       │
└─────────────────────────┬───────────────────────────────┘
                          │
┌─────────────────────────┼───────────────────────────────┐
│                @zkprivacy/sdk                            │
│  PrivacyClient │ Prover │ Shield │ KeyManager           │
└─────────────────────────┬───────────────────────────────┘
                          │
┌─────────────────────────┼───────────────────────────────┐
│               Backend Services                           │
│  Relayer │ QuickSync │ Faucet │ Market Maker │ FX       │
└─────────────────────────┬───────────────────────────────┘
                          │
┌─────────────────────────┼───────────────────────────────┐
│              Smart Contracts                             │
│  UTXOPoolV3 │ EMT Tokens │ Verifiers │ Poseidon2        │
└─────────────────────────────────────────────────────────┘