POST
/
atlantic-query
curl --request POST \
  --url https://staging.atlantic.api.herodotus.cloud/atlantic-query \
  --header 'Content-Type: multipart/form-data' \
  --form 'externalId=<string>' \
  --form layout=auto \
  --form cairoVm=rust \
  --form cairoVersion=cairo0 \
  --form result=PROOF_GENERATION \
  --form mockFactHash=false \
  --form declaredJobSize=S
{
  "atlanticQueryId": "<string>"
}

Please use this endpoint through our Swagger UI!

Sending it from these docs will not work because of a Mintlify (our documentation platform) issue with uploading files.

Query Parameters

​
apiKey
string
required

Body

multipart/form-data
​
declaredJobSize
enum<string>
required

Smaller jobs are cheaper, however your job might fail if you choose a job size that is too small.

Available options:
S,
M,
L
​
externalId
string

The external id of the query, you can use it to track the query

​
layout
enum<string>
default:
auto
Available options:
auto,
plain,
recursive,
recursive_with_poseidon,
recursive_large_output,
all_solidity,
all_cairo,
dynamic,
small,
dex,
starknet,
starknet_with_keccak
​
cairoVm
enum<string>
default:
rust
Available options:
rust,
python
​
programFile
file
​
inputFile
file
​
pieFile
file
​
cairoVersion
enum<string>
default:
cairo0
Available options:
cairo0,
cairo1
​
result
enum<string>
default:
PROOF_GENERATION

Describe what you want to achieve

Available options:
TRACE_GENERATION,
PROOF_GENERATION,
PROOF_VERIFICATION_ON_L1,
PROOF_VERIFICATION_ON_L2
​
mockFactHash
enum<string>
default:
false

Used for proof verification, if true, a fact hash will be mocked

Available options:
false,
true

Response

201
application/json
Default Response
​
atlanticQueryId
string
required
Swagger UIGet query