Skip to content

Local Contact v1

Source schema: doc/schemas/local-contact.v1.schema.json

Daemon-local address-book and contact continuity record. It is never published as a Contact Catalog claim and may contain raw handles, labels, UX metadata, and pairwise routing continuity state. Ownership note: Local Contact Store owns private contact records; Local Relationship Layer owns classes, memberships, relationship policy predicates, and pairwise relationship facts.

Governing Basis

Project Lineage

Stories

Fields

Field Required Shape Description
schema yes const: local-contact.v1
contact/id yes string
handle/kind yes enum: email, phone, other
handle/raw yes string Raw user-entered handle. This stays daemon-local.
handle/normalized yes string
handle/digest yes string
label no string Compatibility single display label.
labels no array User-managed labels for grouping and search.
metadata no object Daemon-local UX/provenance metadata. It is not network evidence.
state yes enum: pending, active, rejected, blocked, archived
pairwise/contact-nym-id no string Compatibility pointer to the current active pairwise mapping.
routing-subject/id no string
remote/subject no ref: #/$defs/subject
source/ref no string
created/at yes string
updated/at yes string

Definitions

Definition Shape Description
subject object
## Field Semantics

schema

  • Required: yes
  • Shape: const: local-contact.v1

contact/id

  • Required: yes
  • Shape: string

handle/kind

  • Required: yes
  • Shape: enum: email, phone, other

handle/raw

  • Required: yes
  • Shape: string

Raw user-entered handle. This stays daemon-local.

handle/normalized

  • Required: yes
  • Shape: string

handle/digest

  • Required: yes
  • Shape: string

label

  • Required: no
  • Shape: string

Compatibility single display label.

labels

  • Required: no
  • Shape: array

User-managed labels for grouping and search.

metadata

  • Required: no
  • Shape: object

Daemon-local UX/provenance metadata. It is not network evidence.

state

  • Required: yes
  • Shape: enum: pending, active, rejected, blocked, archived

pairwise/contact-nym-id

  • Required: no
  • Shape: string

Compatibility pointer to the current active pairwise mapping.

routing-subject/id

  • Required: no
  • Shape: string

remote/subject

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

source/ref

  • Required: no
  • Shape: string

created/at

  • Required: yes
  • Shape: string

updated/at

  • Required: yes
  • Shape: string

Definition Semantics

$defs.subject

  • Shape: object