为什么Web3合约事件过滤器无效？监听Transfer事件未按指定地址过滤

解决方法 #

1. 检查合约Transfer事件的参数标记
   Web3的链上事件过滤器仅支持过滤标记了indexed关键字的参数，你需要先确认合约中Transfer事件的receiver参数前是否添加了indexed修饰符，示例正确的事件定义如下：

// 合约中Transfer事件定义，receiver必须加indexed才支持链上过滤
event Transfer(address indexed sender, address indexed receiver, string message, uint256 value);

如果receiver没有加indexed，链上节点不会对该字段建立索引，自然无法完成过滤。

2. 统一地址大小写格式
   EVM本身不区分地址大小写，但Web3过滤时会对字符串做严格匹配，你需要将过滤地址和事件返回地址统一格式，比如统一转为全小写后再过滤：

myContractInstance.events.Transfer({
    filter: { receiver: this.state.accountAddress.toLowerCase() },
    fromBlock: 0,
    toBlock: 'latest'
}, function (error, event) {
    if (error) {
        console.error(error)
        return
    }
    console.log("监听结果：");
    console.log(event);
    message.info(event.returnValues.sender + " 向你转账了：" + event.returnValues.value);
})
.on('changed', function (event) {
    // remove event from local database
})
.on('error', console.error);

注：原代码中重复定义了回调和data事件监听，二者返回结果完全一致，保留其中一个即可避免重复处理。

3. 非indexed参数的兜底方案
   如果你无法修改合约添加indexed标记，或者你使用的Web3版本存在字符串过滤bug，可以在回调逻辑中手动做二次过滤：

function (error, event) {
    if (error) {
        console.error(error)
        return
    }
    // 手动过滤目标地址
    if (event.returnValues.receiver.toLowerCase() !== this.state.accountAddress.toLowerCase()) {
        return
    }
    // 后续业务逻辑
    console.log("监听结果：");
    console.log(event);
    message.info(event.returnValues.sender + " 向你转账了：" + event.returnValues.value);
}

内容的提问来源于stack exchange，提问作者1234