Skip to main content

TRACE v0.1 — hardware-attested governance records for AI agents

Project description

TRACE

TRACE: Trust Runtime Attestation and Compliance Evidence

License: CC BY 4.0 AAIF Spec PyPI Discord

Developer Preview. Launching at Confidential Computing Summit, June 23 2026. May have breaking changes before v1.0.

Specification  |  Schema  |  Examples  |  Registry  |  Reference Impl

An open specification for hardware-attested AI agent governance records. TRACE defines the format, anchoring protocol, and verification rules for cryptographically provable evidence that an AI agent ran under a specific policy, in a verified hardware environment, on classified data, invoking identified tools, bound into a single signed artifact rooted in silicon attestation.

What a TRACE Trust Record Is

{
  "eat_profile": "tag:agentrust.io,2026:trace-v0.1",
  "iat": 1750676142,
  "subject": "spiffe://trust.example.org/agent/payments-processor/prod",  // or "did:mesh:spiffe://..."
  "model": {
    "provider": "anthropic",
    "model_id": "claude-sonnet-4-6",
    "version": "20251001",
    "weights_digest": "sha256:a3f8d2c1..."
  },
  "runtime": {
    "platform": "amd-sev-snp",
    "measurement": "sha384:c9e4b1d2e3f4...",
    "rim_uri": "https://kdsintf.amd.com/vcek/v1/..."
  },
  "policy": {
    "bundle_hash": "sha256:b2c3d4e5...",
    "enforcement_mode": "enforce",
    "version": "1.2.0"
  },
  "data_class": "confidential",
  "tool_transcript": {
    "hash": "sha256:d4e5f6a7...",
    "call_count": 3
  },
  "build_provenance": {
    "slsa_level": 2,
    "builder": "https://github.com/slsa-framework/slsa-github-generator",
    "digest": "sha256:e5f6a7b8..."
  },
  "appraisal": {
    "status": "affirming",
    "verifier": "https://trust-authority.example.org",
    "policy_ref": "https://trust-authority.example.org/policy/agent-v1"
  },
  "transparency": "https://registry.agentrust.io/claim/trace-2026-06-23T09:15:42Z-f2a8d1",
  "cnf": {
    "jwk": {"kty": "EC", "crv": "P-256", "x": "MEkwEw...", "y": "..."}
  }
}

The record is a single EAT envelope (RFC 9711). Each field is independently verifiable. No callback to the issuer is required.

Supported platforms

Platform v0.1 v0.2 (planned) Notes
intel-tdx Yes Yes
amd-sev-snp Yes Yes
nvidia-h100 Yes Yes
gpu-cc No Planned Generic GPU confidential compute
opaque Yes Yes Explicit opt-in; contact maintainers

Specification

Standards composition

TRACE profiles existing standards rather than replacing them:

Primitive Role in TRACE
RATS / EAT (RFC 9711) Wire envelope and claim model
SLSA Provenance v1.0 Build-time provenance (build_provenance)
SPIFFE SVID / DID URI Workload identity (subject)
SCITT Append-only transparency anchoring (transparency)
EAR (draft-ietf-rats-ar4si) Verifier appraisal output (appraisal)
MCP / A2A Agent tool-call transcript surface (tool_transcript)
AIBOM (SPDX 3.0 / CycloneDX 1.7) Model component inventory (model)

Reference implementation

agentrust-io/cmcp -- Confidential MCP Runtime. Hardware-attested policy enforcement at the MCP tool-call boundary on Intel TDX, AMD SEV-SNP, and NVIDIA H100/Blackwell.

Registry

A public append-only Merkle registry of TRACE Trust Record anchors: agentrust-io/trace-registry.

Install

pip install agentrust-trace
from agentrust_trace import TrustRecord, sign_record, load_signing_key

key = load_signing_key()  # reads TRACE_PRIVATE_KEY_PEM or generates ephemeral
record = sign_record(payload, key)
TrustRecord.model_validate(record)  # validate before writing

Status

v0.2. subject now accepts DID URIs (did:) in addition to SPIFFE SVIDs. slsa_level: 0 supported for software-only deployments. Published at Confidential Computing Summit, San Francisco, June 23 2026. Targeting submission to the Agentic AI Foundation (AAIF) under the Linux Foundation.

Community

Questions, feedback, integration help: Discord.

License

Creative Commons Attribution 4.0 International (CC BY 4.0)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agentrust_trace-0.2.0.tar.gz (44.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agentrust_trace-0.2.0-py3-none-any.whl (12.6 kB view details)

Uploaded Python 3

File details

Details for the file agentrust_trace-0.2.0.tar.gz.

File metadata

  • Download URL: agentrust_trace-0.2.0.tar.gz
  • Upload date:
  • Size: 44.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agentrust_trace-0.2.0.tar.gz
Algorithm Hash digest
SHA256 dec08dd9cb31a2e72a952a1e73114ef622e0a940e1511548c17e8704ec252ef8
MD5 d295596bc9d24e4989ada7e15bd5d98c
BLAKE2b-256 b6f63a4a2015df8b473d31232eee74f008836bb23e6a0c89cf54770090fea043

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentrust_trace-0.2.0.tar.gz:

Publisher: publish.yml on agentrust-io/trace-spec

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file agentrust_trace-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: agentrust_trace-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 12.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agentrust_trace-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b5aabd969817e5c6669a5f0bf4464a7a0155783a38d1f5e451c82de66c000427
MD5 71f0926f1fe64d682700ac1064d78a51
BLAKE2b-256 6d66edee073a3f3e7f2c7dfc1429611ade2a484d875cee51dda1395c2e2f288b

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentrust_trace-0.2.0-py3-none-any.whl:

Publisher: publish.yml on agentrust-io/trace-spec

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page