更新时间:2022-12-12 GMT+08:00
分享

查询范围内区块列表信息

功能介绍

查询范围内区块列表信息,一次查询最大返回数量1000(仅支持专享版)

URI

GET /v1/store/block/list

表1 Query参数

参数

是否必选

参数类型

描述

block_start

Integer

查询区块的起始区块id

最小值:0

最大值:18446744073709551615

block_end

Integer

查询区块的结束区块id

最小值:0

最大值:18446744073709551615

请求参数

响应参数

状态码: 200

表2 响应Body参数

参数

参数类型

描述

count

Integer

区块数量

blocks

Array of Block objects

区块列表

表3 Block

参数

参数类型

描述

id

Integer

区块编号

txs_count

Integer

交易数量

data_hash

String

区块体哈希

pre_hash

String

前一区块体哈希

time

String

区块生成时间

txs

Array of Transaction objects

交易集合

表4 Transaction

参数

参数类型

描述

tx_id

String

交易id

type

String

交易类型COMMON_TRANSACTION:普通交易,VOTE_TRANSACTION:投票交易

枚举值:

  • COMMON_TRANSACTION

  • VOTE_TRANSACTION

block_id

Integer

区块号

creator

String

创建者

create_time

String

创建时间

chaincode_name

String

合约名称

endorsor_orgs

Array of strings

背书组织

read_set

Array of Readset objects

读集

write_set

Array of Writeset objects

写集

表5 Readset

参数

参数类型

描述

key

String

key值

version

Array of Version objects

版本信息

表6 Version

参数

参数类型

描述

block_num

Integer

区块号

tx_num

String

交易编号

表7 Writeset

参数

参数类型

描述

key

String

value

Array of strings

signature

Array of strings

签名

状态码: 400

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

响应示例

状态码: 200

区块列表

{
  "count" : 2,
  "blocks" : [ {
    "id" : 175,
    "txs_count" : 1,
    "data_hash" : "MgY/9ksThAb0kt7S83dqu+BwhHtsfyb505bUHNEQyu4=",
    "pre_hash" : "jsZZc1Cvv0zkA48HQWzZKVpUKWxPVFxDFsYDBHZCLHg=",
    "time" : "2022-04-08T01:39:43Z",
    "txs" : [ {
      "tx_id" : "32063ff64b138406f492ded2f3776abbe070847b6c7f26f9d396d41cd110caee",
      "type" : "COMMON_TRANSACTION",
      "block_id" : 175,
      "creator" : "user-1.org1.hwchain-tdc-eff8ed1eb.svc.cluster.local",
      "create_time" : "2022-04-08T01:39:42Z",
      "chaincode_name" : "tdccontract",
      "endorsor_orgs" : "org1",
      "read_set" : "key:\"IsAppr01\\000total\" version:<block_num:151 > ",
      "write_set" : "key:\"\\000IsAppr01\\000approval\\00039a05febed86e9bfb126daed4afedec2e7eb3fad\\0000d257260b95fdc3c0400c4e850cb4994d01f9cd2\\000\" value:\"{\\\"owner\\\":\\\"39a05febed86e9bfb126daed4afedec2e7eb3fad\\\",\\\"operator\\\":\\\"0d257260b95fdc3c0400c4e850cb4994d01f9cd2\\\",\\\"approved\\\":true}\""
    } ]
  }, {
    "id" : 176,
    "txs_count" : 1,
    "data_hash" : "VdBUrdRs0krijfHb4JnTYB+ErZdAMhLVvoeKfJx3PfY=",
    "pre_hash" : "wFjpSWx5O/b7aUN06yovM5N4jNB/4/hT2c5Bhy7YaQk=",
    "time" : "2022-04-08T01:39:59Z",
    "txs" : [ {
      "tx_id" : "55d054add46cd24ae28df1dbe099d3601f84ad97403212d5be878a7c9c773df6",
      "type" : "COMMON_TRANSACTION",
      "block_id" : 176,
      "creator" : "user-1.org1.hwchain-tdc-eff8ed1eb.svc.cluster.local",
      "create_time" : "2022-04-08T01:39:57Z",
      "chaincode_name" : "tdccontract",
      "endorsor_orgs" : "org1",
      "read_set" : "key:\"SetOpti12\\000creator\" version:<block_num:170 > ,key:\"SetOpti12\\000total\" version:<block_num:170 >",
      "write_set" : "key:\"SetOpti12\\000name\" value:\"apple\" ,key:\"SetOpti12\\000symbol\" value:\"App\""
    } ]
  } ]
}

状态码

状态码

描述

200

区块列表

400

错误响应

相关文档