Proof of Personhood Attestation v1

Source schema: doc/schemas/proof-of-personhood-attestation.v1.schema.json

Machine-readable schema for minimal Proof-of-Personhood attestations that support non-withdrawable UBC and limited cross-federation portability, including recognition through the minimal FIP bridge/registry.

Governing Basis

• doc/normative/40-constitution/CONSTITUTION.md
• doc/normative/50-constitutional-ops/UNIVERSAL-BASIC-COMPUTE.md
• doc/normative/50-constitutional-ops/UBC-LIMIT-PROFILES.md

Fields

Field	Required	Shape	Description
schema/v	yes	const: 1	Schema version.
attestation_id	yes	string	Stable identifier of this attestation record.
subject_ref	yes	string	Stable anonymous handle for the verified person.
issuer_scope	yes	enum: federation, fip_bridge, hybrid	Which institutional path stands behind recognition of personhood: a federation, the minimal FIP bridge, or both together.
issuer_ref	yes	string	Stable reference to the issuing federation, the FIP bridge, or a hybrid issuing path.
issuer_federation_id	no	string	Canonical federation identifier when federation-side recognition participates in issuing the attestation.
bridge_ref	no	string	Optional reference to the FIP bridge/registry that recognizes the attestation cross-federation.
attestation_method	yes	enum: cryptographic_vouching, federation_attestation, sealed_chambers_recognition, fip_bridge_recognition, hybrid	Recognition method used to establish Proof-of-Personhood without making de-anonymization the default path.
assurance_scope	yes	const: proof_of_personhood
deanon_not_required	yes	boolean
uniqueness_scope	yes	enum: federation, trans_federation_limited, trans_federation_extended	How far the attestation's one-person-one-presence guarantees are meant to travel across federation boundaries.
valid_from	yes	string
valid_until	no	string
recognition_basis_ref	no	string
evidence_ref	no	string
revocation_ref	no	string
revocation_status	no	enum: active, revoked, expired, superseded
portability_profile	yes	ref: #/$defs/portabilityProfile	Declared portability floor and extension capability for emergency, communication, and care access modes.
policy_annotations	no	object

Definitions

Definition	Shape	Description
portabilityModeMap	object
portabilityProfile	object

Conditional Rules

Rule 1

When:

{
  "properties": {
    "issuer_scope": {
      "const": "federation"
    }
  },
  "required": [
    "issuer_scope"
  ]
}

Then:

{
  "required": [
    "issuer_federation_id"
  ]
}

Rule 2

When:

{
  "properties": {
    "issuer_scope": {
      "const": "fip_bridge"
    }
  },
  "required": [
    "issuer_scope"
  ]
}

Then:

{
  "required": [
    "bridge_ref"
  ],
  "properties": {
    "attestation_method": {
      "enum": [
        "sealed_chambers_recognition",
        "fip_bridge_recognition",
        "hybrid"
      ]
    },
    "portability_profile": {
      "properties": {
        "bridge_minimum_supported": {
          "const": true
        }
      }
    }
  }
}

Rule 3

When:

{
  "properties": {
    "issuer_scope": {
      "const": "hybrid"
    }
  },
  "required": [
    "issuer_scope"
  ]
}

Then:

{
  "required": [
    "issuer_federation_id",
    "bridge_ref"
  ]
}

Rule 4

When:

{
  "properties": {
    "uniqueness_scope": {
      "const": "trans_federation_extended"
    }
  },
  "required": [
    "uniqueness_scope"
  ]
}

Then:

{
  "properties": {
    "portability_profile": {
      "properties": {
        "extension_profile_refs": {
          "minItems": 1
        }
      }
    }
  }
}

Field Semantics

schema/v

• Required: yes
• Shape: const: 1

Schema version.

attestation_id

• Required: yes
• Shape: string

Stable identifier of this attestation record.

Governing basis: - doc/normative/50-constitutional-ops/UNIVERSAL-BASIC-COMPUTE.md

subject_ref

• Required: yes
• Shape: string

Stable anonymous handle for the verified person.

issuer_scope

• Required: yes
• Shape: enum: federation, fip_bridge, hybrid

Which institutional path stands behind recognition of personhood: a federation, the minimal FIP bridge, or both together.

Governing basis: - doc/normative/50-constitutional-ops/UNIVERSAL-BASIC-COMPUTE.md - doc/normative/50-constitutional-ops/UBC-LIMIT-PROFILES.md

issuer_ref

• Required: yes
• Shape: string

Stable reference to the issuing federation, the FIP bridge, or a hybrid issuing path.

issuer_federation_id

• Required: no
• Shape: string

Canonical federation identifier when federation-side recognition participates in issuing the attestation.

bridge_ref

• Required: no
• Shape: string

Optional reference to the FIP bridge/registry that recognizes the attestation cross-federation.

attestation_method

• Required: yes
• Shape: enum: cryptographic_vouching, federation_attestation, sealed_chambers_recognition, fip_bridge_recognition, hybrid

Recognition method used to establish Proof-of-Personhood without making de-anonymization the default path.

assurance_scope

• Required: yes
• Shape: const: proof_of_personhood

deanon_not_required

• Required: yes
• Shape: boolean

uniqueness_scope

• Required: yes
• Shape: enum: federation, trans_federation_limited, trans_federation_extended

How far the attestation's one-person-one-presence guarantees are meant to travel across federation boundaries.

valid_from

• Required: yes
• Shape: string

valid_until

• Required: no
• Shape: string

recognition_basis_ref

• Required: no
• Shape: string

evidence_ref

• Required: no
• Shape: string

revocation_ref

• Required: no
• Shape: string

revocation_status

• Required: no
• Shape: enum: active, revoked, expired, superseded

portability_profile

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

Declared portability floor and extension capability for emergency, communication, and care access modes.

Governing basis: - doc/normative/50-constitutional-ops/UBC-LIMIT-PROFILES.md

policy_annotations

• Required: no
• Shape: object

Definition Semantics

$defs.portabilityModeMap

• Shape: object

$defs.portabilityProfile

• Shape: object