OpenSVM - Solana Virtual Machine Explorer

OpenSVM is a comprehensive blockchain explorer for the Solana ecosystem, providing detailed insights into transactions, blocks, accounts, programs, and tokens on the Solana blockchain.

Overview

OpenSVM offers a modern, user-friendly interface for exploring the Solana blockchain with advanced features like transaction visualization, wallet path finding, and AI-powered analysis. The project aims to make blockchain data more accessible and understandable for developers, users, and researchers.

Key Features

• Blockchain Data Browsing: Explore blocks, transactions, accounts, programs, and tokens
• Transaction Visualization: Interactive visualizations of transaction flows and relationships
• Wallet Path Finding: Discover connections between wallets through token transfers
• AI Assistant: Get natural language explanations of blockchain data and transactions
• Network Statistics: Monitor Solana network performance and health metrics
• Token Analytics: Track token transfers, balances, and activities

Technology Stack

• Frontend: Next.js, React, TypeScript, Tailwind CSS
• Blockchain Integration: Solana Web3.js, SPL Token
• Data Visualization: D3.js, Cytoscape, Three.js, Chart.js
• AI Components: LLM integration via Together AI
• State Management: XState for complex workflows
• Vector Database: Qdrant for similarity search

Getting Started

Prerequisites

• Node.js 18+ or Bun
• Environment variables (see .example.env)

Installation

# Clone the repository
git clone https://github.com/your-org/opensvm.git
cd opensvm

# Install dependencies
npm install
# or
bun install

# Set up environment variables
cp .example.env .env.local
# Edit .env.local with your configuration

# Start the development server
npm run dev
# or
bun run dev

Building for Production

npm run build
npm run start
# or
bun run build
bun run start

Documentation

For more detailed documentation, see:

• Architecture Documentation - 📚 Comprehensive architectural documentation
  • System Overview - High-level system architecture
  • Component Architecture - Component breakdown and relationships
  • Architecture Decision Records - Architectural decisions and rationale
  • Contributing Guide - How to maintain architecture docs
• Features - Detailed feature descriptions
• API Reference - API endpoints and usage
• Development Guide - Development setup and guidelines

🏗️ Architecture Overview

OpenSVM is built with a modular, scalable architecture:

graph TB
    subgraph "Frontend Layer"
        UI[Next.js App]
        COMPONENTS[React Components]
        VISUALIZATIONS[D3.js Visualizations]
    end
    
    subgraph "API Layer"
        ROUTES[API Routes]
        MIDDLEWARE[Middleware]
        CACHE[Caching]
    end
    
    subgraph "Data Layer"
        SOLANA[Solana Integration]
        VECTOR[Vector Database]
        AI[AI Services]
    end
    
    UI --> ROUTES
    ROUTES --> SOLANA
    ROUTES --> VECTOR
    ROUTES --> AI

Loading

Key Architectural Principles:

• Modularity: Clear separation of concerns with well-defined interfaces
• Performance: Optimized for fast response times and efficient resource usage
• Scalability: Designed for horizontal scaling and growth
• Maintainability: Comprehensive documentation and testing
• Security: Security-first design with proper access controls

For detailed architectural information, see our Architecture Documentation.

License

MIT License