Skip to main content
  • /v1/l1/atlantic-query/proof-generation-verification

​
How to use?

Submit the pie.zip file. The endpoint also offers an option to mock the fact hash, which bypasses actual verification on chain. It is useful for testing purposes.

​
Sending Request

  • Query Parameters
    • apiKey (string, required)
  • Request Body
    • pieFile (file - .zip required) - pie.zip generated e.g. using cairo-run or with /trace-generation endpoint (but in that case you should probably send /l1/atlantic-query instead)
    • mockFactHash (boolean, required) - If true the fact hash will be mocked, bypassing actual verification for testing purposes.

​
Responses

  • Success (201 created)
    • Content-Type:application/json
    • Response Body
    {
    "atlanticQueryId": "string"
}
    • You can use this atlanticQueryId to check status of that request.
  • Error responses
    • 400 Bad Request - Indicates that parameters are invalid such as providing invalid pieFile or mockFactHash.
    • 500 Internal Server Error - This says error is on our side.

​
Example Request

curl -X 'POST' \
  'https://atlantic.api.herodotus.cloud/v1/l1/atlantic-query/proof-generation-verification?apiKey=<your-api-key>' \
  -H 'accept: application/json' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pieFile=@pie.zip;type=application/zip' \
  -F 'mockFactHash=false'