wallet-cli tx info¶

查看交易的完整详情和交易回执。

用法¶

wallet-cli tx info --txid <id> [options]

说明¶

获取完整的交易对象及其执行回执，适用于 TRON 和 EVM 网络。该命令适合取证和费用分析；如果只需判断交易是否成功，tx status 更轻量，其四个稳定状态值可直接用于程序分支。

顶层摘要在两个家族之间是归一化的；而嵌套在下面的原始对象不是。在 TRON 上，它们是 transaction（节点给出的交易对象）和 info（其执行回执）；在 EVM 上，它们是 transaction（eth_getTransactionByHash 的结果）和 receipt（eth_getTransactionReceipt 的结果，既有解码后的字段，也在 raw 中保留一份原样副本）。

注意两者处理未知交易的方式不同：tx status 遇到未知 txid 时返回 not_found，退出码仍为 0；tx info 因没有详情可展示而直接报错。TRON 和 EVM 的错误码及退出码也不同：TRON 将节点拒绝转换为 rpc_error，退出码为 1；EVM 返回 not_found，退出码为 2（该哈希未指向可查询的交易）。请先按退出码分类，再检查 error.code。

选项¶

选项	说明
`--txid <string>`	必填。交易 id / 哈希——TRON 上是不带前缀的 hex，EVM 上是 `0x…`

此外还有全局选项。

示例¶

wallet-cli tx info --txid 34d9da372cd7fa9d4e7384744c0925af9d682eef4c9410fb831e0b87b355171b --network tron:3448148188

TxID           34d9da372cd7fa9d4e7384744c0925af9d682eef4c9410fb831e0b87b355171b
From           TR66PwBkGtktmiRhGjP9C6o8ts2ndDo4sP
To             TVMV1gstFzkDyBfrpNc1Sa72Az2dMgDCLY
Amount         1 TRX
Status         success
Block          #70,433,563
Confirmations  2
Fee            2.1 TRX

-o json 返回完整详情（transaction 是原始交易，info 是回执；此处以空对象示意）：

{"schema":"wallet-cli.result.v1","success":true,"command":"tx.info","data":{"txid":"34d9da372cd7fa9d4e7384744c0925af9d682eef4c9410fb831e0b87b355171b","from":"TR66PwBkGtktmiRhGjP9C6o8ts2ndDo4sP","to":"TVMV1gstFzkDyBfrpNc1Sa72Az2dMgDCLY","amount":"1","symbol":"TRX","status":"success","blockNumber":70433563,"confirmations":2,"feeSun":2100000,"transaction":{},"info":{}},"meta":{"durationMs":1396,"warnings":[]},"chain":{"family":"tron","network":"tron:3448148188","chainId":"3448148188"}}

在 EVM 网络上，摘要中多了 type 和 nonce，费用以 wei 计价，并且嵌套的是 receipt 而不是 info：

{"schema":"wallet-cli.result.v1","success":true,"command":"tx.info","data":{"txid":"0x55b0068ef31bce39bbf5b06d456eaef307fd77f96d85ea291f48c1ae4b900d80","type":"contract-call","from":"0x88878d9250e68C574912f5618ad3b43f675B8888","nonce":342,"to":"0x3bFA4769FB09eefC5a80d6E87c3B9C650f7Ae48E","rawAmount":"0","amount":"0","symbol":"ETH","blockTime":1787817996,"status":"success","blockNumber":11576586,"gasUsed":"127165","feeWei":"635825000000000","effectiveGasPriceWei":"5000000000","confirmations":0,"transaction":{},"receipt":{}},"meta":{"durationMs":706,"warnings":[]},"chain":{"family":"evm","network":"eip155:11155111","chainId":"11155111"}}

未知的 txid 会直接报错——这与 tx status 的 not_found（退出码 0）不同。在 EVM 上是 not_found、退出码 2；在 TRON 上是 rpc_error、退出码 1：

{"schema":"wallet-cli.result.v1","success":false,"command":"tx.info","error":{"code":"rpc_error","message":"TRON getTransaction failed: Transaction not found"},"meta":{"durationMs":1033,"warnings":[]},"chain":{"family":"tron","network":"tron:3448148188","chainId":"3448148188"}}

{"schema":"wallet-cli.result.v1","success":false,"command":"tx.info","error":{"code":"not_found","message":"no transaction with hash 0x0000…0000 on eip155:11155111"},"meta":{"durationMs":412,"warnings":[]},"chain":{"family":"evm","network":"eip155:11155111","chainId":"11155111"}}

输出¶

data 是结构化的交易详情：顶层是归一化的摘要，下面嵌套着该链自己的原始对象。只有摘要部分保证稳定——嵌套对象跟随节点的模型，可能随之变化。参见 machine-interface。

两个家族共有的摘要字段：

字段	类型	含义
`txid`	string	交易 id
`from`	string	发送方地址
`to`	string	接收方地址
`amount`	string	转账金额（人类可读单位）
`symbol`	string	原生币或 token 的符号
`status`	string	全小写。EVM 上是 `success` 或 `revert`；TRON 上是节点自己的 `contractRet` 转小写——`success`、`revert`、`out_of_energy` 等等。它绝不会是 `failed`
`blockNumber`	number	区块高度
`confirmations`	number	在所在区块之上又叠加了多少个块

TRON 额外提供：

字段	类型	含义
`feeSun`	number	实际收取的手续费，单位 SUN
`transaction`	object	原始 TRON 交易对象（`raw_data`、`signature`、`txID` 等）
`info`	object	执行回执（`receipt` 资源消耗、`contractResult`、`blockTimeStamp` 等）

EVM 额外提供：

字段	类型	含义
`type`	string	`transfer`（原生转账，或解码出的 ERC20 转账）、`contract-creation`（没有 `to`），或 `contract-call`
`nonce`	number	发送方在这笔交易上的 nonce
`rawAmount`	string	转移的金额，单位 wei
`blockTime`	number	出块时间戳，epoch 秒；尽力而为——区块读取失败时会省略
`gasUsed`	string	实际消耗的 gas
`feeWei`	string	实际收取的手续费，单位 wei
`effectiveGasPriceWei`	string	实际支付的每单位 gas 价格
`transaction`	object	`eth_getTransactionByHash` 的返回结果，原样给出
`receipt`	object	解码后的回执（`success`、`gasUsed`、`feeWei`、`effectiveGasPriceWei`、`blockNumber`），节点自身的响应保存在 `raw` 中

退出码¶

0 已找到 · 1 执行失败——在 TRON 上包括未找到（rpc_error） · 2 用法错误，在 EVM 上包括未找到（not_found）。

另请参见¶

tx status · account history · 手续费与资源