如何使用 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 槽的段。

​

相关方法