presign-guard.fizzl.eu

{
  "properties": {
    "checkedAt": {
      "type": "string"
    },
    "grade": {
      "enum": [
        "SAFE",
        "CAUTION",
        "RISKY",
        "AVOID"
      ],
      "type": "string"
    },
    "market": {
      "description": "DexScreener data: priceUsd, liquidityUsd, marketCapUsd, volume24hUsd, firstPairAt, ageSeconds, url",
      "type": [
        "object",
        "null"
      ]
    },
    "one_liner": {
      "type": "string"
    },
    "reasons": {
      "items": {
        "properties": {
          "code": {
            "type": "string"
          },
          "details": {},
          "severity": {
            "enum": [
              "red",
              "orange",
              "info"
            ],
            "type": "string"
          }
        },
        "required": [
          "code",
          "severity"
        ],
        "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/presign-guard-signer.json; free check: POST /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 body (POST) or query parameters (GET)",
          "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"
    },
    "sources": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "token": {
      "type": "object"
    },
    "verdict": {
      "enum": [
        "green",
        "orange",
        "red"
      ],
      "type": "string"
    }
  },
  "required": [
    "verdict",
    "grade",
    "one_liner",
    "reasons"
  ],
  "type": "object"
}