List L1 validators

Lists details for L1 validators. By default, returns details for all active L1 validators. Filterable by validator node ids, subnet id, and validation id.

Authorizations

x-glacier-api-key

string

headerrequired

Api keys provide higher access to rate limits. To obtain an api key, sign up for an account at https://avacloud.io/.

Path Parameters

network

enum<string>

required

Either mainnet or testnet/fuji.

Available options:

mainnet,

fuji,

testnet,

devnet

Query Parameters

pageToken

string

A page token, received from a previous list call. Provide this to retrieve the subsequent page.

pageSize

integer

default: 10

The maximum number of items to return. The minimum page size is 1. The maximum pageSize is 100.

Required range: 1 < x < 100

l1ValidationId

any

The L1 Validator's validation ID to filter by. If not provided, then all L1 Validators will be returned.

includeInactiveL1Validators

boolean

nodeId

string

A valid node ID in format 'NodeID-HASH'.

subnetId

any

The subnet ID to filter by. If not provided, then all subnets will be returned.

Response

200 - application/json

validators

object[]

required

The list of L1 validations for the given Subnet ID, NodeId or validationId

Show child attributes

validators.validationId

string

required

Unique L1 validation ID used network-wide to identify L1 validation until its weight is reduced to 0 i.e. removed.

validators.nodeId

string

required

validators.subnetId

string

required

validators.weight

number

required

Weight of the L1 validator used while sampling validators within the L1. A zero-weight L1 validator means it has been removed from the L1, and the validationID is no longer valid

validators.remainingBalance

number

required

Remaining L1 validator balance in nAVAX until inactive. It can rejoin L1 sampling by increasing balance with IncreaseL1ValidatorBalanceTx

validators.creationTimestamp

number

required

The timestamp of the transaction which created this L1 validator

validators.blsCredentials

object

required

validators.remainingBalanceOwner

object

required

The L1 validator owner's balance, returned after it's disabled or removed

Show child attributes

validators.remainingBalanceOwner.addresses

string[]

required

validators.remainingBalanceOwner.threshold

number

required

validators.deactivationOwner

object

required

Owner ddresses details which can disable or remove the L1 validator

Show child attributes

validators.deactivationOwner.addresses

string[]

required

validators.deactivationOwner.threshold

number

required

nextPageToken

string

A token, which can be sent as pageToken to retrieve the next page. If this field is omitted or empty, there are no subsequent pages.