Generate a delegated ZK proof on a holder's behalf | IDA — Identity for the AI Age

curl -X POST https://adid.dev/api/v1/zkp/delegated-proofs \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "holderDid": "did:example:holder123456789",
  "agentDid": "did:example:agent987654321",
  "credentialId": "cred-1234abcd5678efgh",
  "predicate": {
    "attributeName": "age",
    "type": "gte"
  },
  "ibct": {
    "id": "urn:uuid:ibct-9a7b6c5d-4e3f-2a1b-0c9d-8e7f6a5b4c3d",
    "type": "InvocationBoundCapabilityToken",
    "invoker": "did:example:holder123456789",
    "target": "did:example:agent987654321",
    "action": "zkp.predicate.age",
    "delegationRef": "delegation-5678efgh1234abcd",
    "nonce": "f3a1b2c4d5e6f789",
    "issuedAt": "2024-01-15T09:30:00Z",
    "expiresAt": "2024-07-15T09:30:00Z",
    "proofValue": "zQ3x7v9P"
  }
}'

{
  "proofId": "proof-9f8e7d6c5b4a3210",
  "delegationId": "delegation-5678efgh1234abcd",
  "proof": {
    "proof": "0xabc123def4567890",
    "publicSignals": [
      "1234567890abcdef"
    ],
    "predicateType": "age_gte",
    "proofId": "proof-9f8e7d6c5b4a3210"
  },
  "anchor": {
    "status": "confirmed",
    "txHash": "0x4e3f2a1b0c9d8e7f6a5b4c3d2e1f0a9b8c7d6e5f4a3b2c1d0e9f8a7b6c5d4e3f",
    "blockNumber": 15897432,
    "revokedBlock": 0
  }
}

Authentication

AuthorizationBearer

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

X-API-Keystring

API Key authentication via header

Request

This endpoint expects an object.

holderDidstringRequired

agentDidstringRequired

credentialIdstringRequired

predicateobjectRequired

ibctobjectRequired

Invocation-Bound Capability Token witnessing a holder’s authorisation to an agent.

anchorbooleanOptionalDefaults to false

syncWaitMsintegerOptional>=0Defaults to 0

Response

Created

proofIdstring

delegationIdstring

proofobject

anchorobject or null

Compact on-chain anchor receipt. Embedded inline in delegated-proof, verifications/history rows, and dashboard timeline entries when an anchor exists for the underlying proof.

Errors

403

Forbidden Error

404

Not Found Error

410

Gone Error

422

Unprocessable Entity Error

501

Not Implemented Error