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.