Submit a sealed record

Queues a record sealed by the SDK. The relayer checks the envelope signature against owner before queueing.

POST /v1/records

Submit a sealed record

cURL

curl --request POST \
  --url https://relay-1.example.com/v1/records \
  --header 'Content-Type: application/json' \
  --data '
{
  "app": "<string>",
  "owner": "0x1111111111111111111111111111111111111111",
  "envelope": "<string>",
  "attributes": {}
}
'

202

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Body

application/json

app · string · required

owner · string · required

The record's one-time owner.

Pattern: ^0x[0-9a-fA-F]{40}$

Example:

"0x1111111111111111111111111111111111111111"

envelope · string · required

Sealed envelope JSON, padded to exactly 512, 1024, 4096 or 16384 bytes.

attributes · object · required

Attribute name to typed value. Names are lowercase; must include project and vtag; at most 32.

Show child attributes

expSeconds · enum<integer> · required

Available options: 3600, 86400, 604800, 2592000, 7776000

token · object

Show child attributes

minAnonymity · integer

Smallest batch this record may be written in.

Required range: x >= 1

maxHoldMs · integer

How long the relayer may hold the record for minAnonymity.

Required range: x >= 1

Response

202

application/json

Queued

id · string<uuid> · required