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": "getBlockHeight"
}'
带 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": "getBlockHeight",
"params": [
{
"commitment": "finalized"
}
]
}'
使用 web3.js
import { Connection } from '@solana/web3.js';
const connection = new Connection('https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY');
const blockHeight = await connection.getBlockHeight('finalized');
console.log(`Current block height: ${blockHeight}`);
注意事项
- 区块高度随每个新区块单调递增
- 由于跳过的 slot,区块高度可能与 slot 编号不同
- 不同的节点可能根据其网络视图返回略有不同的高度
- 响应是即时的,因为它从当前状态读取
最佳实践
- 根据需求使用适当的 commitment 级别:
processed 获取最新的可能高度
confirmed 获取高概率最终性
finalized 获取保证的最终性
- 如果需要 slot 编号而不是区块高度,请考虑使用
getSlot
- 对于历史查询,使用
getBlock 与特定 slot
常见错误
| 错误码 | 消息 | 解决方案 |
|---|
| -32601 | Method not found | 验证是否连接到 Solana RPC 节点 |
| -32007 | Block height not available | 节点可能正在启动或同步中 |