API Documentation

1. Call POST /audit with tier=pro (without payment)
2. Receive 402 Payment Required with x402 headers and payment details
3. Send USDC to the address specified in the response
4. Retry POST /audit with X-PAYMENT: <tx-signature>
5. Server verifies on-chain payment and returns scan results

Response Headers

HTTP/1.1 402 Payment Required
X-Payment-Required: true
X-Payment-Network: solana-mainnet
X-Payment-Asset: USDC
X-Payment-Address: <payment-wallet>
X-Payment-Amount: 500000
X-Payment-Amount-USD: 0.50
X-Payment-Description: Pro audit: 150 lines (small)

Response Body

{
  "success": false,
  "error": "Payment required",
  "x402": {
    "version": "1.0",
    "network": "solana-mainnet",
    "asset": "USDC",
    "address": "<payment-wallet>",
    "amount": 500000,
    "amount_usd": 0.50,
    "description": "Pro audit for 150 lines (small contract)"
  },
  "instructions": "Send USDC to the address, then retry with X-PAYMENT header containing the transaction signature"
}

Returns API information and pricing details. Use this to discover payment configuration programmatically.

Response

{
  "service": "SmartSec",
  "description": "AI Smart Contract Security Scanner",
  "version": "1.0.0",
  "pricing": {
    "basic": "Free (1/day)",
    "pro": "$0.50-$2.00 (based on contract size)"
  },
  "payment": "USDC on Solana",
  "wallet": "<payment-wallet>"
}

Health check endpoint.

{ "status": "ok" }

Get price estimate before making payment. Analyzes contract complexity and returns pricing for all tiers.

Form Data

Parameter	Type	Description
file required	file	Smart contract source file (max 5MB)
chain	string	Blockchain: ethereum, bsc, polygon, arbitrum (default: ethereum)

Response

{
  "success": true,
  "file": "Token.sol",
  "lines": 350,
  "size": "small",      // small (<500), medium (500-2000), large (2000+)
  "chain": "ethereum",
  "pricing": {
    "basic": { "price": "Free", "limit": "1/day" },
    "pro": { "price": "$0.50" }  // Varies: $0.50/$1.00/$2.00 based on size
  },
  "wallet": "<payment-wallet>"
}

Pro pricing by size: <500 lines = $0.50 | 500-2000 lines = $1.00 | 2000+ lines = $2.00

Run AI-powered security analysis on a smart contract. Returns vulnerability report with risk scoring.

Headers

Header	Description
X-PAYMENT required	Solana TX signature for payment verification

Form Data

Parameter	Type	Description
file required	file	Smart contract source file (max 5MB)
chain	string	Blockchain: ethereum, bsc, polygon, arbitrum
tier	string	Tier: basic (free, 1/day), pro ($0.50-$2.00 by size). Default: basic

Response

{
  "success": true,
  "tier": "pro",
  "contract": "Token",
  "chain": "ethereum",
  "risk_score": 65,
  "issues": 3,
  "vulnerabilities": [
    {
      "severity": "high",
      "type": "reentrancy",
      "description": "Potential reentrancy in withdraw()",
      "line": 142
    },
    {
      "severity": "medium",
      "type": "unchecked-return",
      "description": "Unchecked return value",
      "line": 78
    }
  ],
  "summary": "Contract has 3 potential issues..."
}

Response (Basic tier includes scans remaining)

{
  "success": true,
  "tier": "basic",
  ...
  "scans_left_today": 2
}

Fetch verified contract source code from block explorers (Etherscan, BSCScan, etc.). Useful for scanning deployed contracts.

Path Parameters

Parameter	Description
chain	Blockchain: ethereum, bsc, polygon, arbitrum
address	Contract address (0x...)

Response

{
  "success": true,
  "source": "pragma solidity ^0.8.0;\n\ncontract Token {...}",
  "name": "Token",
  "address": "0x...",
  "chain": "ethereum"
}

Error Response

{
  "success": false,
  "error": "Contract not verified or source not available"
}

Get latest Solana blockhash (for building transactions).

{ "blockhash": "EkSnNWid2cvw..." }

Check USDC balance for a wallet.

{ "balance": "$1.00", "wallet": "<wallet-address>" }

Check if an account exists on Solana.

{ "exists": true }