v6

latestOpenAPI 3.1.0BSD-3-Clause-Clearraw.githubusercontent.com2026-08-01143971.5 KB

User Decrypt v3

Submit a v3 (unified EIP-712) user-decryption request.

post/v3/user-decrypt

Request body

attestationTypestring required

The attestation/signature scheme used for the signature bytes. Must equal "eip712-unified-user-decrypt-v1" for the current release.

signaturestring required

Attestation signature: 0x-hex, or empty for the ERC-1271 empty-signature path.

Example request

{
  "attestationType": "eip712-unified-user-decrypt-v1",
  "attestedPayload": {
    "allowedContracts": [
      "0x1234567890123456789012345678901234567890"
    ],
    "extraData": "0x00",
    "handles": [
      {
        "contractAddress": "0x1234567890123456789012345678901234567890",
        "ctHandle": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
        "ownerAddress": "0x1234567890123456789012345678901234567890"
      }
    ],
    "publicKey": "0x04b8e5d3f1a2c4e6d8f0a1b3c5d7e9f1a2b4c6d8e0f2a3b5c7d9e1f3a5b7c9d1",
    "requestValidity": {
      "durationSeconds": "604800",
      "startTimestamp": "1700000000"
    },
    "type": "user_decryption",
    "userAddress": "0x1234567890123456789012345678901234567890",
    "version": "2.0"
  },
  "signature": "0xaabbccddeeff"
}

Response

Request accepted for processing.

requestIdstring required

statusstring required

Example response

{
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "result": {
    "jobId": "550e8400-e29b-41d4-a716-446655440000"
  },
  "status": "queued"
}