如何使用 getVoteAccounts

​

常见用例

• 验证者监控： 跟踪网络上验证者的状态、权益和性能。
• 权益仪表板： 为希望委托其 SOL 的用户显示可用验证者的信息。
• 网络健康分析： 通过检查权益分布和验证者活动来评估网络的整体健康和去中心化程度。
• 识别失职验证者： 找出未积极参与共识的验证者。

​

请求参数

1. commitment（字符串，可选）：指定查询的承诺级别（例如，"finalized", "confirmed", "processed"）。如果省略，将使用节点的默认承诺。
2. votePubkey（字符串，可选）：如果提供，结果将被过滤以仅包括指定的验证者投票账户地址（base-58 编码）。
3. keepUnstakedDelinquents（布尔型，可选）：默认为false。如果设置为true，则delinquent列表将包括没有激活权益的验证者。否则，将被过滤掉。
4. delinquentSlotDistance（u64，可选）：指定验证者必须落后于账本尖端多少个槽位才能被视为逾期。如果未指定，节点使用默认值。

​

响应结构

• current：一个对象数组，每个对象表示一个活跃的投票账户，具有以下字段：
• votePubkey（字符串）：投票账户地址（base-58 编码）。
• nodePubkey（字符串）：验证者节点的身份公钥（base-58 编码）。
• activatedStake（u64）：委托给该投票账户并在当前时期活跃的权益（以 lamports 为单位）。
• epochVoteAccount（布尔型）：如果投票账户在当前时期至少活跃过一次，则为true。
• commission（数字）：验证者收取的佣金百分比（0-100）。
• lastVote（u64）：此验证者最近投票的槽位号。
• rootSlot（u64）：节点认为是根的最后一个槽（完全确认不会被回滚的区块）。
• epochCredits（数组）：一个数组的数组，每个内部数组包含[epoch, credits_earned_in_epoch, previous_total_credits]。
• delinquent：一个对象数组，结构与 current 相同，表示被节点视为逾期的验证者。

{
  "jsonrpc": "2.0",
  "result": {
    "current": [
      {
        "commission": 10,
        "epochCredits": [[300, 12345, 567890]],
        "epochVoteAccount": true,
        "lastVote": 180000500,
        "nodePubkey": "NodePubkeyExample123...",
        "rootSlot": 180000450,
        "activatedStake": "50000000000000", // lamports
        "votePubkey": "VoteAccountPubkeyExample123..."
      }
      // ... more current validators
    ],
    "delinquent": [
      // ... delinquent validators, if any
    ]
  },
  "id": 1
}

​

代码示例

# Get all current and delinquent vote accounts:
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getVoteAccounts"
  }' \
  <YOUR_RPC_URL>

# Get a specific vote account:
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getVoteAccounts",
    "params": [
      {
        "votePubkey": "<SPECIFIC_VOTE_ACCOUNT_PUBKEY>"
      }
    ]
  }' \
  <YOUR_RPC_URL>

# Get vote accounts with "confirmed" commitment and keep unstaked delinquents:
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getVoteAccounts",
    "params": [
      {
        "commitment": "confirmed",
        "keepUnstakedDelinquents": true
      }
    ]
  }' \
  <YOUR_RPC_URL>

​

开发者提示

• 大响应： 此方法可以返回大量数据，特别是在拥有许多验证者的网络（如Mainnet Beta）上。请注意响应大小和处理时间。
• 逾期定义： “逾期”的定义可能取决于delinquentSlotDistance和节点的视角。如果节点对账本尖端的看法不同，某个验证者可能在一个节点上显示为逾期，而在另一个节点上则不是。
• 权益激活： activatedStake反映了当前纪元中活跃的权益。权益的激活和停用需要时间。
• 纪元学分： epochCredits提供了一个验证者通过投票赚取学分的历史绩效。