📘

确认交易已固化

本接口返回指定高度的已固化区块。要确认某笔交易已固化，还需在返回区块的交易列表中核对其 txID，或使用 walletsolidity/gettransactionbyid 按交易 ID 查询；仅查到该高度的区块不足以确认某笔交易。

确认语义

接口成功返回区块对象时，表示返回的区块已固化。查询不到区块时，应检查高度是否有效、节点同步进度，以及节点是否保留该高度的历史数据。尚未同步或固化的高度可稍后重试；历史数据缺失时，应改用保留相应数据的节点。

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

相关资源

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