post
https://api.shasta.trongrid.io/wallet/broadcasttransaction
将已签名的交易广播到 TRON 网络。
注意事项
result: true 只表示本次广播调用未返回错误。它不证明交易仍保留在待处理池、已传播到其他节点、已打包、执行成功或已固化。对于直接发起的 TRX 或 TRC-10 转账,应通过 /walletsolidity/gettransactionbyid 确认交易本体已进入固化主链;对于智能合约交易,还需通过 /walletsolidity/gettransactioninfobyid 检查执行结果。
- 不能只根据广播返回判断业务成功。
- 交易仍有效时,可以把完全相同的已签名交易重新提交给原节点,或提交给其他可靠、已同步的节点。这笔交易的
txID不变,重复广播不会产生第二次执行;接收节点可能返回DUP_TRANSACTION_ERROR。 - 如果原交易从未提交给任何节点,只是在首次广播前已经过期,可以直接重新构造并签名。如果原交易已经广播或广播结果未知,应先按交易安全重播与替换流程核对原
txID,确认未进入已固化主链后再创建替代交易。 - 如果你只有已签名交易的 hex 编码,可以使用 BroadcastHex。
CONTRACT_VALIDATE_ERROR、BANDWITH_ERROR、TAPOS_ERROR等错误的排查路径见 广播与 RPC 错误诊断。
相关资源
- GetTransactionSign —— 节点侧签名(仅测试环境使用,生产应在客户端本地签名)
- BroadcastHex —— 同样用于广播,参数为已签名交易的 hex 编码
- API 签名与广播流程 —— 端到端的签名与广播工作流
- 确认语义 —— 区分广播响应、打包、执行 receipt 和已固化状态
- 交易协议 —— TAPOS、过期时间与
raw_data结构
