{
  "name": "AgentShield",
  "version": "1.0",
  "description": "Smart contract security infrastructure for autonomous AI agents. Verify contracts before executing transactions.",
  "base_url": "https://agentshield.win",
  "endpoints": {
    "verify": {
      "method": "GET",
      "path": "/verify?contract=0x...&chain=ethereum",
      "description": "Verify a smart contract for honeypots, rug pulls, and risks",
      "auth": "x402 micropayment ($0.001 USDC) or subscription",
      "request": {
        "contract": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",
        "chain": "ethereum"
      },
      "response": {
        "address": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",
        "chain": "ethereum",
        "safe": true,
        "score": 0.95,
        "verdict": "APPROVED",
        "risk_level": "LOW",
        "flags": [],
        "source": "agentshield_allowlist",
        "recommendation": "Contract is on the verified allowlist. Interaction is permitted."
      }
    },
    "deep_scan": {
      "method": "GET",
      "path": "/deep-scan?contract=0x...&chain=ethereum",
      "description": "Deep analysis with signature forensics, simulation, and pattern matching. Free during beta.",
      "request": {
        "contract": "0x...",
        "chain": "ethereum"
      },
      "response": "Extended verification with ownership_analysis, permission_analysis, pattern_matching, simulation, and risk_breakdown fields"
    },
    "monitor": {
      "method": "POST",
      "path": "/monitor",
      "description": "Watch a wallet for drain threats"
    },
    "freeze": {
      "method": "POST",
      "path": "/freeze",
      "description": "Emergency freeze across linked wallets"
    },
    "stats": {
      "method": "GET",
      "path": "/stats",
      "description": "Live platform statistics"
    },
    "subscribe": {
      "method": "GET",
      "path": "/subscribe",
      "description": "Subscription plans and status"
    }
  },
  "supported_chains": [
    "ethereum",
    "base",
    "polygon",
    "arbitrum",
    "optimism",
    "bnb",
    "avalanche"
  ],
  "payment": {
    "protocol": "x402",
    "amount": "$0.001",
    "currency": "USDC",
    "network": "base"
  },
  "agent_integration": {
    "openapi": "/openapi.json",
    "manifest": "/.well-known/agent-manifest.json",
    "ai_plugin": "/.well-known/ai-plugin.json",
    "llms_txt": "/llms.txt"
  },
  "usage_for_agents": [
    "1. Send GET /verify?contract=0x...&chain=ethereum",
    "2. If 402 response, pay $0.001 USDC on Base via x402 header",
    "3. Retry with X-PAYMENT header containing payment proof",
    "4. Parse response: check safe (bool), score (0-1), verdict, flags",
    "5. For deeper analysis, use /deep-scan (free during beta)"
  ]
}