CLI Examples

Real-world scanning scenarios and use cases.

Basic Wallet Scans

Check Your Own Wallet

# Quick privacy check
solana-privacy-scanner scan-wallet YOUR_WALLET_ADDRESS --max-signatures 20

What to look for:

• Overall risk score
• Any CEX interactions (HIGH risk)
• Counterparty reuse patterns
• Timing correlation

---

Deep Wallet Analysis

# Comprehensive scan (may take longer)
solana-privacy-scanner scan-wallet YOUR_WALLET_ADDRESS \
  --max-signatures 200 \
  --output detailed-report.txt

Use case: Before using a wallet for privacy-sensitive activities, do a deep scan to understand existing exposure.

---

Transaction Analysis

Investigate a Suspicious Transaction

solana-privacy-scanner scan-transaction <SIGNATURE>

Use case: Got a transaction from an unknown source? Scan it to see what risk patterns it contains.

---

Program Analysis

Check DEX Privacy

# Scan Jupiter aggregator
solana-privacy-scanner scan-program JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4 \
  --max-accounts 10 \
  --max-transactions 30

Use case: Understand what privacy risks are inherent to using a specific protocol.

---

JSON Output for Automation

Save Scan Results as JSON

solana-privacy-scanner scan-wallet YOUR_WALLET \
  --json \
  --output scan-$(date +%Y%m%d).json

Use case: Automated privacy monitoring in CI/CD or cron jobs.

---

Process JSON with jq

# Extract only HIGH risk signals
solana-privacy-scanner scan-wallet YOUR_WALLET --json | \
  jq '.signals[] | select(.severity == "HIGH")'

# Count total signals
solana-privacy-scanner scan-wallet YOUR_WALLET --json | \
  jq '.summary.totalSignals'

# List known entities
solana-privacy-scanner scan-wallet YOUR_WALLET --json | \
  jq '.knownEntities[].name'

---

Multi-Wallet Comparison

Scan Multiple Wallets

#!/bin/bash
# scan-all.sh

WALLETS=(
  "wallet1..."
  "wallet2..."
  "wallet3..."
)

for wallet in "${WALLETS[@]}"; do
  echo "Scanning $wallet..."
  solana-privacy-scanner scan-wallet "$wallet" \
    --output "report-$wallet.txt"
done

Use case: Compare privacy profiles across your wallet portfolio.

---

Privacy Audit Workflow

Before Important Transaction

# 1. Scan your current wallet
solana-privacy-scanner scan-wallet YOUR_WALLET --max-signatures 50

# 2. Check if result is acceptable
# 3. If HIGH risk, consider using a different wallet or taking mitigation steps

After Using New Protocol

# Scan to see what new risks were introduced
solana-privacy-scanner scan-wallet YOUR_WALLET --max-signatures 10

---

Known Entity Detection

Find CEX Interactions

# Scan and search output for "exchange"
solana-privacy-scanner scan-wallet YOUR_WALLET | grep -i exchange

What to look for:

KNOWN ENTITIES DETECTED
Exchanges:
  • Binance Hot Wallet

If you see this, your wallet has interacted with a CEX - HIGH privacy risk.

---

Debugging and Troubleshooting

Test with Limited Data

# Start with just 5 transactions to test connectivity
solana-privacy-scanner scan-wallet YOUR_WALLET --max-signatures 5

Verbose RPC Errors

# If scan fails, check RPC connectivity
curl -X POST -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"getHealth"}' \
  $SOLANA_RPC

---

Integration Examples

GitHub Actions

name: Privacy Audit

on:
  schedule:
    - cron: '0 0 * * 0'  # Weekly

jobs:
  audit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - uses: actions/setup-node@v2
        with:
          node-version: '20'
      - run: npm install -g solana-privacy-scanner
      - run: |
          solana-privacy-scanner scan-wallet ${{ secrets.WALLET_ADDRESS }} \
            --rpc ${{ secrets.SOLANA_RPC }} \
            --json \
            --output audit-report.json
      - uses: actions/upload-artifact@v2
        with:
          name: privacy-report
          path: audit-report.json

---

Shell Function

Add to .bashrc or .zshrc:

# Quick privacy check
function solscan() {
  solana-privacy-scanner scan-wallet "$1" --max-signatures 30
}

# Usage: solscan YourWalletAddress

---

Best Practices

1. Regular Audits

# Weekly privacy check
0 0 * * 0 solana-privacy-scanner scan-wallet YOUR_WALLET --output ~/privacy-reports/weekly-$(date +\%Y\%m\%d).txt

2. Before/After Comparisons

# Before using new protocol
solana-privacy-scanner scan-wallet YOUR_WALLET --output before.txt

# ... use protocol ...

# After
solana-privacy-scanner scan-wallet YOUR_WALLET --output after.txt
diff before.txt after.txt

3. Dedicated Privacy Wallets

# Scan your "anonymous" wallet to verify it's actually private
solana-privacy-scanner scan-wallet ANON_WALLET --max-signatures 100

# Should show LOW risk and no known entity interactions

---

Next Steps

• User Guide - Full command reference
• Understanding Reports - Interpret results
• Known Entities - Database of tracked addresses