Solana PDA Analyzer

A comprehensive, production-ready tool for analyzing Solana Program Derived Addresses (PDAs), tracking transaction patterns, and understanding program behavior on the Solana blockchain. Features real-time analysis, pattern recognition, and beautiful visualization of PDA derivation patterns.

Features

🔍 Advanced PDA Analysis: Derive seeds and analyze PDA patterns for any Solana program
🌐 REST API Server: Full-featured HTTP API for real-time PDA analysis (see API_EXAMPLES.md)
📊 Real-World Examples: Pre-loaded with examples from major protocols (SPL Token, Metaplex, Serum, Raydium)
🎯 Pattern Recognition: Automatically detect and classify common PDA seed patterns

📊 Analysis Output Sample

════════════════════════════════════════════════════════════════════════════════
🚀 SOLANA PDA ANALYZER - COMPREHENSIVE ANALYSIS REPORT
════════════════════════════════════════════════════════════════════════════════
📊 Analyzing Program Derived Addresses from Live Solana Programs
🔍 Reverse Engineering Seed Patterns and Derivation Logic
════════════════════════════════════════════════════════════════════════════════

📋 DETAILED ANALYSIS RESULTS
────────────────────────────────────────────────────────────────────────────────

1. ✅ USDC Associated Token Account
   🏷️  PDA Address: Gh9ZwEmd...hQKkx
   🔧 Program: SPL Associated Token (ATokenGP...nL)
   📝 Description: Stores USDC tokens for wallet 9WzDXwBbmkg8...
   🎯 Pattern: WALLET_TOKEN_MINT (98% confidence)
   ⏱️  Analysis Time: 12ms
   🌱 Seed Breakdown:
      1. 🔑 Pubkey (32 bytes): Wallet owner address
      2. 🔑 Pubkey (32 bytes): SPL Token Program ID
      3. 🔑 Pubkey (32 bytes): USDC mint address

📊 PATTERN ANALYSIS & STATISTICS
────────────────────────────────────────────────────────────────────────────────

🏆 Pattern Distribution:
   1. WALLET_TOKEN_MINT [█████████░░░░░░░░░░░] 45.0% (9 PDAs)
   2. STRING_PROGRAM_MINT [████░░░░░░░░░░░░░░░░] 20.0% (4 PDAs)
   3. STRING_AUTHORITY [███░░░░░░░░░░░░░░░░░░] 15.0% (3 PDAs)
   4. PUBKEY_U64 [██░░░░░░░░░░░░░░░░░░] 10.0% (2 PDAs)
   5. STRING_SINGLETON [██░░░░░░░░░░░░░░░░░░] 10.0% (2 PDAs)

📈 EXECUTIVE SUMMARY
────────────────────────────────────────────────────────────────────────────────
🎯 Analysis Overview:
   • Total PDAs Analyzed: 20
   • Unique Patterns Detected: 8
   • Overall Success Rate: 95.0%
   • Total Processing Time: 234ms
   • Average Time per PDA: 11.7ms

🚀 Quick Start

Prerequisites

Rust 1.70+
PostgreSQL 12+
Docker (optional)

Installation

Clone the repository

git clone https://github.com/your-username/solana-pda-analyzer.git
cd solana-pda-analyzer

Set up the database

# Create PostgreSQL database
createdb solana_pda_analyzer

# Copy environment file
cp .env.example .env

# Edit .env with your database credentials
nano .env

Build the project

make build
# or manually: cargo build --release

Initialize the database

make db-init
# or manually: ./target/release/pda-analyzer database init

Run the tests
```
make test-all
```

Start the API server

make run
# or manually: ./target/release/pda-analyzer serve

Test the API

# Health check
curl http://localhost:8080/health

# Analyze a PDA
curl -X POST http://localhost:8080/api/v1/analyze/pda \
  -H "Content-Type: application/json" \
  -d '{"address": "SysvarRent111111111111111111111111111111111", "program_id": "11111111111111111111111111111112"}'

Access the API documentation

Open your browser to http://localhost:8080/docs

🐳 Docker Setup (Alternative)

# Start with Docker Compose
docker-compose up -d

# Run tests in Docker
docker-compose exec app make test-all

# View logs
docker-compose logs -f app

💻 Usage

Command Line Interface

Analyze Individual PDAs

# Analyze a specific PDA
./target/release/pda-analyzer analyze \
  --address "Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr" \
  --program-id "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"

# Batch analyze multiple PDAs
./target/release/pda-analyzer batch-analyze \
  --input pdas.json \
  --output results.json

Run Real-World Examples

# Run all example analyses
./examples/run_examples.sh

# Run specific category
./examples/run_examples.sh spl-token
./examples/run_examples.sh metaplex
./examples/run_examples.sh real-world

Database Operations

# Initialize database with schema
./target/release/pda-analyzer database init

# Check database status and metrics
./target/release/pda-analyzer database status

# Reset database (caution!)
./target/release/pda-analyzer database reset

# Run pending migrations
./target/release/pda-analyzer database migrate

Fetch and Analyze Transactions

# Fetch recent transactions for a program
./target/release/pda-analyzer fetch \
  --program-id "metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s" \
  --limit 1000

# Analyze transaction patterns
./target/release/pda-analyzer analyze-transactions \
  --program-id "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin"

Statistics and Reports

# Show comprehensive statistics
./target/release/pda-analyzer stats

# Generate detailed analysis report
./target/release/pda-analyzer report \
  --output html \
  --file analysis_report.html

🔌 REST API

Analyze PDAs

# Analyze a single PDA
curl -X POST http://localhost:8080/api/v1/analyze/pda \
  -H "Content-Type: application/json" \
  -d '{
    "address": "Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr",
    "program_id": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
  }'

# Batch analyze multiple PDAs
curl -X POST http://localhost:8080/api/v1/analyze/pda/batch \
  -H "Content-Type: application/json" \
  -d '{
    "pdas": [
      {"address": "PDA1...", "program_id": "PROG1..."},
      {"address": "PDA2...", "program_id": "PROG2..."}
    ]
  }'

Programs and Patterns

# Get all analyzed programs
curl http://localhost:8080/api/v1/programs

# Get program details and statistics
curl http://localhost:8080/api/v1/programs/{program_id}

# Get PDA patterns for a program
curl http://localhost:8080/api/v1/programs/{program_id}/patterns

Analytics and Reports

# Get database metrics
curl http://localhost:8080/api/v1/analytics/database

# Get pattern distribution
curl http://localhost:8080/api/v1/analytics/patterns

# Get performance metrics
curl http://localhost:8080/api/v1/analytics/performance

Real-World Examples

The tool includes comprehensive examples from major Solana protocols:

📊 SPL Token Examples

Associated Token Accounts: Most common PDA pattern on Solana
Mint Authorities: Program-controlled token minting
Vault Token Accounts: DeFi protocol escrow patterns

🎨 Metaplex NFT Examples

NFT Metadata: Standard NFT information storage
Master Editions: NFT printing and edition control
Collection Metadata: NFT collection organization
Auction House: NFT marketplace structures

🌍 Protocol Examples

Serum DEX: Market authorities and trading structures
Raydium AMM: Liquidity pool management
Marinade Finance: Liquid staking protocol state
Solana Name Service: Domain name resolution
Governance: DAO proposal and voting systems

Each example includes:

✅ Real PDA addresses from mainnet/testnet
🔍 Expected seed patterns with detailed breakdowns
📝 Comprehensive descriptions of functionality
🧪 Automated tests for validation

⚙️ Configuration

Environment Variables

Create a .env file (copy from .env.example) and update as required

🧪 Testing

Running Tests

# Run all tests
make test-all

# Run specific test categories
make test-unit        # Unit tests only
make test-integration # Integration tests only
make test-api        # API endpoint tests
make test-performance # Performance benchmarks

# Run tests with coverage
make test-coverage

# Run example validation
make test-examples

Performance Testing

# Run benchmark tests
cargo bench

# Load test the API
./tests/load_test.py --concurrent 50 --requests 1000

# Profile memory usage
./tests/memory_profile.sh

📊 API Reference

Response Format

All API responses follow this format:

{
  "success": true,
  "data": {
    "pda_info": {
      "address": "Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr",
      "program_id": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL",
      "seeds": [
        {
          "type": "Pubkey",
          "value": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
          "description": "Wallet owner address"
        }
      ],
      "pattern": "WALLET_TOKEN_MINT",
      "confidence": 0.98,
      "analysis_time_ms": 12
    }
  },
  "error": null,
  "timestamp": "2024-01-01T00:00:00Z",
  "request_id": "req_123456789"
}

Complete Endpoint List

PDA Analysis

POST /api/v1/analyze/pda - Analyze a single PDA
POST /api/v1/analyze/pda/batch - Batch analyze multiple PDAs
GET /api/v1/pdas - List analyzed PDAs with pagination
GET /api/v1/pdas/{address} - Get detailed PDA information

Programs

GET /api/v1/programs - List all programs
GET /api/v1/programs/{id} - Get program details
GET /api/v1/programs/{id}/stats - Get program statistics
GET /api/v1/programs/{id}/patterns - Get program PDA patterns

Transactions

GET /api/v1/transactions - List transactions with filters
GET /api/v1/transactions/{signature} - Get transaction details
POST /api/v1/transactions/analyze - Analyze transaction for PDAs

Analytics

GET /api/v1/analytics/database - Database metrics and statistics
GET /api/v1/analytics/patterns - Pattern distribution and trends
GET /api/v1/analytics/performance - Performance metrics and timing

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for detailed guidelines.

Quick Contribution Steps

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Make your changes and add tests
Run the test suite: make test-all
Commit your changes: git commit -m "Add amazing feature"
Push to the branch: git push origin feature/amazing-feature
Submit a pull request

Development Setup

# Install development dependencies
make dev-setup

# Run development server with hot reload
make dev

# Run linting and formatting
make lint
make fmt

# Generate documentation
make docs

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

📞 Support

🐛 Bug Reports: GitHub Issues
💡 Feature Requests: GitHub Discussions
📖 Documentation: Project Wiki
💬 Community: Telegram Channel

Name		Name	Last commit message	Last commit date
Latest commit History 9 Commits
crates		crates
examples		examples
migrations		migrations
scripts		scripts
tests		tests
web		web
.dockerignore		.dockerignore
.env.example		.env.example
.gitignore		.gitignore
API_EXAMPLES.md		API_EXAMPLES.md
CONTRIBUTING.md		CONTRIBUTING.md
Cargo.lock		Cargo.lock
Cargo.toml		Cargo.toml
Dockerfile		Dockerfile
Dockerfile.dev		Dockerfile.dev
Dockerfile.test		Dockerfile.test
IMPLEMENTATION_STATUS.md		IMPLEMENTATION_STATUS.md
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
TESTING.md		TESTING.md
config.toml		config.toml
docker-compose.dev.yml		docker-compose.dev.yml
docker-compose.test.yml		docker-compose.test.yml
docker-compose.yml		docker-compose.yml
test_api.sh		test_api.sh

Folders and files

Latest commit

History

Repository files navigation

Solana PDA Analyzer

Features

📊 Analysis Output Sample

🚀 Quick Start

Prerequisites

Installation

🐳 Docker Setup (Alternative)

💻 Usage

Command Line Interface

Analyze Individual PDAs

Run Real-World Examples

Database Operations

Fetch and Analyze Transactions

Statistics and Reports

🔌 REST API

Analyze PDAs

Programs and Patterns

Analytics and Reports

Real-World Examples

📊 SPL Token Examples

🎨 Metaplex NFT Examples

🌍 Protocol Examples

⚙️ Configuration

Environment Variables

🧪 Testing

Running Tests

Performance Testing

📊 API Reference

Response Format

Complete Endpoint List

PDA Analysis

Programs

Transactions

Analytics

🤝 Contributing

Quick Contribution Steps

Development Setup

📄 License

📞 Support

About

Topics

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages