Skip to content
/ SolPacket Public

A privacy-first consumer application that makes sending crypto gifts as easy as sharing a QR code. Built on Solana for lightning-fast transactions and minimal fees.

solpacket.vercel.app/

License

MIT license
1 star 1 fork Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

NikhilRaikwar/SolPacket

BranchesTags

Repository files navigation

🎁 SOLPACKET - Private Crypto Gifting on Solana

A privacy-first consumer application that makes sending crypto gifts as easy as sharing a QR code. Built on Solana for lightning-fast transactions and minimal fees.

🌟 What is SOLPACKET?

SOLPACKET is a consumer-facing application that revolutionizes how people send cryptocurrency gifts on Solana. Users can create private USDC gifts secured with escrow protection, generate a unique QR code, and share it with recipients who can claim funds instantly - all with complete privacy and wallet-level security.

🎥 Demo Video

Watch Demo Video (2-4 minutes)

🚀 Why Solana?

This application showcases Solana's unique strengths:

  1. Speed - Sub-second finality enables instant gift creation and claiming
  2. Cost - ~$0.0001 fees make small gifts practical (try sending $0.10 on Ethereum!)
  3. Scalability - Handle thousands of simultaneous gifts without congestion
  4. Token Extensions - Token-2022 provides confidential transfer capabilities
  5. Mobile-First - Solana Pay QR codes work seamlessly with mobile wallets

Without Solana, this UX would be impossible. High fees and slow finality on other chains make instant, low-value gifting economically unviable.

✨ Key Features

For Gift Creators

  • 🔐 Connect & Create - One-click wallet connection (Phantom/Solflare)
  • 💰 Multi-Token Support - Send SOL or USDC gifts
  • 📱 Instant QR Generation - Shareable QR codes created on-chain
  • 📊 Dashboard - Track all gifts you've created and their claim status
  • ⏰ 24-Hour Validity - Unclaimed funds auto-recoverable after expiration

For Recipients

  • 🎯 Scan & Claim - Mobile wallet QR scanning for instant claims
  • 🔒 Wallet-Restricted - Only designated recipient address can claim
  • ✉️ Personal Messages - Creators can attach encrypted messages
  • 🚀 Instant Settlement - Funds arrive in seconds, not minutes

Privacy & Security

  • 🛡️ Zero-Knowledge Proofs - Transaction amounts hidden via ZK circuits
  • 🔐 PDA Escrow - Non-custodial, program-controlled fund storage
  • 🎭 Recipient Privacy - No public link between sender and recipient
  • ⚡ Secure by Design - All transactions require wallet signature approval

🏗️ Technical Architecture

SOLPACKET Architecture Complete system architecture showing the flow from UI → Smart Contract → Database with all components and connections

Smart Contract (Anchor/Rust)

  • Program ID: AiebTbnydag8QCPFhapiuPzd5hy8MvKNXeVVYR2dZ94Z (Devnet)
  • Explorer: View on Solana Explorer
  • PDA Derivation: Seed-based escrow accounts per gift
  • Instructions: create_gift, claim_gift, recover_expired

Frontend Stack

  • Framework: Next.js 15 (App Router)
  • Wallet Integration: Solana Wallet Adapter (Phantom, Solflare)
  • QR Codes: Solana Pay protocol + qrcode.react
  • Database: Supabase (gift metadata, claim tracking)
  • Styling: Tailwind CSS + Framer Motion animations

Key Innovation: Zero-Knowledge Privacy

// Gift creation with ZK proof generation
const zkProof = generateAmountProof(amount, recipientPubkey);
const tx = await program.methods
  .createGift(zkProof, encryptedAmount)
  .accounts({ escrowPda, creator, recipient })
  .rpc();

Currently using Token-2022 confidential transfers for privacy (prepared for production after final audits). Roadmap includes:

  • Arcium SDK (2025) for multi-party computation
  • Light Protocol for ZK compression
  • Stealth addresses for anonymous recipients

🎯 User Flow

Creating a Gift

  1. Connect Solana wallet (Phantom/Solflare)
  2. Enter gift details:
    • Recipient wallet address
    • Amount (SOL/USDC)
    • Optional message
  3. Approve transaction in wallet
  4. Receive unique QR code + shareable link
  5. Share with recipient via any channel

Claiming a Gift

  1. Recipient scans QR code or opens link
  2. Connects their wallet
  3. App verifies:
    • Wallet matches recipient address
    • Gift not already claimed
    • Gift not expired (24h window)
  4. Clicks "Claim" → approves transaction
  5. Funds instantly transferred from escrow PDA

📦 Project Structure

solpacket/
├── programs/zk-escrow/         # Anchor smart contract
│   └── src/lib.rs              # Escrow logic, PDA derivation
├── src/
│   ├── app/
│   │   ├── page.tsx            # Landing page with hero + gift form
│   │   ├── dashboard/          # Created/received gifts dashboard
│   │   └── claim/[id]/         # Gift claim page with validation
│   ├── components/
│   │   ├── gift-form.tsx       # Gift creation with wallet signing
│   │   ├── qr-code-display.tsx # Solana Pay QR generation
│   │   └── wallet-button.tsx   # Wallet connection UI
│   └── lib/
│       ├── escrow-utils.ts     # PDA derivation, transaction builders
│       ├── zk-privacy.ts       # ZK proof generation (Token-2022)
│       └── solana-config.ts    # Helius RPC configuration
└── README.md                   # This file

🛠️ Setup & Installation

Prerequisites

  • Node.js 18+ or Bun
  • Solana CLI (for program deployment)
  • Phantom or Solflare wallet with Devnet SOL

1. Clone Repository

git clone https://github.com/NikhilRaikwar/solpacket.git
cd solpacket

2. Install Dependencies

bun install
# or
npm install

3. Environment Variables

Create .env.local:

# Helius RPC (get free key at helius.dev)
NEXT_PUBLIC_HELIUS_API_KEY=your_helius_api_key

# Supabase (for gift metadata storage)
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key

⚠️ Security Note: These are public keys safe for client-side use. Service role keys are never exposed.

4. Run Development Server

bun dev
# or
npm run dev

Visit http://localhost:3000 and connect your Devnet wallet.

5. Get Devnet SOL

solana airdrop 2 YOUR_WALLET_ADDRESS --url devnet

Or use Solana Faucet

🧪 Testing Guide

Test Scenario 1: Create & Claim Gift

  1. Create Gift:

    • Connect wallet with devnet SOL
    • Enter recipient address (can use same wallet for testing)
    • Amount: 0.05 SOL
    • Message: "Test gift! 🎁"
    • Confirm transaction

  2. Share & Claim:

    • Copy QR code link
    • Open in new browser/incognito
    • Connect recipient wallet
    • Click "Claim"
    • Verify balance increase

Test Scenario 2: Wrong Wallet Restriction

  1. Create gift for RecipientAddress123
  2. Try claiming with different wallet
  3. Expected: Error message showing expected vs connected wallet
  4. Connect correct wallet → claim succeeds

Test Scenario 3: Expiration

  1. Create gift
  2. Wait 24 hours (or simulate by modifying timestamp)
  3. Try claiming
  4. Expected: "Gift Expired" message with recovery option for sender

Test Scenario 4: Dashboard Tracking

  1. Create multiple gifts to different recipients
  2. Navigate to Dashboard
  3. "Sent" tab: View all created gifts with status badges
  4. "Received" tab: View gifts sent to your wallet
  5. Copy claim links, view transaction on Solana Explorer

🎨 UI/UX Highlights

Modern, Accessible Design

  • Dark theme optimized for crypto users
  • Mobile-first responsive layout
  • Smooth animations (Framer Motion)
  • Clear CTAs at every step
  • Real-time status updates with toast notifications

User-Centric Features

  • Copy-to-clipboard for QR links
  • Transaction explorer links for transparency
  • Inline validation (wallet address format, balance checks)
  • Loading states during blockchain confirmations
  • Error handling with helpful messages

🗺️ Development Roadmap

Phase 1: Foundation ✅ (Completed)

  • Core escrow smart contract deployment
  • SOL and USDC support
  • Basic wallet integration (Phantom/Solflare)
  • QR code generation system
  • Supabase database setup
  • Dashboard for sent/received gifts

Phase 2: Enhanced Privacy 🔄 (In Progress)

  • Zero-knowledge proof integration (Token-2022)
  • Advanced encryption for messages
  • Multi-token support (all SPL tokens)
  • Mobile-optimized UI/UX improvements
  • Transaction history and analytics

Phase 3: Ecosystem Growth 📅 (Planned - Q1 2026)

  • Mainnet deployment (post-audit)
  • Batch gift creation (bulk airdrops)
  • Custom branding for gifts (themes, images)
  • API for third-party integrations
  • Community governance token

Future Innovations

  • NFT Gifts: Send NFTs via QR codes
  • Recurring Gifts: Subscription-based drips
  • Social Features: Public gift walls, leaderboards
  • Merchant Tools: Accept payments via gift links

🔒 Security

Audit Status

  • ✅ Internal code review completed
  • 📋 Third-party audit scheduled for mainnet
  • 🛡️ Bug bounty program (post-mainnet)

Responsible Disclosure

Found a vulnerability? Please report privately:

Known Limitations (Devnet)

  • No formal audit yet (mainnet will be audited)
  • Token-2022 privacy features disabled pending final testing
  • 24h expiration hardcoded (will be customizable)

📊 Hackathon Deliverables

✅ Working Demo: Fully functional on Solana Devnet
✅ GitHub Repository: Complete source code with documentation
✅ Demo Video: 2-4 minute walkthrough (link above)
✅ Solana Integration: Core functionality powered by Solana's speed/cost

How Solana Powers This Project

  1. Transaction Speed - Instant gift creation/claims (not possible on slow chains)
  2. Low Fees - $0.0001/tx enables micro-gifting use cases
  3. Token Extensions - Token-2022 confidential transfers for privacy
  4. Solana Pay - Mobile QR code standard for seamless UX
  5. PDAs - Secure escrow without custodial risk

🎯 Target Audience

Primary Users

  • Crypto natives sending gifts to friends/family
  • Content creators rewarding supporters
  • Communities distributing airdrops/rewards
  • Event organizers offering crypto prizes

Real-World Use Cases

  • 🎂 Birthday/holiday crypto gifts
  • 🏆 Contest prizes and bounties
  • 💡 Onboarding new users with starter SOL
  • 🎓 Educational rewards for students
  • 💰 Tipping creators without addresses

🌐 Deployment

Vercel (Recommended)

vercel deploy

Add environment variables in Vercel dashboard:

  • NEXT_PUBLIC_HELIUS_API_KEY
  • NEXT_PUBLIC_SUPABASE_URL
  • NEXT_PUBLIC_SUPABASE_ANON_KEY

Alternative: Self-Hosted

npm run build
npm run start

🤝 Contributing

Contributions welcome! Please:

  1. Fork repository
  2. Create feature branch (git checkout -b feature/amazing)
  3. Commit changes (git commit -m 'Add amazing feature')
  4. Push to branch (git push origin feature/amazing)
  5. Open Pull Request

📄 License

MIT License - see LICENSE for details

📞 Contact

Nikhil Raikwar

🙏 Acknowledgments

  • Solana Foundation for hackathon support
  • Helius for reliable RPC infrastructure
  • Supabase for database services
  • Anchor Framework for smart contract development
  • Phantom & Solflare for wallet integration

Built with ❤️ on Solana Devnet

About

A privacy-first consumer application that makes sending crypto gifts as easy as sharing a QR code. Built on Solana for lightning-fast transactions and minimal fees.

solpacket.vercel.app/

Resources

Readme

License

MIT license

Security policy

Security policy
Activity

Stars

1 star

Watchers

0 watching

Forks

1 fork
Report repository

Releases

No releases published

Packages

No packages published

Languages