ethers检索事件

简单来说，ethers.js 事件检索就是去区块链的"历史档案库"里翻找以前发生过的事。

如果说 contract.on 是在听"直播"，那么事件检索就是在看"回放"。

---

1. 它是干什么用的？

区块链的每一个区块都记录了当时释放的事件（Logs）。事件检索允许你根据特定条件（时间段、谁发起的、什么动作）把这些历史记录抓取出来。

常见的应用场景：

• 历史账单：用户打开网页时，展示他过去所有的转账记录。
• 数据统计：计算一个 NFT 系列总共被交易了多少次。
• 断线重连：如果你的网页关掉了一小时，重新打开时，你需要检索这一小时内错过了哪些消息。

---

2. 核心方法：queryFilter

在 ethers.js 中，最常用的函数是 queryFilter。

// 假设我们要查从第 5,000,000 个区块到最新的所有"转账"事件
const filter = contract.filters.Transfer(fromAddress, null); // 筛选特定的发送者
const logs = await contract.queryFilter(filter, 5000000, "latest");

logs.forEach((log) => {
    // log.args 包含了事件里定义的参数，比如 from, to, value
    console.log(`在区块 ${log.blockNumber} 中，发现转账：${log.args.value}`);
});

---

3. 为什么不直接查变量，而要检索事件？

这是一个非常关键的设计思路：

1. 省钱（Gas） ：在合约里存一个巨大的 Array 来记录所有历史交易是非常贵的。而事件日志存放在区块的特殊位置，不占用合约的"实时内存（Storage）"，成本极低。
2. 效率 ：如果你想找"地址 A 给地址 B 转了多少钱"，直接查区块链状态很难查（除非你遍历所有区块），但通过 indexed 标记的事件索引，可以在几秒钟内从数百万个区块中定位到结果。

---

4. 检索的限制

• 只读性 ：智能合约自己不能检索历史事件。只有外部客户端（如浏览器、服务器）可以。
• RPC 节点限制：大多数免费的节点服务（如 Infura/Alchemy）一次最多只允许你查 2000 到 10000 个区块的数据。如果范围太大，你需要分批次查。

---

总结

• contract.on(...) ：监听现在和未来（直播）。
• contract.queryFilter(...) ：查找过去（回放）。