package nexus.orchestrator

Get desktop application:
View/edit binary Protocol Buffers messages

Response to get a single node by ID

• string wallet_address = 1

  The wallet address of the node's owner

Request a prover task.

• string node_id = 1

  This node's ID.

• NodeType node_type = 2

  The type of this node.

• bytes ed25519_public_key = 3

  The client's Ed25519 public key for proof authentication.Add commentMore actions

• TaskDifficulty max_difficulty = 4

  The maximum difficulty level the client wants to handle

A Prover task.

• string program_id = 1

  Deprecated: use field in Task instead. Program id. (Assuming client-side default programs)

• bytes public_inputs = 2

  Deprecated: use field in Task instead. Public inputs to the program.

• string task_id = 3

  Deprecated: use field in Task instead. The task's ID.

• optional Task task = 4

Get outstanding tasks for a node.

• string node_id = 1

• string next_cursor = 2

Tasks assigned to a node.

• repeated Task tasks = 1

• string next_cursor = 2

Node information

Used in: UserResponse

• string node_id = 1

  The node's ID

• NodeType node_type = 2

  The type of node

Performance stats of a node.

Used in: SubmitProofRequest

• optional int32 flops_per_sec = 1

  Flops per second

• optional int32 memory_used = 2

  Memory used in bytes for the proof activity

• optional int32 memory_capacity = 3

  Memory capacity in bytes of the node

• optional string location = 4

  Geo location of the node

Used in: GetProofTaskRequest, Node, RegisterNodeRequest, SubmitProofRequest

• WEB_PROVER = 0

  The node is a web prover.

• CLI_PROVER = 1

  The node is a CLI prover.

Register a node.

• NodeType node_type = 1

  The type of this node.

• string user_id = 2

  The owner of the node.

Response to a node registration request.

• string node_id = 1

  The node's ID.

Register a User.

• string uuid = 1

  UUIDv4 identifier for the user.

• string wallet_address = 2

  The user's wallet public address.

Submit the result of a prover task.

• NodeType node_type = 2

  The type of this node.

• string proof_hash = 3

  Hash of the concatenated proof bytes.

• optional NodeTelemetry node_telemetry = 4

  Telemetry data about the node

• bytes proof = 5

  ZK proof of the program and first set of inputs.

• string task_id = 6

  The task's ID.

• bytes ed25519_public_key = 7

  A Ed25519 public key (~32 bytes) generated by the node to uniquely identify this request, used for DoS protection.

• bytes signature = 8

  A signature of the proof, generated by signing task_id + hash(proof) with the Ed25519 private key corresponding to the public key.

• repeated string all_proof_hashes = 9

  Hash of each individual proof. Sent only on ALL_PROOF_HASHES task type.

• repeated bytes proofs = 10

  ZK proofs of the program running on each set of inputs. To be sent on PROOF_REQUIRED tasks, empty on other task types.

A Prover task

Used in: GetProofTaskResponse, GetTasksResponse

• string task_id = 1

• string program_id = 2

• bytes public_inputs = 3

• optional google.protobuf.Timestamp created_at = 4

• repeated bytes public_inputs_list = 5

• TaskType task_type = 6

  The type of task (proof required or only hash)

• TaskDifficulty difficulty = 7

  The actual difficulty level assigned to this task by the server. This accounts for reputation-based gating and allows clients to track the actual difficulty they're receiving vs what they requested.

Used in: GetProofTaskRequest, Task

• SMALL = 0

  Small difficulty bucket; not used by default for CLI but can be overridden via --max-difficulty argument

• SMALL_MEDIUM = 3

• MEDIUM = 5

• LARGE = 10

• EXTRA_LARGE = 15

• EXTRA_LARGE_2 = 16

• EXTRA_LARGE_3 = 17

• EXTRA_LARGE_4 = 18

• EXTRA_LARGE_5 = 19

Used in: Task

• PROOF_REQUIRED = 0

  Task requires a proof to be submitted

• PROOF_HASH = 1

  Task does not require a proof to be submitted. All proof hashes should be hashed together.

• ALL_PROOF_HASHES = 2

  Task does not require a proof to be submitted, but alll proof hashes should be sent.

Response returning all nodes associated with a user

• repeated Node nodes = 1

  The user's registered nodes

• string nodes_next_cursor = 2

  Cursor to fetch the next page of nodes, empty if there are no more results

• string user_id = 3

  The user's ID.

• string wallet_address = 4

  The user's wallet address