Get Used MMRs

Retrieve the list of MMRs (Merkle Mountain Ranges) used by a specific task

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

Parameter	Type	Description
task_uuid	string	The 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

Field	Type	Description
taskId	string	The unique identifier of the task
mmrs	array	Array of MMR information objects
error	string	Error message (only present in error responses)

MMR Object Fields

Field	Type	Description
id	string	The MMR identifier (hex string)
root	string	The MMR root hash (hex string). For Keccak, this is the combined root_low and root_high
size	string	The size of the MMR (hex string)
chain_id	string	The chain ID where this MMR is located (hex string)
hashing_function	string	The 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