文档首页/ Web3节点引擎服务/ 开发指南/ Polygon PoS/ Polygon PoS API列表/ 共享版/ Ethereum JSON-RPC API/ eth_getBlockByNumber
更新时间：2024-03-06 GMT+08:00
查看PDF
分享

eth_getBlockByNumber

简介

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

参数说明

参数

类型

说明

区块编号

String

十六进制的区块编号，或者是字符串 "earliest"、"latest"、"pending"。

交易详细信息标志

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_getBlockByNumber","params":["0xc5043f",false],"id":1,"jsonrpc":"2.0"}'
父主题： Ethereum JSON-RPC API