Reactor Query Endpoints

Version: 1.0.0 Category: Query Entity: Reactor Base URL: http://localhost:1317 Base Path: /structs

Endpoint Summary

Endpoint Details

Get Reactor by ID

GET /structs/reactor/{id}

Returns a single reactor by its entity ID.

Parameters

Response

• Content-Type: application/json
• Schema: reactor

Example

Request: GET /structs/reactor/3-1

Response:

{
  "Reactor": {
    "id": "3-1",
    "validator": "structsvaloper1...",
    "guildId": "0-1",
    "defaultCommission": "0",
    "owner": "1-11"
  }
}

The owner field (string, PlayerId) identifies the player who owns this reactor.

List All Reactors

GET /structs/reactor

Returns a paginated list of all reactors.

Response

• Content-Type: application/json
• Schema: reactor (array)

Reactor Stake Share

GET /structs/reactor/{reactorId}/stake-share

CLI: structsd query structs reactor-stake-share [reactor-id]. Check this before reactor-infuse: once ten or more validators are bonded, a reactor holding ≥ capBps (default 3000 = 30%) of bonded stake refuses further inflows (reactor stake cap exceeded, code 1613).

Owner Reactor Diversity

GET /structs/owner/{ownerId}/reactor-diversity

CLI: structsd query structs owner-reactor-diversity [owner-id]. Shows the diversity bonus an owner earns for spreading stake across reactors.