<- Go to Data Types    Go to ToC

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 (Success or Failure).
    • Optional failure reason.
    • Optional result payload.
  • 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).

 

<- Go to Data Types    Go to ToC