PRIVATE PUSSY

ZK Privacy Tools for Solana

Shield your SOL with ZK compression. Break the chain. Stay private.

---

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

``bash
npx privatepussy
`

Or install globally:

`bash
npm install -g privatepussy
privatepussy
`

Setup

$3

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

1. Get a free key at helius.dev
2. Set it via environment variable:
`bash
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

$3

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

$3

Analyze any Solana wallet for privacy risks:

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

`bash


Just enter any public address - no private key needed


privatepussy
> Scan Wallet
> Enter wallet 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

`bash


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.

---

Built for the Solana Privacy Hackathon 2026

_{Stay private. Stay safe. 🐱}