| 1. Definition | 2. Functional Requirements | 3. Syntax | 4. Semantics |
1 Definition
A Trust Message is a signed, structured communication exchanged between entities participating in the MPAI‑PTF Trust Framework. A Trust Message may represent either:
- a Trust Request, in which an entity asks another entity to perform a trust‑related operation, or
- a Trust Response, in which an entity returns the result of such a request.
Trust Messages provide a uniform, cryptographically protected mechanism for initiating and responding to trust operations, enabling interoperability, auditability, and policy‑driven verification.
2 Functional Requirements
A Trust Message shall:
- Identify the message
- Include a versioned header.
- Include a unique message identifier.
- Include the time at which the message was created.
- Indicate the message type
"TrustRequest"or"TrustResponse".
- Identify the communicating parties
- A Trust Request shall include a RequesterID.
- A Trust Response shall include a ResponderID.
- Carry request information (for TrustRequest)
- Requested operation.
- Target object type.
- Target object identifier.
- Carry response information (for TrustResponse)
- Status (
SuccessorFailure). - Optional failure reason.
- Optional result payload.
- Status (
- Provide integrity protection
- Include a signature over the canonical form of the object without it (PTF-JSON-CANON-V1), in hexadecimal, and the KeyID of the key that verifies it.
- Support metadata
- Optional descriptive metadata.
- Optional Data Exchange Metadata.
- Reject undeclared fields
- Only the fields defined in the schema shall be permitted.
3 Syntax
https://schemas.mpai.community/PTF/V1.0/data/TrustMessage.json
4 Semantics
| Field | Description |
|---|---|
| Header | Version header of the form PTF-MSG-Vx.y. |
| MInstanceID | ID of the M-Instance. |
| UEnvironmentID | ID of the U-Environment. |
| MessageType | Indicates whether the message is a TrustRequest or a TrustResponse. |
| MessageID | Unique identifier of the trust message. |
| MessageTime | Time at which the message was created, using the OSD Time data type. |
| RequesterID | Identifier of the entity making the request (present only for TrustRequest). |
| ResponderID | Identifier of the entity responding (present only for TrustResponse). |
| Request.Operation | The trust operation being requested. |
| Request.TargetType | Type of object the request concerns (e.g., CII, InstanceCredential). |
| Request.TargetID | Identifier of the target object. |
| Response.Status | Result of the request: Success or Failure. |
| Response.Reason | Optional human‑readable reason for failure. |
| Response.Result | Optional result payload returned by the responder. |
| Presentation | What the sender presents to be trusted, in a Trust Request or a Trust Response: either a Process Instance – its CII and Instance Credential (both required), with its Process Lifecycle Credential, its Attestation Evidence and the CredentialChain – or a party that is itself a Trust Anchor (in the AIF, a Controller, or what executes AIMs apart from it), its TrustAnchor alone. A party that is a Trust Anchor is trusted as an anchor the receiver is configured with. |
| – CII | The Cryptographic Instance Identity of the presenting Process Instance. |
| – InstanceCredential | Its Instance Credential. |
| – ProcessLifecycleCredential | Optional. Its Process Lifecycle Credential. |
| – AttestationEvidence | Optional. Its Attestation Evidence. |
| – CredentialChain | Optional. The issuers between the credential and a Trust Anchor, each its CII and the credential that entitles it to issue. |
| – TrustAnchor | The Trust Anchor object of a party that is itself a Trust Anchor; not together with CII, InstanceCredential or CredentialChain. |
| Signature | Hexadecimal ASCII-encoded signature over the canonical form (PTF-JSON-CANON-V1) of the object without its Signature, by the key KeyID names. |
| KeyID | Identifier of the key that verifies the Signature; the key’s identity states its algorithm. |
| DataXMData | Optional Data Exchange Metadata. |
| DescrMetadata | Optional human‑readable descriptive metadata (max 2048 characters). |