更新时间:2023-10-16 GMT+08:00

eth_getBlockByHash

简介

返回与给定区块哈希匹配的区块的信息。该API所消耗的计算单元为21。

参数说明

参数

类型

说明

区块哈希

String

想要查询的区块的哈希值。

事务详细信息标志

Bool

当此值为 true 时,该方法返回完整的交易对象,否则,它仅返回交易的哈希。

返回值

Object - 区块对象,如果未找到区块,则为 null。区块对象包含以下字段:
  • number: 编码为十六进制的请求块的块号。如果是一个处于待处理(Pending)状态的区块,则为空。
  • hash: 区块的哈希。如果是一个处于待处理(Pending)状态的区块,则为空。
  • parentHash: 父区块的哈希。
  • nonce: 生成的工作量证明的哈希值。如果是一个处于待处理(Pending)状态的区块,则为空。
  • sha3Uncles: 区块中叔区块数据的 SHA3。
  • logsBloom: 区块日志的布隆过滤器。如果是一个处于待处理(Pending)状态的区块,则为空。
  • transactionsRoot: 区块中交易树的根。
  • stateRoot: 区块的最终状态树的根。
  • receiptsRoot: 区块的收据树的根。
  • miner: 获得采矿奖励的受益人的地址。
  • difficulty:此区块的难度。
  • totalDifficulty: 直到这个区块时,链的总难度。
  • extraData:此区块的“额外数据”字段。
  • size:此区块的大小(以字节为单位)。
  • gasLimit:此区块中允许的最大gas。
  • gasUsed:此区块中所有交易的总使用gas。
  • timestamp:整理区块时的 unix 时间戳。
  • transactions:交易对象的数组,或 32 字节的交易哈希,具体取决于最后一个给定的参数。
  • uncles:叔区块哈希数组。

请求样式

curl https://your-http-endpoint/v1/<API-KEY> \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getBlockByHash","params":["0x81e807e7a6031d9f103eeee2a2edc5994c3432ee1e3227c66ff78eef30ea1dec",false],"id":1,"jsonrpc":"2.0"}'