Sign in

v6

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

Submit user decryption.

Deprecated. Superseded by POST /v3/user-decrypt (unified EIP-712 user-decryption). The v2 surface remains available throughout the deprecation window.

post/v2/user-decrypt

Request body

contractAddressesstring[] required
extraDatastring required

Extra data forwarded verbatim to the gateway contract. Accepts "0x00", version 0x01 (0x01 + 32-byte contextId), or version 0x02 (0x02 + 32-byte contextId + 32-byte epochId). contextId must be 0x07-tagged and epochId must be 0x08-tagged (first byte of each).

publicKeystring required

User's public key for re-encryption. Raw hex, no 0x prefix, minimum 2 chars.

signaturestring required

EIP-712 signature over the decryption request, signed by the user. Raw hex, 130 chars, no 0x prefix.

userAddressstring required

Ethereum address of the user requesting decryption. 0x + 40 hex chars.

Example request

{
  "contractAddresses": [
    "0x1234567890123456789012345678901234567890"
  ],
  "contractsChainId": "0xaa36a7",
  "extraData": "0x00",
  "handleContractPairs": [
    {
      "contractAddress": "0x1234567890123456789012345678901234567890",
      "handle": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    }
  ],
  "publicKey": "04b8e5d3f1a2c4e6d8f0a1b3c5d7e9f1a2b4c6d8e0f2a3b5c7d9e1f3a5b7c9d1",
  "requestValidity": {
    "durationDays": "1",
    "startTimestamp": "1700000000"
  },
  "signature": "aabbccdd00112233445566778899aabbccdd00112233445566778899aabbccdd00112233445566778899aabbccdd00112233445566778899aabbccdd0011223344",
  "userAddress": "0x1234567890123456789012345678901234567890"
}

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"
}