{
  "x402Version": 1,
  "operator": "Beggar Bot",
  "note": "Paid: /v1/verify, /v1/risk, /v1/receipt cost $0.01 USDC per call on Base mainnet via x402 (payTo 0x719227f384b66BFEF00093D6d8d32fA9dC2B40e7); utilities analyze Base mainnet (USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) by default, network=base-sepolia optional; /v1/receipt/verify and discovery files are free.",
  "resources": [
    {
      "resource": "https://beggar-bot-demand.beggarbot.workers.dev/v1/verify",
      "method": "GET",
      "description": "Did a USDC payment from payer to payee for exact amount land on Base mainnet (default) or Base Sepolia via network=base-sepolia (invoice echo)",
      "price": "0.01",
      "accepts": [
        {
          "scheme": "exact",
          "network": "base",
          "maxAmountRequired": "10000",
          "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
          "payTo": "0x719227f384b66BFEF00093D6d8d32fA9dC2B40e7",
          "resource": "https://beggar-bot-demand.beggarbot.workers.dev/v1/verify",
          "description": "Verify that a USDC payment (payer -> payee, exact amount) landed on Base mainnet recently; returns verdict + matching transfer.",
          "mimeType": "application/json",
          "outputSchema": {
            "input": {
              "type": "http",
              "method": "GET",
              "discoverable": true,
              "queryParams": {
                "payer": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$",
                  "description": "payer address",
                  "required": true
                },
                "payee": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$",
                  "description": "payee address",
                  "required": true
                },
                "amount": {
                  "type": "string",
                  "description": "USDC decimal amount, e.g. 0.01",
                  "required": true
                },
                "invoice": {
                  "type": "string",
                  "description": "invoice id echo [\\w.:-]{1,64}",
                  "required": true
                },
                "network": {
                  "type": "string",
                  "description": "base (default) or base-sepolia",
                  "enum": [
                    "base",
                    "base-sepolia"
                  ]
                },
                "lookback_blocks": {
                  "type": "string",
                  "description": "blocks to scan (max 5000 mainnet)"
                }
              }
            },
            "output": {
              "type": "object",
              "properties": {
                "network": {
                  "type": "string"
                },
                "invoice": {
                  "type": "string"
                },
                "paid": {
                  "type": "boolean",
                  "description": "exact matching transfer found"
                },
                "verdict": {
                  "type": "string"
                },
                "lookback_blocks": {
                  "type": "number"
                },
                "head": {
                  "type": "number"
                }
              }
            }
          },
          "maxTimeoutSeconds": 120,
          "extra": {
            "name": "USDC",
            "version": "2"
          }
        }
      ]
    },
    {
      "resource": "https://beggar-bot-demand.beggarbot.workers.dev/v1/risk",
      "method": "GET",
      "description": "Risk score for a Base mainnet address (default; network=base-sepolia optional) or an x402 endpoint manifest",
      "price": "0.01",
      "accepts": [
        {
          "scheme": "exact",
          "network": "base",
          "maxAmountRequired": "10000",
          "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
          "payTo": "0x719227f384b66BFEF00093D6d8d32fA9dC2B40e7",
          "resource": "https://beggar-bot-demand.beggarbot.workers.dev/v1/risk",
          "description": "Risk score (0-100) for a Base address (contract/EOA, nonce) or an x402 endpoint manifest.",
          "mimeType": "application/json",
          "outputSchema": {
            "input": {
              "type": "http",
              "method": "GET",
              "discoverable": true,
              "queryParams": {
                "address": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$",
                  "description": "address to score (or use endpoint)"
                },
                "endpoint": {
                  "type": "string",
                  "description": "public https x402 endpoint to check (or use address)"
                },
                "network": {
                  "type": "string",
                  "description": "base (default) or base-sepolia",
                  "enum": [
                    "base",
                    "base-sepolia"
                  ]
                }
              }
            },
            "output": {
              "type": "object",
              "properties": {
                "score": {
                  "type": "number",
                  "description": "0-100, higher is safer"
                },
                "reasons": {
                  "type": "array",
                  "description": "reason codes",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "maxTimeoutSeconds": 120,
          "extra": {
            "name": "USDC",
            "version": "2"
          }
        }
      ]
    },
    {
      "resource": "https://beggar-bot-demand.beggarbot.workers.dev/v1/receipt",
      "method": "POST",
      "description": "Ed25519-signed, hash-chained receipt for a verified Base mainnet USDC payment (default; network=base-sepolia optional)",
      "price": "0.01",
      "accepts": [
        {
          "scheme": "exact",
          "network": "base",
          "maxAmountRequired": "10000",
          "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
          "payTo": "0x719227f384b66BFEF00093D6d8d32fA9dC2B40e7",
          "resource": "https://beggar-bot-demand.beggarbot.workers.dev/v1/receipt",
          "description": "Ed25519-signed, hash-chained receipt for a verified Base USDC payment tx; verify free at /v1/receipt/verify.",
          "mimeType": "application/json",
          "outputSchema": {
            "input": {
              "type": "http",
              "method": "POST",
              "bodyType": "json",
              "discoverable": true,
              "bodyFields": {
                "tx_hash": {
                  "type": "string",
                  "description": "0x tx hash",
                  "required": true,
                  "pattern": "^0x[0-9a-fA-F]{64}$"
                },
                "payer": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$",
                  "description": "payer",
                  "required": true
                },
                "payee": {
                  "type": "string",
                  "pattern": "^0x[0-9a-fA-F]{40}$",
                  "description": "payee",
                  "required": true
                },
                "amount": {
                  "type": "string",
                  "description": "USDC decimal amount",
                  "required": true
                },
                "invoice": {
                  "type": "string",
                  "description": "optional invoice id"
                },
                "resource": {
                  "type": "string",
                  "description": "optional resource"
                },
                "network": {
                  "type": "string",
                  "description": "base (default) or base-sepolia",
                  "enum": [
                    "base",
                    "base-sepolia"
                  ]
                }
              }
            },
            "output": {
              "type": "object",
              "properties": {
                "receipt": {
                  "type": "object"
                },
                "alg": {
                  "type": "string"
                },
                "kid": {
                  "type": "string"
                },
                "signature": {
                  "type": "string",
                  "description": "base64url Ed25519"
                },
                "receipt_hash": {
                  "type": "string"
                }
              }
            }
          },
          "maxTimeoutSeconds": 120,
          "extra": {
            "name": "USDC",
            "version": "2"
          }
        }
      ]
    },
    {
      "resource": "https://beggar-bot-demand.beggarbot.workers.dev/v1/receipt/verify",
      "method": "POST",
      "description": "Verify a receipt signature",
      "price": "0",
      "accepts": []
    }
  ]
}