按高度查询区块。SolidityNode 版本可用作"该区块是否已固化"的探测器（拿到 = 已固化）。

📘

用作固化探测器

在 SolidityNode 上，能查到 = 已固化；查不到 = 尚未固化。这是判断一笔交易是否进入终态的常用模式——拿到该交易的区块号后，调本接口探测；返回成功即可视为终态确认。

确认语义

接口成功返回区块对象时，表示该 block number 已在 SolidityNode 视图中固化。如果按某个高度查询不到区块，通常表示该高度尚未固化、SolidityNode 尚未同步到该高度，或请求的高度不存在。扫描程序应等待下一轮轮询，而不是把它记录为业务失败。

按高度扫描已固化区块时，应持久化已完成处理的最高 block number。交易本体、receipt、Event 和内部交易的解析分工，参见基于区块扫描的充值监听机制。

相关资源

• GetBlockByNum (FullNode) —— FullNode 版本（含未固化）
• GetBlock —— 同时支持按高度或按 ID 查询
• GetNowBlock —— 查询最新已固化区块（链头探测的反向）
• 区块 —— 区块结构、复合区块 ID 和区块查询接口选型
• 基于区块扫描的充值监听机制 —— 已固化区块扫描和交易解析流程