Vault

GET/api/v1/vault/attestations

List_attestations

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Query Parameters

status?string

Filter by lock status (locked, partially_unlocked, unlocked)

page?integer

Page number (1-based)

Formatint64

Range0 <= value

page_size?integer

Page size

Formatint64

Range0 <= value

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/vault/attestations"

{  "attestations": [    {      "attestation_id": "string",      "content_type": "string",      "created_at": "2019-08-24T14:15:22Z",      "lock_type": "time_lock",      "status": "locked",      "unlock_at": "2019-08-24T14:15:22Z"    }  ],  "page": 0,  "page_size": 0,  "total": 0}

POST/api/v1/vault/attestations

Create_attestation

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

content*

Encrypted content to seal in the vault

lock_config*

Lock and release configuration

notifications?null|

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/vault/attestations" \  -H "Content-Type: application/json" \  -d '{    "content": {      "data": "string",      "type": "string"    },    "lock_config": {      "type": "time_lock"    }  }'

{  "attestation_id": "string",  "content_hash": "string",  "holder_shares": [    "string"  ],  "key_commitment": "string",  "lock_proof": {    "leaves": [      {        "hash": "string",        "label": "string"      }    ],    "merkle_root": "string"  },  "locked_at": "2019-08-24T14:15:22Z",  "share_threshold": 0,  "status": "locked",  "unlock_scheduled": "2019-08-24T14:15:22Z"}

GET/api/v1/vault/attestations/{attestation_id}/history

Get_history

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

attestation_id*string

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/vault/attestations/string/history"

{  "attestation_id": "string",  "events": [    {      "actor": "string",      "details": null,      "event_id": "string",      "event_type": "string",      "timestamp": "2019-08-24T14:15:22Z"    }  ]}

POST/api/v1/vault/attestations/{attestation_id}/lottery/enter

Enter_lottery

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

attestation_id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

entry_count*integer

Number of entries to purchase

Formatint32

Range0 <= value

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/vault/attestations/string/lottery/enter" \  -H "Content-Type: application/json" \  -d '{    "entry_count": 0  }'

{  "attestation_id": "string",  "content_key": "string",  "current_probability": 0.1,  "entries_purchased": 0,  "revealed": true,  "status": "locked",  "total_entries": 0}

GET/api/v1/vault/attestations/{attestation_id}/status

Get_attestation_status

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

attestation_id*string

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/vault/attestations/string/status"

{  "attestation_id": "string",  "created_at": "2019-08-24T14:15:22Z",  "lock_type": "time_lock",  "lottery_status": null,  "owner": "string",  "status": "locked",  "time_remaining_seconds": 0,  "unlock_at": "2019-08-24T14:15:22Z",  "unlock_progress": {    "signatures_collected": 0,    "signatures_required": 0,    "signers": [      {        "signed_at": "2019-08-24T14:15:22Z",        "signer": "string"      }    ]  }}

POST/api/v1/vault/attestations/{attestation_id}/unlock

Unlock_attestation

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

attestation_id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

key_shares?array<string>

Shamir key shares held by the caller, combined with the server's custody shares to reconstruct the content key once the unlock gate has opened.

signature?|

Signature payload when performing a multi-signature unlock

unlock_type?UnlockType

Unlock mechanism dispatched by the server (time_expired or multi_signature)

Value in

"time_expired"
"multi_signature"
"lottery"

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/vault/attestations/string/unlock" \  -H "Content-Type: application/json" \  -d '{}'

{  "attestation_id": "string",  "message": "string",  "revealed": null,  "signatures_collected": 0,  "signatures_required": 0,  "status": "locked",  "unlock_method": "string",  "unlock_proof": null,  "unlocked_at": "2019-08-24T14:15:22Z"}

POST/api/v1/vault/attestations/{attestation_id}/witness

Add_witness

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

attestation_id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

metadata?unknown

Optional witness metadata

reason?|

Optional reason for the witness attestation. The authoritative, non-repudiable witness signature is generated server-side from the authenticated signer.

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/vault/attestations/string/witness" \  -H "Content-Type: application/json" \  -d '{}'

{  "attestation_id": "string",  "current": 0,  "required": 0,  "signature_valid": true,  "witness": "string",  "witnessed_at": "2019-08-24T14:15:22Z"}

Vault

200application/json

503

201application/json

400

503

200application/json

403

404

503

200application/json

400

404

503

200application/json

403

404

503

200application/json

202application/json

400

403

404

503

200application/json

403

404

409

503

On this page

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`