如何使用 getBlocks

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

getBlocks RPC方法允许您检索指定起始槽和可选结束槽之间已确认的区块槽号列表。这在您需要知道特定范围内已确认的区块时非常有用，而无需获取每个区块的完整内容。

避免批处理以提高性能

批处理归档方法会显著增加延迟。不允许超过10个请求的批处理。

​

常见用例

• 识别范围内的已确认区块： 快速获取分类账中两个点之间成功确认的所有区块槽的列表。
• 遍历区块： 使用返回的槽列表来获取每个区块的详细信息，如果需要，可使用getBlock。
• 基本区块审核： 在特定范围内验证区块的存在。

​

请求参数

getBlocks方法接受以下参数：

1. start_slot (u64, 必填)：要考虑的第一个槽（包含在内）。
2. end_slot (u64, 可选)：要考虑的最后一个槽（包含在内）。
   • 如果未提供，该查询将返回从start_slot到最新确认槽的区块。
   • start_slot和end_slot之间的范围（如果省略end_slot则为最新槽）不得超过500,000个槽。
3. commitment (string, 可选)：指定查询的提交级别。如果省略，则使用节点的默认提交级别。这作为配置对象中的唯一字段传递，作为最后一个参数。

​

响应结构

JSON-RPC响应的result字段将是一个u64整数数组。数组中的每个整数表示指定范围内的已确认区块槽号。

• 例如: [5, 6, 7, 8, 9, 10]

​

示例

​

1. 获取特定槽范围内的区块

此示例获取从槽位 250000000 到 250000010 的已确认区块槽列表。

cURL

curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getBlocks",
    "params": [
      250000000,
      250000010
    ]
  }'

​

2. 从起始槽到最新确认槽获取区块

此示例获取从 260000000 开始的已确认区块槽，直到节点确认的最新区块（遵循从起始槽位最多 500,000 槽的范围限制）。

cURL

curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getBlocks",
    "params": [
      260000000 
    ]
  }'

​

3. 获取具有特定承诺级别的区块

此示例使用 confirmed 承诺级别获取区块。

cURL

curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getBlocks",
    "params": [
      270000000,
      270000005,
      { "commitment": "confirmed" }
    ]
  }'

​

开发者提示

• 范围限制： 请记住 500,000 槽的范围限制。请求更大的范围将导致错误。
• 节点数据可用性： 节点可能不会保留所有历史槽位的信息。非常旧的 start_slot 值根据节点的配置和分类帐保留情况可能返回空数组或错误。
• 区块确认： 此方法返回已确认的区块。确切的一组区块可能会根据所选的 commitment 级别和查询的节点有所不同，特别是对非常近期的槽位。
• 与 getBlock 的补充： getBlocks 通常用作识别相关区块槽的第一步，然后使用 getBlock 来检索该列表中各个区块的完整详细信息。
• 分页替代方法： 由于 getBlocks 具有范围限制，如果需要扫描区块链的很大一部分，您需要多次调用 getBlocks，将所需的总范围分割为不超过 500,000 槽的段。

本指南概述了如何使用 getBlocks RPC 方法列出 Solana 网络上的已确认区块槽。

​

相关方法

getBlock

获取特定区块的详细信息

getBlocksWithLimit

从特定槽位开始获取固定数量的区块