Skip to content

Routing Subject Binding v1

Source schema: doc/schemas/routing-subject-binding.v1.schema.json

Public or presentable binding between a privacy-preserving routing subject and a node that can receive direct delivery, contact, or inbox artifacts for that subject. It is intentionally not a root participant locator.

Governing Basis

Project Lineage

Requirements

Stories

Fields

Field Required Shape Description
schema yes const: routing-subject-binding.v1
schema/v yes const: 1
binding/id yes string
routing-subject/id yes string Public routing subject. It may be derived from or delegated by a participant privately, but this artifact does not reveal that root relationship.
node/id yes string
disclosure/mode no enum: public-unlinked, participant-disclosed, org-disclosed, present-on-demand
purposes yes array
encryption/key/alg yes string
encryption/key/public yes string
valid/from yes string
valid/until no string
scope/federation-id no string
scope/topic-patterns no ref: #/$defs/stringList
scope/content-schemas no ref: #/$defs/stringList
proof/routing-subject-signature yes ref: #/$defs/signature
proof/node-acceptance-signature yes ref: #/$defs/signature
policy_annotations no object

Definitions

Definition Shape Description
stringList array
signature object
## Field Semantics

schema

  • Required: yes
  • Shape: const: routing-subject-binding.v1

schema/v

  • Required: yes
  • Shape: const: 1

binding/id

  • Required: yes
  • Shape: string

routing-subject/id

  • Required: yes
  • Shape: string

Public routing subject. It may be derived from or delegated by a participant privately, but this artifact does not reveal that root relationship.

node/id

  • Required: yes
  • Shape: string

disclosure/mode

  • Required: no
  • Shape: enum: public-unlinked, participant-disclosed, org-disclosed, present-on-demand

purposes

  • Required: yes
  • Shape: array

encryption/key/alg

  • Required: yes
  • Shape: string

encryption/key/public

  • Required: yes
  • Shape: string

valid/from

  • Required: yes
  • Shape: string

valid/until

  • Required: no
  • Shape: string

scope/federation-id

  • Required: no
  • Shape: string

scope/topic-patterns

  • Required: no
  • Shape: ref: #/$defs/stringList

scope/content-schemas

  • Required: no
  • Shape: ref: #/$defs/stringList

proof/routing-subject-signature

  • Required: yes
  • Shape: ref: #/$defs/signature

proof/node-acceptance-signature

  • Required: yes
  • Shape: ref: #/$defs/signature

policy_annotations

  • Required: no
  • Shape: object

Definition Semantics

$defs.stringList

  • Shape: array

$defs.signature

  • Shape: object