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.
包含以下可选字段的配置对象：
使用的 commitment 级别：
processed：最新区块（未确认）confirmed：超级多数确认finalized：超级多数最终确认
代码示例
基本请求
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": "getBlocks",
"params": [
100000000,
100000100
]
}'
带 Commitment 的请求
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": "getBlocks",
"params": [
100000000,
100000100,
{
"commitment": "finalized"
}
]
}'
使用 web3.js
import { Connection } from '@solana/web3.js';
const connection = new Connection('https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY');
// Get blocks in range
const blocks = await connection.getBlocks(100000000, 100000100);
console.log('Blocks:', blocks);
// Get finalized blocks
const finalizedBlocks = await connection.getBlocks(100000000, 100000100, 'finalized');
console.log('Finalized blocks:', finalizedBlocks);
注意事项
- 返回指定 slot 之间的已确认区块
- 结果按升序返回
- 范围包含起始和结束 slot
- 某些 slot 可能被跳过（未生产区块）
- 响应是即时的，因为它从当前状态读取
最佳实践
- 根据需求使用适当的 commitment 级别：
processed 获取最新区块confirmed 获取高概率最终性finalized 获取保证的最终性
- 保持 slot 范围合理以避免超时
- 考虑使用
getBlocksWithLimit 进行分页
- 适当时缓存结果以减少 RPC 负载
- 在应用逻辑中处理跳过的 slot
常见错误
| 错误码 | 消息 | 解决方案 |
|---|
| -32602 | Invalid param: startSlot must be less than endSlot | 确保 startSlot 小于 endSlot |
| -32602 | Invalid param: slot range too large | 减小 slot 范围大小 |
| -32601 | Method not found | 验证是否连接到 Solana RPC 节点 |
| -32007 | Block information unavailable | 节点可能正在启动或范围太旧 |
