Features

• Privacy Migration - Shield SOL using Light Protocol ZK compression
• Wallet Scanner - Analyze any wallet for dust attacks & privacy risks
• Encrypted Wallets - AES-256-GCM encrypted keypair storage
• QR Code Funding - Easy wallet funding via QR code

Quick Start

npx privatepussy

Or install globally:

npm install -g privatepussy
privatepussy

Setup

Helius API Key (Required for Shield/Unshield)

Privacy Migration requires a Helius API key (free tier available):

1. Get a free key at helius.dev
2. Set it via environment variable:

   export HELIUS_API_KEY=your-api-key

   Or configure in the CLI: Settings → Helius API Key

Note: Wallet scanning works without an API key (uses public RPC).

How It Works

1. Privacy Migration (Shield/Unshield)

Uses Light Protocol ZK compression to break the on-chain link between your wallets:

Your Wallet ──► Shield (compress) ──► Private Account ──► Unshield ──► New Wallet
                     │                                         │
                     └─── No on-chain link between wallets ────┘

The Flow:

1. Create a new wallet in the CLI
2. Send SOL from your existing wallet (Phantom, etc.)
3. Shield the SOL (compress into private account)
4. Unshield to a completely new wallet
5. No traceable connection between source and destination

2. Wallet Scanner

Analyze any Solana wallet for privacy risks:

• Dust attack detection
• Tracking token identification
• Token categorization (empty, dust, legitimate)
• SOL rent recovery estimation

# Just enter any public address - no private key needed
privatepussy
> Scan Wallet
> Enter wallet address: <any-solana-address>

Menu Options

┌─────────────────────────────────────────────────┐
│           PRIVATE PUSSY - Main Menu             │
├─────────────────────────────────────────────────┤
│  ★ Privacy Migration  (Shield/Unshield - ZK)   │
│  › Scan Wallet        (Dust & privacy analysis)│
│  › Settings           (Network/Wallets/RPC)    │
│  › Clear                                        │
│  › Exit                                         │
└─────────────────────────────────────────────────┘

Network Support

| Network | Privacy Migration | Wallet Scan | |---------|-------------------|-------------| | Devnet | ✅ Full support | ✅ Available | | Mainnet | ❌ Coming soon* | ✅ Available |

*Light Protocol state trees for native SOL compression are currently only active on Devnet.

Security

• Keys stay local - Your private keys never leave your machine
• Encrypted storage - Wallets encrypted with AES-256-GCM + PBKDF2
• Open source - Audit the code yourself
• No tracking - We don't collect any data

Privacy Migration vs Other Solutions

| Feature | Private Pussy | Mixers | CEX | |---------|--------------|--------|-----| | No KYC | ✅ | ✅ | ❌ | | No anonymity set dependency | ✅ | ❌ | ✅ | | Trustless | ✅ | ❌ | ❌ | | On-chain privacy | ✅ | ✅ | ❌ | | Instant | ✅ | ❌ | ❌ |

Tech Stack

• Light Protocol - ZK compression
• Helius - RPC infrastructure
• Solana Web3.js - Blockchain interaction

Related

• Web App: solprivacy.xyz - Full privacy analysis dashboard
• API: solprivacy.xyz/api/v3/analyze/{wallet} - Privacy analysis API

Development

# Clone
git clone https://github.com/Pavelevich/privatepussy.git
cd privatepussy

# Install
npm install

# Dev mode
npm run dev

# Build
npm run build

# Run
npm start

License

MIT - Do whatever you want with it.