Skip to content

Abhiram-Kasu/SolSignal

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

4 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿš€ SolSignal

AI-Powered On-Chain Intelligence & Rug Pull Prediction Platform for Solana

Built at HackCU 2026 .NET 10 SvelteKit MongoDB Solana Gemini AI


๐Ÿ† HackCU 2026

SolSignal was built entirely in under 24 hours at HackCU 2026 โ€” the University of Colorado Boulder's annual hackathon. The full-stack application, AI integrations, blockchain data pipeline, and interactive dashboard were all designed, built, and shipped within a single hackathon day.


๐Ÿ“– Overview

SolSignal is an AI-powered analytics platform that brings institutional-grade intelligence to Solana blockchain activity. Think Bloomberg Terminal meets AI โ€” built for DeFi traders, token researchers, and blockchain enthusiasts who need to act fast on real on-chain signals.

The platform ingests live Solana transaction data, builds behavioral wallet profiles, and uses Google Gemini AI to surface patterns that indicate market opportunities, coordinated whale activity, or outright fraudulent tokens โ€” all in real time.


โœจ Features

๐Ÿฆ Wallet Credit Scoring

Assign every Solana wallet a 300โ€“900 behavioral reputation score โ€” similar to a financial credit score โ€” based on:

  • Historical profitability and ROI
  • Rug pull participation history
  • Token holding and exit patterns
  • Early-adopter behavior
  • Transaction frequency and volume
  • Whale classification
Wallet: 9xF...ab2
Credit Score: 812
Classification: Whale Early Adopter
Traits:
  โ€ข Early buyer of successful tokens
  โ€ข Low rug exposure
  โ€ข High ROI history

๐Ÿ‹ Whale Detection & Alerts

Detect coordinated accumulation by elite wallets in real time:

Whale Accumulation Detected
Token: XYZ
Elite Wallets: 4
Accumulation Window: 2 hours
Predicted Movement: Bullish
Confidence: 72%

๐Ÿ” Rug Pull Risk Prediction

AI-powered token analysis scoring the probability of a rug pull before it happens:

Token Risk Analysis โ€” SCAMCOIN
Rug Pull Risk: HIGH
  โ€ข 92% token supply controlled by 3 wallets
  โ€ข Liquidity unlock scheduled in 4 hours
  โ€ข Suspicious early wallet cluster
Confidence: 88%

๐Ÿ“Š Interactive Dashboard

  • Real-time signal feed with whale alerts and market signals
  • Wallet network graph (Cytoscape.js) showing transaction relationships
  • Transaction activity charts (Chart.js)
  • Three.js 3D animated blockchain background
  • Server-Sent Events (SSE) streaming for real-time analysis progress

๐Ÿ—๏ธ Architecture

                 +----------------+
                 |   SvelteKit UI  |
                 |  TailwindCSS   |
                 +--------+-------+
                          |
                     REST API / SSE
                          |
                 +--------v---------+
                 | .NET 10 Backend  |
                 |  Minimal APIs    |
                 +--------+---------+
                          |
      +-------------------+-------------------+
      |                   |                   |
+-----v-----+      +------v------+      +-----v------+
| Solana RPC|      | Gemini API  |      | MongoDB    |
| Blockchain|      | AI Analysis |      | Atlas DB   |
+-----------+      +-------------+      +------------+

๐Ÿ› ๏ธ Tech Stack

Backend

Layer Technology
Framework .NET 10 Minimal APIs (C#)
Database MongoDB Atlas (Driver v3.7.0)
Blockchain Solana RPC (raw HTTP + System.Text.Json)
AI / LLM Google Gemini API (gemini-2.0-flash)
HTTP Client System.Net.Http.HttpClient

Frontend

Layer Technology
Framework SvelteKit v2 (Svelte 5 runes)
Language TypeScript 5
Styling TailwindCSS v4
Bundler Vite v7
Charts Chart.js v4
Graph Visualization Cytoscape.js v3
3D Background Three.js
Icons lucide-svelte

External Services

Service Purpose
Google Gemini API AI wallet scoring, rug pull detection, whale signals
Solana Mainnet RPC Live blockchain data
Helius RPC (optional) Fallback RPC to mitigate rate limits
MongoDB Atlas Cloud-hosted database

๐Ÿ“ Project Structure

SolSignal/
โ”œโ”€โ”€ SolSignalBackend/               # .NET 10 backend
โ”‚   โ”œโ”€โ”€ Program.cs                  # Minimal API routes + DI setup
โ”‚   โ”œโ”€โ”€ Models/
โ”‚   โ”‚   โ”œโ”€โ”€ Wallet.cs
โ”‚   โ”‚   โ”œโ”€โ”€ WalletScore.cs
โ”‚   โ”‚   โ”œโ”€โ”€ Transaction.cs
โ”‚   โ”‚   โ”œโ”€โ”€ Token.cs
โ”‚   โ”‚   โ”œโ”€โ”€ MarketSignal.cs
โ”‚   โ”‚   โ””โ”€โ”€ RugPullAnalysis.cs
โ”‚   โ”œโ”€โ”€ Services/
โ”‚   โ”‚   โ”œโ”€โ”€ SolanaService.cs        # Solana RPC client
โ”‚   โ”‚   โ”œโ”€โ”€ GeminiService.cs        # Gemini AI integration
โ”‚   โ”‚   โ”œโ”€โ”€ WalletAnalysisService.cs
โ”‚   โ”‚   โ”œโ”€โ”€ RugPullService.cs
โ”‚   โ”‚   โ””โ”€โ”€ MarketSignalService.cs
โ”‚   โ”œโ”€โ”€ Repositories/
โ”‚   โ”‚   โ”œโ”€โ”€ WalletRepository.cs
โ”‚   โ”‚   โ”œโ”€โ”€ TokenRepository.cs
โ”‚   โ”‚   โ”œโ”€โ”€ SignalRepository.cs
โ”‚   โ”‚   โ””โ”€โ”€ CacheRepository.cs
โ”‚   โ””โ”€โ”€ Infrastructure/
โ”‚       โ”œโ”€โ”€ MongoContext.cs
โ”‚       โ””โ”€โ”€ Config.cs
โ”‚
โ”œโ”€โ”€ solsignal_frontend/             # SvelteKit frontend
โ”‚   โ””โ”€โ”€ src/
โ”‚       โ”œโ”€โ”€ lib/
โ”‚       โ”‚   โ”œโ”€โ”€ api/client.ts       # API client
โ”‚       โ”‚   โ”œโ”€โ”€ components/         # Svelte UI components
โ”‚       โ”‚   โ””โ”€โ”€ types/index.ts      # TypeScript interfaces
โ”‚       โ””โ”€โ”€ routes/
โ”‚           โ”œโ”€โ”€ +page.svelte        # Dashboard
โ”‚           โ”œโ”€โ”€ wallet/             # Wallet Analyzer
โ”‚           โ”œโ”€โ”€ token/              # Token Analyzer
โ”‚           โ””โ”€โ”€ whale-tracker/      # Whale Tracker
โ”‚
โ”œโ”€โ”€ DesignDocument.md               # Original project spec
โ””โ”€โ”€ DEV_NOTES.md                    # Build log & architecture notes

โšก Quick Start

Prerequisites

1. Clone & Configure

git clone https://github.com/Abhiram-Kasu/SolSignal.git
cd SolSignal

Edit SolSignalBackend/appsettings.json with your credentials:

{
  "MongoDB": {
    "ConnectionString": "mongodb://localhost:27017",
    "DatabaseName": "solsignal"
  },
  "Gemini": {
    "ApiKey": "YOUR_GEMINI_API_KEY",
    "Model": "gemini-2.0-flash",
    "BaseUrl": "https://generativelanguage.googleapis.com/v1beta"
  },
  "Solana": {
    "RpcUrl": "https://api.mainnet-beta.solana.com",
    "HeliusApiKey": "YOUR_HELIUS_API_KEY"
  }
}

๐Ÿ’ก Tip: Store secrets in a gitignored appsettings.Secrets.json file in the same directory.

2. Start the Backend

cd SolSignalBackend
dotnet restore
dotnet run

Backend runs at http://localhost:5068

# Verify it's healthy
curl http://localhost:5068/api/health
# โ†’ {"status":"healthy","service":"SolSignal API","timestamp":"..."}

3. Start the Frontend

cd solsignal_frontend
npm install
npm run dev

Frontend runs at http://localhost:5173 โ€” open it in your browser.


๐ŸŒ API Reference

Wallet Endpoints

Method Endpoint Description
GET /api/wallet/{address} Full wallet intelligence report
GET /api/wallet/{address}/stream Streaming report via SSE
GET /api/wallet/{address}/score Wallet credit score (300โ€“900)
GET /api/wallets/top Top-scored wallets

Token Endpoints

Method Endpoint Description
GET /api/token/{mint}/info Token metadata
GET /api/token/{mint}/rugrisk Rug pull risk analysis
GET /api/token/{mint}/rugrisk/stream Streaming rug analysis via SSE
GET /api/tokens/trending Tokens with unusual activity
GET /api/tokens/highrisk High-risk token list

Signal Endpoints

Method Endpoint Description
GET /api/signals Active market signals
GET /api/signals/whale Whale-specific signals
GET /api/signals/highconfidence High-confidence signals only
GET /api/signals/token/{mint} Signals for a specific token
POST /api/signals/detect/{mint} Trigger whale detection for token
POST /api/signals/detect/{mint}/stream Streaming whale detection via SSE
POST /api/signals/generate Bulk signal generation

System Endpoints

Method Endpoint Description
GET /api/health Health check
GET /api/cache/stats Cache statistics

๐Ÿ–ฅ๏ธ Frontend Pages

Page Route Description
Dashboard / Signal feed, whale alerts, trending tokens
Wallet Analyzer /wallet Input a wallet address for AI analysis
Wallet Report /wallet/{address} Full credit score, traits, transaction graph
Token Analyzer /token Input a token mint for rug pull analysis
Token Report /token/{mint} Rug risk level, supply distribution, AI summary
Whale Tracker /whale-tracker Live whale accumulation detection

๐Ÿ—„๏ธ Database Schema

Collection Purpose
wallets Wallet profiles (address, first seen, tx count, volume)
wallet_scores AI credit scores with classification and traits
transactions Parsed Solana transactions
tokens SPL token metadata and holder distribution
signals Whale and market signals
rugpull_analysis Rug pull risk assessments
analysis_cache 30-minute analysis result cache

โš ๏ธ Important Notes

  • Solana RPC Rate Limits โ€” The public api.mainnet-beta.solana.com endpoint has aggressive rate limits. For heavy use, configure a dedicated RPC provider (Helius, QuickNode, Alchemy).
  • Gemini Free Tier Quota โ€” The Gemini free tier has daily request limits. When exhausted, SolSignal automatically falls back to heuristic-based analysis (the app remains fully functional).
  • Heuristic Fallbacks โ€” Every AI feature has a rule-based fallback. SolSignal works even without a Gemini API key, just without AI-generated summaries.
  • Caching โ€” Wallet reports and token analyses are cached for 30 minutes to reduce RPC and AI calls.

๐Ÿ”ฎ Future Work

  • Real-time WebSocket updates for live price feeds
  • Solana Reputation NFTs (on-chain wallet score badge)
  • AI Investment Agent with autonomous signal recommendations
  • Background data ingestion worker for proactive signal discovery
  • API rate limiting middleware
  • Docker / one-click deployment setup
  • Metaplex token metadata enrichment for accurate token names/symbols

๐Ÿ… Built at HackCU 2026

SolSignal was created from scratch in under 24 hours at HackCU 2026, the University of Colorado Boulder's annual hackathon. The project encompasses:

  • A full .NET 10 backend with 5 services and 19+ REST endpoints
  • A SvelteKit/TypeScript frontend with 11 custom components and 4 data visualization libraries
  • Live Solana blockchain data ingestion via direct RPC calls
  • Google Gemini AI integration with circuit-breaker pattern and heuristic fallbacks
  • Server-Sent Events (SSE) streaming for real-time analysis progress
  • MongoDB Atlas persistence with indexed collections and in-memory caching

๐Ÿ“„ License

This project was created as a hackathon submission. See individual package licenses for third-party dependencies.

About

An AI-Powered Wallet and Token analyzer

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors