更新时间:2024-03-06 GMT+08:00

eth_getTransactionReceiptsByBlock

简介

返回给定区块号或哈希的所有交易收据。该API所消耗的计算单元为1100。

参数说明

参数

类型

说明

区块编号或者区块哈希

String

想要查询的区块的十六进制的编号,或者是字符串 "latest",或是区块哈希值。

返回值

交易收据对象的数组,其中每个交易对象包含如下内容:

  • Object - 交易收据对象,如果未找到交易收据,则为 null。交易收据对象包含以下字段:
    • blockHash:此交易所在的区块的哈希值
    • blockNumber:添加此交易的区块号,编码为十六进制
    • contractAddress:为创建合约创建的合约地址,如果并非合约创建则为空
    • cumulativeGasUsed:在区块中执行此交易时使用的总gas
    • from:源地址
    • gasUsed:仅此特定交易使用的gas
    • logs:生成此交易的日志对象数组
      • address:生成此日志的地址
      • topics:索引日志参数的 0 到 4 个 32 字节 DATA 的数组。在 Solidity 中,第一个主题是事件签名的哈希值(例如 Deposit(address, bytes32, uint256)),除非您使用匿名说明符声明事件
      • data:日志的 32 字节非索引参数
      • blockNumber:此日志所在的块号
      • transactionHash:从中创建此日志的交易的哈希。如果日志处于待处理(Pending)状态,则为 null
      • transactionIndex:从中创建此日志的交易索引位置。如果日志处于待处理(Pending)状态,则为 null
      • blockHash:此日志所在的块的哈希值
      • logIndex:编码为十六进制的块中对数索引位置的整数。如果日志处于待处理(Pending)状态,则为 null
      • removed:如果日志由于链重组而被删除,则为 true,如果它是有效的日志,则为 false。
    • logsBloom:用于检索相关日志的布隆过滤器
    • status:1(成功)或 0(失败),编码为十六进制
    • to:接收方的地址。当它是合约创建交易时为 null
    • transactionHash:交易的哈希值
    • transactionIndex:编码为十六进制的块中的交易索引位置
    • type:值的类型

请求样式

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