eth_getFilterLogs

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

简介

返回与给定过滤器 ID 匹配的所有日志的数组。该API所消耗的计算单元为500。

参数说明

参数	类型	说明
address	String	可选参数，合约地址（20字节）或日志应源自的地址列表。
fromBlock	String	可选参数，默认为“latest”，十六进制区块号，或字符串latest，earliest或pending。
toBlock	String	可选参数，默认为“latest”，十六进制区块号，或字符串latest，earliest或pending。
topics	String	可选参数，32 字节 DATA 主题数组。主题与顺序相关。
blockhash	String	可选参数，将返回的日志限制为 32 字节哈希中引用的单个块blockHash。使用blockHash相当于设置fromBlock和 toBlock中引用的区块均为blockHash所对应的区块。如果blockHash出现在过滤条件中，则fromBlock和toBlock都不能够被设置。

返回值

log 对象数组：与过滤器匹配的日志对象数组。对于自上次轮询以来发生的日志数组，请使用eth_getFilterChanges。日志对象包含以下键及其值：
- address: 该日志的来源地址。
- blockHash：该日志所在块的哈希值。当它是待处理（Pending）日志时返回NULL。
- blockNumber：该日志所在的块号。当它是待处理（Pending）日志时返回NULL。
- data：包含日志的非索引参数。
- logIndex：块中日志索引位置的十六进制。当它是待处理（Pending）日志时返回NULL。
- removed：若日志由于链重组而被删除，则返回true。如果它是有效的日志，则返回false。
- topics：数据数组。索引日志参数的 0 到 4 个 32 字节 DATA 的数组。在 Solidity 中，第一个topic是事件签名的哈希值（例如 Deposit(address,bytes32,uint256)），除非您使用匿名说明符声明事件。
- transactionHash: 创建此日志的事务的哈希值。当它是待处理（Pending）日志时返回NULL。
- transactionIndex：创建此日志的事务索引位置的十六进制。当它是待处理（Pending）日志时返回NULL。

请求样式

curl https://your-http-endpoint/v1/<API-KEY> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","method":"eth_getFilterLogs","params":["0x16"],"id":74}'

父主题： Ethereum JSON-RPC API

上一篇：eth_getFilterChanges

下一篇：eth_newBlockFilter

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消