5.4.6.8 获取块信息接口

当数据落链并生成区块链块后，可以根据块号或者块的哈希查询响应的块的信息，其中块号和块哈希不能同时为空。当同时不为空时，优先查询块号对应的块信息。

1. 接口地址：https://节点网关地址/api/xuperchain/v1/node/getBlockInfo

2. 通讯方式： POST

4. 请求参数

序号	字段名	字段	类型	必填	备注
1	信息头	header	Map	是
2	信息体	body	Map	是
3	签名值	mac	String	是
header
1	用户唯一标识	userCode	String	是
2	应用唯一标识	appCode	String	是
body
1	块高	blockHeight	uInt64	否	为空时blockHash不能为空
2	区块hash	blockHash	String	否	为空时blockNumber不能为空

示例

    {
    "header":{"appCode":"CL1881038873220190902114314","userCode":"newuser"},
    "body":
    {
    "blockNumber":22,
    "blockHash":"0xf27ff42d4be65329a1e7b11365e190086d92f9836168d0379e92642786db7ade"
    },
    "mac":"MEQCIBRhaM2szckWl9N9qcqnaYXOXGQw7SfII9DlRvxcI3YVAiBt4XeNs+EUjhBNSr3IjLRPZucsuGHxfjt9RiaNIQS8cA=="}

5. 响应参数

序号	字段名	字段	类型	必填	备注
1	信息头	header	Map	是
2	信息体	body	Map	是
3	签名值	mac	String	是
header：
1	响应标识	code	int	是	0：校验成功 -1：校验失败
2	响应信息	msg	String	否	code=0时可为null
body:
1	块哈希	blockId	String	是
2	块号	blockNumber	Int64	是
3	上一个块哈希	prevBlockHash	String	是
4	落块时间	blockTime	String	是	毫秒格式时间戳
5	执行区块交易花费的费用	quotaUsed	String	是
6	交易根哈希	transactionsRoot	String	是
7	状态树根哈希	stateRoot	String	是
8	回执根哈希	receiptsRoot	String	是
9	交易信息	transactions	[]TransactionData	是
TransactionData
1	交易哈希	txHash	String
2	交易数据	data	String
3	链码Id	chainId	String
4	交易配额	quota	String
5	交易发送者	from	String
6	交易接收者	to	String
7	随机数	nonce	String
8	交易上链最大区块高度	validUntilBlock	String
9	版本号	version	String

示例

    {
    "code": 1,
    "msg": "处理成功",
    "data": {
    "blockHash": "0xecbc08817c9d8683c62831bf1d261b28682671fb423d32b6fbc7a99f9334eda6",
    "receiptsRoot": "0x2b1ef9c90c51279ea4deae9e9aa1bfdd3a72e9aa6f0a207aea931c97ae8849e9",
    "proposer": "0x088c277a776d5073c0804d4220eb5a1018d9ad9b",
    "quotaUsed": "33391",
    "transactionsRoot": "0xd89c96752518074a4d8582bc267f48af589a8b9bb57d4c7c6fed46053823eaa6",
    "blockNumber": 57877,
    "prevBlockHash": "0xf85656b21e1e8ba0417cb7f4237407c81591cd2562a4c96183786373bf440ffa",
    "stateRoot": "0x7b7b8f7081f07413f820261b00d4d1dc51276af8bbb673af9a17eb5deeade64a",
    "blockTime": "2020-09-25 16:04:51 284",
    "transactions": [
    {
    "data": "0x4ed3885e000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000033233340000000000000000000000000000000000000000000000000000000000",
    "chainId": "1",
    "quota": "33391",
    "from": "0x3c8269e9f92de2949497813b060c399d6c40025e",
    "to": "0xc8bac50c7fc7b2d85c51e2ee9dbd779bf24c10c8",
    "nonce": "4214650517532747442",
    "txHash": "0xd89c96752518074a4d8582bc267f48af589a8b9bb57d4c7c6fed46053823eaa6",
    "validUntilBlock": "57955",
    "version": "2"
    }
    ]
    }
    }

5.4.6.8 获取块信息接口

5.4.6.8 获取块信息接口

results matching ""

No results matching ""

results matching ""

No results matching ""