Sign in

v1

latestOpenAPI 3.1.0Apache-2.02026-07-13136499.6 KB
Nodes

Create a node lock for confidential compute

This endpoint attempts to find a suitable node and retrieve its public key for encryption through a two-step process:

  1. First, it tries to select an existing node with a public key directly.
  2. If no node is immediately available, it falls back to finding the cheapest compatible node and acquiring a new stack entry for it.

This endpoint is specifically designed for confidential compute scenarios where requests need to be encrypted before being processed by nodes.

Errors

  • INTERNAL_SERVER_ERROR - Communication errors or missing node public keys
  • SERVICE_UNAVAILABLE - No nodes available for confidential compute
post/v1/nodes/lock

Request body

max_num_tokensinteger nullable

The number of tokens to be processed for confidential compute (including input and output tokens)

modelstring required

The model to lock a node for

timeoutinteger nullable

An optional timeout period for the locked compute units, in seconds

Response

Node DH public key requested successfully

node_small_idinteger required

The node small id for the selected node

public_keystring required

The public key for the selected node, base64 encoded

stack_entry_digeststring nullable

Transaction digest for the transaction that acquires the stack entry, if any

stack_small_idinteger required

The stack small id to which an available stack entry was acquired, for the selected node