使用web3.js查询代币合约下钱包交易返回空该如何解决

架构老林

2026-10-21

问题排查及解决方法

1. 核心参数格式错误

web3.eth.Contract.getPastEvents 方法的入参规则为 (eventName, options, callback)，所有配置项（filter、fromBlock、toBlock）都需要放在同一个options对象中。你当前把区块范围配置拆成了独立的第三个参数，导致配置完全失效，查询逻辑不符合预期。

2. 公共RPC查询范围限制

Polygon公共RPC节点大多对历史事件查询的区块范围做了限制，直接从创世块（0块）查询到最新块的范围过大，大概率会被节点直接拦截返回空结果，建议缩小查询范围或者分页查询。

3. 过滤条件不完整

当前你只过滤了to等于目标钱包地址的转账事件，只能查到该地址的转入记录，如果需要查询该地址所有相关交易，需要同时过滤from等于该地址的转出记录。

修正后代码示例

const Web3 = require('web3')

// 替换为可用的RPC节点地址
const web3 = new Web3('https://rpc-mainnet.maticvigil.com/v1/___')

const abi = [/* 填写正确的ABI */]
const contract_address = '0x----------'
const wallet_address = '0x2-----------'

const instance = new web3.eth.Contract(abi, contract_address)
// 所有配置合并到同一个options对象
instance.getPastEvents(
    "Transfer",
    {
        filter: { 
            // 同时匹配转入转出可写成 to: [wallet_address], from: [wallet_address]
            to: wallet_address 
        },
        // 建议先缩小范围测试，确认逻辑正常后再调整区块范围
        fromBlock: 40000000, 
        toBlock: "latest" 
    },
    (errors, events) => {
       if (errors) {
            console.error('查询错误：', errors);
            return
       }
       console.log('查询到的事件：', events);
    }
);