Skip to main content

​
Get Used MMRs

Retrieves the list of MMRs (Merkle Mountain Ranges) used by a specific task. This endpoint does not require authentication.

​
Endpoint

GET /tasks/{task_uuid}/mmrs

​
Path Parameters

ParameterTypeDescription
task_uuidstringThe unique identifier (UUID) of the task

​
Example Request

curl -X GET https://staging.hdp.api.herodotus.cloud/tasks/01JPJ03YJT1A93D6NF56G4GVEQ/mmrs \
  -H "Content-Type: application/json"

​
Response

​
Success Response (200 OK)

{
  "taskId": "01JPJ03YJT1A93D6NF56G4GVEQ",
  "mmrs": [
    {
      "id": "0x30314b345136303433515133424b4d42324e31394d4443595757",
      "root": "0x6e7be7495a7126588df5ce10e090b27ea87357b966cc5b4143d0845ee15af0e",
      "size": "0x2644",
      "chain_id": "0xaa37dc",
      "hashing_function": "poseidon"
    },
    {
      "id": "0x30314a4d484d31413242354d38455336505a57524a505354374d",
      "root": "0x8c03a541b8eb37ccfb5d11f2055556668df74acdc8c1fc184081e4a2ec4ccca7",
      "size": "0x0a813",
      "chain_id": "0xaa36a7",
      "hashing_function": "keccak"
    }
  ]
}

​
Not Found Response (404)

{
  "error": "Task not found",
  "taskId": "01JPJ03YJT1A93D6NF56G4GVEQ"
}

​
Server Error Response (500)

{
  "error": "Server error",
  "message": "Failed to decode MMR metadata"
}

​
Response Fields

FieldTypeDescription
taskIdstringThe unique identifier of the task
mmrsarrayArray of MMR information objects
errorstringError message (only present in error responses)

​
MMR Object Fields

FieldTypeDescription
idstringThe MMR identifier (hex string)
rootstringThe MMR root hash (hex string). For Keccak, this is the combined root_low and root_high
sizestringThe size of the MMR (hex string)
chain_idstringThe chain ID where this MMR is located (hex string)
hashing_functionstringThe hashing function used: "poseidon" or "keccak"

​
Notes

  • No authentication is required for this endpoint
  • The response includes all MMRs used by the task, regardless of their hashing function
  • For Poseidon MMRs, the root field contains the single root value
  • For Keccak MMRs, the root field contains the combined root_high and root_low values
  • The hashing_function field explicitly indicates which hashing algorithm was used for each MMR
  • This endpoint is useful for verifying which MMRs were used in the task execution