> ## Documentation Index > Fetch the complete documentation index at: https://docs.lucid.foundation/llms.txt > Use this file to discover all available pages before exploring further. # Compute SDK > Compute node heartbeat registration and health monitoring # Compute SDK Compute node heartbeat registration and health monitoring ## Operations | Method | Description | | --------------- | ----------------------------- | | `searchCompute` | Search compute passports | | `heartbeat` | Submit compute node heartbeat | | `getNodeHealth` | Get compute node health | ## Generated Reference ### Overview Compute node heartbeat registration and health monitoring #### Available Operations * [searchCompute](#searchcompute) - Search compute passports * [heartbeat](#heartbeat) - Submit compute node heartbeat * [getNodeHealth](#getnodehealth) - Get compute node health ### searchCompute Search compute passports with ComputeMeta-specific filters including region, runtime, provider type, minimum VRAM, and GPU model. Returns paginated results with full passport details. #### Example Usage ```typescript theme={null} import { RaijinLabsLucidAi } from "raijin-labs-lucid-ai"; const raijinLabsLucidAi = new RaijinLabsLucidAi(); async function run() { const result = await raijinLabsLucidAi.compute.searchCompute(); for await (const page of result) { console.log(page); } } run(); ``` #### Standalone function The standalone function version of this method: ```typescript theme={null} import { RaijinLabsLucidAiCore } from "raijin-labs-lucid-ai/core.js"; import { computeSearchCompute } from "raijin-labs-lucid-ai/funcs/computeSearchCompute.js"; // Use `RaijinLabsLucidAiCore` for best tree-shaking performance. // You can create one instance of it to use across an application. const raijinLabsLucidAi = new RaijinLabsLucidAiCore(); async function run() { const res = await computeSearchCompute(raijinLabsLucidAi); if (res.ok) { const { value: result } = res; for await (const page of result) { console.log(page); } } else { console.log("computeSearchCompute failed:", res.error); } } run(); ``` #### Parameters | Parameter | Type | Required | Description | | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `request` | [operations.LucidSearchComputeRequest](https://github.com/lucid-fdn/lucid-ai-sdk/blob/main/typescript/docs/models/operations/lucidsearchcomputerequest.md) | :heavy\_check\_mark: | The request object to use for the request. | | `options` | RequestOptions | :heavy\_minus\_sign: | Used to set various options for making HTTP requests. | | `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy\_minus\_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. | | `options.retries` | [RetryConfig](https://github.com/lucid-fdn/lucid-ai-sdk/blob/main/typescript/docs/lib/utils/retryconfig.md) | :heavy\_minus\_sign: | Enables retrying HTTP requests under certain failure conditions. | #### Response **Promise\<[operations.LucidSearchComputeResponse](https://github.com/lucid-fdn/lucid-ai-sdk/blob/main/typescript/docs/models/operations/lucidsearchcomputeresponse.md)>** #### Errors | Error Type | Status Code | Content Type | | ------------------------------------ | ----------- | ---------------- | | errors.ErrorResponse | 500 | application/json | | errors.RaijinLabsLucidAiDefaultError | 4XX, 5XX | \*/\* | ### heartbeat Submit a heartbeat from a compute node to register or update its live state. Compute nodes must send heartbeats within the 30-second TTL to remain eligible for matching. Includes queue depth and P95 latency estimates. #### Example Usage ```typescript theme={null} import { RaijinLabsLucidAi } from "raijin-labs-lucid-ai"; const raijinLabsLucidAi = new RaijinLabsLucidAi(); async function run() { const result = await raijinLabsLucidAi.compute.heartbeat({ computePassportId: "", status: "healthy", }); console.log(result); } run(); ``` #### Standalone function The standalone function version of this method: ```typescript theme={null} import { RaijinLabsLucidAiCore } from "raijin-labs-lucid-ai/core.js"; import { computeHeartbeat } from "raijin-labs-lucid-ai/funcs/computeHeartbeat.js"; // Use `RaijinLabsLucidAiCore` for best tree-shaking performance. // You can create one instance of it to use across an application. const raijinLabsLucidAi = new RaijinLabsLucidAiCore(); async function run() { const res = await computeHeartbeat(raijinLabsLucidAi, { computePassportId: "", status: "healthy", }); if (res.ok) { const { value: result } = res; console.log(result); } else { console.log("computeHeartbeat failed:", res.error); } } run(); ``` #### Parameters | Parameter | Type | Required | Description | | ---------------------- | ------------------------------------------------------------------------------------------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `request` | [models.ComputeHeartbeat](https://github.com/lucid-fdn/lucid-ai-sdk/blob/main/typescript/docs/models/computeheartbeat.md) | :heavy\_check\_mark: | The request object to use for the request. | | `options` | RequestOptions | :heavy\_minus\_sign: | Used to set various options for making HTTP requests. | | `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy\_minus\_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. | | `options.retries` | [RetryConfig](https://github.com/lucid-fdn/lucid-ai-sdk/blob/main/typescript/docs/lib/utils/retryconfig.md) | :heavy\_minus\_sign: | Enables retrying HTTP requests under certain failure conditions. | #### Response **Promise\<[operations.LucidHeartbeatResponse](https://github.com/lucid-fdn/lucid-ai-sdk/blob/main/typescript/docs/models/operations/lucidheartbeatresponse.md)>** #### Errors | Error Type | Status Code | Content Type | | ------------------------------------ | ----------- | ---------------- | | errors.ErrorResponse | 400 | application/json | | errors.ErrorResponse | 500 | application/json | | errors.RaijinLabsLucidAiDefaultError | 4XX, 5XX | \*/\* | ### getNodeHealth Get the current health state of a compute node. Returns 503 if the node's heartbeat has expired (>30s since last heartbeat). #### Example Usage ```typescript theme={null} import { RaijinLabsLucidAi } from "raijin-labs-lucid-ai"; const raijinLabsLucidAi = new RaijinLabsLucidAi(); async function run() { const result = await raijinLabsLucidAi.compute.getNodeHealth({ computePassportId: "", }); console.log(result); } run(); ``` #### Standalone function The standalone function version of this method: ```typescript theme={null} import { RaijinLabsLucidAiCore } from "raijin-labs-lucid-ai/core.js"; import { computeGetNodeHealth } from "raijin-labs-lucid-ai/funcs/computeGetNodeHealth.js"; // Use `RaijinLabsLucidAiCore` for best tree-shaking performance. // You can create one instance of it to use across an application. const raijinLabsLucidAi = new RaijinLabsLucidAiCore(); async function run() { const res = await computeGetNodeHealth(raijinLabsLucidAi, { computePassportId: "", }); if (res.ok) { const { value: result } = res; console.log(result); } else { console.log("computeGetNodeHealth failed:", res.error); } } run(); ``` #### Parameters | Parameter | Type | Required | Description | | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `request` | [operations.LucidGetHealthRequest](https://github.com/lucid-fdn/lucid-ai-sdk/blob/main/typescript/docs/models/operations/lucidgethealthrequest.md) | :heavy\_check\_mark: | The request object to use for the request. | | `options` | RequestOptions | :heavy\_minus\_sign: | Used to set various options for making HTTP requests. | | `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy\_minus\_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. | | `options.retries` | [RetryConfig](https://github.com/lucid-fdn/lucid-ai-sdk/blob/main/typescript/docs/lib/utils/retryconfig.md) | :heavy\_minus\_sign: | Enables retrying HTTP requests under certain failure conditions. | #### Response **Promise\<[operations.LucidGetHealthResponse](https://github.com/lucid-fdn/lucid-ai-sdk/blob/main/typescript/docs/models/operations/lucidgethealthresponse.md)>** #### Errors | Error Type | Status Code | Content Type | | ------------------------------------ | ----------- | ---------------- | | errors.ErrorResponse | 500, 503 | application/json | | errors.RaijinLabsLucidAiDefaultError | 4XX, 5XX | \*/\* |