Documentation Index
Fetch the complete documentation index at: https://docs.herodotus.cloud/llms.txt
Use this file to discover all available pages before exploring further.
Get Task Details
Retrieves comprehensive details of a specific HDP task, including all metadata, MMRs used, and execution information. This endpoint does not require authentication.
Endpoint
GET /tasks/{task_uuid}/details
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/details \
-H "Content-Type: application/json"
Response
Success Response (200 OK)
{
"taskId": "01JPJ03YJT1A93D6NF56G4GVEQ",
"status": "TaskDecommitmentCompleted",
"destinationChainId": "11155111",
"scheduleMode": "onchain",
"scheduleTxHash": "0xabcd...",
"dataSourceChains": ["0xaa36a7", "0xaa37dc"],
"dataDestinationChain": "0xaa36a7",
"hdpCoreProgramHash": "0x5678...",
"taskHash": "0x9abc...",
"programHash": "0xdef0...",
"programName": "my_module",
"outputTreeRoot": "0x1234...",
"outputTreeRootPreimage": ["0x1", "0x2", "0x3"],
"taskInputs": {
"param1": "value1"
},
"mmrs": [
{
"id": "0x30314b345136303433515133424b4d42324e31394d4443595757",
"root": "0x6e7be7495a7126588df5ce10e090b27ea87357b966cc5b4143d0845ee15af0e",
"size": "0x2644",
"chain_id": "0xaa37dc",
"hashing_function": "poseidon"
}
],
"createdAt": "2024-03-17T10:24:00Z",
"updatedAt": "2024-03-17T10:25:00Z"
}
Not Found Response (404)
{
"error": "Task not found",
"taskId": "01JPJ03YJT1A93D6NF56G4GVEQ"
}
Response Fields
| Field | Type | Description |
|---|
| taskId | string | The unique identifier of the task |
| status | string | Current status of the task |
| destinationChainId | string | Chain ID where the task will be proven |
| scheduleMode | string | null | Schedule mode: “onchain” or “offchain” |
| scheduleTxHash | string | null | Transaction hash if scheduled onchain |
| dataSourceChains | array | null | Array of source chain IDs |
| dataDestinationChain | string | null | Destination chain ID |
| hdpCoreProgramHash | string | null | HDP core program hash |
| taskHash | string | null | Task hash |
| programHash | string | null | Program hash |
| programName | string | null | Program name |
| outputTreeRoot | string | null | Output tree root |
| outputTreeRootPreimage | array | null | Output tree root preimage |
| taskInputs | object | null | Task input parameters |
| mmrs | array | Array of MMR information objects used by the task |
| createdAt | string | ISO 8601 timestamp of task creation |
| updatedAt | string | ISO 8601 timestamp of last update |
MMR Object Fields
| Field | Type | Description |
|---|
| id | string | The MMR identifier (hex string) |
| root | string | The MMR root hash (hex string) |
| 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
- This endpoint provides the most comprehensive view of a task
- MMRs array will be empty if no MMRs were used
- If task_hash or output_tree_root are not stored in the database, they will be extracted from the task results if available
- The program_hash will fallback to the HDP core program hash if not specified
