attestazione.spaziogenesi.org

{
  "name": "spaziogenesi_service_status",
  "kind": "answer",
  "impl": "imperative",
  "description": "Report the live status of the Spazio Genesi attestation service: engine, certificate archive, PDF signer and Bitcoin anchor. Use this before telling a user that attesting or verifying is unavailable.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "spaziogenesi_verify_attestation",
  "kind": "act",
  "impl": "imperative",
  "description": "Check whether an attestation certificate issued by Spazio Genesi is authentic and unaltered, by validating its HMAC signature. This does NOT check that a file matches the fingerprint — recompute the SHA-256 locally for that. Requires the three values printed on the certificate.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "fingerprint": {
        "type": "string",
        "description": "The SHA-256 fingerprint, 64 hexadecimal characters."
      },
      "attestation": {
        "type": "string",
        "description": "The attestation string, in the form \"SHA-256:<fingerprint>@<iso timestamp>\"."
      },
      "signature": {
        "type": "string",
        "description": "The HMAC signature from the certificate (base64, not hexadecimal)."
      },
      "declaredTitle": {
        "type": "string",
        "description": "Declared title, if the certificate shows one."
      },
      "declaredAuthor": {
        "type": "string",
        "description": "Declared author, if the certificate shows one."
      },
      "declaredYear": {
        "type": "string",
        "description": "Declared year, if the certificate shows one."
      },
      "declaredNotes": {
        "type": "string",
        "description": "Declared notes, if the certificate shows any."
      }
    },
    "required": [
      "fingerprint",
      "attestation",
      "signature"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "spaziogenesi_lookup_certificate",
  "kind": "answer",
  "impl": "imperative",
  "description": "Check whether a SHA-256 fingerprint has an archived certificate with a permanent public verification page, and return its URL. A negative answer does not mean nothing was ever attested: an attestation created without requesting the PDF certificate archives nothing.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "fingerprint": {
        "type": "string",
        "description": "The SHA-256 fingerprint, 64 hexadecimal characters."
      }
    },
    "required": [
      "fingerprint"
    ],
    "additionalProperties": false
  },
  "page": "/"
}