Zum Inhalt
HALOWERK

X402werk

receipt / verify

Cryptographic verification of the offer-receipt extension of x402. Accepts a signed offer in eip712, jws or eip191 form — either bundled as {format, payload, signature} or as payload plus a separate signature — and an optional signed receipt.

POST https://x402.halowerk.com/receipt/verify

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
offerobjectJaThe signed offer as {format, payload, signature}, or the bare offer payload with version, resourceUrl, scheme, network, asset, payTo, amount and validUntil — then pass signature and format separately.
signaturestringNeinSignature of the offer, if it is not inside the offer object.
formatstringNeinSignature method, if the offer object does not name it. eip712 is what the offer-receipt extension produces.
public_keyobjectNeinPublic key as a JWK, required for jws signatures whose key identifier cannot be resolved from the token itself.
receiptobjectNeinOptional signed receipt as {format, payload, signature}, or the bare receipt payload with version, network, resourceUrl, payer, issuedAt and transaction.
receipt_signaturestringNeinSignature of the receipt, if it is not inside the receipt object.
receipt_formatstringNeinSignature method of the receipt, if the receipt object does not name it.
expected_payerstringNeinAddress you expected to have paid. When given, the receipt payer is compared against it.
max_receipt_age_secondsintegerNeinHow old a receipt may be before its timestamps are called implausible.
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "offer"
  ],
  "additionalProperties": false,
  "properties": {
    "offer": {
      "type": "object",
      "description": "The signed offer as {format, payload, signature}, or the bare offer payload with version, resourceUrl, scheme, network, asset, payTo, amount and validUntil — then pass signature and format separately."
    },
    "signature": {
      "type": "string",
      "maxLength": 8192,
      "description": "Signature of the offer, if it is not inside the offer object."
    },
    "format": {
      "type": "string",
      "enum": [
        "eip712",
        "jws",
        "eip191"
      ],
      "description": "Signature method, if the offer object does not name it. eip712 is what the offer-receipt extension produces."
    },
    "public_key": {
      "type": "object",
      "description": "Public key as a JWK, required for jws signatures whose key identifier cannot be resolved from the token itself."
    },
    "receipt": {
      "type": "object",
      "description": "Optional signed receipt as {format, payload, signature}, or the bare receipt payload with version, network, resourceUrl, payer, issuedAt and transaction."
    },
    "receipt_signature": {
      "type": "string",
      "maxLength": 8192,
      "description": "Signature of the receipt, if it is not inside the receipt object."
    },
    "receipt_format": {
      "type": "string",
      "enum": [
        "eip712",
        "jws",
        "eip191"
      ],
      "description": "Signature method of the receipt, if the receipt object does not name it."
    },
    "expected_payer": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Address you expected to have paid. When given, the receipt payer is compared against it."
    },
    "max_receipt_age_seconds": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2592000,
      "default": 3600,
      "description": "How old a receipt may be before its timestamps are called implausible."
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "offer": {},
  "max_receipt_age_seconds": 3600
}

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →