Zum Inhalt
HALOWERK

X402werk

guard / replay

A stateful duplicate check for agents that settle x402 payments. Supply any of payment_id, payload_hash and nonce; each is hashed with SHA-256 before storage, so the service keeps fingerprints and timestamps and never the values themselves, never a payload, never an address. The answer states for every supplied identifier whether it was seen before, when it was first and last seen, how often, and whether the first sighting falls inside window_seconds.

POST https://x402.halowerk.com/guard/replay

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
payment_idstringNeinPayment identifier of the x402 payment-identifier extension, or any identifier your client treats as unique per payment. Stored only as a SHA-256 fingerprint.
payload_hashstringNeinHash of the request payload that was paid for. Stored only as a SHA-256 fingerprint of the value you send.
noncestringNeinNonce of the signed payment authorisation. Stored only as a SHA-256 fingerprint.
window_secondsintegerNeinHow far back a sighting still counts as a duplicate for the recommendation. Fingerprints are kept for 24 hours regardless.
recordbooleanNeinWhether this call is remembered. Set to false to check without writing, so repeated checks of the same payment do not report themselves as duplicates.
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "additionalProperties": false,
  "anyOf": [
    {
      "required": [
        "payment_id"
      ]
    },
    {
      "required": [
        "payload_hash"
      ]
    },
    {
      "required": [
        "nonce"
      ]
    }
  ],
  "properties": {
    "payment_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "Payment identifier of the x402 payment-identifier extension, or any identifier your client treats as unique per payment. Stored only as a SHA-256 fingerprint."
    },
    "payload_hash": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "Hash of the request payload that was paid for. Stored only as a SHA-256 fingerprint of the value you send."
    },
    "nonce": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "Nonce of the signed payment authorisation. Stored only as a SHA-256 fingerprint."
    },
    "window_seconds": {
      "type": "integer",
      "minimum": 1,
      "maximum": 86400,
      "default": 3600,
      "description": "How far back a sighting still counts as a duplicate for the recommendation. Fingerprints are kept for 24 hours regardless."
    },
    "record": {
      "type": "boolean",
      "default": true,
      "description": "Whether this call is remembered. Set to false to check without writing, so repeated checks of the same payment do not report themselves as duplicates."
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "payment_id": "beispiel",
  "window_seconds": 3600,
  "record": true
}

Ergebnis & Dokumentation

Veröffentlichtes Ergebnisschema anzeigen
{
  "$ref": "https://x402.halowerk.com/guard/replay/schema#/outputSchema"
}

Veröffentlichtes Ergebnisbeispiel öffnen

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 →