Sign in
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

Changes

Changed in 5 of the 13 revisions of this API.125

  • f0bf5a2dde0f2See the full diff
    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

  • e19be1e82c3b2See the full diff
    • ●

      removed the request property

      request-property-removed

    • ●

      removed the request property

      request-property-removed

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • e7076a00f41c2See the full diff
    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

  • d714acb641bd1See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 45e3254839bd1See the full diff
    • ▲

      api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 64 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog