Chronolapse411/sicarius-guard

**Solana Token & NFT Safety Oracle for AI Agents & Trading Bots**
Real-time token and NFT safety analysis combining byte-level on-chain inspection, LP lock verification, deployer reputation scoring, market intelligence, and NFT fraud detection. Built for autonomous AI agents, MCP-enabled LLMs, and trading infrastructure.
> *"Don't trade blind. Query SicariusGuard before every swap."*
🌐 Live API: https://sicarius-guard-640545264957.us-east4.run.app
---
📑 Table of Contents
- What It Does
- Quick Start
- API Endpoints
- MCP Server (for AI Agents)
- Architecture
- x402 Payment Protocol
- Configuration
- Performance
- Tech Stack
- Why SicariusGuard?
- Related MCP Servers
- Links
🔍 What It Does
SicariusGuard performs **12 layers of safety analysis** on any Solana SPL token or NFT:
On-Chain Safety (Layers 1-5)
| Layer | Source | Detection |
|-------|--------|-----------|
| 🔓 **Mint Authority** | Raw SPL mint bytes | Can deployer print infinite tokens? |
| 🧊 **Freeze Authority** | SPL layout offset 46 | Can deployer freeze any wallet? |
| ⚠️ **Token-2022 Extensions** | Extension type scan | PermanentDelegate, TransferHook, ConfidentialTransfers |
| 🍯 **Honeypot Detection** | Jupiter sell simulation | Can you actually sell this token? |
| 📊 **Holder Concentration** | getTokenLargestAccounts | Top 5 wallets controlling >50% supply? |
LP & Token Maturity (Layers 6-8)
| Layer | Source | Detection |
|-------|--------|-----------|
| 🔒 **LP Lock/Burn** | Raydium V4 byte decode + GeckoTerminal | Is liquidity locked, burned, or unlocked? |
| ⏰ **Token Age** | Helius enhanced RPC | Newborn ( ](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522sicarius-guard%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522sicarius-guard%2522%255D%257D)
Or via CLI:
Install from Source (Claude Desktop / Cursor)
🏗️ Architecture
💰 x402 Payment Protocol
SicariusGuard implements the **x402 HTTP Payment Required** protocol for machine-native micropayments. AI agents can pay per API call with SOL — no registration, no API keys, no accounts.
How It Works
Pricing
| Endpoint | Price (SOL) | Description |
|----------|------------|-------------|
| /v1/check | 0.001 | On-chain safety check |
| /v1/scan | 0.002 | Full 12-layer scan |
| /v1/honeypot | 0.0005 | Honeypot simulation |
| /v1/holders | 0.0005 | Holder analysis |
| /v1/nft-check | 0.001 | NFT safety check |
Example (Paid Request)
Security
- **On-chain verification** — Every payment is verified against Solana mainnet
- **Replay protection** — Each tx signature can only be used once
- **Amount validation** — Exact SOL amount must match endpoint pricing
- **Freshness check** — Transactions older than 10 minutes are rejected
- **Verified live on mainnet** — Tested with real SOL transfers
Access Tiers
| Tier | Auth Method | Rate Limit |
|------|------------|------------|
| **Free** | None | 100 calls/day per IP |
| **x402 Pay-Per-Call** | X-PAYMENT header (SOL tx sig) | Unlimited |
🔧 Configuration
| Variable | Description | Default |
|----------|-------------|---------|
| HELIUS_RPC_URL | Solana RPC endpoint (Helius recommended) | https://api.mainnet-beta.solana.com |
| PORT | API server port | 3400 |
| HOST | Bind address | 0.0.0.0 |