更新时间:2024-03-06 GMT+08:00
eth_getBlockByNumber
简介
返回与给定的区块号匹配的区块信息。该API所消耗的计算单元为133。
参数说明
参数 |
类型 |
说明 |
---|---|---|
区块编号 |
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"}'
父主题: 共享版