交易结果查询接口
交易结果查询接口
接口描述
根据交易Hash，查询交易的上链结果。
权限说明
API权限认证采用Basic Auth方式，请求发起人需要具有合法的Username和Password才能发起请求，其中Username和Password详见所创建的以太坊网络。查看以太坊网络
注意事项
如果请求中没有用户认证信息（即匿名访问），返回401 Unauthorized，错误信息：401 Authorization Required。
服务域名
以太坊合约网关接口服务域名地址<ContractGateWayHost>详见BBE中所创建的以太坊网络详情。查看以太坊网络
请求结构
GET /v2/ethereum/tx/{txId}
Host: <ContractGateWayHost>请求头域
除公共头域外，无其它特殊头域。
请求参数
| 名称 | 类型 | 位置 | 描述 | 是否必须 |
|---|---|---|---|---|
| txId | String | URL参数 | 交易Hash | 必须 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| requestId | String | 用户请求Id |
| result | JsonObject | 交易结果数据 |
| status | Integer | 交易状态，1表示成功，0表示失败 |
| from | String | 合约调用者地址 |
| contract | String | 合约地址 |
| ethValue | Integer | 向合约发送的以太币数量 |
| gas | Integer | 交易消耗的gas |
| transactionHash | String | 交易hash |
| nonce | Integer | nonce值 |
| blockNumber | Integer | 交易所在区块高度 |
| blockHash | String | 区块Hash |
| currBlockNumber | Integer | 当前区块高度 |
| logs | Array | 交易输出日志 |
请求示例
GET /v2/ethereum/tx/0x208140b148622f260f354c38d9424722949cb1b31f542cd33125630dfa6c9809 HTTP/1.1
Host: 106.12.189.XXX:8080交易已打包到区块中响应示例
HTTP/1.1 200 OK
Date: Wed, Thu, 19 Sep 2019 07:59:04 GMT
Content Type: application/json; charset=utf-8
Content-Length: 1399
{
"requestId": "e23a3d74-966c-4b35-8c87-e33ada7e93da",
"result": {
"status": 1,
"from": "0x7244Ea287849942bAAC280B1912A575aEeCCc792",
"contract": "0x134BFd7a3D43ca3b4599718045156ADa22EC8591",
"ethValue": 0,
"gas": 41136,
"transactionHash": "0x208140b148622f260f354c38d9424722949cb1b31f542cd33125630dfa6c9809",
"nonce": 52,
"blockNumber": 101467,
"blockHash": "0xcaf81f10e0874a8490b85df95b223b04dd83f3054dd96989149df3e95fc03ee1",
"currBlockNumber": 101730,
"logs": [
{
"address": "0x134bfd7a3d43ca3b4599718045156ada22ec8591",
"topics": [
"0x0d81390ade415b1e4a25c6b5d8fca3bc67227e5d3835677b0ff6db0128262d2e",
"0x0000000000000000000000007244ea287849942baac280b1912a575aeeccc792",
"0x000000000000000000000000000000000000000000000000000000000000006f"
],
"data": "0x000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000036262650000000000000000000000000000000000000000000000000000000000",
"blockNumber": "0x18c5b",
"transactionHash": "0x208140b148622f260f354c38d9424722949cb1b31f542cd33125630dfa6c9809",
"transactionIndex": "0x1",
"blockHash": "0xcaf81f10e0874a8490b85df95b223b04dd83f3054dd96989149df3e95fc03ee1",
"logIndex": "0x1",
"removed": false
}
]
}
} 交易在区块中不存在响应示例
HTTP/1.1 200 OK
Date: Thu, 19 Sep 2019 07:59:04 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 91
{
"requestId": "1bd2ed0d-8bfc-4d6f-ac7a-c550430a3ead",
"result": {}
}调用合约方法详见：调用合约方法接口
