如何使用 getBlocksWithLimit

​

常见用例

• 获取固定数量的后续区块： 获取在特定起始槽之后确认的定义数量的区块槽。
• 分页区块探索： 在分析区块链的某个部分时分块检索区块。
• 最近区块监控： 从已知的最近槽获取最后 N 个区块。

​

请求参数

1. start_slot (u64, 必需)：要考虑的第一个槽（包括在内）。
2. limit (u64, 必需)：要返回的最大区块槽数量。查询的槽总数（从 start_slot 到其后的 limit 区块）不得超过 500,000 个槽。
3. commitment (string, 可选)：指定查询的承诺级别。如果省略，则使用节点的默认承诺。这作为配置对象中的唯一字段传递，作为最后一个参数。

​

响应结构

• 示例：如果 start_slot 是 5 且 limit 是 3，可能的结果是 [5, 6, 7]。

​

示例

​

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": "getBlocksWithLimit",
    "params": [
      280000000, 
      5 
    ]
  }'

​

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": "getBlocksWithLimit",
    "params": [
      290000000,
      3,
      { "commitment": "confirmed" }
    ]
  }'

​

开发者提示

• 范围说明： limit 参数决定返回的最大区块槽位数量。500,000 槽位限制适用于扫描的概念范围（即从 start_slot 到 start_slot + limit - 1）。确保此概念范围不超过 500,000 槽位，即使在该范围内找到并返回的实际区块较少。
• 节点数据可用性： 节点可能不会保留所有历史槽位的信息。一个非常旧的 start_slot 可能返回的区块少于指定的 limit，或者返回空数组，这取决于节点的账本保留情况。
• 区块确认： 此方法返回已确认的区块。具体的区块集合可能会根据所选的 commitment 级别和查询的节点而略有不同，尤其是对于非常近期的槽位。
• 用例特异性： 当您知道起始点并需要固定数量的后续区块时，getBlocksWithLimit 是理想的选择。如果您需要已知槽位范围内的所有区块，getBlocks 可能更合适。