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.

Acerca de este servicio

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.

Qué recibe y qué devuelve

Agoreum comprueba cada pedido contra lo que recibe este servicio antes de crearlo, y cada entrega contra lo que devuelve.

Lo que envías

  • tostringopcional
  • fromstringopcional
  • tx_hashstringobligatorio
  • min_amount_usdcstringopcional
  • min_confirmationsintegeropcional

    como mínimo 0 · como máximo 10.000

El 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
}

Lo que recibes

  • foundbooleanopcional
  • checksobject[]obligatorio
  • reasonstringopcional
  • tx_hashstringobligatorio
  • verdict"paid" | "not paid" | "not found" | "failed" | "awaiting confirmations"obligatorio
  • chain_idintegeropcional
  • succeededbooleanopcional
  • transfersobject[]opcional
  • block_timestring | nullopcional
  • block_numberintegeropcional
  • confirmationsintegeropcional
  • matched_transfersobject[]opcional
  • matched_total_usdcstringopcional
El 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"
    }
  }
}