Anchor a ZK proof on-chain | IDA — Identity for the AI Age

curl -X POST https://adid.dev/api/v1/zkp/proofs/id/anchor \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "proofId": "urn:uuid:8c0f3a3a-4f2b-11ee-be56-0242ac120002",
  "status": "pending",
  "submittedAt": "2024-01-15T09:30:00Z",
  "proofHash": "0x3a1f5b7c9d8e4f6a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a",
  "predicateHash": "0x7b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f53a1f5b7c9d8e4f6a2b3c4d5e6f7a8",
  "submitterDid": "did:example:123456789abcdefghi",
  "holderDid": "did:example:abcdef123456789ghi",
  "credentialId": "cred-9876543210abcdef",
  "txHash": "0x9f8e7d6c5b4a39281726354433221100ffeeddccbbaa99887766554433221100",
  "blockNumber": 15873245,
  "confirmedAt": "2024-01-15T09:45:00Z",
  "revokedAt": "2024-02-01T12:00:00Z",
  "revokedBlock": 15874000,
  "failureReason": "Transaction timeout exceeded",
  "lagBlocks": 3
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

X-API-Keystring

API Key authentication via header

Path parameters

idstringRequired

Request

This endpoint expects an object.

syncWaitMsintegerOptional>=0Defaults to 0

predicateHashstringOptionalformat: "^0x[0-9a-fA-F]{64}$"

Response

Anchor confirmed within syncWaitMs

proofIdstring

statusenum

Lifecycle state of an on-chain ZK proof anchor row.

Allowed values:

submittedAtdatetime

proofHashstringformat: "^0x[0-9a-fA-F]{64}$"

predicateHashstringformat: "^0x[0-9a-fA-F]{64}$"

submitterDidstring

holderDidstring or null

credentialIdstring

txHashstring or nullformat: "^0x[0-9a-fA-F]{64}$"

blockNumberlong or null>=0

confirmedAtdatetime or null

revokedAtdatetime or null

revokedBlocklong or null

failureReasonstring or null

lagBlocksinteger>=0

Errors

403

Forbidden Error

404

Not Found Error

409

Conflict Error

501

Not Implemented Error

Authentication

Path parameters

Headers

Request

Response

Errors