Zero-Knowledge Privacy Protocol
Cryptographically Unlinkable Transactions on the World's Fastest Blockchain
- Full Transparency — Every transaction is publicly visible
- Address Linking — Wallets are easily traced across transactions
- Identity Exposure — CEX deposits reveal user identities
- MEV Attacks — Front-running exploits cost users millions
- No Native Privacy — Unlike other chains, Solana lacks built-in privacy
"On Solana, everyone can see your entire financial history."
A non-custodial privacy layer that breaks the on-chain link between sender and receiver
| Feature | Description |
|---|---|
| 🔐 ZK-SNARKs | Groth16 proofs on BN254 curve |
| 🌳 Merkle Tree | Cryptographic commitment storage |
| 👻 Unlinkable Transfers | Complete transaction anonymity |
| ⚡ Sub-second Latency | Solana-native performance |
| 🛡️ Non-custodial | Users control their funds at all times |
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ DEPOSIT │ ──▶ │ SHIELDED │ ──▶ │ WITHDRAW │
│ (Shield) │ │ POOL │ │ (Unshield) │
└─────────────┘ └─────────────┘ └─────────────┘
│ │ │
▼ ▼ ▼
Generate Stored as ZK Proof
Commitment Merkle Leaf Verification
- Shield — User deposits SOL with a secret commitment
- Pool — Commitment stored in on-chain Merkle tree
- Withdraw — Generate ZK proof to claim funds to any address
┌────────────────────────────────────────────────────────┐
│ DASHBOARD (Next.js) │
├────────────────────────────────────────────────────────┤
│ CLI / SDK │
├──────────────────┬─────────────────┬───────────────────┤
│ ZK CIRCUITS │ SHADOW RELAYER │ SOLANA PROGRAM │
│ (Circom) │ (Node.js) │ (Anchor/Rust) │
├──────────────────┴─────────────────┴───────────────────┤
│ SOLANA BLOCKCHAIN │
└────────────────────────────────────────────────────────┘
Public Inputs (The Statement):
- Merkle Root
- Nullifier Hash
- Recipient Address
- Relayer Address
- Fee & Amount
Private Inputs (The Witness):
- Secret Key
- Nullifier Key
- Merkle Path
Security Bindings:
- ✅ Commitment includes amount → prevents inflation
- ✅ Recipient bound to proof → prevents theft
- ✅ Nullifier prevents double-spend
| Component | Technology | Purpose |
|---|---|---|
| Hash Function | Poseidon-3 | ZK-optimized, circuit-efficient |
| Proof System | Groth16 | Constant-size proofs (~200 bytes) |
| Curve | BN254 | Ethereum-compatible, fast pairing |
| Merkle Tree | 8-level depth | Supports 256 deposits per pool |
| Trusted Setup | Powers of Tau | Hermez ceremony (100+ participants) |
Core Instructions:
• initialize() → Setup protocol state
• deposit() → Add commitment to Merkle tree
• withdraw() → Verify proof & release funds
• trigger_emergency() → Admin safety controlsSecurity Features:
- ✅ Field element validation (BN254)
- ✅ Root history (50 roots) for proof freshness
- ✅ PDA-based nullifier tracking
- ✅ Circuit breaker for emergencies
- ✅ Rate limiting & fee controls
import { SolVoidClient } from 'solvoid';
// Initialize client
const client = new SolVoidClient(config, wallet);
// Shield funds (deposit)
const { commitmentData } = await client.shield(1.5 * LAMPORTS_PER_SOL);
// Check privacy score
const passport = await client.getPassport(address);
console.log(`Ghost Score: ${passport.overallScore}/100`);
// Prepare ZK withdrawal
const proof = await client.prepareWithdrawal(
secret, nullifier, amount, recipient, ...
);# Privacy Analysis
solvoid ghost <address> --badge --share
# Shield Funds (Private Deposit)
solvoid shield 1.5
# ZK Withdrawal
solvoid withdraw <secret> <nullifier> <recipient> <amount>
# Emergency Rescue (MEV-Protected)
solvoid rescue <wallet> --jito-bundle --emergency
# Admin Controls
solvoid admin pause # Circuit breaker
solvoid admin resume # Resume operationsGhost Score (0-100) measures on-chain anonymity:
| Score | Rating | Meaning |
|---|---|---|
| 90-100 | 👻 Ghost | Excellent privacy practices |
| 70-89 | 🔒 Secure | Good privacy hygiene |
| 50-69 | Some privacy leaks detected | |
| 0-49 | 🚨 Compromised | Significant exposure |
Analyzed Factors:
- CEX interactions
- Transaction patterns
- Address clustering
- Known entity connections
User ──▶ Relayer 1 ──▶ Relayer 2 ──▶ ... ──▶ Solana
(Onion Routing: 1-5 hops)
Benefits:
- 🔥 Gasless — Relayer pays transaction fees
- 🕵️ IP Privacy — User IP never touches blockchain
- 🛡️ MEV Protection — Optional Jito bundle integration
- ⚡ Fast — Sub-second relay times
API Endpoints:
GET /status— Health & metricsGET /commitments— Merkle state syncPOST /relay— Submit transaction
Use Cases:
- 🔑 Private key compromise
- 🤖 MEV/Bot attack detected
- 💸 Wallet drainer identified
Features:
solvoid rescue <wallet> \
--to <safe-address> \
--jito-bundle \
--emergency \
--reason key-leak- Atomic multi-asset transfers
- Jito MEV bundle protection
- Sub-2 second execution
- Dry-run simulation mode
Built with Next.js 15
| Component | Function |
|---|---|
| 🎯 Privacy Radar | Real-time Ghost Score visualization |
| 📊 Forensic Feed | Live leak detection & alerts |
| 🌐 Network Heatmap | Global relayer topology |
| 🌳 Merkle Tree 3D | Interactive commitment explorer |
| 🔐 Shadow Vault | Shield/unshield operations |
| ⚡ Tactical Ops | Emergency rescue interface |
| Assumption | Risk Level | Mitigation |
|---|---|---|
| Groth16 security | LOW | KEA + DLP assumptions |
| Poseidon hash | LOW | Extensive cryptanalysis |
| BN254 curve | MEDIUM | ~100-bit security accepted |
| Trusted setup | LOW | 100+ ceremony participants |
| RPC provider | MEDIUM | Multi-endpoint verification |
| User key storage | HIGH | User responsibility |
Emergency Controls:
- Circuit breaker (pause withdrawals)
- Emergency fee multiplier (up to 10x)
- Rate limiting per hour
┌─────────────────────────────────────┐
│ WITHDRAWAL FLOW │
├─────────────────────────────────────┤
│ Amount: 1.0 SOL │
│ - Protocol Fee (0.1%): 0.001 SOL │
│ - Relayer Bounty: 0.002 SOL │
│ = Recipient Gets: 0.997 SOL │
└─────────────────────────────────────┘
Safety Parameters:
- Minimum reserve: 0.1 SOL
- Hourly limit: 5 SOL
- Circuit breaker threshold: 0.5 SOL
Build Pipeline:
# ZK Circuits
./scripts/build-circuits.sh
# Solana Program
anchor build && anchor deploy
# Initialize Protocol
solvoid init --authority <PUBKEY>CI/CD Workflows:
- TypeScript type checking
- Jest test suite (unit + integration)
- Rust clippy & cargo audit
- Cross-platform hash verification
| Test Category | Description |
|---|---|
| Unit Tests | SDK, CLI, crypto primitives |
| Integration Tests | End-to-end deposit/withdraw |
| Security Tests | Proof forgery, double-spend |
| Performance Tests | Proof generation < 10 seconds |
| Circuit Tests | Soundness & constraint validation |
Validation Scripts:
./scripts/run-security-tests.sh
./scripts/security-validation.sh
./scripts/verify-hash-consistency.sh| Phase | Status | Features |
|---|---|---|
| Alpha | ✅ Done | Core circuits, basic program |
| Beta | ✅ Current | Full SDK, CLI, Dashboard |
| Audit | 🔄 Pending | External security review |
| Mainnet | 📋 Planned | Production deployment |
| V2 | 🔮 Future | Multi-asset pools, compliance mode |
| Feature | SolVoid | Competitors |
|---|---|---|
| Chain | Solana (65k TPS) | Ethereum (15 TPS) |
| Latency | Sub-second | Minutes |
| Fees | ~$0.001 | $5-50+ |
| Ghost Score | ✅ Built-in | ❌ None |
| MEV Protection | ✅ Jito bundles | ❌ Limited |
| Rescue Engine | ✅ Atomic | ❌ None |
👤 Individual Users
- Private salary payments
- Anonymous donations
- Personal financial privacy
🏢 Institutions
- Treasury operations
- Competitive privacy
- Regulatory compliance (optional)
🔧 Developers
- SDK integration
- Privacy-as-a-service
- dApp privacy layer
| Component | Specification |
|---|---|
| Proof Generation | < 10 seconds (browser) |
| Proof Size | ~200 bytes (Groth16) |
| Merkle Depth | 8 levels (256 leaves) |
| Root History | 50 roots cached |
| Curve | BN254 (alt_bn128) |
| Hash | Poseidon (t=3, RF=8, RP=57) |
SolVoid/
├── circuits/ # Circom ZK circuits
├── programs/ # Anchor Solana program
├── sdk/ # TypeScript SDK
├── cli/ # Command-line interface
├── dashboard/ # Next.js web UI
├── relayer/ # Shadow relay service
├── scripts/ # Build & deploy tools
└── tests/ # Comprehensive test suite
License: MIT
# Clone repository
git clone https://github.com/brainless3178/SolVoid.git
cd SolVoid
# Install dependencies
npm install
# Build ZK circuits
./scripts/build-zk.sh
# Deploy to devnet
anchor deploy --provider.cluster devnet
# Run dashboard
npm run dashboard:dev| Resource | Link |
|---|---|
| 🌐 Website | solvoid.io |
| 📚 Documentation | docs.solvoid.io |
| 🐙 GitHub | github.com/brainless3178/SolVoid |
| 🐦 Twitter/X | @solvoid |
| 💬 Discord | discord.gg/solvoid |
- SolVoid brings institutional-grade privacy to Solana
- ZK-SNARKs enable cryptographically unlinkable transfers
- Non-custodial design — users always control their funds
- Sub-second latency with Solana-native performance
- Comprehensive toolkit — SDK, CLI, Dashboard, Relayer
- Security-first — circuit breakers, rate limits, audits
"Privacy is not a feature. It's a fundamental right."
| Metric | Value |
|---|---|
| Lines of Rust | ~1,500 |
| Lines of Circom | ~200 |
| Lines of TypeScript | ~10,000 |
| Test Coverage | 80%+ |
| Proof Generation | < 10s |
| Transaction Latency | < 1s |
| Max Pool Size | 256 deposits |
SolVoid — Engineering-First. Privacy-Preserving. Solana-Native.