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

# getBlocksWithLimit

> 返回从给定 slot 开始的已确认区块列表

## 参数

<ParamField query="startSlot" type="number" required>
  起始 slot（包含）
</ParamField>

<ParamField query="limit" type="number" required>
  返回的最大区块数
</ParamField>

<ParamField query="config" type="object" optional>
  包含以下可选字段的配置对象：

  <Expandable title="config fields">
    <ParamField query="commitment" type="string" optional>
      使用的 commitment 级别：

      * `processed`：最新区块（未确认）
      * `confirmed`：超级多数确认
      * `finalized`：超级多数最终确认
    </ParamField>
  </Expandable>
</ParamField>

## 响应

<ResponseField name="result" type="array">
  按升序排列的区块 slot 数组
</ResponseField>

## 代码示例

### 基本请求

```bash theme={null}
curl https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBlocksWithLimit",
  "params": [
    100000000,
    10
  ]
}'
```

### 带 Commitment 的请求

```bash theme={null}
curl https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBlocksWithLimit",
  "params": [
    100000000,
    10,
    {
      "commitment": "finalized"
    }
  ]
}'
```

### 使用 web3.js

```typescript theme={null}
import { Connection } from '@solana/web3.js';

const connection = new Connection('https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY');

// Get 10 blocks starting from slot
const blocks = await connection.getBlocksWithLimit(100000000, 10);
console.log('Blocks:', blocks);

// Get finalized blocks
const finalizedBlocks = await connection.getBlocksWithLimit(100000000, 10, 'finalized');
console.log('Finalized blocks:', finalizedBlocks);
```

## 注意事项

1. 返回从指定 slot 开始的已确认区块
2. 结果按升序返回
3. limit 控制返回的最大区块数
4. 某些 slot 可能被跳过（未生产区块）
5. 响应是即时的，因为它从当前状态读取

## 最佳实践

1. 根据需求使用适当的 commitment 级别
2. 保持 limit 合理以避免超时
3. 使用此方法代替 `getBlocks` 进行分页
4. 适当时缓存结果以减少 RPC 负载
5. 在应用逻辑中处理跳过的 slot

## 常见错误

| 错误码    | 消息                                    | 解决方案                  |
| ------ | ------------------------------------- | --------------------- |
| -32602 | Invalid param: limit must be positive | 确保 limit 大于 0         |
| -32602 | Invalid param: limit too large        | 减小 limit 大小           |
| -32601 | Method not found                      | 验证是否连接到 Solana RPC 节点 |
| -32007 | Block information unavailable         | 节点可能正在启动或 slot 太旧     |