AI-Powered Rug Pull Detection

🚀 Quick Start

🎭 Demo Mode (Free Testing):

• Use payment_id starting with "demo_" (e.g., demo_test_123)

• No payment required - instant testing!

💰 Production Mode:

1. Send 0.1 USDC to the service wallet on Base network

2. Use the transaction hash as payment_id

3. Call the API with your contract address

💳 X402 Protocol Support

RugDetector is fully X402-compliant, enabling native HTTP payment flow using industry-standard headers.

📡 Payment Required Response (HTTP 402)

When payment is required, the API returns:

HTTP/1.1 402 Payment Required
X-PAYMENT-RESPONSE: eyJzY2hlbWVzIjpbeyJzY2hlbWUiOi...
WWW-Authenticate: X402
Content-Type: application/json

{
  "error": "Payment required",
  "error_code": "PAYMENT_REQUIRED",
  "message": "This endpoint requires payment. Send 0.1 USDC on Base network.",
  "payment_details": {
    "amount": "0.1",
    "currency": "USDC",
    "network": "base"
  }
}

🔐 X-PAYMENT Header

Include payment proof via X-PAYMENT header (base64-encoded JSON):

// Payment payload (before encoding)
{
  "scheme": "exact",
  "network": "base",
  "currency": "USDC",
  "amount": "0.1",
  "txHash": "0xYOUR_TRANSACTION_HASH"
}

// Example request with X-PAYMENT header
curl -X POST https://rugdetector.ai/check \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: eyJzY2hlbWUiOiJleGFjdCIsIm5ldHdvcmsi..." \
  -d '{"contract_address": "0x1234..."}'

📋 X-PAYMENT-RESPONSE Header

The X-PAYMENT-RESPONSE header contains base64-encoded payment details:

// Decoded X-PAYMENT-RESPONSE header
{
  "schemes": [{
    "scheme": "exact",
    "network": "base",
    "currency": "USDC",
    "amount": "0.1",
    "recipient": "0xYourServiceWallet",
    "description": "Smart contract analysis",
    "metadata": {
      "service": "rugdetector",
      "version": "1.0.0",
      "endpoint": "/check"
    }
  }]
}

🔍 Service Discovery

GET /.well-known/ai-service.json

Returns X402 manifest with pricing and capabilities

📤 Request Format

{
  "payment_id": "tx_0xYOUR_TRANSACTION_HASH",
  "contract_address": "0x1234567890abcdef1234567890abcdef12345678",
  "blockchain": "ethereum"
}

📥 Response Format

{
  "success": true,
  "data": {
    "riskScore": 0.78,
    "riskCategory": "high",
    "confidence": 0.92,
    "features": {
      "hasOwnershipTransfer": true,
      "liquidityRatio": 0.23,
      "giniCoefficient": 0.76,
      "... 57 more features": "..."
    },
    "recommendation": "High risk detected. Avoid investing.",
    "analysis_timestamp": "2025-10-24T02:00:00Z",
    "zkml": {
      "proof_id": "cc0bad36b87b96ea",
      "protocol": "jolt-atlas-v1",
      "verifiable": true
    }
  }
}

🛡️ Security Features

⚠️ Error Codes

💻 Example Code

const response = await fetch('https://rugdetector.ai/check', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    payment_id: 'demo_test_123', // Use 'demo_' prefix for free testing
    contract_address: '0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f',
    blockchain: 'ethereum' // or 'base', 'bsc', 'polygon', 'solana'
  })
});

const data = await response.json();
console.log('Risk Score:', data.data.riskScore);

import requests

response = requests.post('https://rugdetector.ai/check',
    json={
        'payment_id': 'demo_test_123',  # Use 'demo_' for free testing
        'contract_address': '0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f',
        'blockchain': 'base'  # ethereum, base, bsc, polygon, solana
    }
)

data = response.json()
print('Risk Score:', data['data']['riskScore'])

curl -X POST https://rugdetector.ai/check \
  -H "Content-Type: application/json" \
  -d '{
    "payment_id": "demo_test_123",
    "contract_address": "0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f",
    "blockchain": "solana"
  }'

// Create X-PAYMENT header
const paymentPayload = {
  scheme: 'exact',
  network: 'base',
  currency: 'USDC',
  amount: '0.1',
  txHash: '0xYOUR_TX_HASH'
};

const xPaymentHeader = btoa(JSON.stringify(paymentPayload));

// Make request with X-PAYMENT header
const response = await fetch('https://rugdetector.ai/check', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-PAYMENT': xPaymentHeader
  },
  body: JSON.stringify({
    contract_address: '0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f',
    blockchain: 'ethereum'
  })
});

// Handle 402 Payment Required
if (response.status === 402) {
  const xPaymentResponse = response.headers.get('X-PAYMENT-RESPONSE');
  const paymentDetails = JSON.parse(atob(xPaymentResponse));
  console.log('Payment required:', paymentDetails);
} else {
  const data = await response.json();
  console.log('Analysis:', data);
}

📚 Additional Resources