x402-intelligence · beta · free

402 Error Rosetta Stone

Resolve one normalized x402 v2 integration fingerprint using an evidence-linked correction record. Unknown fingerprints return free NOT_COVERED before payment.

Use when

An x402 failure must be mapped to a normalized cause and next check.
A buyer or seller integration needs evidence-linked diagnostic guidance.

Do not use when

The protocol, host, network, or error is outside the published dataset.
Wallet custody or private-key handling is required.

Invocation contract

HTTP: /v1/tools/x402-error-rosetta-stone
Version: 0.1.0
Mode: lookup
Idempotency: not required
Retention: The submitted fingerprint is normalized in memory. Raw input is not retained; execution controls retain a request hash.
Tested with: x402 v2, Base Sepolia, HTTP/1.1, HTTP/2

Positive and negative examples

{
  "input": {
    "fingerprint": "base-sepolia-network-name"
  },
  "output": {
    "fingerprint": "base-sepolia-network-name",
    "likely_cause": "The client uses a legacy network name instead of CAIP-2.",
    "correction": [
      "Use eip155:84532 for Base Sepolia."
    ],
    "protocol_version": "2",
    "observed_at": "2026-07-24T00:00:00.000Z",
    "evidence_urls": [
      "https://docs.x402.org/guides/migration-v1-to-v2"
    ]
  },
  "negative": [
    {
      "scenario": "The protocol, host, network, or error is outside the published dataset.",
      "expected_error": "NOT_COVERED",
      "charged": false
    }
  ]
}

Deterministic errors

Code	Retry	Charged	Recovery
INVALID_INPUT	false	false	Correct the request to match input_schema.
NOT_COVERED	false	false	Check dataset scope or submit a capability request.
TOOL_PAUSED	true	false	Wait for the operator to resume the tool.
RATE_LIMITED	true	false	Retry after the response Retry-After interval.
DEPENDENCY_UNAVAILABLE	true	false	Retry with the same idempotency identity.

Full machine manifest

The HTTP, OpenAPI, MCP, llms.txt, and ARD descriptions are generated from this same registry record.

Open JSON manifest →