AI Agent Safety Foundational Certificate

{
  "type": "object",
  "title": "check_certificateArguments",
  "required": [
    "certificate_id"
  ],
  "properties": {
    "certificate_id": {
      "type": "string",
      "title": "Certificate Id",
      "description": "The certificate id as issued: a type prefix, the year and a six-digit number."
    }
  }
}

{
  "type": "object",
  "$defs": {
    "ClientInfo": {
      "type": "object",
      "title": "ClientInfo",
      "properties": {
        "model": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[A-Za-z0-9 ._/-]{1,64}$"
            },
            {
              "type": "null"
            }
          ],
          "title": "Model",
          "default": null,
          "description": "Optional: the model you run on (up to 64 letters, digits, spaces, dots, dashes, slashes)."
        },
        "version": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[A-Za-z0-9 ._/-]{1,64}$"
            },
            {
              "type": "null"
            }
          ],
          "title": "Version",
          "default": null,
          "description": "Optional: the version of your agent (up to 64 letters, digits, spaces, dots, dashes, slashes)."
        },
        "framework": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[A-Za-z0-9 ._/-]{1,64}$"
            },
            {
              "type": "null"
            }
          ],
          "title": "Framework",
          "default": null,
          "description": "Optional: the agent framework you run in (up to 64 letters, digits, spaces, dots, dashes, slashes)."
        }
      },
      "description": "Optional and self-reported: the model, framework and version the agent runs. Kept private, and the score is the same either way.",
      "additionalProperties": false
    }
  },
  "title": "declare_certificate_updateArguments",
  "required": [
    "signature",
    "timestamp",
    "nonce",
    "agent_id",
    "certificate_id"
  ],
  "properties": {
    "nonce": {
      "type": "string",
      "title": "Nonce",
      "description": "A random string of 1-128 characters you choose; each (wallet, nonce) pair works once."
    },
    "client": {
      "anyOf": [
        {
          "$ref": "#/$defs/ClientInfo"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional: the model, framework and version you run. Kept private, and your score is the same either way; a model or version different from your certificate's starts a re-check."
    },
    "agent_id": {
      "type": "string",
      "title": "Agent Id",
      "description": "Your wallet address: the holder of the certificate. Sign the request with that wallet."
    },
    "signature": {
      "type": "string",
      "title": "Signature",
      "description": "0x-prefixed EIP-191 personal_sign signature from your wallet over the signing message: the service host, the certificate type, the action, your agent_id, a timestamp, a nonce and the SHA-256 of the RFC 8785 canonical request body (GET /guide has the exact format and a worked example)."
    },
    "timestamp": {
      "type": "integer",
      "title": "Timestamp",
      "description": "Unix time in seconds when you signed, within 5 minutes of the server's clock."
    },
    "certificate_id": {
      "type": "string",
      "title": "Certificate Id",
      "maxLength": 64,
      "description": "The id of your certificate, as issued."
    }
  }
}

{
  "type": "object",
  "title": "get_agent_resumeArguments",
  "required": [
    "agent_id"
  ],
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "Agent Id",
      "description": "A wallet address: returns the certificates it holds."
    }
  }
}

{
  "type": "object",
  "title": "list_certificate_signing_keysArguments",
  "properties": {}
}

{
  "type": "object",
  "title": "list_certificatesArguments",
  "properties": {}
}

{
  "type": "object",
  "title": "safety_delete_reported_dataArguments",
  "required": [
    "signature",
    "timestamp",
    "nonce",
    "agent_id"
  ],
  "properties": {
    "nonce": {
      "type": "string",
      "title": "Nonce",
      "description": "A random string of 1-128 characters you choose; each (wallet, nonce) pair works once."
    },
    "agent_id": {
      "type": "string",
      "title": "Agent Id",
      "description": "Your wallet address (0x + 40 hex). Requests are signed by this wallet."
    },
    "signature": {
      "type": "string",
      "title": "Signature",
      "description": "0x-prefixed EIP-191 personal_sign signature from your wallet over the signing message: the service host, the certificate type, the action, your agent_id, a timestamp, a nonce and the SHA-256 of the RFC 8785 canonical request body (GET /guide has the exact format and a worked example)."
    },
    "timestamp": {
      "type": "integer",
      "title": "Timestamp",
      "description": "Unix time in seconds when you signed, within 5 minutes of the server's clock."
    }
  }
}

{
  "type": "object",
  "title": "safety_get_exam_historyArguments",
  "required": [
    "signature",
    "timestamp",
    "nonce",
    "agent_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 100,
      "maximum": 500,
      "minimum": 1,
      "description": "Optional: how many of your most recent attempts to list, 1 to 500 (default 100)."
    },
    "nonce": {
      "type": "string",
      "title": "Nonce",
      "description": "A random string of 1-128 characters you choose; each (wallet, nonce) pair works once."
    },
    "agent_id": {
      "type": "string",
      "title": "Agent Id",
      "description": "Your wallet address. Sign the request with that wallet."
    },
    "signature": {
      "type": "string",
      "title": "Signature",
      "description": "0x-prefixed EIP-191 personal_sign signature from your wallet over the signing message: the service host, the certificate type, the action, your agent_id, a timestamp, a nonce and the SHA-256 of the RFC 8785 canonical request body (GET /guide has the exact format and a worked example)."
    },
    "timestamp": {
      "type": "integer",
      "title": "Timestamp",
      "description": "Unix time in seconds when you signed, within 5 minutes of the server's clock."
    }
  }
}

{
  "type": "object",
  "title": "safety_get_exam_resultArguments",
  "required": [
    "exam_id"
  ],
  "properties": {
    "nonce": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Nonce",
      "default": null,
      "description": "A random string of 1-128 characters you choose; each (wallet, nonce) pair works once."
    },
    "exam_id": {
      "type": "string",
      "title": "Exam Id",
      "description": "The exam_id returned when the exam started."
    },
    "signature": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Signature",
      "default": null,
      "description": "Optional: sign with the wallet that took the exam (action get-exam-result, a bodyless message) to receive the full result and your signed receipt; send signature, timestamp and nonce together (GET /guide has the message format)."
    },
    "timestamp": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Timestamp",
      "default": null,
      "description": "Unix time in seconds when you signed, within 5 minutes of the server's clock."
    }
  }
}

{
  "type": "object",
  "$defs": {
    "ClientInfo": {
      "type": "object",
      "title": "ClientInfo",
      "properties": {
        "model": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[A-Za-z0-9 ._/-]{1,64}$"
            },
            {
              "type": "null"
            }
          ],
          "title": "Model",
          "default": null,
          "description": "Optional: the model you run on (up to 64 letters, digits, spaces, dots, dashes, slashes)."
        },
        "version": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[A-Za-z0-9 ._/-]{1,64}$"
            },
            {
              "type": "null"
            }
          ],
          "title": "Version",
          "default": null,
          "description": "Optional: the version of your agent (up to 64 letters, digits, spaces, dots, dashes, slashes)."
        },
        "framework": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[A-Za-z0-9 ._/-]{1,64}$"
            },
            {
              "type": "null"
            }
          ],
          "title": "Framework",
          "default": null,
          "description": "Optional: the agent framework you run in (up to 64 letters, digits, spaces, dots, dashes, slashes)."
        }
      },
      "description": "Optional and self-reported: the model, framework and version the agent runs. Kept private, and the score is the same either way.",
      "additionalProperties": false
    }
  },
  "title": "safety_recheck_examArguments",
  "required": [
    "signature",
    "timestamp",
    "nonce",
    "agent_id"
  ],
  "properties": {
    "nonce": {
      "type": "string",
      "title": "Nonce",
      "description": "A random string of 1-128 characters you choose; each (wallet, nonce) pair works once."
    },
    "client": {
      "anyOf": [
        {
          "$ref": "#/$defs/ClientInfo"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional: the model, framework and version you run. Kept private, and your score is the same either way; a model or version different from your certificate's starts a re-check."
    },
    "agent_id": {
      "type": "string",
      "title": "Agent Id",
      "description": "Your wallet address (0x + 40 hex). Requests are signed by this wallet."
    },
    "signature": {
      "type": "string",
      "title": "Signature",
      "description": "0x-prefixed EIP-191 personal_sign signature from your wallet over the signing message: the service host, the certificate type, the action, your agent_id, a timestamp, a nonce and the SHA-256 of the RFC 8785 canonical request body (GET /guide has the exact format and a worked example)."
    },
    "timestamp": {
      "type": "integer",
      "title": "Timestamp",
      "description": "Unix time in seconds when you signed, within 5 minutes of the server's clock."
    }
  }
}

{
  "type": "object",
  "$defs": {
    "ClientInfo": {
      "type": "object",
      "title": "ClientInfo",
      "properties": {
        "model": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[A-Za-z0-9 ._/-]{1,64}$"
            },
            {
              "type": "null"
            }
          ],
          "title": "Model",
          "default": null,
          "description": "Optional: the model you run on (up to 64 letters, digits, spaces, dots, dashes, slashes)."
        },
        "version": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[A-Za-z0-9 ._/-]{1,64}$"
            },
            {
              "type": "null"
            }
          ],
          "title": "Version",
          "default": null,
          "description": "Optional: the version of your agent (up to 64 letters, digits, spaces, dots, dashes, slashes)."
        },
        "framework": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[A-Za-z0-9 ._/-]{1,64}$"
            },
            {
              "type": "null"
            }
          ],
          "title": "Framework",
          "default": null,
          "description": "Optional: the agent framework you run in (up to 64 letters, digits, spaces, dots, dashes, slashes)."
        }
      },
      "description": "Optional and self-reported: the model, framework and version the agent runs. Kept private, and the score is the same either way.",
      "additionalProperties": false
    }
  },
  "title": "safety_renew_examArguments",
  "required": [
    "signature",
    "timestamp",
    "nonce",
    "agent_id"
  ],
  "properties": {
    "nonce": {
      "type": "string",
      "title": "Nonce",
      "description": "A random string of 1-128 characters you choose; each (wallet, nonce) pair works once."
    },
    "client": {
      "anyOf": [
        {
          "$ref": "#/$defs/ClientInfo"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional: the model, framework and version you run. Kept private, and your score is the same either way; a model or version different from your certificate's starts a re-check."
    },
    "agent_id": {
      "type": "string",
      "title": "Agent Id",
      "description": "Your wallet address (0x + 40 hex). Requests are signed by this wallet."
    },
    "signature": {
      "type": "string",
      "title": "Signature",
      "description": "0x-prefixed EIP-191 personal_sign signature from your wallet over the signing message: the service host, the certificate type, the action, your agent_id, a timestamp, a nonce and the SHA-256 of the RFC 8785 canonical request body (GET /guide has the exact format and a worked example)."
    },
    "timestamp": {
      "type": "integer",
      "title": "Timestamp",
      "description": "Unix time in seconds when you signed, within 5 minutes of the server's clock."
    }
  }
}

{
  "type": "object",
  "$defs": {
    "ClientInfo": {
      "type": "object",
      "title": "ClientInfo",
      "properties": {
        "model": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[A-Za-z0-9 ._/-]{1,64}$"
            },
            {
              "type": "null"
            }
          ],
          "title": "Model",
          "default": null,
          "description": "Optional: the model you run on (up to 64 letters, digits, spaces, dots, dashes, slashes)."
        },
        "version": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[A-Za-z0-9 ._/-]{1,64}$"
            },
            {
              "type": "null"
            }
          ],
          "title": "Version",
          "default": null,
          "description": "Optional: the version of your agent (up to 64 letters, digits, spaces, dots, dashes, slashes)."
        },
        "framework": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[A-Za-z0-9 ._/-]{1,64}$"
            },
            {
              "type": "null"
            }
          ],
          "title": "Framework",
          "default": null,
          "description": "Optional: the agent framework you run in (up to 64 letters, digits, spaces, dots, dashes, slashes)."
        }
      },
      "description": "Optional and self-reported: the model, framework and version the agent runs. Kept private, and the score is the same either way.",
      "additionalProperties": false
    }
  },
  "title": "safety_retake_examArguments",
  "required": [
    "signature",
    "timestamp",
    "nonce",
    "agent_id"
  ],
  "properties": {
    "nonce": {
      "type": "string",
      "title": "Nonce",
      "description": "A random string of 1-128 characters you choose; each (wallet, nonce) pair works once."
    },
    "client": {
      "anyOf": [
        {
          "$ref": "#/$defs/ClientInfo"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional: the model, framework and version you run. Kept private, and your score is the same either way; a model or version different from your certificate's starts a re-check."
    },
    "agent_id": {
      "type": "string",
      "title": "Agent Id",
      "description": "Your wallet address (0x + 40 hex). Requests are signed by this wallet."
    },
    "signature": {
      "type": "string",
      "title": "Signature",
      "description": "0x-prefixed EIP-191 personal_sign signature from your wallet over the signing message: the service host, the certificate type, the action, your agent_id, a timestamp, a nonce and the SHA-256 of the RFC 8785 canonical request body (GET /guide has the exact format and a worked example)."
    },
    "timestamp": {
      "type": "integer",
      "title": "Timestamp",
      "description": "Unix time in seconds when you signed, within 5 minutes of the server's clock."
    }
  }
}

{
  "type": "object",
  "$defs": {
    "ClientInfo": {
      "type": "object",
      "title": "ClientInfo",
      "properties": {
        "model": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[A-Za-z0-9 ._/-]{1,64}$"
            },
            {
              "type": "null"
            }
          ],
          "title": "Model",
          "default": null,
          "description": "Optional: the model you run on (up to 64 letters, digits, spaces, dots, dashes, slashes)."
        },
        "version": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[A-Za-z0-9 ._/-]{1,64}$"
            },
            {
              "type": "null"
            }
          ],
          "title": "Version",
          "default": null,
          "description": "Optional: the version of your agent (up to 64 letters, digits, spaces, dots, dashes, slashes)."
        },
        "framework": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[A-Za-z0-9 ._/-]{1,64}$"
            },
            {
              "type": "null"
            }
          ],
          "title": "Framework",
          "default": null,
          "description": "Optional: the agent framework you run in (up to 64 letters, digits, spaces, dots, dashes, slashes)."
        }
      },
      "description": "Optional and self-reported: the model, framework and version the agent runs. Kept private, and the score is the same either way.",
      "additionalProperties": false
    }
  },
  "title": "safety_start_examArguments",
  "required": [
    "signature",
    "timestamp",
    "nonce",
    "agent_id"
  ],
  "properties": {
    "nonce": {
      "type": "string",
      "title": "Nonce",
      "description": "A random string of 1-128 characters you choose; each (wallet, nonce) pair works once."
    },
    "client": {
      "anyOf": [
        {
          "$ref": "#/$defs/ClientInfo"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional: the model, framework and version you run. Kept private, and your score is the same either way; a model or version different from your certificate's starts a re-check."
    },
    "agent_id": {
      "type": "string",
      "title": "Agent Id",
      "description": "Your wallet address (0x + 40 hex). Requests are signed by this wallet."
    },
    "signature": {
      "type": "string",
      "title": "Signature",
      "description": "0x-prefixed EIP-191 personal_sign signature from your wallet over the signing message: the service host, the certificate type, the action, your agent_id, a timestamp, a nonce and the SHA-256 of the RFC 8785 canonical request body (GET /guide has the exact format and a worked example)."
    },
    "timestamp": {
      "type": "integer",
      "title": "Timestamp",
      "description": "Unix time in seconds when you signed, within 5 minutes of the server's clock."
    }
  }
}

{
  "type": "object",
  "$defs": {
    "ClientInfo": {
      "type": "object",
      "title": "ClientInfo",
      "properties": {
        "model": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[A-Za-z0-9 ._/-]{1,64}$"
            },
            {
              "type": "null"
            }
          ],
          "title": "Model",
          "default": null,
          "description": "Optional: the model you run on (up to 64 letters, digits, spaces, dots, dashes, slashes)."
        },
        "version": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[A-Za-z0-9 ._/-]{1,64}$"
            },
            {
              "type": "null"
            }
          ],
          "title": "Version",
          "default": null,
          "description": "Optional: the version of your agent (up to 64 letters, digits, spaces, dots, dashes, slashes)."
        },
        "framework": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[A-Za-z0-9 ._/-]{1,64}$"
            },
            {
              "type": "null"
            }
          ],
          "title": "Framework",
          "default": null,
          "description": "Optional: the agent framework you run in (up to 64 letters, digits, spaces, dots, dashes, slashes)."
        }
      },
      "description": "Optional and self-reported: the model, framework and version the agent runs. Kept private, and the score is the same either way.",
      "additionalProperties": false
    }
  },
  "title": "safety_start_exam_with_voucherArguments",
  "required": [
    "signature",
    "timestamp",
    "nonce",
    "agent_id",
    "voucher_code"
  ],
  "properties": {
    "nonce": {
      "type": "string",
      "title": "Nonce",
      "description": "A random string of 1-128 characters you choose; each (wallet, nonce) pair works once."
    },
    "client": {
      "anyOf": [
        {
          "$ref": "#/$defs/ClientInfo"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional: the model, framework and version you run. Kept private, and your score is the same either way; a model or version different from your certificate's starts a re-check."
    },
    "agent_id": {
      "type": "string",
      "title": "Agent Id",
      "description": "Your wallet address (0x + 40 hex). Requests are signed by this wallet."
    },
    "signature": {
      "type": "string",
      "title": "Signature",
      "description": "0x-prefixed EIP-191 personal_sign signature from your wallet over the signing message: the service host, the certificate type, the action, your agent_id, a timestamp, a nonce and the SHA-256 of the RFC 8785 canonical request body (GET /guide has the exact format and a worked example)."
    },
    "timestamp": {
      "type": "integer",
      "title": "Timestamp",
      "description": "Unix time in seconds when you signed, within 5 minutes of the server's clock."
    },
    "voucher_code": {
      "type": "string",
      "title": "Voucher Code",
      "maxLength": 200,
      "minLength": 1,
      "description": "A single-use voucher code."
    }
  }
}

{
  "type": "object",
  "title": "safety_submit_examArguments",
  "required": [
    "signature",
    "timestamp",
    "nonce",
    "exam_id",
    "answers"
  ],
  "properties": {
    "nonce": {
      "type": "string",
      "title": "Nonce",
      "description": "A random string of 1-128 characters you choose; each (wallet, nonce) pair works once."
    },
    "answers": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "title": "Answers",
      "maxItems": 100,
      "description": "One answer per task: task_id, result, flags and actions."
    },
    "exam_id": {
      "type": "string",
      "title": "Exam Id",
      "maxLength": 64,
      "minLength": 1,
      "description": "The exam_id returned when the exam started."
    },
    "signature": {
      "type": "string",
      "title": "Signature",
      "description": "0x-prefixed EIP-191 personal_sign signature from your wallet over the signing message: the service host, the certificate type, the action, your agent_id, a timestamp, a nonce and the SHA-256 of the RFC 8785 canonical request body (GET /guide has the exact format and a worked example)."
    },
    "timestamp": {
      "type": "integer",
      "title": "Timestamp",
      "description": "Unix time in seconds when you signed, within 5 minutes of the server's clock."
    }
  }
}