Contact Attestation Request v1¶
Source schema: doc/schemas/contact-attestation-request.v1.schema.json
Acquisition-side request from a node to a contact attestation service asking it to challenge one email address or phone number and later issue a contact-control passport.
Governing Basis¶
Project Lineage¶
Fields¶
| Field | Required | Shape | Description |
|---|---|---|---|
schema |
yes |
const: contact-attestation-request.v1 |
|
schema/v |
yes |
const: 1 |
|
request/id |
yes |
string | |
contact/kind |
yes |
enum: email, phone |
|
contact/value |
yes |
string | Raw delivery target. It is sent only to the selected attestation service. |
subject |
yes |
ref: #/$defs/subject |
|
requested/capability-id |
yes |
enum: email-control, phone-control |
|
requested/profile |
yes |
enum: email-control@v1, phone-control@v1 |
|
requested/purposes |
yes |
array | |
delivery/preference |
no |
enum: link-and-code, code-only |
|
issued/at |
yes |
string | |
expires/at |
no |
string | |
proof/signature |
no |
ref: #/$defs/signature |
Definitions¶
| Definition | Shape | Description |
|---|---|---|
subject |
object | |
signature |
object | |
| ## Field Semantics |
schema¶
- Required:
yes - Shape: const:
contact-attestation-request.v1
schema/v¶
- Required:
yes - Shape: const:
1
request/id¶
- Required:
yes - Shape: string
contact/kind¶
- Required:
yes - Shape: enum:
email,phone
contact/value¶
- Required:
yes - Shape: string
Raw delivery target. It is sent only to the selected attestation service.
subject¶
- Required:
yes - Shape: ref:
#/$defs/subject
requested/capability-id¶
- Required:
yes - Shape: enum:
email-control,phone-control
requested/profile¶
- Required:
yes - Shape: enum:
email-control@v1,phone-control@v1
requested/purposes¶
- Required:
yes - Shape: array
delivery/preference¶
- Required:
no - Shape: enum:
link-and-code,code-only
issued/at¶
- Required:
yes - Shape: string
expires/at¶
- Required:
no - Shape: string
proof/signature¶
- Required:
no - Shape: ref:
#/$defs/signature
Definition Semantics¶
$defs.subject¶
- Shape: object
$defs.signature¶
- Shape: object