确认语义

TRON API 会在不同阶段返回不同类型的数据。集成时应先判断当前拿到的是广播接收结果、交易本体、执行收据、已固化状态，还是索引服务数据。不要把中间状态当作最终结果。

📘

前置阅读

• API 参考
• 交易签名与广播——API 工作流
• 区块

状态语义速查

广播接收不等于执行成功

广播接口只检查交易是否能被节点接受。它不会告诉你合约是否执行成功，也不会告诉你交易是否已经进入已固化区块。

常见错误是把下面的响应直接当作最终成功：

{ "result": true, "txid": "..." }

正确流程是继续查询 receipt：

1. 用 GetTransactionById 查询交易本体，确认节点能找到这笔交易。
2. 用 GetTransactionInfoById 查询执行 receipt。
3. 需要最终状态时，用 GetTransactionInfoById，SolidityNode 查询已固化 receipt。

交易本体不等于执行收据

交易本体描述“请求方提交了什么”，执行收据描述“链上实际执行后发生了什么”。

对普通 TRX / TRC-10 顶层转账，交易本体通常已经包含收款地址和金额。对 TriggerSmartContract，必须读取 receipt 才能判断实际执行结果。

最新链头不等于已固化状态

FullNode 返回节点当前看到的最新链头。这个状态延迟低，但可能尚未固化。SolidityNode 返回最新已固化区块上的状态，通常比链头落后约 1 分钟。

如果流程需要最终状态（如交易确认、余额对账、报表生成和区块监听），应基于 SolidityNode 或本地已固化区块索引判断。

索引数据不等于节点原生状态

TronGrid V1 API 和自建索引器适合查询账户历史、TRC-20 转账历史、Event、内部交易和聚合统计。索引服务通常比直接扫块更方便，但要考虑分页、限流、重试和索引延迟。

当你需要完整状态判断时，可以按以下方式组合：

1. 用 TronGrid 或自建索引器发现候选交易、Event 或内部交易。
2. 用 SolidityNode receipt 或已固化区块扫描确认最终状态。
3. 在本地保存已处理的 block number、transaction ID 和 log index，保证重试幂等。

相关资源

• 交易签名与广播——API 工作流 —— 构建、签名、广播和确认交易结果的完整路径
• 广播与 RPC 错误 —— 广播失败、广播后未上链和节点限流排查
• 区块 —— 区块结构、block ID、block number 和查询接口选型
• API 任务地图 —— 按任务选择 docs 页面和 reference API