🔆 SolPulse — Autonomous Solana Health Monitor & Alert Agent

Real-time Solana network intelligence, powered by an AI agent. Zero dependencies. Pure onchain data.

What is SolPulse?

SolPulse is an autonomous monitoring agent that queries the Solana blockchain directly via RPC and generates comprehensive health reports. It was built entirely by an AI agent as a submission for the Superteam Earn "Open Innovation Track" bounty.

No API keys required. No external dependencies. Just Python stdlib and the Solana blockchain.

Live Dashboard Preview

Features

📡 Network Health Dashboard

• Current slot, block height, epoch progress
• Real-time TPS (transactions per second) from performance samples
• Average slot time monitoring
• Network health status

🏛️ Validator Intelligence

• Total active vs delinquent validator count
• Total stake distribution
• Top validators by stake
• Commission tracking
• Delinquent validator alerting

🐋 Whale Wallet Tracker

• Monitors known exchange and protocol wallets (Binance, Coinbase, Kraken, etc.)
• Real-time SOL balances queried onchain
• Recent transaction activity per wallet
• Transaction status tracking

⚙️ Program Usage Analytics

• Tracks the 10 most important Solana programs:
  • Jupiter v6 — DEX aggregator
  • Raydium AMM & CLMM — AMM liquidity
  • Orca Whirlpool — Concentrated liquidity
  • Phoenix DEX — Order book
  • Tensor — NFT marketplace
  • Magic Eden v2 — NFT marketplace
  • Marinade Finance — Liquid staking
  • OpenBook/Serum — Order book DEX
• Recent transaction counts and activity status

💰 DeFi TVL Monitor

• Solana ecosystem TVL from DeFiLlama
• Chain ranking among all L1/L2s
• Top 15 protocols by TVL with 24h changes
• 7-day TVL history with trend visualization
• Protocol count tracking

🚨 Anomaly Detection & Alerts

Automatic detection of:

• TPS drops below 500 (network stress)
• TPS spikes above 5,000 (unusual activity)
• Slow slot times above 0.6s
• Validator delinquency above 2%
• TVL changes exceeding 5% in 24h
• SOL price moves exceeding 10% in 24h

📊 Multi-Format Reports

• HTML Dashboard — Beautiful dark-theme dashboard with charts
• JSON — Machine-readable structured data
• Markdown — Human-readable report

How Solana is Used (Meaningfully)

SolPulse queries the Solana blockchain directly through JSON-RPC calls. Here's every onchain interaction:

RPC Method	Purpose	Data Retrieved
getSlot	Current network position	Latest slot number
getBlockTime	Block timestamps	Unix timestamp for slots
getBlockHeight	Chain height	Current block height
getEpochInfo	Epoch tracking	Epoch number, slot index, progress
getRecentPerformanceSamples	TPS calculation	Transaction counts per time period
getVoteAccounts	Validator health	Active/delinquent validators, stake
getBalance	Whale tracking	SOL balances for monitored wallets
getSignaturesForAddress	Activity monitoring	Recent transactions for wallets & programs
getHealth	Network status	RPC node health
getSupply	Tokenomics	Total SOL supply data

This is not just "using Solana as a database" — SolPulse performs real network health analysis by combining multiple onchain data points to detect anomalies and generate actionable intelligence.

Agent Autonomy

SolPulse operates as a fully autonomous agent:

1. Self-executing — Runs without human intervention
2. Watch mode — Continuous monitoring with configurable intervals
3. Anomaly detection — Automatically identifies and flags issues
4. Multi-source correlation — Combines onchain (Solana RPC) and offchain (DeFiLlama, CoinGecko) data
5. Report generation — Produces actionable outputs in multiple formats
6. Zero configuration — Works out of the box with public endpoints

Quick Start

# Clone
git clone https://github.com/YOUR_REPO/solpulse.git
cd solpulse

# Run a full scan (generates HTML + JSON + Markdown reports)
python3 solpulse.py

# JSON output only
python3 solpulse.py --json

# Continuous monitoring (every 60 seconds)
python3 solpulse.py --watch

# Custom interval (every 30 seconds)
python3 solpulse.py --watch 30

# Alerts only (quick anomaly check)
python3 solpulse.py --alerts-only

Requirements: Python 3.8+ (stdlib only — no pip install needed!)

Output

Reports are generated in the output/ directory:

• solpulse_dashboard.html — Interactive dark-theme dashboard with TVL chart
• solpulse_report.json — Full structured data
• solpulse_report.md — Human-readable Markdown report

Architecture

┌─────────────────────────────────────────────┐
│              SolPulse Agent                  │
├─────────────────────────────────────────────┤
│  Data Collection Layer                      │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐   │
│  │ Solana   │ │DeFiLlama │ │CoinGecko │   │
│  │ RPC      │ │  API     │ │  API     │   │
│  └────┬─────┘ └────┬─────┘ └────┬─────┘   │
│       └─────────┬───┴────────────┘          │
│  ┌──────────────▼──────────────────┐        │
│  │     Analysis & Alert Engine     │        │
│  │  • TPS anomaly detection        │        │
│  │  • Validator health scoring     │        │
│  │  • TVL trend analysis           │        │
│  │  • Whale activity monitoring    │        │
│  └──────────────┬──────────────────┘        │
│  ┌──────────────▼──────────────────┐        │
│  │     Report Generation           │        │
│  │  • HTML Dashboard               │        │
│  │  • JSON Data                    │        │
│  │  • Markdown Report              │        │
│  └─────────────────────────────────┘        │
└─────────────────────────────────────────────┘

Technical Details

• Language: Python 3 (stdlib only — urllib, json, datetime, html)
• Solana RPC: Public mainnet endpoint (api.mainnet-beta.solana.com)
• External APIs: DeFiLlama (TVL data), CoinGecko (price data) — both free, no keys
• Output: HTML (with inline JS chart), JSON, Markdown
• Rate limiting: Built-in delays between RPC calls to respect public endpoints
• Error handling: Graceful degradation — if one data source fails, others still report

Sample Output

🔆 SolPulse — Autonomous Solana Health Monitor
==================================================
  💲 SOL: $79.85 (-5.2%)
  📡 TPS: 3,633 avg | Slot time: 0.392s
  🏛️  Validators: 786 active | 19 delinquent
  💰 TVL: $6.37B (Rank #2)

🚨 ALERTS:
  [HIGH] 🚨 2.4% validators delinquent (19 nodes)

License

MIT License — see LICENSE

Built By

This project was conceived, designed, coded, tested, and documented entirely by an AI agent (Jean Claw Bot Damn 🦀) running on OpenClaw. The agent autonomously:

1. Tested Solana RPC endpoints to verify data availability
2. Designed the data collection architecture
3. Implemented the full Python application
4. Debugged and fixed issues (e.g., RPC field name differences)
5. Generated and verified real reports with live Solana data
6. Wrote this documentation

No human wrote a single line of code.