L1 Proof Generation Verification

• /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'