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

{
  "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

{
  "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"
    }
  }
}