Documentation

Getting Started

What is SolenceAi?

SolenceAi is an AI-powered security scanner for Solana wallets. It analyzes wallet activity, transaction patterns, and token holdings to generate a deterministic risk score (0-100) along with actionable AI-generated security insights.

How to Scan a Wallet

1. Navigate to the App
2. Enter any Solana wallet address (base58 format, 32-44 characters)
3. Click "Scan Wallet" - no wallet connection required
4. Review the risk score, findings, and AI insights
5. Share the report link or mint a Safety Badge if eligible (score ≥75)

Understanding Risk Scores

Scoring Methodology

Our deterministic scoring engine analyzes:

• Transaction History: Volume, frequency, and patterns
• Token Diversity: Number and type of tokens held
• Wallet Age: Account creation date and activity duration
• Activity Patterns: Regularity and behavior indicators
• Known Interactions: Engagement with verified protocols

Note: The same wallet will always produce the same score when scanned under identical blockchain conditions. This ensures transparency and reproducibility.

How Safety Badges Work

Turn your security score into permanent on-chain proof that unlocks opportunities across the Solana ecosystem.

What Is A Safety Badge?

if (wallet.hasBadge) {
  ✅ approve()
  // Whitelist
  // Airdrop
  // DAO access
} else {
  ❌ deny()
}

Safety Badges

What is a Safety Badge?

A Safety Badge is a verifiable SPL token minted on Solana that proves a wallet has passed SolenceAi's security threshold (score ≥75). Each badge is a 1-supply NFT permanently associated with the scanned wallet.

Minting Requirements

• Wallet must achieve a score of 75 or higher
• One badge per wallet (immutable after minting)
• Badge mint transaction is recorded on-chain
• Viewable on Solana Explorer

Badge Revocation

Safety Badges are immutable SPL tokens and cannot be revoked or burned. If a wallet's security posture degrades after minting, we flag this in new scan reports, but the original badge remains on-chain. Users can re-scan at any time to see updated status.

API Reference

Endpoint

Authentication

No API key required. Include x-viewer-wallet header to access token holder benefits.

Headers

Content-Type: application/json
x-viewer-wallet: <your_wallet_address>  # optional

Request

{
  "wallet": "[SOLANA_WALLET_ADDRESS]",
  "isPublic": false
}

Response

{
  "ok": true,
  "scan": {
    "wallet": "YOUR_WALLET_ADDRESS",
    "score": 82,
    "riskLevel": "LOW",
    "findings": [
      "Wallet age: 247 days (established)",
      "Transaction count: 1,234 (active)",
      "Token diversity: 12 unique tokens"
    ],
    "aiSummary": "This wallet shows healthy activity...",
    "walletDetails": {
      "solBalance": 12.5432,
      "tokenCount": 12,
      "nftCount": 3,
      "txCount": 1234,
      "accountAgeDays": 247,
      "lastActivity": "2025-01-15T10:30:00.000Z",
      "firstActivity": "2024-05-14T08:15:00.000Z"
    },
    "createdAt": "2025-01-15T10:30:00.000Z",
    "meta": {
      "createdByWallet": "YOUR_WALLET_ADDRESS",
      "isPublic": false
    }
  }
}

Rate Limits

Errors

Notes

Token holders are verified on-chain in real-time. Rate limits reset every 60 seconds. All timestamps are in ISO 8601 format (UTC).

Integration Guide

Embedding SolenceAi

You can integrate SolenceAi scans into your dApp, DAO, or platform to verify wallet security before critical operations.

Common Use Cases

• Treasury Management: Verify multisig wallets before large transfers
• Community Gating: Require Safety Badges for Discord roles or DAO membership
• OTC Trading: Screen counterparty wallets before trades
• Airdrop Eligibility: Filter high-risk wallets from distributions

Example: Badge Verification

// Verify if a wallet has a Safety Badge
async function hasSafetyBadge(wallet: string): Promise<boolean> {
  const response = await fetch(`/api/scans?wallet=${wallet}`);
  const data = await response.json();
  
  if (data.scans.length === 0) return false;
  
  const latestScan = data.scans[0];
  return latestScan.badgeMinted === true && latestScan.score >= 75;
}

Frequently Asked Questions

Support & Contact

Need Help?

For enterprise inquiries, partnerships, or technical support, reach out via our social channels.