Instantly analyze any Solana token for security risks. The Solana Sentinel combines live on-chain data with AI-powered sentiment analysis to deliver a comprehensive, easy-to-understand risk report.
The Solana Sentinel is a cutting-edge web application that provides real-time, AI-driven risk analysis for Solana tokens. By synthesizing live on-chain data with decentralized AI sentiment analysis, it generates a comprehensive "Sentinel Score" to help users identify potentially malicious projects before they invest.
- Try it live: the-solana-sentinel.vercel.app
- Watch the demo: YouTube
- 🤖 Gemini-Powered Verdict: Leverages Google's Gemini model via Genkit to provide a nuanced, human-readable summary of a token's overall risk profile.
- 🔗 Real-Time On-Chain Forensics: Fetches and analyzes critical on-chain metrics from the Helius API, including:
- ✅ Contract Authorities: Checks if developers have renounced control over minting and freezing tokens.
- 📊 Holder Concentration: Calculates the supply percentage held by top wallets to detect whale dominance.
- 💧 Liquidity Analysis: Assesses the deployer's share of the liquidity pool to identify potential rug-pull risks.
- ☁️ Decentralized AI Sentiment: Offloads social media sentiment analysis to the Nosana Network, a decentralized GPU grid, for unbiased and scalable compute.
- 💯 Holistic Sentinel Score: Our proprietary algorithm synthesizes on-chain and off-chain data into a single, intuitive risk score (0-100).
- 📈 Dynamic & Interactive Reports: Presents the full analysis in a clean, responsive, and beautifully designed interface built with Next.js and ShadCN UI.
The application follows a simple but powerful serverless architecture to deliver real-time analysis on demand.
User Input (Token Address) ───> Server Action (Next.js) ───> Data Fetching ([Helius API] & [Nosana Network]) ───> AI Analysis (Google Genkit) ───> Final Report (UI)
- Framework: Next.js (App Router, Server Actions)
- Language: TypeScript
- Styling: Tailwind CSS & ShadCN UI
- AI Toolkit: Google Genkit (with Gemini)
- On-Chain Data: Helius API
- Decentralized Compute: Nosana Network
- Hosting: Vercel / Firebase Hosting
Follow these instructions to get a local copy up and running for development and testing.
- Node.js (v18 or later)
- npm or yarn
- Docker Desktop (must be running)
- Nosana CLI installed globally (
npm install -g @nosana/cli)
git clone https://github.com/iamaanahmad/The-Solana-Sentinel.git
cd The-Solana-Sentinelnpm installCreate a new file named .env by copying .env.example. Then, fill in the required secret keys:
# Get your free API key from https://www.helius.dev/
HELIUS_API_KEY="your-helius-api-key"
# This will be generated in the Nosana Job Deployment step below
NOSANA_JOB_ID="your-nosana-job-id"The sentiment analysis script is located in the nosana-job directory. You need to deploy it to the Nosana Network to get your NOSANA_JOB_ID.
a. Navigate to the Job Directory
cd nosana-jobb. Build & Push the Docker Image
(Replace your-docker-hub-username with your actual Docker Hub username.)
# Make sure Docker Desktop is running!
docker build -t your-docker-hub-username/solana-sentinel-sentiment:v1 .
docker push your-docker-hub-username/solana-sentinel-sentiment:v1c. Update nosana.json
Open nosana-job/nosana.json and replace the placeholder image value with the name of the image you just pushed.
d. Publish the Job to Nosana
This command deploys your job and returns its unique ID.
nosana job publishe. Update Environment File
Copy the Job Address from the command output and paste it as the NOSANA_JOB_ID in your root .env file.
Navigate back to the project root and start the app.
cd ..
npm run devOpen http://localhost:3000 in your browser to see the application.
This project is licensed under the MIT License. See the LICENSE file for details.
Made with ❤️ for the future of decentralized AI.
