paddock.finance

{
  "properties": {
    "_meta": {
      "type": "object"
    },
    "checked_at": {
      "description": "When the live probe ran. The whole value of this response is that it was taken at this instant; it is never cached.",
      "format": "date-time",
      "type": "string"
    },
    "checks": {
      "description": "One block per check, each carrying its own status, universe, basis and as_of date. No figure in one block is divided by a figure in another.",
      "properties": {
        "circular": {
          "type": "object"
        },
        "contract": {
          "type": "object"
        },
        "liveness": {
          "type": "object"
        },
        "paid_fulfillment": {
          "description": "Independent third-party paid-verification result, re-served under CC-BY 4.0. Carries status, last_paid_attempt_at (the date the SOURCE observed it, never defaulted to now), basis, attribution_url, and the settlement tx_hash where one was published. Absent coverage returns not_assessed with a basis naming why.",
          "type": "object"
        },
        "price": {
          "type": "object"
        },
        "settlement": {
          "type": "object"
        }
      },
      "type": "object"
    },
    "contract_and_request_ok": {
      "description": "The combined verdict (0.6). true only when the live contract matched your expectations (route === true) AND your own declared request passed pre-flight (checks.requestPreflight.status === \"pass\"). false when either term is bad - including when YOUR request is missing a parameter the challenge declares required. The STRING \"not_assessed\" when a term was never established, most often because you passed no intended_params or intended_params_empty, so there was no request of yours to clear; that is not a soft yes and not a no. Test with contract_and_request_ok === true. It does not replace route, which is unchanged, and it is NOT a clearance - read contract_and_request_ok_excludes.",
      "oneOf": [
        {
          "type": "boolean"
        },
        {
          "const": "not_assessed",
          "type": "string"
        }
      ]
    },
    "contract_and_request_ok_excludes": {
      "description": "Every risk category the conjunction does NOT cover, each with the field where that category's own verdict lives and what it can be doing while contract_and_request_ok is true: settlement recency, an unassessed circular signal, attribution divergence, a payTo-only divergence from the seller's published config, a divergent second challenge channel, and price against the category median. The list is STATIC - it says what the formula leaves out, not how this endpoint scored, so coverage can never be inferred from an absence.",
      "items": {
        "properties": {
          "category": {
            "type": "string"
          },
          "note": {
            "type": "string"
          },
          "where": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "evidence": {
      "description": "One row per fact, each with the source it came from and the time it is as-of. Probe rows are as-of now; snapshot and classification rows are as-of their own dates, which are older.",
      "items": {
        "properties": {
          "check": {
            "type": "string"
          },
          "detail": {
            "type": "string"
          },
          "observed_at": {
            "format": "date-time",
            "type": "string"
          },
          "source": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "expectations_supplied": {
      "type": "object"
    },
    "mpp": {
      "description": "Decoded MPP challenges from the live 402, with checks against the caller's expectations. Null when the seller offers no MPP challenge.",
      "properties": {
        "challenges": {
          "items": {
            "properties": {
              "amount": {
                "description": "Base units, as the seller wrote them.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "amount_usd": {
                "description": "Six decimals, only for the Tempo mainnet USDC.e token; null otherwise.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "checks": {
                "properties": {
                  "price": {
                    "enum": [
                      "match",
                      "mismatch",
                      "not_checked",
                      "inconclusive"
                    ],
                    "type": "string"
                  },
                  "recipient": {
                    "enum": [
                      "match",
                      "mismatch",
                      "not_checked",
                      "inconclusive",
                      "not_applicable"
                    ],
                    "type": "string"
                  },
                  "record": {
                    "enum": [
                      "inconclusive",
                      "not_applicable"
                    ],
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "currency": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "index": {
                "description": "Zero-based position in header order.",
                "type": "integer"
              },
              "intent": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "method": {
                "description": "tempo (on-chain USDC.e) or stripe (card).",
                "type": [
                  "string",
                  "null"
                ]
              },
              "realm": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "recipient": {
                "description": "On-chain recipient for a tempo challenge; null for stripe.",
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "type": "object"
          },
          "type": "array"
        },
        "matched_rail": {
          "description": "Which rail the pay_to you gave matched: x402 or tempo. Null when you gave no pay_to or it matched neither.",
          "enum": [
            "x402",
            "tempo",
            null
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "result": {
          "enum": [
            "ok",
            "mismatch",
            "inconclusive"
          ],
          "type": "string"
        }
      },
      "type": [
        "object",
        "null"
      ]
    },
    "paddock_url": {
      "description": "The paddock.finance/s/<domain> service page for this target, when one exists; null otherwise. Additive, non-breaking (no schema_version bump).",
      "type": [
        "string",
        "null"
      ]
    },
    "reason_codes": {
      "description": "Stable, append-only vocabulary, e.g. live_402_observed, contract_mismatch_price, circular_flagged_cluster_member, settlement_never_observed.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "route": {
      "description": "true = the endpoint asked for payment and the contract you stated matched. false = do not pay. \"inconclusive\" = either we could not read a 402, so we cannot vouch for what it will charge you, or you supplied no pay_to and no expect_* so there was nothing to compare (reason code no_expectations_supplied).",
      "oneOf": [
        {
          "type": "boolean"
        },
        {
          "const": "inconclusive",
          "type": "string"
        }
      ]
    },
    "route_note": {
      "type": "string"
    },
    "route_state": {
      "description": "route_state carries the same verdict as route, always as a string (\"true\", \"false\", \"inconclusive\"), for clients that cannot type a boolean-or-string field.",
      "enum": [
        "true",
        "false",
        "inconclusive"
      ],
      "type": "string"
    },
    "schema_version": {
      "description": "Bumped when a stored response stops being comparable to a live one: a breaking shape change, a change to what an existing field means, or a new verdict the older version did not emit. Store it with the verdict - a verdict is only comparable to another at the same version.",
      "type": "string"
    },
    "summary": {
      "type": "string"
    },
    "target": {
      "description": "What was probed, what the wallet resolved to, and which wallet the circular check used.",
      "type": "object"
    },
    "tool": {
      "const": "verify_before_pay",
      "type": "string"
    }
  },
  "type": "object"
}