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

整理：链小知（AI 辅助）
资料核对日期：2026-10-12
引用地址：https://lianxiaozhi.com/tools/guides/orbitflare-rpc-license-and-network-check
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

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

## 使用工具
- [OrbitFlare RPC](https://lianxiaozhi.com/tools/orbitflare) · [官方入口](https://orbitflare.com/)

## 前置条件
- 准备已脱敏 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 清楚区分。
依据：[OrbitFlare：产品认证与连接限制](https://docs.orbitflare.com/authentication.md)
依据：[OrbitFlare：license 与 RPC 示例](https://docs.orbitflare.com/quickstart.md)
依据：[OrbitFlare：HTTP 与 commitment](https://docs.orbitflare.com/rpc/http.md)

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

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

核对结果：预期集群、实际 genesis 与匹配状态可追溯，没有未知值被默认当主网。
依据：[OrbitFlare：genesis 与集群表](https://docs.orbitflare.com/rpc/methods/getGenesisHash.md)

## 3. 按同一 commitment 比较 block height

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

核对结果：高度、slot、commitment 与时间分开，单个数值未被当成交易到账。
依据：[OrbitFlare：区块高度和 slot 的区别](https://docs.orbitflare.com/rpc/methods/getBlockHeight.md)
依据：[OrbitFlare：HTTP 与 commitment](https://docs.orbitflare.com/rpc/http.md)

## 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，不把失败记为链停摆。
依据：[OrbitFlare：HTTP 与 JSON-RPC 错误](https://docs.orbitflare.com/rpc/error-codes.md)
依据：[OrbitFlare：产品认证与连接限制](https://docs.orbitflare.com/authentication.md)
依据：[JSON-RPC 2.0：响应与错误](https://www.jsonrpc.org/specification)

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

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

核对结果：结论限于已有 RPC 记录，串流和历史能力没有被自动宣布通过。
依据：[OrbitFlare：产品认证与连接限制](https://docs.orbitflare.com/authentication.md)
依据：[OrbitFlare：套餐范围与历史声明](https://docs.orbitflare.com/products.md)

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

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

## 相关知识
- [区块确认与最终性是什么？交易成功和充值到账为何不同步](https://lianxiaozhi.com/learn/confirmations-and-finality)

## 官方依据
- [OrbitFlare：产品认证与连接限制](https://docs.orbitflare.com/authentication.md)
- [OrbitFlare：license 与 RPC 示例](https://docs.orbitflare.com/quickstart.md)
- [OrbitFlare：HTTP 与 commitment](https://docs.orbitflare.com/rpc/http.md)
- [OrbitFlare：genesis 与集群表](https://docs.orbitflare.com/rpc/methods/getGenesisHash.md)
- [OrbitFlare：区块高度和 slot 的区别](https://docs.orbitflare.com/rpc/methods/getBlockHeight.md)
- [OrbitFlare：HTTP 与 JSON-RPC 错误](https://docs.orbitflare.com/rpc/error-codes.md)
- [OrbitFlare：套餐范围与历史声明](https://docs.orbitflare.com/products.md)
- [JSON-RPC 2.0：响应与错误](https://www.jsonrpc.org/specification)