# Blockdaemon 高度不更新：核对 Ethereum 入口、API Suite key 与限额

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

用既有 eth_blockNumber 与同步记录排查错网络、错误产品凭据或请求失败，保留官方入口路径差异。

## 使用工具
- [Blockdaemon RPC API](https://lianxiaozhi.com/tools/blockdaemon) · [官方入口](https://www.blockdaemon.com/)

## 前置条件
- 准备同一项目的脱敏 endpoint、网络、请求时间、HTTP/JSON-RPC 原响应，以及可用的套餐和 key 限制记录。
- 比较高度需要至少两条带时间记录；单条文档示例或仅截图数字无法判断当前是否停滞。

## 1. 锁定 Ethereum 网络与实际路径

Ethereum 专页列 https://svc.blockdaemon.com/ethereum/mainnet/native，Sepolia/Hoodi 使用各自网络段。通用认证页却举 /ethereum/mainnet/native/rpc；先保留既有项目的实际路径及文档来源，不把两条路径视为已实测等价。遇到 404，先核对网络、路径、HTTP 方法和项目配置，不归因于链停止出块。

核对结果：目标网络、实际路径与文档差异明确，404 没有被当成高度为零。
依据：[Blockdaemon：Ethereum 入口与 blockNumber](https://docs.blockdaemon.com/docs/access-ethereum-rpc-api)
依据：[Blockdaemon：产品 key、认证与 key 级限制](https://docs.blockdaemon.com/docs/authentication)
依据：[Blockdaemon：HTTP 状态与错误正文](https://docs.blockdaemon.com/docs/error-handling.md)

## 2. 确认产品 key、headers 与允许客户端

RPC 用 API Suite 对应凭据，不能从 Staking Authentication 页拿 key 当通用替代。Ethereum 专页支持 Authorization: Bearer <key> 或 X-API-Key: <key>；脱敏记录只保留 header 名。检查已有配置中的 Domain/CIDR/User Agent 限制与实际来源，401 查有效凭据，403 查权限；认证页 query 参数表与其他协议示例写法不同，本流程不迁移该格式到 Ethereum。

核对结果：产品 key 类型、header 位置和允许来源可追踪，未暴露可用凭据或混用质押 key。
依据：[Blockdaemon：产品 key、认证与 key 级限制](https://docs.blockdaemon.com/docs/authentication)
依据：[Blockdaemon：Ethereum 入口与 blockNumber](https://docs.blockdaemon.com/docs/access-ethereum-rpc-api)
依据：[Blockdaemon：HTTP 状态与错误正文](https://docs.blockdaemon.com/docs/error-handling.md)

## 3. 复核 eth_blockNumber 的原始请求与响应

读取 POST 的 JSON body：jsonrpc 为 2.0、method 为 eth_blockNumber、params 为 []，id 与响应相关联。HTTP 200 仍检查业务 error、result 是否存在且符合该方法；认证错误可能是 type/title/status 的 HTTP 错误体，不能强行当 result。result 是十六进制高度，使用整数转换；文档样例不作为当前高度。

核对结果：同一请求的 HTTP 与业务结果都已读取，高度原值、整数和时间留存，失败不补成零。
依据：[Blockdaemon：Ethereum 入口与 blockNumber](https://docs.blockdaemon.com/docs/access-ethereum-rpc-api)
依据：[Blockdaemon：Ethereum 方法与 CU](https://docs.blockdaemon.com/reference/ethereum-methods-rpc-api)
依据：[Blockdaemon：HTTP 状态与错误正文](https://docs.blockdaemon.com/docs/error-handling.md)
依据：[JSON-RPC 2.0：响应、错误与请求 ID](https://www.jsonrpc.org/specification)

## 4. 在同网络时间线上限定同步结论

将两次成功高度按时间对齐；不同网络、不同路径或失败响应先单列。有既有 eth_syncing 结果时保留 false 或同步对象，false 仅表示该节点报告未在同步，不证明端点始终健康；高度停留的短时间记录也不能单独诊断全网故障。不要用 REST/索引列表的数量、bd_estimateFee 的 mostRecentBlock 或质押报表来填补缺少的节点高度证据。

核对结果：高度与同步观察来自相同网络且时间可比较；其他产品结果没有替代 RPC 缺失项。
依据：[Blockdaemon：Ethereum 入口与 blockNumber](https://docs.blockdaemon.com/docs/access-ethereum-rpc-api)
依据：[Blockdaemon：Ethereum 方法与 CU](https://docs.blockdaemon.com/reference/ethereum-methods-rpc-api)
依据：[Blockdaemon：产品 key、认证与 key 级限制](https://docs.blockdaemon.com/docs/authentication)

## 5. 同时核对订阅、key 上限与方法 CU

复核已有 Dashboard Usage 和 key 配置：套餐 RPS、订阅 CU 与 key 自身更低上限都可能影响读取。触及 key 级额度不发通知邮件，没邮件不等于没限额；Staking 的 RPM 与 RPC 的 RPS 不能换算后直接套用。Ethereum 表列 blockNumber、chainId、syncing 各 1 CU，它们是服务用量，未广播读请求不等于厂商不扣量。

核对结果：429、账户配额和 key 限制有对应记录；缺控制台记录时写待核，不凭套餐名推算余量。
依据：[Blockdaemon：产品 key、认证与 key 级限制](https://docs.blockdaemon.com/docs/authentication)
依据：[Blockdaemon：不同产品的 RPS/CU 限制](https://docs.blockdaemon.com/docs/rate-limits.md)
依据：[Blockdaemon：Ethereum 方法与 CU](https://docs.blockdaemon.com/reference/ethereum-methods-rpc-api)

## 6. 输出问题类别与待补证据

结论分别列路径/网络、凭据/权限、HTTP 或 JSON-RPC 失败、限额与高度观察。429 等待后续有边界重试，认证/参数错误先修正原因；不要对未知入口批量尝试。若目标是确认某笔交易，另保留交易哈希与 receipt 待查，节点最高高度不是该交易的最终确认记录。

核对结果：报告指向具体失败层和缺失记录，未把高度观察、费用估计或索引服务当交易到账证明。
依据：[Blockdaemon：HTTP 状态与错误正文](https://docs.blockdaemon.com/docs/error-handling.md)
依据：[Blockdaemon：不同产品的 RPS/CU 限制](https://docs.blockdaemon.com/docs/rate-limits.md)
依据：[Blockdaemon：Ethereum 方法与 CU](https://docs.blockdaemon.com/reference/ethereum-methods-rpc-api)
依据：[JSON-RPC 2.0：响应、错误与请求 ID](https://www.jsonrpc.org/specification)

## 常见错误
- /native 与 /native/rpc 尚未做认证访问验证，不承诺它们在所有账户上等价。
- eth_syncing=false、HTTP 200 与链上最终性是不同证据。
- 没有 key 级限额邮件，并不证明该 key 还有可用额度。

## 完成检查
- 得到带时间和网络的有效高度观察或明确失败/待核清单，可区分入口、认证、权限与用量问题。
- 仅官方文档核验和既有记录排查流程，未登录 Portal、创建 key 或执行认证 RPC。

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

## 官方依据
- [Blockdaemon：Ethereum 入口与 blockNumber](https://docs.blockdaemon.com/docs/access-ethereum-rpc-api)
- [Blockdaemon：产品 key、认证与 key 级限制](https://docs.blockdaemon.com/docs/authentication)
- [Blockdaemon：Ethereum 方法与 CU](https://docs.blockdaemon.com/reference/ethereum-methods-rpc-api)
- [Blockdaemon：不同产品的 RPS/CU 限制](https://docs.blockdaemon.com/docs/rate-limits.md)
- [Blockdaemon：HTTP 状态与错误正文](https://docs.blockdaemon.com/docs/error-handling.md)
- [JSON-RPC 2.0：响应、错误与请求 ID](https://www.jsonrpc.org/specification)