Skip to content

N-45div/cysh

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
.husky
.husky
 
 
docs
docs
 
 
packages
packages
 
 
prisma
prisma
 
 
programs
programs
 
 
public/circuits
public/circuits
 
 
scripts
scripts
 
 
src/lib
src/lib
 
 
tests
tests
 
 
.env.example
.env.example
 
 
.eslintrc.cjs
.eslintrc.cjs
 
 
.gitignore
.gitignore
 
 
.lintstagedrc.json
.lintstagedrc.json
 
 
.prettierrc
.prettierrc
 
 
Anchor.toml
Anchor.toml
 
 
Cargo.toml
Cargo.toml
 
 
HACKATHON_PITCH.md
HACKATHON_PITCH.md
 
 
PROJECT_STRUCTURE.md
PROJECT_STRUCTURE.md
 
 
QUICKSTART.md
QUICKSTART.md
 
 
QUICKSTART_DB.md
QUICKSTART_DB.md
 
 
README.md
README.md
 
 
TECHNICAL_STACK.md
TECHNICAL_STACK.md
 
 
TODO.md
TODO.md
 
 
package.json
package.json
 
 
pnpm-lock.yaml
pnpm-lock.yaml
 
 
pnpm-workspace.yaml
pnpm-workspace.yaml
 
 
tsconfig.json
tsconfig.json
 
 

Repository files navigation

🌑 Shadow OTC Nexus

Privacy-First On-Chain OTC Protocol for Solana Whales & Institutions

Cypherpunk Hackathon 2025 Submission

🎯 The Problem

Whales and institutions face a critical "alpha decay" problem on transparent blockchains:

  • MEV Exploitation: Large swaps lose 2-5% to sandwich attacks
  • Front-Running: Public orders get copied or front-run by bots
  • Position Exposure: Wallet trackers (Nansen, Arkham) reveal strategies
  • Clunky OTC: Telegram desks are slow, risky, and charge 0.5-2% spreads

Impact: $300M-$1B in daily OTC volume on Solana has no privacy-preserving solution.

💡 Our Solution

Shadow OTC Nexus enables discreet, large-scale trades ($100K+) through:

Core Innovation: Ghost Bidding System

  1. Encrypted Order Submission via Telegram bot
  2. Private Matching using MPC (Multi-Party Computation)
  3. Batched Settlement on Solana with MEV resistance
  4. Post-Trade DeFi auto-routing to yield strategies

Key Differentiators

✅ Compliance-First: KYC-gated access (not like Tornado Cash)
✅ True Privacy: Orders never visible on-chain
✅ Atomic Settlement: No counterparty risk
✅ Capital Efficient: Auto-yield on idle assets

🔧 Technical Architecture

Technology Stack Integration

1. Arcium - Encrypted Order Matching Layer

Role: Powers the "ghost bidding" system

How We Use It:

  • MXE Programs (Multi-Party eXecution): Process encrypted orders without decryption
  • MPC Network: 3-step flow:
    1. Client encrypts order details (token, amount, price)
    2. Submit to Arcium's decentralized MPC nodes
    3. Matching algorithm runs on encrypted data

Why Perfect for Us:

  • Extends Anchor framework (familiar Rust tooling)
  • Mark functions as confidential - no crypto knowledge needed
  • Solana-native with on-chain verification
  • Dark pool use case explicitly mentioned in docs

Implementation:

// Example: Confidential order matching
#[confidential]
pub fn match_orders(ctx: Context<MatchOrders>, 
                   encrypted_bid: Vec<u8>, 
                   encrypted_ask: Vec<u8>) -> Result<MatchResult> {
    // MPC processes encrypted orders
    // Returns match without revealing prices
}

2. magicblock - Settlement & Performance Layer

Role: High-throughput batched settlements

How We Use It:

  • Ephemeral Rollups (ER): Execute real-time, zero-fee transaction batching

    • 1000+ TPS for order aggregation
    • Temporary state for order book accumulation
    • Finalize batches to Solana mainnet every 5 minutes

  • Private Ephemeral Rollup (TEE): Additional privacy layer

    • Trusted Execution Environment for sensitive computations
    • Prevents validator MEV during settlement

  • VRF: Verifiable randomness for batch ordering

    • Prevents settlement manipulation
    • Fair execution order within batches

Why Perfect for Us:

  • A16z-backed, production-ready
  • Open-source ephemeral validator
  • Zero fees during batch accumulation
  • Solana-native (no bridging)

Architecture Flow:

Orders accumulate in ER → Batch every 5 min → Settle to Solana

3. Solana Token-2022 - Asset Privacy Layer

Role: Confidential token transfers post-settlement

How We Use It:

  • ConfidentialTransferMint extension for encrypted balances
  • ElGamal encryption for amount hiding
  • ZK proofs for transfer validity

Integration:

// Post-settlement: Transfer to user wallets with privacy
await confidentialTransfer({
  mint: usdcMint,
  source: escrowAccount,
  destination: userAccount,
  amount: encryptedAmount, // ElGamal encrypted
  proof: zkProof // ZK range proof
});

🏗️ System Architecture

┌─────────────────┐
│  Telegram Bot   │ ← User Interface
│   (Node.js)     │
└────────┬────────┘
         │ Submit Encrypted Order
         ▼
┌─────────────────────────┐
│   Arcium MPC Network    │ ← Ghost Bidding Engine
│  (Encrypted Matching)   │
└────────┬────────────────┘
         │ Matched Orders
         ▼
┌─────────────────────────┐
│ magicblock Ephemeral    │ ← Batching Layer
│  Rollup (TEE-enabled)   │
│  - Accumulate orders    │
│  - Batch every 5 min    │
└────────┬────────────────┘
         │ Settlement Batch
         ▼
┌─────────────────────────┐
│   Solana Mainnet        │ ← Final Settlement
│  - Anchor Programs      │
│  - Token-2022 Privacy   │
│  - Atomic Swaps         │
└────────┬────────────────┘
         │ (Optional)
         ▼
┌─────────────────────────┐
│   DeFi Integrations     │
│  - Drift (Perps)        │
│  - Kamino (Lending)     │
│  - Marinade (Staking)   │
└─────────────────────────┘

🗓️ 2-Week MVP Plan

Week 1: Foundation & Core Privacy (Oct 25 - Nov 1)

Day 1-2: Setup & Research

  • Environment setup (Solana, Anchor, Arcium CLI)
  • Deploy test programs to Solana devnet
  • Study Arcium MXE examples (hello world)
  • Research magicblock ER SDK integration
  • Design database schema for orders

Deliverables: Dev environment + architecture doc

Day 3-4: Telegram Bot

  • Create bot with Grammy.js framework
  • Implement commands:
    • /start - Onboarding flow
    • /order - Create encrypted order
    • /balance - Check escrow balance
    • /history - View completed trades
  • Wallet connection (Phantom/Solflare via deep links)
  • Order encryption client-side

Deliverables: Working TG bot with order submission

Day 5-7: Arcium Integration (Ghost Bidding)

  • Write Arcium MXE program for order matching
  • Implement confidential matching logic:
    • Price compatibility check (encrypted)
    • Amount matching algorithm
    • Match notification
  • Test with 2-party encrypted orders
  • Build TypeScript client for MXE interaction

Deliverables: Encrypted order matching working on Arcium testnet

Week 2: Settlement & Demo (Nov 2 - Nov 8)

Day 8-9: magicblock Integration

  • Setup ephemeral rollup session
  • Integrate ER SDK for batch accumulation
  • Configure 5-minute batch finalization
  • Test settlement to Solana devnet

Deliverables: Batched settlement pipeline

Day 10-11: Solana Programs

  • Write Anchor program for atomic swaps
  • Implement escrow accounts (PDA-based)
  • Add Token-2022 confidential transfer support
  • Security: Add reentrancy guards, overflow checks

Deliverables: Battle-tested settlement contracts

Day 12: DeFi Yield Integration

  • Integrate with Drift Protocol (optional yield)
  • Auto-staking to Marinade for idle SOL
  • UI for yield preferences

Deliverables: Post-trade capital efficiency

Day 13: Compliance Layer

  • Basic KYC stub (mock verification)
  • Transaction limits ($500K max for demo)
  • Audit log dashboard (judges can view)
  • Whitelist mechanism for sanctioned addresses

Deliverables: Compliance-friendly design

Day 14: Demo & Pitch

  • Record demo video showing:
    • 2 whales swapping $100K USDC ↔ SOL privately
    • Order book stays hidden
    • Settlement in single atomic transaction
  • Prepare pitch deck (10 slides max)
  • Deploy to devnet with public demo link
  • Write technical documentation

Deliverables: Submission-ready project

📊 Market Validation

Target Users

  1. DeFi Protocols (Primary): Treasury swaps, $10M+ deals

    • Example: Jupiter swapping protocol fees privately

  2. Solana Whales (Secondary): $1M+ holders

    • Example: Early SOL investors rebalancing portfolios

  3. Institutions (Future): Market makers, funds

    • Example: GSR, Wintermute doing OTC on Solana

Willingness to Pay

  • Fee Model: 0.3% of trade volume (vs 0.5-2% market makers charge)
  • Market Size: $300M-$1B daily OTC volume on Solana
  • Revenue Potential: $900K-$3M daily at 0.3% fee

Competitive Advantage

Feature Shadow OTC Telegram Desks Serum Hidden Orders
Privacy ✅ Full (MPC) ❌ Off-chain 🟡 Partial
Speed ⚡ 5 min 🐌 Hours ⚡ Instant
Fees 0.3% 1-2% 0.1%
Atomic ✅ Yes ❌ No ✅ Yes
MEV Safe ✅ Batched ❌ Off-chain ❌ No

🎮 Demo Scenario

Actors: Alice (Whale A), Bob (Whale B)

  1. Alice wants to swap $100K USDC for SOL privately

    • Opens TG bot → /order buy SOL 500 at $200/SOL
    • Bot encrypts order, submits to Arcium

  2. Bob wants to sell 500 SOL for USDC

    • Opens TG bot → /order sell SOL 500 at $200/SOL
    • Bot encrypts order, submits to Arcium

  3. Arcium MPC matches orders (both stay encrypted)

    • Neither party sees the other's order details
    • Match found: 500 SOL ↔ $100K USDC

  4. magicblock ER batches the trade with other orders

    • Accumulates for 5 minutes
    • Prevents MEV by batching atomically

  5. Solana Settlement

    • Atomic swap executes on-chain
    • Token-2022 transfers assets with privacy
    • Both wallets updated, no public order book

Result: Private, MEV-resistant, trustless OTC trade in <6 minutes.

🛠️ Tech Stack Summary

Layer Technology Purpose
UI Telegram Bot (Grammy.js) User interface
Privacy Arcium MPC Encrypted order matching
Performance magicblock ER Batched settlement
Settlement Solana + Anchor Atomic swaps
Token Privacy Token-2022 Extensions Confidential transfers
DeFi Drift, Kamino, Marinade Yield generation

🚀 Beyond MVP (Post-Hackathon)

Phase 2: Advanced Features

  • Multi-token support (RWAs, NFTs)
  • Partial fill orders
  • Limit orders with time expiry
  • Reputation system for participants

Phase 3: Institutional Grade

  • Full KYC/AML integration (Sumsub)
  • Regulatory compliance dashboard
  • API for institutional desks
  • Insurance fund for settlement failures

Phase 4: Network Effects

  • Liquidity mining incentives
  • Governance token (SHADOW)
  • Cross-chain OTC (Wormhole integration)
  • AI-powered price discovery

🔐 Security Considerations

Attack Vectors & Mitigations

  1. Front-Running: ✅ Encrypted orders + batched settlement
  2. Order Book Manipulation: ✅ MPC prevents price leakage
  3. Reentrancy: ✅ Anchor's reentrant guards
  4. Oracle Manipulation: ✅ Use Pyth with staleness checks
  5. Sybil Attacks: ✅ KYC requirement + minimum trade size

Audits Planned

  • Arcium MXE program: Post-hackathon audit by OtterSec
  • Anchor settlement contracts: Pre-launch by Neodyme
  • magicblock integration: Follow ER security best practices

📚 Resources & Documentation

Key Links

Example Projects

  • Renegade (Dark Pool on Arbitrum using MPC)
  • Drift Protocol (Solana perpetuals)
  • Elusiv (Privacy on Solana - now pivoted)

🤝 Team & Contributions

Built for: Solana Cypherpunk Hackathon 2025
Focus Tracks: Privacy, DeFi, Institutional Infrastructure

Looking For

  • Frontend devs (React + TG bot experience)
  • Rust/Anchor developers
  • Privacy cryptography experts
  • DeFi protocol partnerships

📄 License

MIT License - Open source for the cypherpunk community

🎯 Why This Wins Cypherpunk Hackathon

Perfect Theme Alignment ✅

  • Privacy is core (not bolted on)
  • Uses cutting-edge MPC + TEE tech
  • Solves real institutional pain point

Technical Innovation ✅

  • First OTC protocol combining Arcium + magicblock
  • Novel "ghost bidding" mechanism
  • Production-ready architecture

Market Potential ✅

  • $300M-$1B addressable market
  • Clear monetization ($900K+ daily revenue)
  • Institutional demand validated

Compliance Angle ✅

  • Avoids Tornado Cash mistakes
  • KYC-gated, audit logs
  • Regulator-friendly design

Demo Impact ✅

  • Live devnet deployment
  • Real privacy demonstration
  • Tangible value proposition

📞 Contact & Demo

Demo Link: [Coming Soon - Deploy Day 14]
Twitter: [@ShadowOTCNexus]
Telegram: [@ShadowOTCBot]
GitHub: [github.com/shadowotc/nexus]

"Privacy is not about hiding. It's about protecting what matters." - Cypherpunk Manifesto

📊 Current Implementation Status

✅ Settlement Program + SDK (Production-Ready)

  • Program: Token-2022 atomic swaps on devnet
    • Program ID: HkamtrV1uGYGHgL8rZxmXubtnLawS3yiizCBQXCpiZds
    • Instructions: init_escrow, deposit, settle_atomic_swap, withdraw
    • Full test coverage: programs/settlement/tests/token22-swap.test.ts
  • SDK: TypeScript client with typed methods
    • Location: packages/sdk/src/settlement/
    • PDA helpers, token account management, full lifecycle methods
  • Status: Ready for integration

⏸️ Arcium Matching (Blocked - DKG Pending)

  • Program: Encrypted order matching implemented
    • Program ID: 6QFiiqmYBELXw9LgGwogYcwiXkRD6AyGjWtXgoJ3NS3G
    • MPC flow: init_match_orders_comp_def, match_orders, callback
  • Cluster: 4040404 (active, awaiting DKG key agreement)
  • Current Error: MxeKeysNotSet (6002) - cluster nodes finalizing keys
  • Tests: Gated with ARCIUM_ENABLED=true environment variable
  • Status: Implementation complete, waiting for external DKG completion

⏸️ Magicblock ER (Client-Side Only)

  • Approach: Using ConnectionMagicRouter for transaction routing
  • Reason: Rust SDK incompatibilities with Solana 2.x/Anchor 0.31+
  • On-Chain: Settlement program has ER methods behind feature flag (disabled)
  • Status: Client-side routing functional, on-chain integration deferred

🚧 Database & Telegram Bot (Separate Dev Stream)

  • Prisma schema exists
  • Bot implementation pending (different developer)

🔥 Settlement-Only Demo (Available Now)

You can test the atomic swap flow today without Arcium/ER dependencies:

# Clone and setup
git clone https://github.com/shadowotc/nexus.git
cd nexus
pnpm install

# Run settlement tests
pnpm test:settlement

# Or run Token-2022 tests directly
cd programs/settlement
pnpm test:token22

What the Demo Shows

  1. Create Token-2022 mints (USDC 6dp, SOL 9dp)
  2. Initialize trade escrow for matched order
  3. Maker deposits 100 USDC → escrow
  4. Taker deposits 1 SOL → escrow
  5. Atomic settlement → tokens swapped
  6. Withdrawal flow (cancel scenario)

Expected Output:

  • ✅ Maker receives 1 SOL
  • ✅ Taker receives 100 USDC
  • ✅ Double settlement prevented
  • ✅ Non-depositor withdrawal blocked

Reference: programs/settlement/tests/token22-swap.test.ts

🔥 Quick Start (For Judges)

# Clone repo
git clone https://github.com/shadowotc/nexus.git
cd nexus

# Install dependencies
pnpm install

# Setup environment
cp .env.example .env
# Add your Solana wallet, Arcium API key, Telegram bot token

# Deploy to devnet
pnpm run deploy:devnet

# Start Telegram bot
pnpm run bot:start

# Test order flow
# 1. Open @ShadowOTCBot
# 2. /order buy SOL 10 at 200
# 3. Watch encrypted matching in action

Built with 🖤 by the Shadow OTC team
Powered by Arcium 🔐 | magicblock ⚡ | Solana ☀️

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages