ToIP Alignment

NANDA aligns with the Trust over IP (ToIP) Foundation and the Decentralized Identity Foundation (DIF) Trust Establishment working group to provide interoperable, standards-based trust infrastructure for AI agents.

Trust Framework Model

A Trust Framework defines the governance rules, policies, and standards that participants in a trust ecosystem agree to follow. NANDA registers trust frameworks as metadata records that agents can reference:

Framework Registration

Each framework has a unique framework_id, version, governance URL, and alignment tag (e.g. toip-tswg, dif-trust-graph).

Pre-Seeded Framework

NANDA ships with the kym-trust-v1 framework pre-seeded — the KnowYourModel Trust Framework, aligned with ToIP TSWG standards.

Framework Schema

{
  "framework_id": "kym-trust-v1",
  "name": "KnowYourModel Trust Framework",
  "version": "1.0",
  "governance_url": "https://knowyourmodel.ai/docs",
  "alignment": "toip-tswg"
}

Trust Graph

The Trust Graph models directed trust relationships between DIDs (Decentralized Identifiers). Each edge represents a trust assertion from one party to another:

Directed Edges

Each edge has a from_did, to_did, relationship type (issuer, verifier, peer, endorser), and a trust_level from 0.0 to 1.0.

Path Finding

BFS-based path computation finds the shortest trust chain between two DIDs. Trust is multiplicative along the path — each hop reduces the aggregate trust level.

Evidence & Validity

Edges can reference an evidence_uri (e.g. a VC proof), a framework_id, and optional valid_from / valid_until timestamps.

Relationship Types

RelationshipDescriptionExample
issuerCredential issuer → subjectNANDA node issues VC to agent
verifierVerifier trusts issuerConsumer trusts NANDA node's credentials
peerBidirectional peer trustTwo federated NANDA nodes
endorserThird-party endorsementAudit body endorses agent compliance

API Endpoints

Trust framework and graph data are accessible via authenticated API endpoints:

GET /api/trust/framework              — List all registered frameworks
GET /api/trust/framework?id=kym-trust-v1  — Get specific framework
GET /api/trust/framework/graph?did=did:web:example  — Trust edges for a DID
GET /api/trust/framework/graph?from=did:A&to=did:B  — Compute trust path

All endpoints require a valid nanda_ API key via Bearer token authentication.

Standards Alignment

ToIP TSWG

Trust Spanning Working Group — defines the Trust Spanning Protocol for cross-domain trust establishment.

DIF Trust Graph

Joint ToIP/DIF initiative for modeling trust relationships as directed graphs with evidence and attestation.

W3C VC

Verifiable Credentials Data Model v2.0 — the foundational standard for cryptographically verifiable claims.

See also Trust & Security for Ed25519, VCs, and Bitstring Status List · Federation for cross-node trust scores
Related reading Trust Without Borders — cross-registry identity and trust in the Agentic Web series · Governance at Scale — multi-stakeholder governance frameworks

Coming Soon

By Invitation Only