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.
List Tasks
Retrieves a paginated list of all HDP tasks with optional search functionality. This endpoint does not require authentication.
Endpoint
Query Parameters
| Parameter | Type | Required | Description |
|---|
| hdp_tasks_page | integer | No | Page number (default: 1, minimum: 1) |
| hdp_tasks_per_page | integer | No | Number of tasks per page (default: 10, minimum: 1, maximum: 100) |
| hdp_tasks_search | string | No | Search term to filter tasks by UUID, program hash, or program name (case-insensitive) |
Example Request
curl -X GET "https://staging.hdp.api.herodotus.cloud/tasks?hdp_tasks_page=1&hdp_tasks_per_page=10&hdp_tasks_search=01JPJ" \
-H "Content-Type: application/json"
Response
Success Response (200 OK)
{
"tasks": [
{
"uuid": "01JPJ03YJT1A93D6NF56G4GVEQ",
"status": "TaskDecommitmentCompleted",
"destinationChainId": "11155111",
"contractClassHash": "0x1234...",
"scheduleMode": "onchain",
"scheduleTxHash": "0xabcd...",
"dataSourceChains": ["0xaa36a7", "0xaa37dc"],
"dataDestinationChain": "0xaa36a7",
"hdpCoreProgramHash": "0x5678...",
"taskHash": "0x9abc...",
"programHash": "0xdef0...",
"programName": "my_module",
"outputTreeRoot": "0x1234...",
"createdAt": "2024-03-17T10:24:00Z",
"updatedAt": "2024-03-17T10:25:00Z"
}
],
"pagination": {
"page": 1,
"perPage": 10,
"total": 42,
"totalPages": 5
}
}
Response Fields
| Field | Type | Description |
|---|
| tasks | array | Array of task objects |
| pagination | object | Pagination metadata |
Task Object Fields
| Field | Type | Description |
|---|
| uuid | string | The unique identifier of the task |
| status | string | Current status of the task |
| destinationChainId | string | Chain ID where the task will be proven |
| contractClassHash | string | Hash of the contract class |
| 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 |
| createdAt | string | ISO 8601 timestamp of task creation |
| updatedAt | string | ISO 8601 timestamp of last update |
| Field | Type | Description |
|---|
| page | integer | Current page number |
| perPage | integer | Number of items per page |
| total | integer | Total number of tasks |
| totalPages | integer | Total number of pages |
Notes
- No authentication is required for this endpoint
- Tasks are ordered by creation date (newest first)
- Search is case-insensitive and matches UUID, program hash, or program name
- Maximum 100 tasks per page to prevent excessive response sizes
- Empty search string is treated as no search filter
