eth_getBlockByNumber怎么用？

发布 2026-07-21 更新 2026-07-21 Daniel Park 浏览 --

eth_getBlockByNumber的第二个参数决定返回完整交易对象还是只返回交易哈希；第一个参数既可用十六进制区块号，也可用latest、safe、finalized等标签。审计时必须把两个选择写进请求记录。

eth_getBlockByNumber怎么用？图 1 — eth_getBlockByNumber怎么用？ · 图 1

eth_getBlockByNumber 的第二个参数决定返回完整交易对象还是只返回交易哈希；第一个参数既可用十六进制区块号，也可用 latest、safe、finalized 等标签。审计时必须把两个选择写进请求记录。

最小请求与返回

    {"jsonrpc":"2.0","id":1,"method":"eth_getBlockByNumber","params":["0x12D687",false]}

返回对象中的 number、hash、parentHash、timestamp 和 transactions 属于同一区块上下文。fullTransactions 为 false 时，transactions 是哈希数组；改为 true 会返回交易对象，响应体明显增大。

    {"jsonrpc":"2.0","id":1,"result":{"number":"0x12d687","hash":"0xabc...","parentHash":"0xdef...","timestamp":"0x62f3a900","transactions":["0x91..."]}}

标签如何选择

latest 追随节点当前链头，适合界面展示但可能变化；safe 与 finalized 表达更强确认语义，节点不支持时可能报错。历史审计应保存最终解析出的 number 和 hash，日后按固定区块号重放，不能只保存 latest。

错误分支与验收

result 为 null 可能是区块不存在或节点未同步；错误对象则检查标签支持和参数格式。第二节点复取时同时比较 hash 与 parentHash，同高度不一致先处理重组或分叉，再统计交易。

完整交易开关的取舍

把第二个参数设为 true 后，每个交易项会带 from、to、input、value、gas 等对象字段，适合单区块诊断；批量索引更适合先取哈希，再按需要补交易和回执。timestamp 也是十六进制秒数，转换为日期时保留原值。无论采用哪种模式，区块 hash 都是连接头字段、交易列表和后续回执的主键。

eth_getBlockByNumber：来源支持到哪一层

eth_getBlockByNumber接收区块数量标签和一个布尔值，决定transactions字段返回交易哈希还是完整交易对象。
latest、safe和finalized等标签表达不同链头视角；用latest查询得到的区块仍可能因重组变化，不能当成永久固定快照。
返回对象同时包含parentHash、stateRoot、receiptsRoot、gasUsed等头字段；节点找不到目标区块时可返回null。（有限确认）

eth_getBlockByNumber：读完要解决的四个问题

顺序	核心问题	可执行目标
1	请求参数开关	用请求参数开关直接回答搜索意图并形成可执行核验信息。
2	标签最终性表	用标签最终性表直接回答搜索意图并形成可执行核验信息。
3	区块头字段	用区块头字段直接回答搜索意图并形成可执行核验信息。
4	null与重组边界	用null与重组边界直接回答搜索意图并形成可执行核验信息。