v1

latestOpenAPI 3.1.0Apache-2.02026-07-13136499.6 KB
Nodes

Create node

This endpoint allows nodes to register or update their public address in the system. When a node comes online or changes its address, it can use this endpoint to ensure the system has its current address for routing requests.

Errors

Returns various AtomaProxyError variants:

  • MissingHeader - If the signature header is missing
  • InvalidHeader - If the signature header is malformed
  • InvalidBody - If:
    • The request body cannot be read
    • The signature is invalid
    • The body cannot be parsed
    • The sui address doesn't match the signature
  • InternalError - If:
    • The state manager channel is closed
    • The registration event cannot be sent
    • Node Sui address lookup fails
post/v1/nodes

Request body

signaturestring required

The signature of the data base 64 encoded

Response

Node public address registered successfully

messagestring required

The message of the response