agent-card.json

{
  "protocolVersion": "1.0",
  "name": "SNTL DePIN Oracle",
  "display_name": "SNTL DePIN Oracle",
  "description": "Pay-per-query datalake for the Helium and Solana DePIN network. Query an AI-classified datalake of enriched on-chain events: threat tiers (critical to low), anomaly scores, H3 geospatial hotspot resolution, forensic space-time-power chronicles, tiered LLM escalation verdicts, and scored wallet/audience segments. Sandboxed SQL SELECT, LIMIT 1, allow-listed tables. Tiered x402 settlement on Solana mainnet - no signup, no API key. Two skills are free: probe before you pay. Built for Agent2Agent (A2A) agents to check a Solana/Helium wallet, tx, or program and get back an on-chain-verifiable answer. https://pop-os.tail08831d.ts.net",
  "version": "2.1.1",
  "url": "https://pop-os.tail08831d.ts.net/api/v2",
  "preferredTransport": "JSONRPC",

  "provider": {
    "organization": "Web3 Solutions, LLC",
    "url": "https://pop-os.tail08831d.ts.net"
  },

  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "extensions": [
      {
        "uri": "https://github.com/google-a2a/a2a-x402/v0.1",
        "description": "Pay-per-call via x402 - tiered USDC on Solana mainnet, gasless via PayAI facilitator. No signup, no API key, no CDP.",
        "required": true,
        "params": {
          "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
          "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
          "assetSymbol": "USDC",
          "payTo": "77jDxfGUbCUbJCRZfrmXcjQ2kT7MHe4oQ3ZUBzncBXCp",
          "price_usdc": 0.01,
          "facilitator": "https://facilitator.payai.network",
          "proof_tx": "2TEnsbpuxLC3qsCLAf4MB2XfUbr2SF4B34vjpkV1Yzq2BeDqVuTzmEo6UX3SXFDkKRWMYtbSJ6K8GcuNZt7J939c",
          "proof_note": "Live-rail Agent2Agent (A2A) settlement, verifiable on Solana mainnet."
        }
      }
    ]
  },

  "securitySchemes": {
    "x402": {
      "type": "http",
      "scheme": "x402",
      "description": "Per-query settlement. Server returns 402 with accepts:[PaymentRequirements]; client resubmits with X-PAYMENT header. Solana mainnet USDC, gasless via PayAI facilitator. Tiered pricing per record. Free skills require no payment."
    }
  },
  "security": [{ "x402": [] }],

  "defaultInputModes": ["application/json"],
  "defaultOutputModes": ["application/json"],

  "x-free-tier": {
    "description": "Two skills are free. Probe these to verify the rail before spending.",
    "skills": ["wallet-history", "stats"]
  },

  "x-limits": {
    "sql_select_only": true,
    "default_rows": 1,
    "max_rows": 1,
    "allow_listed_tables": true,
    "agent_controlled_input": "?limit only (parsed and capped at 1)",
    "note": "All paid calls enforce LIMIT 1 per record. No pagination."
  },

  "tags": [
    "threat-detection", "anomaly-detection", "wallet-risk", "aml",
    "forensics", "security", "fraud-detection", "helium", "solana",
    "depin", "on-chain-analytics", "blockchain-intelligence", "web3-security",
    "x402", "pay-per-query", "Agent2Agent", "A2A", "sql-datalake",
    "h3", "geospatial", "MCP"
  ],

  "skills": [
    {
      "id": "stats",
      "name": "Threat distribution (FREE)",
      "description": "FREE. Live counts of enriched events by threat tier. Confirms corpus depth and rail liveness. No payment required.",
      "tags": ["free", "meta", "stats", "probe"],
      "x-pricing": { "free": true },
      "x-endpoint": "GET /api/v2/stats",
      "examples": ["GET /api/v2/stats?limit=1"]
    },
    {
      "id": "wallet-history",
      "name": "Wallet ledger (FREE)",
      "description": "FREE. Enriched event ledger for a single wallet. No payment required - use this to verify the rail before paying.",
      "tags": ["free", "wallet", "ledger", "solana", "probe"],
      "x-pricing": { "free": true },
      "x-endpoint": "GET /api/v2/ledger/{wallet}",
      "examples": ["GET /api/v2/ledger/3S8mLQgv849WeLMNH43BXLBCreJQQatnxazFH7vk1PJG?limit=1"]
    },

    {
      "id": "query-datalake",
      "name": "Query the Helium datalake",
      "description": "Run a read-only SQL SELECT over enriched Helium/Solana events. Sandboxed: SELECT-only, LIMIT 1, allow-listed tables. Returns rows + rowCount. Tiered x402 pricing per record.",
      "tags": ["sql", "datalake", "enriched-events", "threat-intel", "anomaly"],
      "x-pricing": { "usdc": 0.01 },
      "x-endpoint": "POST /api/v2/query",
      "examples": ["SELECT transaction_id, threat_assessment, anomaly_score, summary FROM enriched_events_base WHERE threat_assessment = 'critical' ORDER BY block_time DESC LIMIT 1"]
    },
    {
      "id": "lookup-event",
      "name": "Look up one enriched event",
      "description": "Fetch a single enriched event by transaction signature. Tiered x402 pricing per record.",
      "tags": ["event", "lookup", "forensics"],
      "x-pricing": { "usdc": 0.01 },
      "x-endpoint": "GET /api/v2/event/{signature}",
      "examples": ["GET /api/v2/event/2mCN9t17?limit=1"]
    },

    {
      "id": "threats-critical",
      "name": "Critical threats",
      "description": "Enriched Helium/Solana events classified CRITICAL threat. $1.00 USDC per record.",
      "tags": ["threat", "critical", "security", "depin", "helium"],
      "x-pricing": { "usdc": 1.00 },
      "x-endpoint": "GET /api/v2/threats/critical",
      "examples": ["GET /api/v2/threats/critical?limit=1"]
    },
    {
      "id": "threats-high",
      "name": "High threats",
      "description": "Enriched events classified HIGH threat. $0.75 USDC per record.",
      "tags": ["threat", "high", "security", "depin", "helium"],
      "x-pricing": { "usdc": 0.75 },
      "x-endpoint": "GET /api/v2/threats/high",
      "examples": ["GET /api/v2/threats/high?limit=1"]
    },
    {
      "id": "threats-medium",
      "name": "Medium threats",
      "description": "Enriched events classified MEDIUM threat. $0.50 USDC per record.",
      "tags": ["threat", "medium", "security", "depin", "helium"],
      "x-pricing": { "usdc": 0.50 },
      "x-endpoint": "GET /api/v2/threats/medium",
      "examples": ["GET /api/v2/threats/medium?limit=1"]
    },
    {
      "id": "threats-low",
      "name": "Low threats",
      "description": "Enriched events classified LOW threat. $0.01 USDC per record.",
      "tags": ["threat", "low", "security", "depin", "helium"],
      "x-pricing": { "usdc": 0.01 },
      "x-endpoint": "GET /api/v2/threats/low",
      "examples": ["GET /api/v2/threats/low?limit=1"]
    },
    {
      "id": "pending-loops",
      "name": "Pending open-loops",
      "description": "Events where threat assessment started but never resolved. $0.01 USDC per record.",
      "tags": ["threat", "pending", "open-loop", "depin", "helium"],
      "x-pricing": { "usdc": 0.01 },
      "x-endpoint": "GET /api/v2/threats/pending",
      "examples": ["GET /api/v2/threats/pending?limit=1"]
    },
    {
      "id": "anomalies",
      "name": "Top anomalies",
      "description": "Highest anomaly-score enriched events. $0.01 USDC per record.",
      "tags": ["anomaly", "scoring", "depin", "helium"],
      "x-pricing": { "usdc": 0.01 },
      "x-endpoint": "GET /api/v2/anomalies",
      "examples": ["GET /api/v2/anomalies?limit=1"]
    },

    {
      "id": "architects",
      "name": "Architects",
      "description": "Wallets that received a cNFT blast across all campaigns. $0.01 USDC per record.",
      "tags": ["wallet", "audience", "cnft", "architects"],
      "x-pricing": { "usdc": 0.01 },
      "x-endpoint": "GET /api/v2/wallets/architects",
      "examples": ["GET /api/v2/wallets/architects?limit=1"]
    },
    {
      "id": "target-wallets",
      "name": "Target wallets",
      "description": "Scored, invite-tracked target wallet pool. $0.01 USDC per record.",
      "tags": ["wallet", "audience", "scored", "target"],
      "x-pricing": { "usdc": 0.01 },
      "x-endpoint": "GET /api/v2/wallets/target",
      "examples": ["GET /api/v2/wallets/target?limit=1"]
    },
    {
      "id": "hvt-anomaly",
      "name": "HVT anomaly pool",
      "description": "High-value-target anomaly wallets. $0.01 USDC per record.",
      "tags": ["wallet", "audience", "hvt", "anomaly"],
      "x-pricing": { "usdc": 0.01 },
      "x-endpoint": "GET /api/v2/wallets/hvt-anomaly",
      "examples": ["GET /api/v2/wallets/hvt-anomaly?limit=1"]
    },
    {
      "id": "wallet-pool",
      "name": "Wallet pool",
      "description": "Generic scored wallet pool. $0.01 USDC per record.",
      "tags": ["wallet", "audience", "pool"],
      "x-pricing": { "usdc": 0.01 },
      "x-endpoint": "GET /api/v2/wallets/pool",
      "examples": ["GET /api/v2/wallets/pool?limit=1"]
    },
    {
      "id": "connected",
      "name": "Connected",
      "description": "Authenticated agents who hit the paywall, unpaid. $0.01 USDC per record.",
      "tags": ["wallet", "audience", "connected", "lead"],
      "x-pricing": { "usdc": 0.01 },
      "x-endpoint": "GET /api/v2/wallets/connected",
      "examples": ["GET /api/v2/wallets/connected?limit=1"]
    },
    {
      "id": "blink-ready",
      "name": "Blink-ready wallets",
      "description": "Wallets flagged blink-ready for action. $0.01 USDC per record.",
      "tags": ["wallet", "audience", "blink", "action"],
      "x-pricing": { "usdc": 0.01 },
      "x-endpoint": "GET /api/v2/wallets/blink-ready",
      "examples": ["GET /api/v2/wallets/blink-ready?limit=1"]
    },
    {
      "id": "anomaly-critical-wallets",
      "name": "Critical-anomaly wallets",
      "description": "Wallets behind critical-tier events. $0.01 USDC per record.",
      "tags": ["wallet", "audience", "critical", "anomaly"],
      "x-pricing": { "usdc": 0.01 },
      "x-endpoint": "GET /api/v2/wallets/critical",
      "examples": ["GET /api/v2/wallets/critical?limit=1"]
    },
    {
      "id": "anomaly-medium-wallets",
      "name": "Medium-anomaly wallets",
      "description": "Wallets behind medium-tier events. $0.01 USDC per record.",
      "tags": ["wallet", "audience", "medium", "anomaly"],
      "x-pricing": { "usdc": 0.01 },
      "x-endpoint": "GET /api/v2/wallets/medium",
      "examples": ["GET /api/v2/wallets/medium?limit=1"]
    },
    {
      "id": "paid",
      "name": "Paid wallets",
      "description": "Converted paying wallets. $0.01 USDC per record.",
      "tags": ["wallet", "audience", "paid", "converted"],
      "x-pricing": { "usdc": 0.01 },
      "x-endpoint": "GET /api/v2/wallets/paid",
      "examples": ["GET /api/v2/wallets/paid?limit=1"]
    },

    {
      "id": "tier-1",
      "name": "Tier 1",
      "description": "Maximum-signal wallets appearing on 6-7 independent lists. $1.00 USDC per record.",
      "tags": ["wallet", "engagement", "tier-1", "signal"],
      "x-pricing": { "usdc": 1.00 },
      "x-endpoint": "GET /api/v2/pyramid/tier-1",
      "examples": ["GET /api/v2/pyramid/tier-1?limit=1"]
    },
    {
      "id": "tier-2",
      "name": "Tier 2",
      "description": "Wallets appearing on 4-5 independent lists. $0.75 USDC per record.",
      "tags": ["wallet", "engagement", "tier-2"],
      "x-pricing": { "usdc": 0.75 },
      "x-endpoint": "GET /api/v2/pyramid/tier-2",
      "examples": ["GET /api/v2/pyramid/tier-2?limit=1"]
    },
    {
      "id": "tier-3",
      "name": "Tier 3",
      "description": "Wallets appearing on 2-3 independent lists. $0.50 USDC per record.",
      "tags": ["wallet", "engagement", "tier-3"],
      "x-pricing": { "usdc": 0.50 },
      "x-endpoint": "GET /api/v2/pyramid/tier-3",
      "examples": ["GET /api/v2/pyramid/tier-3?limit=1"]
    },

    {
      "id": "world-state-chronicle",
      "name": "World-state chronicle",
      "description": "Time / space / power dimensional event chains. $0.01 USDC per record.",
      "tags": ["forensic", "chronicle", "dimensional", "helium"],
      "x-pricing": { "usdc": 0.01 },
      "x-endpoint": "GET /api/v2/chronicle",
      "examples": ["GET /api/v2/chronicle?limit=1"]
    },
    {
      "id": "geo-hotspots",
      "name": "Geo hotspots (H3)",
      "description": "H3 geospatial hotspot resolution. $0.01 USDC per record.",
      "tags": ["forensic", "geo", "h3", "hotspot"],
      "x-pricing": { "usdc": 0.01 },
      "x-endpoint": "GET /api/v2/geo",
      "examples": ["GET /api/v2/geo?limit=1"]
    },
    {
      "id": "escalation-ledger",
      "name": "LLM escalation ledger",
      "description": "Tiered LLM verdict trail (SLM 0.5B -> SLM 3.5B -> LLM). $0.01 USDC per record.",
      "tags": ["forensic", "llm", "escalation", "verdict"],
      "x-pricing": { "usdc": 0.01 },
      "x-endpoint": "GET /api/v2/escalation",
      "examples": ["GET /api/v2/escalation?limit=1"]
    },
    {
      "id": "unparsed-dlq",
      "name": "Unparsed DLQ",
      "description": "Failure-mode data / dead-letter queue. $0.01 USDC per record.",
      "tags": ["forensic", "dlq", "failure", "unparsed"],
      "x-pricing": { "usdc": 0.01 },
      "x-endpoint": "GET /api/v2/dlq",
      "examples": ["GET /api/v2/dlq?limit=1"]
    }
  ],

  "x-discovery": {
    "agent_card": "https://pop-os.tail08831d.ts.net/.well-known/agent-card.json",
    "ai_manifest": "https://pop-os.tail08831d.ts.net/.well-known/ai.json",
    "free_probe": "https://pop-os.tail08831d.ts.net/api/v2/stats",
    "mcp_repository": "https://github.com/substreambc/helium-mcp",
    "mcp_package": "@web3solutions33/helium-mcp",
    "fallback_url": "https://pop-os.tail08831d.ts.net"
  },
  "related_agents": [
    {
      "name": "SNTL DePIN Oracle (MCP)",
      "relation": "same-rail",
      "description": "Machine-first x402 MCP server for the same Helium/Solana DePIN datalake. Drop into any MCP host.",
      "url": "https://github.com/substreambc/helium-mcp",
      "agent_card": "https://pop-os.tail08831d.ts.net/.well-known/agent-card.json"
    }
  ]
}