交易结果查询接口
更新时间：2020-04-09
交易结果查询接口
接口描述
根据交易Hash，查询交易的上链结果。
权限说明
API权限认证采用Basic Auth方式，请求发起人需要具有合法的Username和Password才能发起请求，其中Username和Password详见所创建或加入的Quorum联盟。查看Quorum联盟
注意事项
如果请求中没有用户认证信息（即匿名访问），返回401 Unauthorized，错误信息：401 Authorization Required。
服务域名
以太坊合约网关接口服务域名地址<ContractGateWayHost>详见BBE中所创建或加入的Quorum联盟。查看Quorum联盟
请求结构
GET /v2/quorum/tx/{txId}
Host: <ContractGateWayHost>请求头域
除公共头域外，无其它特殊头域。
请求参数
| 名称 | 类型 | 位置 | 描述 | 是否必须 |
|---|---|---|---|---|
| txId | String | URL参数 | 交易Hash | 必须 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 名称 | 位置 | 描述 |
|---|---|---|
| requestId | String | 用户请求携带的X-Request-Id |
| result | JsonObject | 交易结果数据 |
| status | Integer | 交易状态，1表示成功，0表示失败 |
| from | String | 合约调用者地址 |
| contract | String | 合约地址 |
| ethValue | Integer | 向合约发送的以太币数量 |
| gas | Integer | 交易消耗的gas |
| transactionHash | String | 交易hash |
| nonce | Integer | nonce值 |
| blockNumber | Integer | 交易所在区块高度 |
| currBlockNumber | Integer | 当前区块高度 |
| blockHash | String | 区块Hash |
| logs | Array | 交易输出日志 |
| v | Integer | 交易类型标识，37、38表示私有交易 |
请求示例
GET /v2/quorum/tx/0xd7752833e7da2e56dbb52075bbe931e38a59967f43bb83db3a49320feec4e109 HTTP/1.1
Host: 106.12.189.XXX:8080交易已打包到区块中响应示例
HTTP/1.1 200 OK
Date: Thu, 19 Sep 2019 09:55:34 GMT
Content Type: application/json; charset=utf-8
Content-Length: 518
{
"requestId": "aaaac3f4-1931-4670-9c7f-d56a898483b1",
"result": {
"status": 1,
"from": "0x04c512DEA0943e27D036EA5550987d0fF8b48a60",
"contract": "0x5C695f5b6c14D4D59b1B2F65A7fB66f02fe15469",
"ethValue": 0,
"gas": 0,
"transactionHash": "0x9a91045a3841e315229c9e36d10d86b882f709fd1bf889875a179cf43b218eb7",
"nonce": 80,
"blockNumber": 34645,
"blockHash": "0x55d3cc65f7d0eaf4444e5bbe1083fb31c6a1aff7129742703a18f58f7f856f22",
"currBlockNumber": 34738,
"logs": [],
"v": 37
}
} 交易在区块中不存在响应示例
HTTP/1.1 200 OK
Date: Thu, 19 Sep 2019 09:56:24 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 73
{
"requestId": "27161565-71ff-470f-9010-6808bb2cdf17",
"result": {}
}调用合约方法详见：调用合约方法接口