百度区块链引擎BBE

    交易结果查询接口

    交易结果查询接口

    接口描述

    根据交易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": {}
    }

    调用合约方法详见:调用合约方法接口

    上一篇
    接口说明
    下一篇
    调用合约方法接口