mirror of https://github.com/luxfi/node.git synced 2026-07-27 03:39:39 +00:00

Files

T

zeekayandHanzo Dev 51a304804c chore: migrate luxd HTTP routes /ext -> /v1

Drop the Avalanche-heritage /ext prefix; /v1 is the single canonical route
surface (one way, no backward compat). The node's baseURL is the source of
truth; clients, SDKs, CLI, indexer, maker, genesis, netrunner, and the
k8s/compose/gateway/explorer configs are updated to match.

Co-authored-by: Hanzo Dev <dev@hanzo.ai>

2026-07-01 11:40:13 -07:00

3.0 KiB

Raw Blame History

GetAllValidatorsAt RPC Endpoint

Overview

The GetAllValidatorsAt endpoint returns the validator sets of all networks (including the primary network) at a specified height.

Endpoint

POST /v1/bc/P

Request Format

Method

{
  "jsonrpc": "2.0",
  "method": "platform.getAllValidatorsAt",
  "params": {
    "height": 100
  },
  "id": 1
}

Parameters

height (number | "proposed"): The blockchain height to query. Use "proposed" for the current proposed height.

Response Format

{
  "jsonrpc": "2.0",
  "result": {
    "validatorSets": {
      "11111111111111111111111111111111LpoYY": {
        "NodeID-7Xhw2mDxuDS44j42TCB6U5579esbSt3Lg": {
          "nodeID": "NodeID-7Xhw2mDxuDS44j42TCB6U5579esbSt3Lg",
          "publicKey": "0x8f95423f7142d00a48e1014a3de8d28907d420dc33b3052a6dee03a3f2941a393c2351e354704ca66a3fc29870282e15",
          "weight": 2000000000000
        }
      },
      "2DeHa5NWHHHB8yS8QuAXBDXQbSYbvq5bBP": {
        "NodeID-GvPWg2xDazqLeTw7r4sQP8D2S8kGe5FWH": {
          "nodeID": "NodeID-GvPWg2xDazqLeTw7r4sQP8D2S8kGe5FWH",
          "publicKey": "0x9f95423f7142d00a48e1014a3de8d28907d420dc33b3052a6dee03a3f2941a393c2351e354704ca66a3fc29870282e16",
          "weight": 1000000000000
        }
      }
    }
  },
  "id": 1
}

Response Fields

validatorSets: Map of network ID to validator set
- Key: Network ID (string)
- Value: Map of node ID to validator information
  - nodeID: The validator's node ID
  - publicKey: The validator's BLS public key (hex-encoded with 0x prefix)
  - weight: The validator's staking weight in nLUX

Examples

Get validators at specific height

curl -X POST --data '{
  "jsonrpc":"2.0",
  "id"     :1,
  "method" :"platform.getAllValidatorsAt",
  "params": {
    "height": 1000
  }
}' -H 'content-type:application/json;' http://127.0.0.1:9650/v1/bc/P

Get validators at proposed height

curl -X POST --data '{
  "jsonrpc":"2.0",
  "id"     :1,
  "method" :"platform.getAllValidatorsAt",
  "params": {
    "height": "proposed"
  }
}' -H 'content-type:application/json;' http://127.0.0.1:9650/v1/bc/P

Use Cases

Network Monitoring: Track validator participation across all networks
Historical Queries: Analyze validator sets at specific historical heights
Cross-Network Analysis: Compare validator distributions across multiple networks
Consensus Verification: Verify validator state for cross-chain operations

Implementation Notes

The endpoint returns all networks with at least one validator
Primary network (ID: 11111111111111111111111111111111LpoYY) is always included
Validator weights are in nLUX (1 LUX = 1,000,000,000 nLUX)
BLS public keys are 48-byte values encoded as hex with "0x" prefix

platform.getValidatorsAt: Get validators for a specific network at a height
platform.getCurrentValidators: Get current validators for a network
platform.getPendingValidators: Get pending validators for a network

3.0 KiB Raw Blame History