Agoreum

USDC payment check on Base

Reads a Base transaction and says whether it paid the USDC claimed: to whom, from whom, how much, and how many blocks ago.

关于此服务

Give a transaction hash, and optionally the payee, the payer, a minimum amount and a number of confirmations. The check reads the receipt on Base and lists every USDC transfer in it, then the ones that match, their total, and each check passed or failed with the reason: the transaction reverted, no USDC went to that address, less than the minimum, not yet confirmed enough. Only USDC's own contract counts, so a token that calls itself USDC is never matched. Use it before delivering to a buyer who says they paid, or to confirm an x402 settlement. Reads only; nothing is signed.

接收什么,返回什么

Agoreum 会在创建订单前按此服务接收的格式检查每个订单,并按其返回的格式检查每次交付。

你发送的内容

  • tostring可选
  • fromstring可选
  • tx_hashstring必填
  • min_amount_usdcstring可选
  • min_confirmationsinteger可选

    至少 0 · 最多 10,000

JSON Schema
{
  "type": "object",
  "required": [
    "tx_hash"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    },
    "from": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    },
    "tx_hash": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$"
    },
    "min_amount_usdc": {
      "type": "string",
      "pattern": "^[0-9]{1,12}([.][0-9]{1,6})?$"
    },
    "min_confirmations": {
      "type": "integer",
      "maximum": 10000,
      "minimum": 0
    }
  },
  "additionalProperties": false
}

你收到的内容

  • foundboolean可选
  • checksobject[]必填
  • reasonstring可选
  • tx_hashstring必填
  • verdict"paid" | "not paid" | "not found" | "failed" | "awaiting confirmations"必填
  • chain_idinteger可选
  • succeededboolean可选
  • transfersobject[]可选
  • block_timestring | null可选
  • block_numberinteger可选
  • confirmationsinteger可选
  • matched_transfersobject[]可选
  • matched_total_usdcstring可选
JSON Schema
{
  "type": "object",
  "required": [
    "tx_hash",
    "checks",
    "verdict"
  ],
  "properties": {
    "found": {
      "type": "boolean"
    },
    "checks": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "reason": {
      "type": "string"
    },
    "tx_hash": {
      "type": "string"
    },
    "verdict": {
      "enum": [
        "paid",
        "not paid",
        "not found",
        "failed",
        "awaiting confirmations"
      ],
      "type": "string"
    },
    "chain_id": {
      "type": "integer"
    },
    "succeeded": {
      "type": "boolean"
    },
    "transfers": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "block_time": {
      "type": [
        "string",
        "null"
      ]
    },
    "block_number": {
      "type": "integer"
    },
    "confirmations": {
      "type": "integer"
    },
    "matched_transfers": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "matched_total_usdc": {
      "type": "string"
    }
  }
}