{"id":46566601,"url":"https://github.com/sip-protocol/sip-app","last_synced_at":"2026-03-07T07:12:07.544Z","repository":{"id":331820917,"uuid":"1131948274","full_name":"sip-protocol/sip-app","owner":"sip-protocol","description":"SIP Protocol Web Application - Privacy-first Web3 interface","archived":false,"fork":false,"pushed_at":"2026-03-01T00:15:39.000Z","size":12894,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-01T03:41:16.711Z","etag":null,"topics":["cryptocurrency","defi","nextjs","payments","privacy","react","sip-protocol","solana","stealth-addresses","tailwindcss","typescript","wallet-adapter","web3","zustand"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sip-protocol.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-11T02:19:36.000Z","updated_at":"2026-03-01T00:15:43.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sip-protocol/sip-app","commit_stats":null,"previous_names":["sip-protocol/sip-app"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sip-protocol/sip-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sip-protocol%2Fsip-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sip-protocol%2Fsip-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sip-protocol%2Fsip-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sip-protocol%2Fsip-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sip-protocol","download_url":"https://codeload.github.com/sip-protocol/sip-app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sip-protocol%2Fsip-app/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30209484,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T05:23:27.321Z","status":"ssl_error","status_checked_at":"2026-03-07T05:00:17.256Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cryptocurrency","defi","nextjs","payments","privacy","react","sip-protocol","solana","stealth-addresses","tailwindcss","typescript","wallet-adapter","web3","zustand"],"created_at":"2026-03-07T07:12:06.848Z","updated_at":"2026-03-07T07:12:07.525Z","avatar_url":"https://github.com/sip-protocol.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cpre\u003e\n███████╗ ██╗ ██████╗      █████╗ ██████╗ ██████╗\n██╔════╝ ██║ ██╔══██╗    ██╔══██╗██╔══██╗██╔══██╗\n███████╗ ██║ ██████╔╝    ███████║██████╔╝██████╔╝\n╚════██║ ██║ ██╔═══╝     ██╔══██║██╔═══╝ ██╔═══╝\n███████║ ██║ ██║         ██║  ██║██║     ██║\n╚══════╝ ╚═╝ ╚═╝         ╚═╝  ╚═╝╚═╝     ╚═╝\n\u003c/pre\u003e\n\n# SIP App\n\n\u003e **Privacy is not a feature. It's a right.**\n\n**The Privacy Command Center for Web3 — enterprise-grade compliance, analytics \u0026 power user workflows**\n\n*Private payments • Wallet surveillance analyzer • Viewing key disclosure • Compliance dashboards*\n\n[![CI](https://github.com/sip-protocol/sip-app/actions/workflows/ci.yml/badge.svg)](https://github.com/sip-protocol/sip-app/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Next.js](https://img.shields.io/badge/Next.js-16-black?logo=next.js\u0026logoColor=white)](https://nextjs.org/)\n[![React](https://img.shields.io/badge/React-19-61DAFB?logo=react\u0026logoColor=white)](https://react.dev/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-3178C6?logo=typescript\u0026logoColor=white)](https://www.typescriptlang.org/)\n[![Tailwind](https://img.shields.io/badge/Tailwind-4.0-06B6D4?logo=tailwindcss\u0026logoColor=white)](https://tailwindcss.com/)\n\n**Live:** [app.sip-protocol.org](https://app.sip-protocol.org) | **Companion:** [SIP Privacy Mobile](https://github.com/sip-protocol/sip-mobile)\n\n\u003c/div\u003e\n\n---\n\n## Table of Contents\n\n- [What is SIP App?](#-what-is-sip-app)\n- [Product Family](#-product-family)\n- [Features](#-features)\n- [Live Demo](#-live-demo)\n- [Quick Start](#-quick-start)\n- [Architecture](#%EF%B8%8F-architecture)\n- [App Routes](#-app-routes)\n- [Tech Stack](#%EF%B8%8F-tech-stack)\n- [Development](#-development)\n- [Deployment](#-deployment)\n- [Design Philosophy](#-design-philosophy)\n- [Related Projects](#-related-projects)\n- [License](#-license)\n\n---\n\n## 🛡️ What is SIP App?\n\nSIP 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.\n\n```\nSDK developers   → See SIP App → \"I want this for my users\" → Integrate SDK\nEnterprise users → Use SIP App → Compliance dashboards, audit trails, power tools\n```\n\n**The app is the pitch. Quality sells the SDK.**\n\n---\n\n## 👨‍👩‍👧‍👦 Product Family\n\nSIP has two companion products — same privacy, platform-optimized:\n\n```\n┌─────────────────────────────────┐   ┌─────────────────────────────────┐\n│  app.sip-protocol.org           │   │  SIP Privacy (Mobile)           │\n│  ─────────────────────────────  │   │  ─────────────────────────────  │\n│  \"Privacy Command Center\"       │   │  \"Privacy in Your Pocket\"       │\n│                                 │   │                                 │\n│  • Power users / Enterprise     │   │  • Consumers                    │\n│  • D3 visualizations            │   │  • Quick payments / swaps       │\n│  • Compliance dashboards        │   │  • Native key management        │\n│  • Audit trails / Reports       │   │  • Biometric security           │\n│  • Multi-monitor workflows      │   │  • On-the-go privacy            │\n│                                 │   │                                 │\n│  ← YOU ARE HERE                 │   │  → sip-mobile repo              │\n└─────────────────────────────────┘   └─────────────────────────────────┘\n```\n\n**NOT 1:1 clones** — each optimized for its platform's strengths.\n\n---\n\n## ✨ Features\n\n### 🔐 Private Payments\nSend and receive shielded payments with stealth addresses. Full privacy with one toggle.\n\n| Feature | Description | Status |\n|---------|-------------|--------|\n| **Send** | Send SOL/tokens to stealth addresses | ✅ Live |\n| **Receive** | Generate one-time stealth addresses | ✅ Live |\n| **Scan** | Detect incoming payments to your keys | ✅ Live |\n| **History** | View transaction history | ✅ Live |\n| **Disclose** | Share viewing keys for compliance | ✅ Live |\n\n### 📊 Privacy Score\nAnalyze any wallet's surveillance exposure with D3 visualizations.\n\n- Heuristic analysis of on-chain activity\n- Exchange interaction detection\n- Address clustering risk assessment\n- Privacy improvement recommendations\n\n### 🔑 Viewing Key Disclosure\nSelective disclosure for compliance without exposing spending keys.\n\n- Export viewing keys for specific time ranges\n- Track who you've shared with\n- Revoke access anytime\n- Audit-ready transaction proofs\n\n### 🏢 Enterprise (Coming Soon)\nCompliance dashboards and audit tools for institutions.\n\n- Batch transaction processing\n- Audit report generation\n- Multi-signature workflows\n- Regulatory compliance tools\n\n---\n\n## 🎥 Live Demo\n\n**Try it now:** [app.sip-protocol.org](https://app.sip-protocol.org)\n\n### Screenshots\n\n| Hub Dashboard | Private Payments | Privacy Score |\n|---------------|------------------|---------------|\n| App overview with feature cards | Send/receive shielded payments | Wallet surveillance analyzer |\n\n---\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- Node.js 20+\n- pnpm 9+\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/sip-protocol/sip-app.git\ncd sip-app\n\n# Install dependencies\npnpm install\n\n# Start development server\npnpm dev\n\n# Open http://localhost:3000\n```\n\n### Environment Variables\n\n```bash\n# .env.local\nNEXT_PUBLIC_SOLANA_RPC_URL=https://api.mainnet-beta.solana.com\nNEXT_PUBLIC_HELIUS_API_KEY=your-key  # For DAS API\n```\n\n---\n\n## 🏗️ Architecture\n\n### Project Structure\n\n```\nsip-app/\n├── src/\n│   ├── app/                      # Next.js App Router\n│   │   ├── layout.tsx            # Root layout (nav/footer)\n│   │   ├── page.tsx              # Hub dashboard\n│   │   │\n│   │   ├── (payments)/           # Route group: Private Payments\n│   │   │   └── payments/\n│   │   │       ├── page.tsx      # Payments dashboard\n│   │   │       ├── send/         # Send shielded payment\n│   │   │       ├── receive/      # Generate stealth address\n│   │   │       ├── scan/         # Scan for incoming\n│   │   │       ├── history/      # Transaction history\n│   │   │       └── disclose/     # Viewing key disclosure\n│   │   │\n│   │   ├── (wallet)/             # Route group: Wallet\n│   │   │   └── wallet/\n│   │   │       ├── page.tsx      # Wallet overview\n│   │   │       └── keys/         # Viewing key management\n│   │   │\n│   │   ├── (dex)/                # Route group: DEX\n│   │   │   └── dex/\n│   │   │       ├── page.tsx      # Private swap interface\n│   │   │       └── jupiter/      # Jupiter integration\n│   │   │\n│   │   ├── (enterprise)/         # Route group: Enterprise\n│   │   │   └── enterprise/\n│   │   │       ├── page.tsx      # Dashboard\n│   │   │       └── compliance/   # Compliance tools\n│   │   │\n│   │   ├── privacy-score/        # Wallet analyzer\n│   │   └── showcase/             # Hackathon showcases\n│   │\n│   ├── components/\n│   │   ├── ui/                   # Base components (Button, Card, Input)\n│   │   ├── payments/             # Payment-specific components\n│   │   ├── wallet/               # Wallet components\n│   │   └── shared/               # Shared components\n│   │\n│   ├── hooks/                    # Custom React hooks\n│   │   ├── use-send-payment.ts\n│   │   ├── use-scan-payments.ts\n│   │   └── use-stealth-address.ts\n│   │\n│   ├── stores/                   # Zustand stores\n│   │   ├── wallet.ts\n│   │   ├── privacy.ts\n│   │   └── payments.ts\n│   │\n│   ├── lib/                      # Utilities\n│   │   ├── sip-client.ts         # SIP SDK integration\n│   │   ├── solana.ts             # Solana connection\n│   │   └── privacy/              # Privacy backends\n│   │\n│   └── types/                    # TypeScript types\n│\n├── public/                       # Static assets\n├── tests/                        # Test suites\n└── docker-compose.yml            # Production deployment\n```\n\n### Data Flow\n\n```\nUser Action → React Component → Custom Hook → SIP SDK → Solana\n                                    │\n                                    ▼\n                            Privacy Layer\n                    ┌──────────────────────────┐\n                    │ • Generate stealth addr  │\n                    │ • Create commitment      │\n                    │ • Sign transaction       │\n                    └──────────────────────────┘\n                                    │\n                                    ▼\n                            On-Chain Execution\n```\n\n---\n\n## 📍 App Routes\n\n### Live Routes (8)\n\n| Route | Purpose | Status |\n|-------|---------|--------|\n| `/` | Hub dashboard with app cards | ✅ Live |\n| `/payments` | Private Payments dashboard | ✅ Live |\n| `/payments/send` | Send shielded payment | ✅ Live |\n| `/payments/receive` | Generate stealth address | ✅ Live |\n| `/payments/scan` | Scan for incoming payments | ✅ Live |\n| `/payments/history` | Transaction history | ✅ Live |\n| `/payments/disclose` | Viewing key disclosure | ✅ Live |\n| `/privacy-score` | Wallet surveillance analyzer | ✅ Live |\n\n### Scaffolded Routes (6)\n\n| Route | Purpose | Status |\n|-------|---------|--------|\n| `/wallet` | Wallet interface | 🔲 Scaffolded |\n| `/wallet/keys` | Viewing key management | 🔲 Scaffolded |\n| `/dex` | Private DEX | 🔲 Scaffolded |\n| `/dex/jupiter` | Jupiter integration | 🔲 Scaffolded |\n| `/enterprise` | Enterprise dashboard | 🔲 Scaffolded |\n| `/enterprise/compliance` | Compliance tools | 🔲 Scaffolded |\n\n---\n\n## 🛠️ Tech Stack\n\n| Category | Technology | Purpose |\n|----------|------------|---------|\n| **Framework** | Next.js 16 (App Router) | Full-stack React |\n| **UI** | React 19 | Component library |\n| **Styling** | Tailwind CSS 4 | Utility-first CSS |\n| **State** | Zustand 5 | Client state management |\n| **Animations** | Framer Motion | Micro-interactions |\n| **Visualization** | D3.js | Privacy Score charts |\n| **Testing** | Vitest + Playwright | Unit + E2E tests |\n| **Privacy SDK** | @sip-protocol/sdk | Core privacy primitives |\n| **React Hooks** | @sip-protocol/react | useSIP, useStealthAddress |\n| **Wallet** | @solana/wallet-adapter | Phantom, Solflare, etc. |\n\n---\n\n## 💻 Development\n\n### Commands\n\n```bash\npnpm dev              # Start development server\npnpm build            # Build for production\npnpm start            # Start production server\npnpm test             # Run tests in watch mode\npnpm test:run         # Run tests once\npnpm typecheck        # Type check with TypeScript\npnpm lint             # Lint with ESLint\npnpm format           # Format with Prettier\npnpm validate         # Run all checks\n```\n\n### Testing\n\n```bash\n# Unit tests\npnpm test:run\n\n# E2E tests\npnpm test:e2e\n\n# With UI\npnpm test:e2e:ui\n\n# Coverage\npnpm test:coverage\n```\n\n### Key Components\n\n| Component | Purpose |\n|-----------|---------|\n| `SendShieldedForm` | Form for sending private payments |\n| `StealthAddressGenerator` | Generate + display stealth meta-address |\n| `PaymentScanner` | Scan blockchain for incoming payments |\n| `ClaimPayment` | Claim received stealth payments |\n| `ViewingKeyDisclosure` | Reveal transaction to auditor |\n| `PrivacyToggle` | Privacy level selector |\n| `WalletConnect` | Solana wallet connection |\n\n---\n\n## 🚀 Deployment\n\n### Docker (Production)\n\n```bash\n# Build Docker image\ndocker build -t sip-app .\n\n# Run locally\ndocker run -p 3000:3000 sip-app\n```\n\n### VPS Configuration\n\n```yaml\n# docker-compose.yml\nname: sip-app\n\nservices:\n  app-blue:\n    image: ghcr.io/sip-protocol/sip-app:latest\n    container_name: sip-app-blue\n    ports:\n      - \"5004:3000\"\n    restart: unless-stopped\n\n  app-green:\n    image: ghcr.io/sip-protocol/sip-app:green\n    container_name: sip-app-green\n    ports:\n      - \"5005:3000\"\n    restart: unless-stopped\n```\n\n### CI/CD Pipeline\n\n```\nPush to main → GitHub Actions → Build Docker → Push to GHCR → SSH Deploy → Live\n```\n\n---\n\n## 🎨 Design Philosophy\n\n### Quality Standards\n\n| Aspect | Standard |\n|--------|----------|\n| **UX** | Delightful, intuitive, zero friction |\n| **Performance** | Sub-second interactions, optimistic UI |\n| **Design** | Clean, modern, professional |\n| **Reliability** | 99.9% uptime, graceful error handling |\n| **Accessibility** | WCAG 2.1 AA compliant |\n| **Mobile** | Mobile-first responsive design |\n\n### Design Inspirations\n\n| App | What to Learn |\n|-----|---------------|\n| **jup.ag** | Swap UX, token selection, transaction flow |\n| **phantom.app** | Wallet UX, onboarding, mobile experience |\n| **uniswap.org** | Clean design, professional feel |\n| **stripe.com** | Form design, error handling, trust signals |\n| **linear.app** | Speed, keyboard shortcuts, polish |\n\n### Quality Benchmark\n\n\u003e **\"Would this be acceptable on jup.ag?\"**\n\u003e\n\u003e If no, raise the bar. The app sells the SDK.\n\n---\n\n## 🔗 Related Projects\n\n| Project | Description | Link |\n|---------|-------------|------|\n| **sip-protocol** | Core SDK (6,600+ tests) | [GitHub](https://github.com/sip-protocol/sip-protocol) |\n| **sip-mobile** | Companion mobile app | [GitHub](https://github.com/sip-protocol/sip-mobile) |\n| **sip-website** | Marketing website | [GitHub](https://github.com/sip-protocol/sip-website) |\n| **docs-sip** | Documentation | [docs.sip-protocol.org](https://docs.sip-protocol.org) |\n\n---\n\n## 📄 License\n\n[MIT License](LICENSE) — see LICENSE file for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Privacy Command Center for Web3**\n\n*Privacy is not a feature. It's a right.*\n\n[Live App](https://app.sip-protocol.org) · [Documentation](https://docs.sip-protocol.org) · [Report Bug](https://github.com/sip-protocol/sip-app/issues)\n\n*Part of the [SIP Protocol](https://github.com/sip-protocol) ecosystem*\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsip-protocol%2Fsip-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsip-protocol%2Fsip-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsip-protocol%2Fsip-app/lists"}