<- Go to Data Types    Go to ToC

1. Definition 2. Functional Requirements 3. Syntax 4. Semantics

1 Definition

A Trust Operation is a structured description of an action performed within the MPAI‑PTF Trust Framework that affects trust establishment, verification, or lifecycle management. Trust Operations provide a machine‑readable record of what trust‑related action occurred, who performed it, when, on what object, and with what outcome.

Trust Operations enable:

  • auditability
  • traceability
  • policy enforcement
  • verification workflows
  • compliance reporting

They are intentionally generic so they can describe operations such as:

  • verifying a signature
  • validating a credential
  • checking evidence freshness
  • evaluating a policy
  • binding a policy
  • issuing a credential
  • revoking a credential
  • updating lifecycle state

2 Functional Requirements

A Trust Operation shall:

  • Identify the operation
    • Include a header indicating the version.
    • Include a unique operation identifier.
    • Include the time at which the operation occurred.
  • Describe the operation
    • Include an operation type from the Trust Operation Taxonomy.
    • Include the target object (e.g., CII, ICR, PLC, Evidence).
  • Record the actor
    • Include the identifier of the entity performing the operation.
  • Record the outcome
    • Include a status (e.g., Success, Failure).
    • Optionally include a reason for failure.
  • Support cryptographic integrity
    • 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
    • Include optional descriptive metadata.
    • Include optional Data Exchange Metadata.
  • Forbid undeclared fields
    • Reject any properties not defined in the schema.

3 Syntax

https://schemas.mpai.community/PTF/V1.0/data/TrustOperation.json

4 Semantics

Label Description
Header Version header of the form PTF-TOP-Vx.y.
MInstanceID Optional managing instance identifier.
UEnvironmentID ID of the U-Environment.
TrustOperationID Unique identifier of the trust operation.
TrustOperationTime Time at which the operation occurred (OSD Time).
OperationType Operation type identifier from the Trust Operation Taxonomy.
TargetType Type of object the operation applies to: CII, InstanceCredential, ProcessLifecycleCredential, AttestationEvidence, PolicyBinding, Profile, TrustMessage, or – for the decisions of a Controller on its links – Controller, ExternalLink, ExternalMessage, Payload.
TargetID Identifier of the target object.
ActorID Identifier of the entity performing the operation.
Status Outcome of the operation: Success, Failure.
FailureReason Optional human‑readable reason for failure.
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 Data Exchange Metadata.
DescrMetadata Optional descriptive metadata (max 2048 chars).

<- Go to Data Types    Go to ToC