> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 如何使用 getLeaderSchedule

> 了解 getLeaderSchedule 的使用案例、代码示例、请求参数、响应结构和提示。

[RPC 方法](https://www.helius.dev/docs/api-reference/rpc/http/getleaderschedule) 返回特定 epoch 的区块生产领导分配给验证者的情况。了解领导计划对于网络分析、预测哪个验证者将在某些时间生产区块或与特定领导者交互的工具非常有用。

## 常见用例

* **网络监控：** 观察一个 epoch 中验证者之间的领导者槽分布。
* **交易路由（高级）：** 一些高级应用程序可能尝试将交易路由到当前或即将成为领导者的验证者，尽管这通常由网络和 RPC 节点处理。
* **验证者性能分析：** 将领导者计划与实际区块生产相关联，以评估验证者的正常运行时间和性能。
* **理解 epoch 进程：** 查看哪些验证者在整个 epoch 中负责生成区块。

## 请求参数

该方法最多可以接受两个可选参数：

1. **`slot`**（u64，可选）：一个槽号。如果提供，将获取包含此槽的 epoch 的领导计划。如果 `null` 或省略，则获取当前 epoch 的领导计划。
2. **`config`**（对象，可选）：一个可以包含以下内容的配置对象：
   * **`commitment`**（字符串，可选）：指定[承诺级别](https://www.helius.dev/blog/solana-commitment-levels)。如果未提供，则使用节点的默认承诺。
   * **`identity`**（字符串，可选）：验证者的 base-58 编码公钥。如果提供，返回的计划将仅包含分配给该验证者的槽。

## 响应结构

JSON-RPC 响应的 `result` 字段将是：

* `null`：如果找不到请求的 `slot`（或如果未提供槽则为当前 epoch）对应的 epoch 或其领导计划不可用（例如，对于未来的、未计算的 epoch）。
* 一个 **对象**：如果找到了计划。该对象是一个映射，其中：
  * 每个 **key** 是验证者的 base-58 编码公钥（身份）。
  * 相应的 **value** 是一个数字数组。每个数字是该验证者作为领导者的 epoch 开始的相对槽索引。

例如，如果一个 epoch 从槽 `1000` 开始，并且验证者在其计划中有 `[0, 1, 5]`，这意味着该验证者是槽 `1000`、`1001` 和 `1005` 的领导者。

## 示例

### 1. 获取当前纪元的领导者计划

此示例获取当前纪元的完整领导者计划。

<CodeGroup>
  ```bash cURL theme={"system"}
  # Replace <api-key> with your Helius API key
  curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
    '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "getLeaderSchedule"
    }'
  ```

  ```javascript JavaScript (using @solana/web3.js) theme={"system"}
  // Replace <api-key> with your Helius API key
  const { Connection } = require('@solana/web3.js');

  async function fetchCurrentLeaderSchedule() {
    const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
    try {
      const leaderSchedule = await connection.getLeaderSchedule(); // Fetches for current epoch by default
      if (leaderSchedule) {
        console.log('Leader Schedule for Current Epoch:');
        for (const [validatorIdentity, slots] of Object.entries(leaderSchedule)) {
          console.log(`  Validator: ${validatorIdentity}`);
          console.log(`    Slots (relative to epoch start): ${slots.join(', ')}`);
        }
      } else {
        console.log('Leader schedule for the current epoch not found or not yet available.');
      }
      // console.log(JSON.stringify(leaderSchedule, null, 2));
    } catch (error) {
      console.error('Error fetching leader schedule:', error);
    }
  }

  fetchCurrentLeaderSchedule();
  ```
</CodeGroup>

### 2. 获取特定纪元中特定验证者的领导者计划（按槽位）

此示例获取给定验证器标识在包含插槽 `200000` 的纪元的领导者计划。

<CodeGroup>
  ```bash cURL theme={"system"}
  # Replace <api-key> with your Helius API key
  # Replace VALIDATOR_PUBKEY with an actual validator identity public key
  curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
    '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "getLeaderSchedule",
      "params": [
        200000,
        { "identity": "VALIDATOR_PUBKEY" }
      ]
    }'
  ```

  ```javascript JavaScript (using @solana/web3.js) theme={"system"}
  // Replace <api-key> with your Helius API key
  // Replace VALIDATOR_PUBKEY with an actual validator identity public key
  const { Connection, PublicKey } = require('@solana/web3.js');

  async function fetchValidatorEpochSchedule() {
    const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
    const targetSlot = 200000;
    const validatorIdentity = 'VALIDATOR_PUBKEY'; // e.g., 'Vote111111111111111111111111111111111111111'

    try {
      const leaderSchedule = await connection.getLeaderSchedule(targetSlot, { identity: validatorIdentity });
      if (leaderSchedule && leaderSchedule[validatorIdentity]) {
        console.log(`Leader Schedule for Validator ${validatorIdentity} in epoch of slot ${targetSlot}:`);
        console.log(`  Slots (relative to epoch start): ${leaderSchedule[validatorIdentity].join(', ')}`);
      } else {
        console.log(`No leader slots found for validator ${validatorIdentity} in epoch of slot ${targetSlot}, or schedule not available.`);
      }
      // console.log(JSON.stringify(leaderSchedule, null, 2));
    } catch (error) {
      console.error('Error fetching validator leader schedule:', error);
    }
  }

  fetchValidatorEpochSchedule();
  ```
</CodeGroup>

## 开发者提示

* **纪元边界：** 领导者计划在整个纪元内是固定的。您可以使用 `getEpochInfo` 来查找纪元的开始和结束插槽。
* **未来纪元：** 请求遥远未来纪元的计划可能会返回 `null`，如果网络尚未计算出它。
* **相对插槽索引：** 请记住，响应中的插槽编号是相对于*请求的*纪元的第一个插槽，而不是区块链上的绝对插槽编号。
* **大型响应：** 对于没有身份过滤器的完整纪元计划，响应可能很大，列出所有验证者及其分配的插槽。

本指南提供使用 `getLeaderSchedule` 在 Solana 网络上查询任何给定纪元区块生产者分配的必要信息。

## 相关方法

<CardGroup cols={2}>
  <Card title="getEpochInfo" href="/docs/zh/api-reference/rpc/http/getepochinfo">
    获取当前纪元信息，包括插槽边界
  </Card>

  <Card title="getSlotLeaders" href="/docs/zh/api-reference/rpc/http/getslotleaders">
    获取特定范围插槽的领导者
  </Card>
</CardGroup>