SIP App

███████╗ ██╗ ██████╗ █████╗ ██████╗ ██████╗
██╔════╝ ██║ ██╔══██╗ ██╔══██╗██╔══██╗██╔══██╗
███████╗ ██║ ██████╔╝ ███████║██████╔╝██████╔╝
╚════██║ ██║ ██╔═══╝ ██╔══██║██╔═══╝ ██╔═══╝
███████║ ██║ ██║ ██║ ██║██║ ██║
╚══════╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝

SIP App

Privacy is not a feature. It's a right.

The Privacy Command Center for Web3 — enterprise-grade compliance, analytics & power user workflows

Private payments • Wallet surveillance analyzer • Viewing key disclosure • Compliance dashboards

Live:app.sip-protocol.org | Companion:SIP Privacy Mobile

🏆 Winner — Zypherpunk Hackathon ($6,500) | 🥇 1st Place — Solana Graveyard Hackathon (Torque)

🛡️ What is SIP App?

SIP App is the flagship privacy application built on the SIP Protocol SDK. Like jup.ag is to Jupiter SDK, app.sip-protocol.org is to @sip-protocol/sdk — a world-class consumer application that showcases the full capabilities of cryptographic privacy.

SDK developers → See SIP App → "I want this for my users" → Integrate SDK
Enterprise users → Use SIP App → Compliance dashboards, audit trails, power tools

The app is the pitch. Quality sells the SDK.

👨‍👩‍👧‍👦 Product Family

SIP has two companion products — same privacy, platform-optimized:

┌─────────────────────────────────┐ ┌─────────────────────────────────┐
│ app.sip-protocol.org │ │ SIP Privacy (Mobile) │
│ ───────────────────────────── │ │ ───────────────────────────── │
│ "Privacy Command Center" │ │ "Privacy in Your Pocket" │
│ │ │ │
│ • Power users / Enterprise │ │ • Consumers │
│ • D3 visualizations │ │ • Quick payments / swaps │
│ • Compliance dashboards │ │ • Native key management │
│ • Audit trails / Reports │ │ • Biometric security │
│ • Multi-monitor workflows │ │ • On-the-go privacy │
│ │ │ │
│ ← YOU ARE HERE │ │ → sip-mobile repo │
└─────────────────────────────────┘ └─────────────────────────────────┘

NOT 1:1 clones — each optimized for its platform's strengths.

✨ Features

🔐 Private Payments

Send and receive shielded payments with stealth addresses. Full privacy with one toggle.

Feature	Description	Status
Send	Send SOL/tokens to stealth addresses	✅ Live
Receive	Generate one-time stealth addresses	✅ Live
Scan	Detect incoming payments to your keys	✅ Live
History	View transaction history	✅ Live
Disclose	Share viewing keys for compliance	✅ Live

📊 Privacy Score

Analyze any wallet's surveillance exposure with D3 visualizations.

Heuristic analysis of on-chain activity
Exchange interaction detection
Address clustering risk assessment
Privacy improvement recommendations

🔑 Viewing Key Disclosure

Selective disclosure for compliance without exposing spending keys.

Export viewing keys for specific time ranges
Track who you've shared with
Revoke access anytime
Audit-ready transaction proofs

🏢 Enterprise (Coming Soon)

Compliance dashboards and audit tools for institutions.

Batch transaction processing
Audit report generation
Multi-signature workflows
Regulatory compliance tools

🎥 Live Demo

Try it now:app.sip-protocol.org

Screenshots

Hub Dashboard	Private Payments	Privacy Score
App overview with feature cards	Send/receive shielded payments	Wallet surveillance analyzer

🚀 Quick Start

Prerequisites

Node.js 20+
pnpm 9+

Installation

# Clone the repository
git clone https://github.com/sip-protocol/sip-app.git
cd sip-app
# Install dependencies
pnpm install
# Start development server
pnpm dev
# Open http://localhost:3000

Environment Variables

# .env.local
NEXT_PUBLIC_SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
NEXT_PUBLIC_SIP_APP_HELIUS_API_KEY=your-key # For DAS API

🏗️ Architecture

Project Structure

sip-app/
├── src/
│ ├── app/ # Next.js App Router
│ │ ├── layout.tsx # Root layout (nav/footer)
│ │ ├── page.tsx # Hub dashboard
│ │ │
│ │ ├── (payments)/ # Route group: Private Payments
│ │ │ └── payments/
│ │ │ ├── page.tsx # Payments dashboard
│ │ │ ├── send/ # Send shielded payment
│ │ │ ├── receive/ # Generate stealth address
│ │ │ ├── scan/ # Scan for incoming
│ │ │ ├── history/ # Transaction history
│ │ │ └── disclose/ # Viewing key disclosure
│ │ │
│ │ ├── (wallet)/ # Route group: Wallet
│ │ │ └── wallet/
│ │ │ ├── page.tsx # Wallet overview
│ │ │ └── keys/ # Viewing key management
│ │ │
│ │ ├── (dex)/ # Route group: DEX
│ │ │ └── dex/
│ │ │ ├── page.tsx # Private swap interface
│ │ │ └── jupiter/ # Jupiter integration
│ │ │
│ │ ├── (enterprise)/ # Route group: Enterprise
│ │ │ └── enterprise/
│ │ │ ├── page.tsx # Dashboard
│ │ │ └── compliance/ # Compliance tools
│ │ │
│ │ ├── privacy-score/ # Wallet analyzer
│ │ └── showcase/ # Hackathon showcases
│ │
│ ├── components/
│ │ ├── ui/ # Base components (Button, Card, Input)
│ │ ├── payments/ # Payment-specific components
│ │ ├── wallet/ # Wallet components
│ │ └── shared/ # Shared components
│ │
│ ├── hooks/ # Custom React hooks
│ │ ├── use-send-payment.ts
│ │ ├── use-scan-payments.ts
│ │ └── use-stealth-address.ts
│ │
│ ├── stores/ # Zustand stores
│ │ ├── wallet.ts
│ │ ├── privacy.ts
│ │ └── payments.ts
│ │
│ ├── lib/ # Utilities
│ │ ├── sip-client.ts # SIP SDK integration
│ │ ├── solana.ts # Solana connection
│ │ └── privacy/ # Privacy backends
│ │
│ └── types/ # TypeScript types
│
├── public/ # Static assets
├── tests/ # Test suites
└── docker-compose.yml # Production deployment

Data Flow

User Action → React Component → Custom Hook → SIP SDK → Solana
│
▼
Privacy Layer
┌──────────────────────────┐
│ • Generate stealth addr │
│ • Create commitment │
│ • Sign transaction │
└──────────────────────────┘
│
▼
On-Chain Execution

📍 App Routes

Live Routes (8)

Route	Purpose	Status
`/`	Hub dashboard with app cards	✅ Live
`/payments`	Private Payments dashboard	✅ Live
`/payments/send`	Send shielded payment	✅ Live
`/payments/receive`	Generate stealth address	✅ Live
`/payments/scan`	Scan for incoming payments	✅ Live
`/payments/history`	Transaction history	✅ Live
`/payments/disclose`	Viewing key disclosure	✅ Live
`/privacy-score`	Wallet surveillance analyzer	✅ Live

Scaffolded Routes (6)

Route	Purpose	Status
`/wallet`	Wallet interface	🔲 Scaffolded
`/wallet/keys`	Viewing key management	🔲 Scaffolded
`/dex`	Private DEX	🔲 Scaffolded
`/dex/jupiter`	Jupiter integration	🔲 Scaffolded
`/enterprise`	Enterprise dashboard	🔲 Scaffolded
`/enterprise/compliance`	Compliance tools	🔲 Scaffolded

🛠️ Tech Stack

Category	Technology	Purpose
Framework	Next.js 16 (App Router)	Full-stack React
UI	React 19	Component library
Styling	Tailwind CSS 4	Utility-first CSS
State	Zustand 5	Client state management
Animations	Framer Motion	Micro-interactions
Visualization	D3.js	Privacy Score charts
Testing	Vitest + Playwright	Unit + E2E tests
Privacy SDK	@sip-protocol/sdk	Core privacy primitives
React Hooks	@sip-protocol/react	useSIP, useStealthAddress
Wallet	@solana/wallet-adapter	Phantom, Solflare, etc.

💻 Development

Commands

pnpm dev # Start development server
pnpm build # Build for production
pnpm start # Start production server
pnpm test# Run tests in watch mode
pnpm test:run # Run tests once
pnpm typecheck # Type check with TypeScript
pnpm lint # Lint with ESLint
pnpm format # Format with Prettier
pnpm validate # Run all checks

Testing

# Unit tests
pnpm test:run
# E2E tests
pnpm test:e2e
# With UI
pnpm test:e2e:ui
# Coverage
pnpm test:coverage

Key Components

Component	Purpose
`SendShieldedForm`	Form for sending private payments
`StealthAddressGenerator`	Generate + display stealth meta-address
`PaymentScanner`	Scan blockchain for incoming payments
`ClaimPayment`	Claim received stealth payments
`ViewingKeyDisclosure`	Reveal transaction to auditor
`PrivacyToggle`	Privacy level selector
`WalletConnect`	Solana wallet connection

🚀 Deployment

Docker (Production)

# Build Docker image
docker build -t sip-app .# Run locally
docker run -p 3000:3000 sip-app

VPS Configuration

# docker-compose.ymlname: sip-appservices:
app-blue:
image: ghcr.io/sip-protocol/sip-app:latestcontainer_name: sip-app-blueports:
- "5004:3000"restart: unless-stoppedapp-green:
image: ghcr.io/sip-protocol/sip-app:greencontainer_name: sip-app-greenports:
- "5005:3000"restart: unless-stopped

CI/CD Pipeline

Push to main → GitHub Actions → Build Docker → Push to GHCR → SSH Deploy → Live

🎨 Design Philosophy

Quality Standards

Aspect	Standard
UX	Delightful, intuitive, zero friction
Performance	Sub-second interactions, optimistic UI
Design	Clean, modern, professional
Reliability	99.9% uptime, graceful error handling
Accessibility	WCAG 2.1 AA compliant
Mobile	Mobile-first responsive design

Design Inspirations

App	What to Learn
jup.ag	Swap UX, token selection, transaction flow
phantom.app	Wallet UX, onboarding, mobile experience
uniswap.org	Clean design, professional feel
stripe.com	Form design, error handling, trust signals
linear.app	Speed, keyboard shortcuts, polish

Quality Benchmark

"Would this be acceptable on jup.ag?"
If no, raise the bar. The app sells the SDK.

🔗 Related Projects

Project	Description	Link
sip-protocol	Core SDK (6,600+ tests)	GitHub
sip-mobile	Companion mobile app	GitHub
sip-website	Marketing website	GitHub
docs-sip	Documentation	docs.sip-protocol.org

📄 License

MIT License — see LICENSE file for details.

Privacy Command Center for Web3

Privacy is not a feature. It's a right.

Live App · Documentation · Report Bug

Part of the SIP Protocol ecosystem

Name		Name	Last commit message	Last commit date
Latest commit History 451 Commits
.github		.github
docs		docs
e2e		e2e
public		public
src		src
tests		tests
.gitignore		.gitignore
.prettierignore		.prettierignore
.prettierrc		.prettierrc
.vercelignore		.vercelignore
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
Dockerfile		Dockerfile
README.md		README.md
docker-compose.yml		docker-compose.yml
eslint.config.mjs		eslint.config.mjs
next.config.ts		next.config.ts
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
postcss.config.mjs		postcss.config.mjs
tsconfig.json		tsconfig.json
vercel.json		vercel.json
vitest.config.ts		vitest.config.ts

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

SIP App

Table of Contents

🛡️ What is SIP App?

👨‍👩‍👧‍👦 Product Family

✨ Features

🔐 Private Payments

📊 Privacy Score

🔑 Viewing Key Disclosure

🏢 Enterprise (Coming Soon)

🎥 Live Demo

Screenshots

🚀 Quick Start

Prerequisites

Installation

Environment Variables

🏗️ Architecture

Project Structure

Data Flow

📍 App Routes

Live Routes (8)

Scaffolded Routes (6)

🛠️ Tech Stack

💻 Development

Commands

Testing

Key Components

🚀 Deployment

Docker (Production)

VPS Configuration

CI/CD Pipeline

🎨 Design Philosophy

Quality Standards

Design Inspirations

Quality Benchmark

🔗 Related Projects

📄 License

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages