platform.getPendingValidators

List the validators in the pending validator set of the specified Subnet. Each validator is not currently validating the Subnet but will in the future.

Signature​

platform.getPendingValidators({
    subnetID: string, //optional
    nodeIDs: string[], //optional
}) -> {
    validators: []{
        txID: string,
        startTime: string,
        endTime: string,
        stakeAmount: string, //optional
        nodeID: string,
        delegationFee: string,
        connected: bool,
        weight: string, //optional
    },
    delegators: []{
        txID: string,
        startTime: string,
        endTime: string,
        stakeAmount: string,
        nodeID: string
    }
}

• subnetID is the subnet whose current validators are returned. If omitted, returns the current validators of the Primary Network.

• nodeIDs is a list of the nodeIDs of pending validators to request. If omitted, all pending validators are returned. If a specified nodeID is not in the set of pending validators, it will not be included in the response.

• validators:

  • txID is the validator transaction.

  • startTime is the Unix time when the validator starts validating the Subnet.

  • endTime is the Unix time when the validator stops validating the Subnet.

  • stakeAmount is the amount of nAVAX this validator staked. Omitted if subnetID is not the Primary Network.

  • nodeID is the validator’s node ID.

  • connected if the node is connected.

  • weight is the validator’s weight when sampling validators. Omitted if subnetID is the Primary Network.

• delegators:

  • txID is the delegator transaction.

  • startTime is the Unix time when the delegator starts.

  • endTime is the Unix time when the delegator stops.

  • stakeAmount is the amount of nAVAX this delegator staked. Omitted if subnetID is not the Primary Network.

  • nodeID is the validating node’s node ID.

Example

Request

curl -X POST --data '{
    "jsonrpc": "2.0",
    "method": "platform.getPendingValidators",
    "params": {},
    "id": 1
}' -H 'content-type:application/json;' https://ava-mainnet.blastapi.io/<project-id>/ext/P

Result

{
    "jsonrpc": "2.0",
    "result": {
        "validators": [],
        "delegators": [{
            "txID": "2nfzULTgRrMMB5V2BLnNWQzAUPaYL3gtoeSNdPLPDz1H8XYNVc",
            "startTime": "1647877635",
            "endTime": "1650130261",
            "stakeAmount": "25000000000",
            "nodeID": "NodeID-3Y1QHL1C8LgL2eTaVDkyq2zeFo2XM6S1V"
        }, {
            "txID": "2sBfv5vEvfoJ4dYyprL5xHgbL3nAdJoZPrDe7aF1HGGSmSqES",
            "startTime": "1647877685",
            "endTime": "1650130591",
            "stakeAmount": "25000000000",
            "nodeID": "NodeID-7foQsWAsjpqqNgtzwRr6Ym7FLfyMF8VwW"
        }, {
            "txID": "2fuNeGcHszXkTy3Eq9RZeCcK6Bnrxt8ismQLCXroWJA9yY4jsR",
            "startTime": "1647877823",
            "endTime": "1670706025",
            "stakeAmount": "626000000000",
            "nodeID": "NodeID-HpMSfYT2ox1vkr1hFNMwmdWuq8QWhvH2u"
        }, {
            "txID": "2Z7gAhyntuAZRKkCe3SeqVgbABeSXYar1ZR5XPQS55PuoLunNN",
            "startTime": "1647877825",
            "endTime": "1677668455",
            "stakeAmount": "29757479962",
            "nodeID": "NodeID-HdG8EdGWAy8LR8YPA8hndoa1uwwgGv1si"
        }, {
            "txID": "2PC3d6fuYUace31vpikZjoF9owbBz8Rp5cvehGnkxZoPoZ9yu7",
            "startTime": "1647877889",
            "endTime": "1652112067",
            "stakeAmount": "100000000000",
            "nodeID": "NodeID-8UynAEU8PuuGetmjiiPcbGmvD3EyycuN6"
        }]
    },
    "id": 1
}