/wallet/broadcasttransaction

广播一笔已签名的交易。

• 源码：framework/src/main/java/org/tron/core/services/http/BroadcastServlet.java
• Method：POST
• Response：api.Return + txid

请求参数

直接传 protocol.Transaction 的 JSON 表示（即 createtransaction 类接口的返回 + 签名）：

字段	类型	必填	说明
raw_data	object	是	与 createtransaction 返回一致；节点据此重新序列化为 protobuf bytes 做 SHA256 验签
raw_data_hex	string	否（节点忽略）	客户端可视化辅助字段——raw_data 的 protobuf 编码。不是 protocol.Transaction 的 proto 字段，JsonFormat.merge 在 parse 阶段直接忽略，节点既不读也不与 raw_data 比对。客户端在签名时通常拿它做 SHA256 得到 txID，但广播给节点后是否一致、是否合法 hex 都不影响处理
signature	string[]	是	签名数组（普通账户 1 个；多签按权限要求）
visible	bool	否	地址、文本字段格式

示例：

curl --request POST \
     --url https://nile.trongrid.io/wallet/broadcasttransaction \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "raw_data":     { "...": "..." },
  "raw_data_hex": "0a02...",
  "signature":    ["b8c0...01"]
}
'

上例为占位结构，实际调用前需把 raw_data / raw_data_hex / signature 替换为来自 /wallet/createtransaction 等接口的真实未签名交易加签后内容。

响应

字段	类型	说明
result	bool	是否进入交易池
code	enum	SUCCESS / SIGERROR / CONTRACT_VALIDATE_ERROR / CONTRACT_EXE_ERROR / BANDWITH_ERROR / DUP_TRANSACTION_ERROR / TAPOS_ERROR / TOO_BIG_TRANSACTION_ERROR / TRANSACTION_EXPIRATION_ERROR / SERVER_BUSY / NO_CONNECTION / NOT_ENOUGH_EFFECTIVE_CONNECTION / BLOCK_UNSOLIDIFIED / OTHER_ERROR
message	string	失败原因；visible=true 时为 UTF-8 文本，visible=false 时为 UTF-8 字节的 hex
txid	string	交易哈希

result: true 仅代表节点已收且入池，最终是否上链需通过 /wallet/gettransactioninfobyid 查询。

响应示例：

{
  "result": true,
  "code": "SUCCESS",
  "txid": "d5ec749ecc2a615399d8a6c864ea4c74ff9f8453eaa44d6b1e2f0b7b3e2f3b6a"
}

异常响应

业务级错误仍按上面的 result/code/message 形态返回，例如：

{ "result": false, "code": "DUP_TRANSACTION_ERROR", "message": "Dup transaction.", "txid": "..." }
{ "result": false, "code": "SIGERROR", "message": "validateSignature error", "txid": "..." }
{ "result": false, "code": "TAPOS_ERROR", "message": "Tapos failed", "txid": "..." }

code 含义：

code	含义
SIGERROR	签名校验失败
CONTRACT_VALIDATE_ERROR	合约前置校验失败（余额不足、参数非法等）
CONTRACT_EXE_ERROR	执行期失败
BANDWITH_ERROR	带宽不足
DUP_TRANSACTION_ERROR	重复交易
TAPOS_ERROR	ref_block_* 不在链上（最常见于交易过期或链未同步）
TOO_BIG_TRANSACTION_ERROR	交易体积超限
TRANSACTION_EXPIRATION_ERROR	expiration 已过期
SERVER_BUSY	节点繁忙（pending 满）
NO_CONNECTION / NOT_ENOUGH_EFFECTIVE_CONNECTION	节点对外连接不足，未广播
BLOCK_UNSOLIDIFIED	区块尚未固化（针对相关查询）
OTHER_ERROR	其他

JSON 解析失败、raw_data 缺失或类型错等走 Util.processError：

触发条件	响应
请求体超过 node.maxMessageSize	{"Error": "class java.lang.Exception : body size is too big, the limit is <N>"}
请求体不是合法 JSON	{"Error": "class com.alibaba.fastjson.JSONException : <解析器信息>"}
缺少 raw_data、raw_data.contract 不是数组、signature 非数组或元素非 hex、raw_data 字段类型不符等	{"Error": "class java.lang.NullPointerException : null"}（Util.packTransaction 把 JsonFormat$ParseException / ClassCastException 静默捕获后返回 null，下游构造 TransactionCapsule(null) 触发空指针）
raw_data.contract[i].parameter.value 内字段类型不符	该 contract 在 packTransaction 内部被 catch 并丢弃，最终广播为空 contract 列表，返回 {"code": "CONTRACT_VALIDATE_ERROR", "message": "<\"No contract!\" 的 hex>", ...}
其他异常	{"Error": "<exceptionClass> : <message>"}

---