x402-doctor.fizzl.eu

{
  "properties": {
    "cached": {
      "type": "boolean"
    },
    "checked_at": {
      "type": "string"
    },
    "method": {
      "type": [
        "string",
        "null"
      ]
    },
    "options": {
      "items": {
        "properties": {
          "amount": {
            "type": [
              "string",
              "null"
            ]
          },
          "asset_symbol": {
            "type": [
              "string",
              "null"
            ]
          },
          "index": {
            "type": "integer"
          },
          "method": {
            "description": "MPP payment method (evm, tempo, stripe); absent for x402 options",
            "type": [
              "string",
              "null"
            ]
          },
          "network": {
            "type": [
              "string",
              "null"
            ]
          },
          "network_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "pay_to": {
            "type": [
              "string",
              "null"
            ]
          },
          "payable": {
            "type": "boolean"
          },
          "problems": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "protocol": {
            "enum": [
              "x402",
              "mpp",
              "l402"
            ],
            "type": "string"
          },
          "usd": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "index",
          "payable",
          "problems"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "reasons": {
      "items": {
        "properties": {
          "code": {
            "type": "string"
          },
          "level": {
            "enum": [
              "no_go",
              "caution",
              "info"
            ],
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "required": [
          "level",
          "code",
          "message"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "receipt": {
      "description": "Signature over this whole answer (without receipt.signature), so the verdict can be verified later: EIP-191 personal_sign over canonical JSON (sorted keys, compact, ASCII-escaped). Signer addresses: /.well-known/x402-doctor-signer.json; free check: POST /api/v1/verify.",
      "properties": {
        "algorithm": {
          "enum": [
            "eip191-canonical-json-v1"
          ],
          "type": "string"
        },
        "cert": {
          "description": "The payout wallet's certificate for this signing key: personal_sign by authority over 'fizzl receipt signer\\nservice: <service>\\nsigner: <signer>\\nvalid_from: <date>'. Pin the payout wallet and a rotated key still verifies.",
          "properties": {
            "authority": {
              "type": "string"
            },
            "service": {
              "type": "string"
            },
            "signature": {
              "type": "string"
            },
            "signer": {
              "type": "string"
            },
            "valid_from": {
              "type": "string"
            }
          },
          "type": "object"
        },
        "input_sha256": {
          "description": "sha256 of canonical JSON {route, input}: your query parameters as strings",
          "type": "string"
        },
        "payment": {
          "description": "The payment behind this answer, from your x402 payment payload. EVM: payer + EIP-3009 nonce; find the settlement as AuthorizationUsed(payer, nonce) on the asset contract. Solana: payer + sha256 of the signed transaction you sent.",
          "properties": {
            "amount": {
              "type": "string"
            },
            "asset": {
              "type": "string"
            },
            "network": {
              "type": "string"
            },
            "nonce": {
              "type": "string"
            },
            "pay_to": {
              "type": "string"
            },
            "payer": {
              "type": "string"
            },
            "proof": {
              "enum": [
                "eip3009",
                "svm-transaction"
              ],
              "type": "string"
            },
            "transaction_sha256": {
              "type": "string"
            }
          },
          "type": "object"
        },
        "request_id": {
          "type": "string"
        },
        "route": {
          "type": "string"
        },
        "signature": {
          "type": "string"
        },
        "signed_at": {
          "type": "string"
        },
        "signer": {
          "type": "string"
        }
      },
      "required": [
        "request_id",
        "route",
        "input_sha256",
        "signed_at",
        "signer",
        "algorithm",
        "signature"
      ],
      "type": "object"
    },
    "recommended_option": {
      "type": [
        "integer",
        "null"
      ]
    },
    "safe_to_pay": {
      "type": "boolean"
    },
    "signals": {
      "type": "object"
    },
    "summary": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "verdict": {
      "enum": [
        "go",
        "caution",
        "no_go"
      ],
      "type": "string"
    }
  },
  "required": [
    "url",
    "verdict",
    "safe_to_pay",
    "summary",
    "options",
    "reasons"
  ],
  "type": "object"
}