Skip to content

The Solana Sentinel is a cutting-edge web application that provides real-time, AI-driven risk analysis for Solana tokens. By combining live on-chain data with decentralized AI sentiment analysis and x402 protocol payment verification.

License

Notifications You must be signed in to change notification settings

iamaanahmad/The-Solana-Sentinel

Repository files navigation

The Solana Sentinel 🛡️

Your AI-Powered Shield for Secure Solana Trading

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 Banner

Next.js TypeScript Tailwind CSS Gemini Nosana

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.

🔗 Live Demo & Video


✨ Core Features

  • 🤖 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.

⚙️ How It Works

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)


🚀 Technology Stack

  • 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

🛠️ Getting Started

Follow these instructions to get a local copy up and running for development and testing.

Prerequisites

  • Node.js (v18 or later)
  • npm or yarn
  • Docker Desktop (must be running)
  • Nosana CLI installed globally (npm install -g @nosana/cli)

1. Clone the Repository

git clone https://github.com/iamaanahmad/The-Solana-Sentinel.git
cd The-Solana-Sentinel

2. Install Dependencies

npm install

3. Set Up Environment Variables

Create 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"

4. Deploy the Nosana Sentiment Job

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-job

b. 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:v1

c. 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 publish

e. Update Environment File

Copy the Job Address from the command output and paste it as the NOSANA_JOB_ID in your root .env file.

5. Run the Development Server

Navigate back to the project root and start the app.

cd ..
npm run dev

Open http://localhost:3000 in your browser to see the application.

📄 License

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

Made with ❤️ for the future of decentralized AI.

About

The Solana Sentinel is a cutting-edge web application that provides real-time, AI-driven risk analysis for Solana tokens. By combining live on-chain data with decentralized AI sentiment analysis and x402 protocol payment verification.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Contributors 2

  •  
  •