百度区块链引擎BBE

    Event日志检索接口

    Event日志检索接口

    接口描述

    Event(事件)触发后形成日志记录在区块里,本接口提供根据区块范围和Event主题对日志进行检索功能。

    权限说明

    API权限认证采用Basic Auth方式,请求发起人需要具有合法的Username和Password才能发起请求,其中Username和Password详见所创建或加入的Quorum联盟。查看Quorum联盟

    注意事项

    如果请求中没有用户认证信息(即匿名访问),返回401 Unauthorized,错误信息:401 Authorization Required

    服务域名

    Quorum合约网关接口服务域名地址<ContractGateWayHost>详见BBE中所创建或加入的Quorum联盟。查看Quorum联盟

    请求结构

     POST /v2/quorum/log/{contract}/{eventName} HTTP/1.1
     Host: <ContractGateWayHost>
     Content-Type: application/json

    请求头域

    头域 类型 说明 是否必须
    Content-Type String 值为application/json 必须

    请求参数

    名称 类型 位置 描述 是否必须
    contract String URL参数 合约地址 必须
    eventName String URL参数 合约事件名称 必须
    fromBlock Integer RequestBody参数 起始区块高度,默认为0 非必须
    toBlock Integer RequestBody参数 结束区块高度,默认为最新区块高度 非必须
    jsonrpcUrl String RequestBody参数 节点JSON-RPC地址 选填,私有交易必填,公开交易选填
    invokeParameters JsonObject RequestBody参数 根据指定合约事件topic过滤,如未指定,则默认返回全部 选填

    使用限制

    • 事件检索支持主题参数类型: intX/uintX, string, address, bytes, bytes32
    • 使用indexed修饰的事件主题输出不支持string和动态类型数组

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    名称 类型 描述
    requestId String 用户请求Id
    result Array 日志检索返回结果
    contract String 合约地址
    data JsonObject 检索的日志信息,包括indexed修饰的topics数据和未修饰的data数据
    blockNumber Integer 发生本事件的区块高度
    blockHash String 发生本事件的区块哈希
    txHash String 发生本事件的交易哈希
    txIndex Integer 发生本事件的交易所在区块交易的位置
    index Integer 本日志在收据中的位置
    removed Bool 日志是否被回退

    请求示例

    说明:Quorum支持对indexed修饰的topic进行多条件过滤,即指定多个topic关键字则会按照多个关键字进行过滤。如本请求示例中使用address类型的from和int64类型的i进行日志检索。

      POST /v2/quorum/log/0x5c695f5b6c14d4d59b1b2f65a7fb66f02fe15469/ChangeEvent HTTP/1.1
      Host: 106.12.189.XXX:8080
      Content-Type: application/json
      
      {
            "fromBlock":0,
            "toBlock":123439,
            "jsonrpcUrl":"http://106.12.189.XXX:8081/quorum-jsonrpc/ba9f7aad-2f49-4aab-8bd2-12d7ab009937/6d398463",
            "invokeParameters":{
    		"from":["0x04c512DEA0943e27D036EA5550987d0fF8b48a60"]
    	}
     }

    请求响应示例

     HTTP/1.1 200 OK     
     Date: Thu, 19 Sep 2019 10:07:15 GMT
     Content Type: application/json; charset=utf-8
     Content-Length: 1412   
     {
      "requestId": "9e7002d3-247d-4686-9555-4e07f81f3a67",
      "result": [
        {
          "contract": "0x5c695f5b6c14d4d59b1b2f65a7fb66f02fe15469",
          "data": {
            "from": "0x04c512dea0943e27d036ea5550987d0ff8b48a60",
            "i": 111,
            "s": "baidu"
          },
          "blockNumber": 34341,
          "txHash": "0x9efd1bae01055189f067d7f0a0095f9626672894f5132bc4573abb3728dde026",
          "txIndex": 0,
          "blockHash": "0xedff2a83e915169f115bf3bc90d37276411c20df1aa9c2a8dd218d74983646c1",
          "index": 0,
          "removed": false
        }
        {
          "contract": "0x5c695f5b6c14d4d59b1b2f65a7fb66f02fe15469",
          "data": {
            "from": "0x04c512dea0943e27d036ea5550987d0ff8b48a60",
            "i": 222,
            "s": "bbe"
          },
          "blockNumber": 34783,
          "txHash": "0xf8fbac3d191d4f3e9748c398886a51d06aadab9c84220180c09a8118031e96df",
          "txIndex": 0,
          "blockHash": "0xe76c51789b84ed9b9a8ff7707957dc34980da0b695ea042d930dad7c2aab86b2",
          "index": 0,
          "removed": false
        }
      ]
    }    
    上一篇
    交易结果查询接口
    下一篇
    Event监听注册接口