ChainProbe

Advanced Blockchain Forensic Analysis Platform for Solana

Investigate transactions, analyze wallet behavior, and detect suspicious patterns on the Solana blockchain

Overview

ChainProbe is a comprehensive blockchain forensic analysis platform specifically designed for the Solana ecosystem. It empowers users with advanced tools to investigate transaction flows, analyze wallet behavior patterns, identify suspicious activities, and perform comprehensive security audits on tokens and smart contracts.

Target Audience

Blockchain Investigators - Track illicit funds and investigate fraudulent activities
Security Researchers - Analyze suspicious patterns and wallet behaviors
DeFi Teams - Conduct thorough due diligence on protocols and tokens
Token Projects - Verify smart contract security and tokenomics
Individual Users - Check wallet security and assess token safety

Features

Core Analysis Tools

Feature	Description	Key Benefits
Transaction Flow Visualization	Interactive 3D graph visualization of fund movements	• Real-time transaction mapping • Identify money laundering patterns • Trace fund origins and destinations
Wallet Analysis	Comprehensive wallet behavior and risk assessment	• Transaction history analysis • Risk scoring with ML algorithms • Activity pattern detection
Transaction Clustering	Group related transactions to reveal hidden networks	• Discover wallet clusters • Identify coordinated activities • Network analysis visualization
Pattern Analysis	Detect suspicious patterns and anomalies	• Wash trading detection • Circular transaction identification • Automated risk flagging
Entity Labels	Identify and categorize blockchain entities	• Exchange identification • Protocol classification • Suspicious actor flagging

Token Security Suite

Tool	Purpose	Integration
Token Analyzer	Comprehensive token security assessment
Trending Tokens	Monitor popular tokens with real-time risk scoring
New Tokens	Track and assess newly created tokens
Verified Tokens	Directory of verified secure tokens

Advanced Security Tools

Smart Contract Scanner - Automated vulnerability detection and security analysis
Bridge Monitor [Beta] - Cross-chain bridge transaction monitoring with risk assessment
Risk Assessment Engine - Powered by Webacy for comprehensive threat analysis

Technology Stack

Frontend Architecture

┌─────────────────┬─────────────────┬─────────────────┐
│   Framework     │   Styling       │   State Mgmt    │
├─────────────────┼─────────────────┼─────────────────┤
│ React 18        │ Tailwind CSS    │ React Query     │
│ TypeScript      │ Framer Motion   │ Context API     │
│ Vite            │ Custom Themes   │ Local Storage   │
└─────────────────┴─────────────────┴─────────────────┘

Visualization & UI

3D Graphs: Force Graph React, Three.js
Charts: Chart.js with date adapters
Flow Diagrams: ReactFlow for network visualization
Animations: Framer Motion for smooth interactions
Icons: React Icons (Remix Icon set)

Backend & APIs

┌─────────────────┬─────────────────┬─────────────────┐
│   Blockchain    │   Security      │   Data Sources  │
├─────────────────┼─────────────────┼─────────────────┤
│ Solana Web3.js  │ Webacy API      │ Helius RPC      │
│ Wallet Adapter  │ RugCheck API    │ Dune Analytics  │
│ RPC Endpoints   │ Jupiter API     │ Solscan API     │
└─────────────────┴─────────────────┴─────────────────┘

Development & Deployment

Build Tool: Vite with TypeScript
Deployment: Vercel (Frontend), Render (Backend)
Code Quality: ESLint, TypeScript strict mode
Version Control: Git with conventional commits

Installation & Setup

Prerequisites

Quick Start

Clone the repository

git clone https://github.com/ge0frey/chainprobe.git
cd chainprobe

Install dependencies

# Frontend dependencies
npm install

# Backend dependencies (if running locally)
cd backend && npm install

Environment Configuration

Frontend (.env):

# Backend API URL
VITE_API_BASE_URL=http://localhost:3001

# Solana Network Configuration
VITE_SOLANA_NETWORK=mainnet-beta

Backend (backend/.env):

# Server Configuration
PORT=3001
FRONTEND_URL=http://localhost:5173

# API Keys (Required for full functionality)
HELIUS_API_KEY=your_helius_api_key_here
DD_API_KEY=your_webacy_dd_api_key_here
DUNE_API_KEY=your_dune_api_key_here

Start the application

# Start frontend (from root directory)
npm run dev

# Start backend (from backend directory - new terminal)
cd backend && npm run dev

Access the application
- Frontend: http://localhost:5173
- Backend API: http://localhost:3001

API Keys Setup

Service	Required	Purpose	Get API Key
Helius	Yes	Solana RPC & enhanced transactions	helius.xyz
Webacy	Yes	Risk assessment & security analysis	webacy.com
Dune	Optional	Token balance data	dune.com

Usage Guide

🔍 Transaction Flow Analysis

Visualize fund movements in 3D interactive graphs

graph LR
    A[Enter Wallet Address] --> B[Generate Flow Graph]
    B --> C[Interactive 3D Visualization]
    C --> D[Node Details & Filters]
    D --> E[Risk Assessment]

Key Features:

Real-time transaction mapping
Suspicious pattern highlighting
Time-based filtering
Export capabilities

💼 Wallet Risk Analysis

Comprehensive wallet behavior assessment

Analysis Type	Data Points	Risk Factors
Transaction History	Volume, frequency, patterns	Unusual activity spikes
Connected Entities	Known exchanges, protocols	Suspicious interactions
Token Holdings	Portfolio diversity, values	High-risk token exposure
Activity Patterns	Time-based behavior	Bot-like patterns

🛡️ Token Security Analysis

Multi-layered token security assessment

📊 Token Analysis Pipeline
┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│   Mint      │ => │   RugCheck  │ => │   Risk      │
│   Address   │    │   Analysis  │    │   Report    │
└─────────────┘    └─────────────┘    └─────────────┘
       │                   │                   │
       v                   v                   v
 Verify Address     Contract Audit      Score & Flags

Assessment Categories:

Contract vulnerabilities
Liquidity analysis
Holder distribution
Creator background
Market manipulation risks

Architecture Overview

Component Structure

chainprobe/
├── 🎯 src/components/           # React components
│   ├── 📊 Dashboard.tsx         # Main overview dashboard
│   ├── 🔄 TransactionFlow.tsx   # 3D transaction visualization
│   ├── 💼 WalletAnalysis.tsx    # Wallet behavior analysis
│   ├── 🛡️ TokenSecurity/        # Token analysis suite
│   ├── 🔍 PatternAnalysis.tsx   # Suspicious pattern detection
│   └── 🌐 ui/                   # Reusable UI components
├── ⚙️ src/services/             # API integrations
├── 🖥️ backend/                  # Express.js API proxy
└── 📁 public/                   # Static assets

Data Flow Architecture

graph TB
    A[ChainProbe Frontend] --> B[Backend API Proxy]
    B --> C[Helius RPC]
    B --> D[Webacy API]
    B --> E[RugCheck API]
    B --> F[Dune Analytics]
    
    C --> G[Solana Blockchain]
    D --> H[Risk Database]
    E --> I[Token Registry]
    F --> J[Analytics DB]

API Integration Matrix

Service	Purpose	Rate Limits	Caching
Helius	Solana RPC & enhanced transactions	5000 req/min	Redis, 30s
Webacy	Risk assessment & sanctions	1000 req/min	Local, 5min
RugCheck	Token security analysis	500 req/min	Redis, 1hr
Dune	Token balance analytics	100 req/min	Local, 15min

Security Features

Rate Limiting: Implemented on all API endpoints
Request Validation: Input sanitization and validation
Error Handling: Graceful fallbacks for API failures
CORS Protection: Configured for production deployment

Contributing

We welcome contributions from the community! Here's how you can help improve ChainProbe.

Development Guidelines

Getting Started

Fork the repository and clone your fork

Create a feature branch from main

git checkout -b feature/your-feature-name

Install dependencies and set up your environment
Make your changes following our coding standards
Test your changes thoroughly
Submit a pull request with a clear description

Code Standards

TypeScript: All new code must be written in TypeScript
Conventional Commits: Use conventional commit messages
Component Structure: Follow established patterns in /src/components/
API Integration: Add new services to /src/services/
Error Handling: Implement proper error boundaries and fallbacks

Areas for Contribution

Area	Difficulty	Description
UI/UX Improvements	🟢 Beginner	Enhance existing components and layouts
API Integrations	🟡 Intermediate	Add new blockchain data sources
Security Features	🔴 Advanced	Implement advanced risk detection algorithms
Performance	🟡 Intermediate	Optimize data processing and visualization
Documentation	🟢 Beginner	Improve guides and API documentation

Deployment

Production Deployment

Frontend (Vercel):

# Automatic deployment from main branch
# Environment variables configured in Vercel dashboard

Backend (Render):

# Automatic deployment from main branch
# Environment variables configured in Render dashboard

Environment Variables

Production Frontend:

VITE_API_BASE_URL=https://chainprobe-backend.onrender.com
VITE_SOLANA_NETWORK=mainnet-beta

Production Backend:

NODE_ENV=production
FRONTEND_URL=https://chainprobe.vercel.app
# API keys configured securely

Performance Considerations

Caching Strategy: Redis for API responses, browser cache for static assets
Rate Limiting: Exponential backoff for API requests
Code Splitting: Dynamic imports for heavy visualization components
Bundle Optimization: Tree shaking and chunk splitting with Vite

License

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

Acknowledgments

APIs & Services

Helius - Enhanced Solana RPC and transaction data
Webacy - Web3 security and risk assessment
RugCheck - Token security analysis
Dune Analytics - Blockchain analytics and data

Technology Partners

Solana - High-performance blockchain platform
Vercel - Frontend deployment and hosting
Render - Backend API hosting

Built for the Solana ecosystem
_{Empowering blockchain security and transparency}

Name		Name	Last commit message	Last commit date
Latest commit History 129 Commits
backend		backend
public		public
src		src
.env.example		.env.example
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
eslint.config.js		eslint.config.js
index.html		index.html
package-lock.json		package-lock.json
package.json		package.json
postcss.config.js		postcss.config.js
tailwind.config.js		tailwind.config.js
tsconfig.app.json		tsconfig.app.json
tsconfig.json		tsconfig.json
tsconfig.node.json		tsconfig.node.json
vite.config.ts		vite.config.ts

License

Ge0frey/chainprobe

Folders and files

Latest commit

History

Repository files navigation

ChainProbe

Advanced Blockchain Forensic Analysis Platform for Solana

Overview

Target Audience

Features

Core Analysis Tools

Token Security Suite

Advanced Security Tools

Technology Stack

Frontend Architecture

Visualization & UI

Backend & APIs

Development & Deployment

Installation & Setup

Prerequisites

Quick Start

API Keys Setup

Usage Guide

🔍 Transaction Flow Analysis

💼 Wallet Risk Analysis

🛡️ Token Security Analysis

Architecture Overview

Component Structure

Data Flow Architecture

API Integration Matrix

Security Features

Contributing

Development Guidelines

Getting Started

Code Standards

Areas for Contribution

Deployment

Production Deployment

Environment Variables

Performance Considerations

License

Acknowledgments

APIs & Services

Technology Partners

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Languages

Packages