跳转到主要内容

参数

config
object
包含以下可选字段的配置对象:

响应

result
number
当前区块高度

代码示例

基本请求

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}`);

注意事项

  1. 区块高度随每个新区块单调递增
  2. 由于跳过的 slot,区块高度可能与 slot 编号不同
  3. 不同的节点可能根据其网络视图返回略有不同的高度
  4. 响应是即时的,因为它从当前状态读取

最佳实践

  1. 根据需求使用适当的 commitment 级别:
    • processed 获取最新的可能高度
    • confirmed 获取高概率最终性
    • finalized 获取保证的最终性
  2. 如果需要 slot 编号而不是区块高度,请考虑使用 getSlot
  3. 对于历史查询,使用 getBlock 与特定 slot

常见错误

错误码消息解决方案
-32601Method not found验证是否连接到 Solana RPC 节点
-32007Block height not available节点可能正在启动或同步中