diff --git a/docs/workshops/README.md b/docs/workshops/README.md
new file mode 100644
index 0000000..381726f
--- /dev/null
+++ b/docs/workshops/README.md
@@ -0,0 +1,612 @@
+# PrivacyLayer Developer Workshops
+
+Comprehensive workshop curriculum for building privacy-preserving applications with PrivacyLayer.
+
+---
+
+## Workshop Series Overview
+
+| Workshop | Title | Duration | Level |
+|----------|-------|----------|-------|
+| 1 | Introduction to Privacy-Preserving Development | 2 hours | Beginner |
+| 2 | Building with PrivacyLayer SDK | 3 hours | Intermediate |
+| 3 | Advanced ZK Circuit Development | 3 hours | Advanced |
+
+---
+
+## Workshop 1: Introduction to Privacy-Preserving Development
+
+### Duration: 2 hours
+### Level: Beginner
+### Prerequisites: Basic programming knowledge
+
+### Learning Objectives
+By the end of this workshop, participants will be able to:
+- Understand the importance of privacy in Web3
+- Explain how zero-knowledge proofs work
+- Set up a basic PrivacyLayer development environment
+- Create their first private transaction
+
+### Curriculum
+
+#### Part 1: Why Privacy Matters (30 minutes)
+
+**Slides:**
+1. The Privacy Problem in Public Blockchains
+   - Transaction transparency
+   - Real-world privacy risks
+   - Case studies: Privacy failures
+
+2. Privacy vs. Anonymity
+   - Definitions and differences
+   - Regulatory landscape
+   - Privacy as a feature
+
+3. Zero-Knowledge Proofs Introduction
+   - The magic cave analogy
+   - Properties: Completeness, Soundness, Zero-Knowledge
+   - Real-world applications
+
+**Interactive Element:** Privacy Quiz
+- Participants answer questions about privacy scenarios
+- Real-time polling and discussion
+
+#### Part 2: PrivacyLayer Architecture (30 minutes)
+
+**Slides:**
+1. System Overview
+   - Components: Smart contracts, SDK, dApp
+   - Transaction flow
+   - Security model
+
+2. Core Concepts
+   - Privacy pools
+   - Commitments and nullifiers
+   - Merkle trees
+
+3. Stellar Integration
+   - Soroban smart contracts
+   - Freighter wallet
+   - Transaction fees
+
+**Live Demo:**
+- Walk through a deposit/withdrawal on testnet
+- Show transaction on Stellar Expert
+
+#### Part 3: Hands-on Setup (45 minutes)
+
+**Exercise 1: Environment Setup**
+```bash
+# Install dependencies
+npm install @privacylayer/sdk
+
+# Clone workshop repository
+git clone https://github.com/PrivacyLayer/workshop-starter
+
+# Install Freighter wallet extension
+# https://freighter.app
+```
+
+**Exercise 2: First Deposit**
+```typescript
+import { PrivacyLayer } from '@privacylayer/sdk';
+
+// Initialize client
+const client = new PrivacyLayer({
+  network: 'testnet',
+  wallet: freighterWallet
+});
+
+// Connect wallet
+await client.connect();
+
+// Deposit funds
+const note = await client.deposit({
+  amount: '10', // XLM
+  asset: 'XLM'
+});
+
+console.log('Deposit note:', note);
+// IMPORTANT: Save this note securely!
+```
+
+**Exercise 3: First Withdrawal**
+```typescript
+// Withdraw using your saved note
+const tx = await client.withdraw({
+  note: savedNote,
+  recipientAddress: 'G...', // Fresh address
+});
+
+console.log('Withdrawal complete:', tx.hash);
+```
+
+#### Part 4: Q&A and Wrap-up (15 minutes)
+
+- Review key concepts
+- Answer questions
+- Homework assignment: Complete a private transaction
+
+### Materials Provided
+- Slide deck (PDF and Google Slides)
+- Code repository with exercises
+- Cheat sheet for common commands
+- Recording (posted after workshop)
+
+---
+
+## Workshop 2: Building with PrivacyLayer SDK
+
+### Duration: 3 hours
+### Level: Intermediate
+### Prerequisites: Workshop 1 or equivalent knowledge, JavaScript/TypeScript proficiency
+
+### Learning Objectives
+- Build a complete privacy-enabled application
+- Handle deposits, withdrawals, and balance queries
+- Implement proper security practices
+- Integrate PrivacyLayer into existing applications
+
+### Curriculum
+
+#### Part 1: SDK Deep Dive (45 minutes)
+
+**Topics:**
+1. SDK Architecture
+   - Module structure
+   - Configuration options
+   - Error handling
+
+2. Core Methods
+   - `deposit()` - Add funds to pool
+   - `withdraw()` - Private withdrawal
+   - `getBalance()` - Check privacy balance
+   - `getAnonymitySet()` - View pool statistics
+
+3. Event Handling
+   - Transaction events
+   - Pool updates
+   - Error events
+
+**Code Example:**
+```typescript
+// Full SDK initialization
+import { PrivacyLayer, WalletType } from '@privacylayer/sdk';
+
+const client = new PrivacyLayer({
+  network: 'mainnet',
+  wallet: {
+    type: WalletType.Freighter,
+  },
+  options: {
+    pollingInterval: 5000,
+    maxRetries: 3,
+  }
+});
+
+// Event listeners
+client.on('deposit:confirmed', (event) => {
+  console.log('Deposit confirmed:', event);
+});
+
+client.on('withdrawal:complete', (event) => {
+  console.log('Withdrawal complete:', event);
+});
+
+await client.connect();
+```
+
+#### Part 2: Building a Privacy-Enabled DApp (90 minutes)
+
+**Project: Private Payment Gateway**
+
+**Step 1: Project Setup (15 minutes)**
+```bash
+# Create Next.js project
+npx create-next-app private-payments
+
+# Install dependencies
+npm install @privacylayer/sdk stellar-sdk @stellar/freighter-api
+```
+
+**Step 2: SDK Integration (30 minutes)**
+```typescript
+// lib/privacy.ts
+import { PrivacyLayer } from '@privacylayer/sdk';
+
+export const createClient = async () => {
+  const client = new PrivacyLayer({
+    network: process.env.NEXT_PUBLIC_NETWORK as 'testnet' | 'mainnet',
+    wallet: { type: 'freighter' }
+  });
+  
+  await client.connect();
+  return client;
+};
+```
+
+**Step 3: Deposit Component (20 minutes)**
+```tsx
+// components/DepositForm.tsx
+import { useState } from 'react';
+import { usePrivacyClient } from '../hooks/usePrivacyClient';
+
+export function DepositForm() {
+  const [amount, setAmount] = useState('');
+  const [note, setNote] = useState('');
+  const client = usePrivacyClient();
+
+  const handleDeposit = async () => {
+    const result = await client.deposit({
+      amount,
+      asset: 'XLM'
+    });
+    setNote(result.note);
+    alert('Save this note securely!');
+  };
+
+  return (
+    <div className="deposit-form">
+      <input
+        type="number"
+        value={amount}
+        onChange={(e) => setAmount(e.target.value)}
+        placeholder="Amount in XLM"
+      />
+      <button onClick={handleDeposit}>Deposit</button>
+      {note && (
+        <div className="warning">
+          Save this note: {note}
+        </div>
+      )}
+    </div>
+  );
+}
+```
+
+**Step 4: Withdrawal Component (25 minutes)**
+```tsx
+// components/WithdrawForm.tsx
+import { useState } from 'react';
+import { usePrivacyClient } from '../hooks/usePrivacyClient';
+
+export function WithdrawForm() {
+  const [note, setNote] = useState('');
+  const [recipient, setRecipient] = useState('');
+  const client = usePrivacyClient();
+
+  const handleWithdraw = async () => {
+    try {
+      const tx = await client.withdraw({
+        note,
+        recipientAddress: recipient
+      });
+      alert(`Withdrawal complete: ${tx.hash}`);
+    } catch (error) {
+      alert(`Error: ${error.message}`);
+    }
+  };
+
+  return (
+    <div className="withdraw-form">
+      <textarea
+        value={note}
+        onChange={(e) => setNote(e.target.value)}
+        placeholder="Your deposit note"
+      />
+      <input
+        type="text"
+        value={recipient}
+        onChange={(e) => setRecipient(e.target.value)}
+        placeholder="Recipient address"
+      />
+      <button onClick={handleWithdraw}>Withdraw</button>
+    </div>
+  );
+}
+```
+
+#### Part 3: Security Best Practices (30 minutes)
+
+**Topics:**
+1. Key Management
+   - Secure note storage
+   - Hardware wallet integration
+   - Backup strategies
+
+2. Operational Security
+   - IP protection
+   - Timing attacks
+   - Address hygiene
+
+3. Smart Contract Security
+   - Verification of contract addresses
+   - Understanding permissions
+   - Audit considerations
+
+**Checklist:**
+```markdown
+## Security Checklist for Production Apps
+
+### Key Management
+- [ ] Implement secure note storage (encrypted)
+- [ ] Add hardware wallet support
+- [ ] Create backup/recovery flow
+
+### Operational Security
+- [ ] Integrate Tor/VPN options
+- [ ] Add random delays for withdrawals
+- [ ] Generate fresh addresses automatically
+
+### Contract Security
+- [ ] Verify contract addresses on load
+- [ ] Implement signature verification
+- [ ] Add transaction simulation before signing
+```
+
+#### Part 4: Testing and Deployment (15 minutes)
+
+**Testing Strategy:**
+```typescript
+// __tests__/privacy.test.ts
+import { PrivacyLayer } from '@privacylayer/sdk';
+import { mockWallet } from './mocks/wallet';
+
+describe('PrivacyLayer Client', () => {
+  it('should deposit successfully', async () => {
+    const client = new PrivacyLayer({
+      network: 'testnet',
+      wallet: mockWallet
+    });
+    
+    const result = await client.deposit({ amount: '10', asset: 'XLM' });
+    expect(result.note).toBeDefined();
+    expect(result.txHash).toBeDefined();
+  });
+});
+```
+
+### Materials Provided
+- Complete project template
+- Exercise solutions
+- Security checklist
+- Deployment guide
+
+---
+
+## Workshop 3: Advanced ZK Circuit Development
+
+### Duration: 3 hours
+### Level: Advanced
+### Prerequisites: Workshop 2, understanding of ZK proofs, Rust/Noir familiarity
+
+### Learning Objectives
+- Understand PrivacyLayer's circuit architecture
+- Write custom Noir circuits
+- Integrate circuits with Soroban contracts
+- Debug and optimize circuit performance
+
+### Curriculum
+
+#### Part 1: Circuit Architecture (45 minutes)
+
+**Topics:**
+1. Noir Language Overview
+   - Syntax and types
+   - Built-in functions
+   - Constraint system
+
+2. PrivacyLayer Circuits
+   - Commitment circuit
+   - Withdrawal circuit
+   - Merkle proof verification
+
+3. Circuit Compilation
+   - Proving keys
+   - Verification keys
+   - Trusted setup considerations
+
+**Code Walkthrough:**
+```noir
+// circuits/commitment.nr
+use dep std;
+
+fn main(
+    secret: Field,
+    amount: Field,
+    nullifier: Field
+) -> pub Field {
+    // Compute commitment
+    let commitment = std::hash::pedersen([secret, amount]);
+    
+    // Compute nullifier hash
+    let nullifier_hash = std::hash::pedersen([nullifier]);
+    
+    // Return both
+    commitment
+}
+```
+
+#### Part 2: Writing Custom Circuits (60 minutes)
+
+**Exercise: Private Transfer Circuit**
+
+```noir
+// circuits/private_transfer.nr
+use dep std;
+
+struct PrivateTransfer {
+    sender_secret: Field,
+    recipient_public: Field,
+    amount: Field,
+    nullifier: Field,
+}
+
+fn main(
+    transfer: PrivateTransfer,
+    merkle_root: Field,
+    merkle_proof: [Field; 32],
+    merkle_index: Field
+) -> pub Field {
+    // 1. Verify sender's commitment exists in tree
+    let sender_commitment = std::hash::pedersen([
+        transfer.sender_secret,
+        transfer.amount
+    ]);
+    
+    // Verify Merkle proof
+    let computed_root = std::merkle::verify(
+        merkle_proof,
+        merkle_index,
+        sender_commitment
+    );
+    assert(computed_root == merkle_root);
+    
+    // 2. Create recipient commitment
+    let recipient_commitment = std::hash::pedersen([
+        transfer.recipient_public,
+        transfer.amount
+    ]);
+    
+    // 3. Emit nullifier to prevent double-spend
+    let nullifier_hash = std::hash::pedersen([transfer.nullifier]);
+    
+    recipient_commitment
+}
+```
+
+#### Part 3: Integration with Soroban (45 minutes)
+
+**Contract Integration:**
+```rust
+// contracts/src/privacy_pool.rs
+use soroban_sdk::{Env, Symbol, Address};
+
+pub struct PrivacyPool;
+
+#[contractimpl]
+impl PrivacyPool {
+    pub fn verify_withdrawal(
+        env: Env,
+        proof: Vec<u8>,
+        nullifier: Symbol,
+        recipient: Address
+    ) -> bool {
+        // Verify ZK proof
+        let verified = verify_groth16_proof(&env, &proof);
+        
+        if verified {
+            // Check nullifier hasn't been used
+            assert!(!env.storage().has(&nullifier), "Already withdrawn");
+            
+            // Mark nullifier as used
+            env.storage().set(&nullifier, &true);
+            
+            // Transfer funds
+            // ... transfer logic
+        }
+        
+        verified
+    }
+}
+```
+
+#### Part 4: Debugging and Optimization (30 minutes)
+
+**Common Issues:**
+1. Constraint count too high
+2. Proof generation timeout
+3. Verification gas costs
+
+**Optimization Techniques:**
+```noir
+// Before: 10,000 constraints
+fn compute_root_old(leaves: [Field; 256]) -> Field {
+    // Naive implementation
+    // ...
+}
+
+// After: 2,000 constraints
+fn compute_root_optimized(leaves: [Field; 256]) -> Field {
+    // Use incremental Merkle tree
+    // ...
+}
+```
+
+### Materials Provided
+- Circuit templates
+- Debugging guide
+- Optimization checklist
+- Performance benchmarks
+
+---
+
+## Workshop Materials Repository
+
+All workshop materials are available at:
+`https://github.com/PrivacyLayer/workshops`
+
+### Structure
+```
+workshops/
+├── workshop-1/
+│   ├── slides.pdf
+│   ├── exercises/
+│   └── solutions/
+├── workshop-2/
+│   ├── project-template/
+│   ├── completed-project/
+│   └── security-checklist.md
+├── workshop-3/
+│   ├── circuit-templates/
+│   ├── examples/
+│   └── benchmarks/
+└── recordings/
+    ├── workshop-1.mp4
+    ├── workshop-2.mp4
+    └── workshop-3.mp4
+```
+
+---
+
+## Video Recordings
+
+All workshops are recorded and made available on:
+- YouTube: @PrivacyLayer
+- Documentation site
+- Discord community
+
+### Recording Schedule
+
+| Workshop | Recording Date | Status |
+|----------|---------------|--------|
+| Workshop 1 | Week 1 | Planned |
+| Workshop 2 | Week 2 | Planned |
+| Workshop 3 | Week 3 | Planned |
+
+---
+
+## Facilitator Guide
+
+### Prerequisites for Facilitators
+- Strong understanding of ZK proofs
+- Experience with Noir and Soroban
+- Teaching/presentation experience
+
+### Preparation Checklist
+- [ ] Review all slides and materials
+- [ ] Test all code examples
+- [ ] Prepare backup environments
+- [ ] Set up recording equipment
+- [ ] Create participant accounts (testnet)
+
+### Tips for Success
+1. Start with the basics, even if audience seems advanced
+2. Use live coding to demonstrate concepts
+3. Encourage questions throughout
+4. Have helpers available for hands-on exercises
+5. Provide clear instructions for environment setup
+
+---
+
+*Part of the PrivacyLayer Education Initiative*
\ No newline at end of file
diff --git a/docs/workshops/workshop-1-exercises.md b/docs/workshops/workshop-1-exercises.md
new file mode 100644
index 0000000..0203c45
--- /dev/null
+++ b/docs/workshops/workshop-1-exercises.md
@@ -0,0 +1,293 @@
+# Workshop 1: Exercises
+
+Hands-on exercises for Introduction to Privacy-Preserving Development workshop.
+
+---
+
+## Exercise 1: Environment Setup
+
+### Objective
+Set up your development environment for PrivacyLayer development.
+
+### Steps
+
+1. **Install Node.js** (if not already installed)
+   ```bash
+   # Check version
+   node --version  # Should be 18.x or higher
+   ```
+
+2. **Clone the workshop repository**
+   ```bash
+   git clone https://github.com/PrivacyLayer/workshop-starter
+   cd workshop-starter
+   npm install
+   ```
+
+3. **Install Freighter Wallet**
+   - Visit https://freighter.app
+   - Install the browser extension
+   - Create a new wallet
+   - **Important:** Save your seed phrase securely!
+
+4. **Get Testnet Funds**
+   - Switch Freighter to Testnet
+   - Visit https://laboratory.stellar.org/#account-creator
+   - Create and fund your account
+
+### Verification
+Run the setup verification script:
+```bash
+npm run verify-setup
+```
+
+Expected output:
+```
+✅ Node.js version: 18.x
+✅ Freighter wallet detected
+✅ Testnet account funded
+✅ SDK installed
+```
+
+### Troubleshooting
+
+| Issue | Solution |
+|-------|----------|
+| Node version too old | Update to Node.js 18+ |
+| Freighter not detected | Refresh page, check extension enabled |
+| Account not funded | Wait a few seconds and retry |
+
+---
+
+## Exercise 2: Your First Deposit
+
+### Objective
+Make your first deposit into the PrivacyLayer pool.
+
+### Code
+
+Create a new file `deposit.ts`:
+```typescript
+import { PrivacyLayer } from '@privacylayer/sdk';
+import { connectFreighter } from './utils/wallet';
+
+async function main() {
+  // 1. Initialize client
+  const client = new PrivacyLayer({
+    network: 'testnet'
+  });
+
+  // 2. Connect wallet
+  const wallet = await connectFreighter();
+  await client.connect(wallet);
+
+  // 3. Check balance
+  const balance = await client.getBalance('XLM');
+  console.log('Your XLM balance:', balance);
+
+  // 4. Make deposit
+  const result = await client.deposit({
+    amount: '10',
+    asset: 'XLM'
+  });
+
+  console.log('✅ Deposit successful!');
+  console.log('Transaction:', result.txHash);
+  console.log('\n⚠️ IMPORTANT: Save this note securely!');
+  console.log('Note:', result.note);
+}
+
+main().catch(console.error);
+```
+
+### Run
+```bash
+npm run deposit
+```
+
+### Expected Output
+```
+Your XLM balance: 10000
+✅ Deposit successful!
+Transaction: abc123...
+
+⚠️ IMPORTANT: Save this note securely!
+Note: privacy-xxx-yyy-zzz
+```
+
+### Save Your Note!
+Copy your note and save it securely. You'll need it for Exercise 3.
+
+---
+
+## Exercise 3: Your First Withdrawal
+
+### Objective
+Withdraw your deposited funds to a fresh address.
+
+### Prerequisites
+- Complete Exercise 2
+- Have your deposit note ready
+
+### Steps
+
+1. **Generate a fresh address**
+   ```typescript
+   import { Keypair } from 'stellar-sdk';
+   
+   const freshKeypair = Keypair.random();
+   console.log('Fresh address:', freshKeypair.publicKey());
+   console.log('Secret:', freshKeypair.secret());
+   // Save the secret securely!
+   ```
+
+2. **Create withdrawal script**
+   
+   Create `withdraw.ts`:
+   ```typescript
+   import { PrivacyLayer } from '@privacylayer/sdk';
+   import { connectFreighter } from './utils/wallet';
+   
+   // Replace with your saved note
+   const YOUR_NOTE = 'privacy-xxx-yyy-zzz';
+   
+   // Replace with your fresh address
+   const FRESH_ADDRESS = 'GXXXXXXXX...';
+   
+   async function main() {
+     const client = new PrivacyLayer({ network: 'testnet' });
+     const wallet = await connectFreighter();
+     await client.connect(wallet);
+   
+     // Check privacy pool balance
+     const poolBalance = await client.getPoolBalance({
+       note: YOUR_NOTE
+     });
+     console.log('Available to withdraw:', poolBalance);
+   
+     // Wait for anonymity set (optional but recommended)
+     const stats = await client.getPoolStats();
+     console.log('Anonymity set size:', stats.depositCount);
+   
+     // Withdraw
+     const result = await client.withdraw({
+       note: YOUR_NOTE,
+       recipientAddress: FRESH_ADDRESS
+     });
+   
+     console.log('✅ Withdrawal successful!');
+     console.log('Transaction:', result.txHash);
+     console.log('Funds sent to:', FRESH_ADDRESS);
+   }
+   
+   main().catch(console.error);
+   ```
+
+3. **Run withdrawal**
+   ```bash
+   npm run withdraw
+   ```
+
+### Expected Output
+```
+Available to withdraw: 10
+Anonymity set size: 42
+✅ Withdrawal successful!
+Transaction: def456...
+Funds sent to: GXXXXXX...
+```
+
+### Verification
+Check your fresh address on Stellar Expert:
+```
+https://stellar.expert/explorer/testnet/account/GXXXXXX...
+```
+
+You should see your 10 XLM (minus small fees).
+
+---
+
+## Exercise 4: Privacy Analysis
+
+### Objective
+Understand how privacy is achieved and verify your transaction is untraceable.
+
+### Tasks
+
+1. **Find your deposit transaction**
+   - Go to Stellar Expert
+   - Look for your deposit transaction
+   - Note the transaction hash
+
+2. **Find your withdrawal transaction**
+   - Note the transaction hash
+
+3. **Try to link them**
+   - Can you prove which deposit corresponds to which withdrawal?
+   - What information is hidden?
+
+### Discussion Questions
+1. Why can't you link deposit to withdrawal?
+2. What information IS visible on-chain?
+3. What would make the link stronger? (Answer: small anonymity set, immediate withdrawal, same amount)
+
+---
+
+## Exercise 5: Privacy Best Practices
+
+### Objective
+Learn and apply privacy best practices.
+
+### Scenarios
+
+#### Scenario 1: Timing
+**Question:** You deposit 10 XLM. When should you withdraw?
+- A) Immediately after depositing
+- B) After 5 more deposits
+- C) After 50 more deposits
+
+**Answer:** C is best. Larger anonymity set = better privacy.
+
+#### Scenario 2: Amounts
+**Question:** You want to withdraw 10 XLM. Should you:
+- A) Withdraw exactly 10 XLM
+- B) Withdraw 9.95 XLM (slightly less)
+
+**Answer:** B is better. Different amount prevents simple matching.
+
+#### Scenario 3: Addresses
+**Question:** Where should you withdraw to?
+- A) Your main wallet
+- B) A fresh address you've never used
+
+**Answer:** B is essential. Never reuse addresses for privacy.
+
+### Checklist
+Review your transactions against this checklist:
+
+- [ ] Deposited amount doesn't match withdrawal amount exactly
+- [ ] Waited for multiple deposits after yours
+- [ ] Withdrew to a fresh, never-used address
+- [ ] Saved deposit note securely
+- [ ] Used VPN or Tor (optional but recommended)
+
+---
+
+## Solutions
+
+### Exercise 1 Solution
+See `solutions/exercise-1/` for complete setup code.
+
+### Exercise 2 Solution
+See `solutions/exercise-2/deposit.ts` for complete deposit script.
+
+### Exercise 3 Solution
+See `solutions/exercise-3/withdraw.ts` for complete withdrawal script.
+
+---
+
+## Need Help?
+
+- **Discord:** https://discord.gg/privacylayer
+- **Documentation:** https://docs.privacylayer.io
+- **GitHub Issues:** https://github.com/PrivacyLayer/sdk/issues
\ No newline at end of file
diff --git a/docs/workshops/workshop-2-template.md b/docs/workshops/workshop-2-template.md
new file mode 100644
index 0000000..bf3dc41
--- /dev/null
+++ b/docs/workshops/workshop-2-template.md
@@ -0,0 +1,338 @@
+# Workshop 2: Project Template
+
+This is a complete Next.js project template for building privacy-enabled applications.
+
+---
+
+## Project Structure
+
+```
+private-payments/
+├── app/
+│   ├── page.tsx              # Home page
+│   ├── deposit/
+│   │   └── page.tsx          # Deposit page
+│   ├── withdraw/
+│   │   └── page.tsx          # Withdraw page
+│   └── layout.tsx            # App layout
+├── components/
+│   ├── DepositForm.tsx       # Deposit component
+│   ├── WithdrawForm.tsx      # Withdraw component
+│   ├── BalanceDisplay.tsx    # Balance display
+│   └── Navbar.tsx            # Navigation
+├── lib/
+│   ├── privacy.ts            # PrivacyLayer client
+│   └── stellar.ts            # Stellar utilities
+├── hooks/
+│   ├── usePrivacyClient.ts   # Client hook
+│   └── useWallet.ts          # Wallet hook
+├── styles/
+│   └── globals.css           # Global styles
+├── .env.local                # Environment variables
+├── package.json
+└── README.md
+```
+
+---
+
+## Getting Started
+
+```bash
+# Clone template
+npx create-next-app -e https://github.com/PrivacyLayer/private-payments-template
+
+# Install dependencies
+npm install
+
+# Configure environment
+cp .env.example .env.local
+
+# Run development server
+npm run dev
+```
+
+---
+
+## Core Files
+
+### lib/privacy.ts
+```typescript
+import { PrivacyLayer, Network } from '@privacylayer/sdk';
+
+let client: PrivacyLayer | null = null;
+
+export async function getClient(): Promise<PrivacyLayer> {
+  if (!client) {
+    client = new PrivacyLayer({
+      network: process.env.NEXT_PUBLIC_NETWORK as Network || 'testnet',
+    });
+    await client.connect();
+  }
+  return client;
+}
+
+export async function deposit(amount: string, asset: string = 'XLM') {
+  const client = await getClient();
+  return client.deposit({ amount, asset });
+}
+
+export async function withdraw(note: string, recipient: string) {
+  const client = await getClient();
+  return client.withdraw({ note, recipientAddress: recipient });
+}
+
+export async function getBalance(note?: string) {
+  const client = await getClient();
+  return client.getBalance({ note });
+}
+```
+
+### hooks/usePrivacyClient.ts
+```typescript
+import { useState, useEffect } from 'react';
+import { PrivacyLayer } from '@privacylayer/sdk';
+import { getClient } from '@/lib/privacy';
+
+export function usePrivacyClient() {
+  const [client, setClient] = useState<PrivacyLayer | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<Error | null>(null);
+
+  useEffect(() => {
+    getClient()
+      .then(setClient)
+      .catch(setError)
+      .finally(() => setLoading(false));
+  }, []);
+
+  return { client, loading, error };
+}
+```
+
+### components/DepositForm.tsx
+```typescript
+'use client';
+
+import { useState } from 'react';
+import { usePrivacyClient } from '@/hooks/usePrivacyClient';
+
+export function DepositForm() {
+  const [amount, setAmount] = useState('');
+  const [note, setNote] = useState('');
+  const [loading, setLoading] = useState(false);
+  const { client } = usePrivacyClient();
+
+  const handleDeposit = async () => {
+    if (!client || !amount) return;
+    
+    setLoading(true);
+    try {
+      const result = await client.deposit({
+        amount,
+        asset: 'XLM'
+      });
+      setNote(result.note);
+    } catch (err) {
+      console.error(err);
+      alert('Deposit failed: ' + (err as Error).message);
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  return (
+    <div className="p-6 bg-gray-900 rounded-xl">
+      <h2 className="text-xl font-bold mb-4">Deposit</h2>
+      
+      <div className="space-y-4">
+        <div>
+          <label className="block text-sm text-gray-400 mb-1">Amount (XLM)</label>
+          <input
+            type="number"
+            value={amount}
+            onChange={(e) => setAmount(e.target.value)}
+            className="w-full p-3 bg-gray-800 rounded-lg text-white"
+            placeholder="10"
+          />
+        </div>
+
+        <button
+          onClick={handleDeposit}
+          disabled={loading || !amount}
+          className="w-full py-3 bg-gradient-to-r from-blue-500 to-purple-500 rounded-lg font-semibold disabled:opacity-50"
+        >
+          {loading ? 'Processing...' : 'Deposit'}
+        </button>
+
+        {note && (
+          <div className="p-4 bg-yellow-900/50 rounded-lg">
+            <p className="text-yellow-200 font-semibold mb-2">
+              ⚠️ Save this note securely!
+            </p>
+            <code className="block p-2 bg-gray-800 rounded text-xs break-all">
+              {note}
+            </code>
+          </div>
+        )}
+      </div>
+    </div>
+  );
+}
+```
+
+### components/WithdrawForm.tsx
+```typescript
+'use client';
+
+import { useState } from 'react';
+import { usePrivacyClient } from '@/hooks/usePrivacyClient';
+import { Keypair } from 'stellar-sdk';
+
+export function WithdrawForm() {
+  const [note, setNote] = useState('');
+  const [recipient, setRecipient] = useState('');
+  const [txHash, setTxHash] = useState('');
+  const [loading, setLoading] = useState(false);
+  const { client } = usePrivacyClient();
+
+  const generateFreshAddress = () => {
+    const keypair = Keypair.random();
+    setRecipient(keypair.publicKey());
+    // In production, save the secret securely!
+    alert(`Fresh address generated!\nPublic: ${keypair.publicKey()}\n\nSave your secret securely!`);
+  };
+
+  const handleWithdraw = async () => {
+    if (!client || !note || !recipient) return;
+    
+    setLoading(true);
+    try {
+      const result = await client.withdraw({
+        note,
+        recipientAddress: recipient
+      });
+      setTxHash(result.txHash);
+    } catch (err) {
+      console.error(err);
+      alert('Withdrawal failed: ' + (err as Error).message);
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  return (
+    <div className="p-6 bg-gray-900 rounded-xl">
+      <h2 className="text-xl font-bold mb-4">Withdraw</h2>
+      
+      <div className="space-y-4">
+        <div>
+          <label className="block text-sm text-gray-400 mb-1">Deposit Note</label>
+          <textarea
+            value={note}
+            onChange={(e) => setNote(e.target.value)}
+            className="w-full p-3 bg-gray-800 rounded-lg text-white h-24"
+            placeholder="Your saved deposit note..."
+          />
+        </div>
+
+        <div>
+          <label className="block text-sm text-gray-400 mb-1">Recipient Address</label>
+          <div className="flex gap-2">
+            <input
+              type="text"
+              value={recipient}
+              onChange={(e) => setRecipient(e.target.value)}
+              className="flex-1 p-3 bg-gray-800 rounded-lg text-white"
+              placeholder="G..."
+            />
+            <button
+              onClick={generateFreshAddress}
+              className="px-4 py-2 bg-gray-700 rounded-lg hover:bg-gray-600"
+            >
+              Generate Fresh
+            </button>
+          </div>
+        </div>
+
+        <button
+          onClick={handleWithdraw}
+          disabled={loading || !note || !recipient}
+          className="w-full py-3 bg-gradient-to-r from-green-500 to-blue-500 rounded-lg font-semibold disabled:opacity-50"
+        >
+          {loading ? 'Processing...' : 'Withdraw'}
+        </button>
+
+        {txHash && (
+          <div className="p-4 bg-green-900/50 rounded-lg">
+            <p className="text-green-200 font-semibold mb-2">
+              ✅ Withdrawal successful!
+            </p>
+            <a
+              href={`https://stellar.expert/explorer/testnet/tx/${txHash}`}
+              target="_blank"
+              rel="noopener noreferrer"
+              className="text-blue-400 hover:underline"
+            >
+              View transaction →
+            </a>
+          </div>
+        )}
+      </div>
+    </div>
+  );
+}
+```
+
+---
+
+## Security Checklist
+
+Before deploying to production, ensure:
+
+### Key Management
+- [ ] Implement encrypted note storage
+- [ ] Add hardware wallet support
+- [ ] Create backup/recovery flow
+- [ ] Never log or expose notes
+
+### Operational Security
+- [ ] Add random withdrawal delays
+- [ ] Implement fresh address generation
+- [ ] Warn users about timing attacks
+- [ ] Add Tor/VPN recommendations
+
+### Smart Contract Security
+- [ ] Verify contract addresses on load
+- [ ] Implement transaction simulation
+- [ ] Add error handling for all edge cases
+- [ ] Test with small amounts first
+
+---
+
+## Testing
+
+```bash
+# Run tests
+npm test
+
+# Run E2E tests
+npm run test:e2e
+```
+
+---
+
+## Deployment
+
+```bash
+# Build for production
+npm run build
+
+# Deploy to Vercel
+vercel --prod
+```
+
+---
+
+## License
+
+MIT
\ No newline at end of file