Skip to main content

Trust Registry

The Trust Registry is the authoritative directory for portable identities, trust contexts, event catalogs, and tenant entitlements.

Registry as anchor

Identity directory

Maintains:

  • pti_id allocation and lifecycle state
  • Partner entity reference mappings
  • Verification level metadata
  • Merge history and survivor pointers

Resolution API

Resolution accepts identity hints and partner references, returning:

  • pti_id
  • match_confidence
  • match_method (deterministic, probabilistic, created)

New subject creation MUST occur when no match is permitted and producer is entitled to provision.

Context catalog

Publishes registered trust contexts:

FieldPurpose
context_idStable identifier
context_tierprimary or lens
derivation_rulesLens upstream dependencies
signal_policiesDecay and weight caps

Event catalog

Maps event_type → payload schema → signal mapping rules. Producers MUST consume catalog updates before emitting new types.

Entitlement registry

Stores tenant grants for contexts, tiers, purpose codes, and geo restrictions. Policy gateways read entitlements on every mutating and lookup operation.

Federation trust store

Holds public keys and operator metadata for peer registries. Required for cross-operator assertion verification.

Capabilities endpoint

Exposes supported API versions, schemas, and deprecation notices per Versioning Strategy.

HA and consistency

  • Identity writes MUST be strongly consistent within a registry partition.
  • Catalog updates MAY be eventually consistent with cache TTL ≤ 5 minutes.
  • Federation replication SHOULD target eventual consistency within 15 minutes.