如何使用 getBlocks

​

常见用例

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

​

请求参数

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

​

响应结构

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

​

示例

​

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

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. 从起始插槽获取到最新确认的区块

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. 获取具有特定承诺级别的区块

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 插槽的段。