跳到正文
← 使用教程

OrbitFlare 高度不更新:区分 license、集群、区块高度与 slot

链小知 · 进阶 · 核验 · 依官方文档整理

复核既有 getGenesisHash/getBlockHeight 记录,避免 Customer API key、Devnet、commitment 或限额造成错误结论。

开始前准备

  • 准备已脱敏 endpoint、已有 license 类型/套餐记录、原始 HTTP 与 JSON-RPC 响应;不复制任何有效 key。
  • 比较高度需至少两条带时间的真实记录;没有真实响应时只能整理待补项,不用文档示例认定节点健康。

1. 先核对产品凭据与实际主机

RPC 使用 license key,通过区域 URL 的 api_key 参数传入;Customer API 的 X-ORBIT-KEY 或 Bearer token 不能因此充当 RPC license。主网示例为 fra.rpc.orbitflare.com,Devnet 列专用 devnet.rpc.orbitflare.com。对照现有配置和套餐记录,免费计划也不等于无认证;脱敏时保留主机、参数名与产品类型,不保留其值。

检查结果:RPC license、Customer API 凭据与主网/Devnet 清楚区分。

2. 用已有 genesis 记录核对集群

getGenesisHash 无方法参数,result 是 base58 字符串;将已有返回与项目的预期集群记录及官方对应表核对。表中主网、testnet、devnet 是不同 hash;若不匹配或出现未知 hash,先保留错集群/待核状态。URL 看似主网、某个账户返回零或请求成功,都不足以替代这一核对;文档示例不证明当前连接。

检查结果:预期集群、实际 genesis 与匹配状态可追溯,没有未知值被默认当主网。

3. 按同一 commitment 比较 block height

检查 getBlockHeight 的 method、ID 和配置,result 为区块高度数值;比较时使用同一网络、同一 commitment 和各自时间。具体方法页明确 block height 与 slot 可因跳过 slot 而不同,不能拿 HTTP 类型概览中的合并表述作为同义定义。minContextSlot 是最低上下文条件,不是强制结果等于某高度或历史快照;單个成功高度也不是某笔交易最终确认的证据。

检查结果:高度、slot、commitment 与时间分开,单个数值未被当成交易到账。

4. 按原状态和 message 排错

每条记录保留 HTTP 状态、JSON-RPC error.code/message 与 result,HTTP 200 仍须检查 error。401 先查正确产品和 license,403 查权限或已配置 IP 限制,429 查实际 RPS;超时或 5xx 保留上游/服务异常证据。厂商 Common Error Codes 的 -320xx 映射不能不看 message 就套到所有 Solana 实现,失败响应不填高度零;只对可重试读取整理有限次数的指数退避计划。

检查结果:认证、权限、限额和读取错误分开,有原始 message,不把失败记为链停摆。

5. 检查流连接与套餐疑点,再汇总

RPS、TPS、串流连接与历史权限分别记录。认证页列共享 WebSocket 每 IP 并发 50,跨区域累计、空闲 60 秒可关闭;gRPC 另有每 IP 50 的共享上限,不能把 HTTP 成功率当串流验收。产品页部分套餐强调历史数据,末尾又称所有套餐包含;已读认证表只列 9 区而营销称 11 区,均保持待核,不补猜测。输出集群与高度对照、错误时间段和具体权限缺口。

检查结果:结论限于已有 RPC 记录,串流和历史能力没有被自动宣布通过。

怎样确认完成

  • 形成产品凭据类型、主机、genesis、commitment、时间和响应的脱敏清单,明确缺记录与文档冲突。
  • 本教程为官方文档核验,未注册、购买 license、发送交易或访问账户端点。

常见错误与边界

  • Customer API 认证和 RPC license 是两套产品入口。
  • 同一地址的 Devnet 与主网余额不能互相替代。
  • 高度、slot 或 health=ok 不单独证明某笔交易已最终确认。

本教程根据官方资料整理,尚未完成逐步操作验收。界面、支持范围及费用变化时,先核对官方说明。 纯文本版 · 提交纠错依据