Skip to content

Pavelevich/shadow-tracker

Repository files navigation

Solana Privacy React 18 TypeScript npm

SolPrivacy

Your wallet is talking. We show you what it's saying.

Advanced privacy analysis for Solana wallets using information theory,
graph analysis, and blockchain forensics from academic research.

Live Demo · CLI Tool · API Docs


The Problem

Every Solana transaction is permanently recorded on a public ledger. While addresses appear anonymous, patterns in your transactions can reveal:

What's Exposed How It's Detected
Your real identity Exchange KYC correlation
Net worth & holdings Token balance analysis
Geographic location Transaction timing patterns
Social connections Counterparty graph analysis
Trading strategies Behavioral fingerprinting

Most users have no idea how exposed they are.


How It Works

SolPrivacy uses the same techniques employed by Chainalysis, Elliptic, and academic researchers to analyze your wallet's privacy posture.

Privacy Score (0-100)

┌─────────────────────────────────────────────────────────────┐
│  CRITICAL   │   HIGH    │  MODERATE  │   LOW    │  MINIMAL  │
│    0-20     │   21-40   │   41-60    │  61-80   │   81-100  │
└─────────────────────────────────────────────────────────────┘

Attack Simulations

Attack Vector Description
Temporal Fingerprinting Infer timezone from transaction timing
Dust Attack Tracking Detect malicious micro-deposits
Graph Topology Cluster wallets via network analysis
Exchange Correlation Match to KYC'd exchange accounts
Amount Heuristics Identify patterns in transaction amounts

Scientific Metrics

Metric What It Measures
Shannon Entropy Transaction randomness/predictability
K-Anonymity How many wallets share your fingerprint
Clustering Coefficient Network interconnectedness
Differential Privacy (ε) Privacy guarantees against inference

Quick Start

Option 1: CLI with AI Agent (Recommended)

npm install -g solprivacy
solprivacy

The CLI includes an AI-powered agent that can:

  • Analyze wallets with natural language queries
  • Simulate attacks on your wallet
  • Compare privacy between wallets
  • Generate detailed reports

Option 2: Web Interface

Visit solprivacy.xyz and paste any Solana wallet address.

Option 3: Self-Host

git clone https://github.com/Pavelevich/shadow-tracker.git
cd shadow-tracker
npm install
npm run dev

Features

Privacy Score Dashboard

  • Overall score with letter grade (A-F)
  • Risk level classification
  • Before/after improvement projections

Attack Simulation

  • Probability of de-anonymization per attack type
  • Estimated time for adversary identification
  • Specific vulnerability breakdown

Identity Fingerprint

  • K-anonymity value
  • Quasi-identifiers analysis
  • Graph topology statistics

Actionable Recommendations

  • Personalized privacy tool suggestions
  • Direct integration with Light Protocol, Arcium
  • Projected score improvements

API Reference

Analyze Wallet

GET https://solprivacy.xyz/api/v3/analyze/:walletAddress

Response:

{
  "success": true,
  "data": {
    "address": "...",
    "advancedPrivacyScore": 42,
    "grade": "D",
    "riskLevel": "HIGH",
    "entropy": {
      "totalEntropy": 0.73,
      "amountEntropy": 0.65,
      "temporalEntropy": 0.81
    },
    "kAnonymity": {
      "kValue": 12,
      "quasiIdentifiers": ["timing", "amounts"]
    },
    "attackSimulation": {
      "temporalAttack": { "probability": 0.78 },
      "graphAttack": { "probability": 0.45 }
    },
    "recommendations": [...]
  }
}

Tech Stack

Layer Technology
Frontend React 18, TypeScript, Vite
Styling TailwindCSS, Framer Motion
Components shadcn/ui
Backend Express.js, Node.js
Blockchain Helius Enhanced API
Hosting Digital Ocean

Research Foundation

Our methodology is grounded in peer-reviewed academic research:

  • Meiklejohn et al. (2013) - "A Fistful of Bitcoins" - IMC '13
  • Ron & Shamir (2013) - "Quantitative Analysis of Bitcoin Transaction Graph"
  • Sweeney (2002) - "k-Anonymity: A Model for Protecting Privacy"
  • Narayanan & Shmatikov (2009) - "De-anonymizing Social Networks" - IEEE S&P
  • Möser et al. (2018) - "Traceability in the Monero Blockchain" - PoPETs

Integrations

Light Protocol
ZK Compression
Helius
Enhanced RPC
Arcium
Confidential MPC

License

MIT License - See LICENSE for details.


Website · npm · CLI Repo

Built for the Solana ecosystem

About

State-of-the-Art Privacy Analyzer for Solana - 11 metrics, 10 academic papers, ~80% attack coverage. Built with Helius API.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors