SuperAPI AI 工具集

portal-query-evm-transactions

通用与其它

查看项目

更新于 10-16 08:40

技能介绍

用途:通过 SQD Portal 查询 EVM 交易,适合追踪钱包收发活动、监控合约的特定函数调用、按函数选择器(sighash)查找交易、分析交易模式与数量,以及获取交易关联的日志和 traces。

主要能力:查询结构包含 type(EVM 链填 "evm")、必填的 fromBlock/toBlock 区块范围、transactions 过滤数组和 fields 响应字段。过滤字段中 from、to、sighash 为 INDEXED 可快速查询,另支持 firstNonce/lastNonce 范围过滤,以及 logs、traces、stateDiffs 布尔字段以自动关联数据。响应字段涵盖 hash、from、to、input、value、nonce、gas、gasUsed、gasPrice、maxFeePerGas、contractAddress、type、status、sighash、chainId 等。

使用方式:sighash 为 keccak256 函数签名前 4 字节,例如 ethers.id("swap(uint256,address[])").slice(0, 10) 得到 0x414bf389。合约创建可用 "to": [] 过滤,contractAddress 返回新合约地址。若环境提供 Portal MCP 工具,可优先用 portal_query_transactions、portal_get_recent_transactions、portal_get_wallet_summary 快速查询,需要自定义字段、nonce 过滤或关联 logs/traces/stateDiffs 时再用原始 Stream API。响应为 JSON Lines,每行一个 JSON 对象,首行为区块头。

限制与注意:status 不是有效过滤字段,只能作为响应字段,需在客户端过滤;不能直接用 input 过滤,应改用 sighash;关联数据需在过滤对象内加 logs/traces/stateDiffs 为 true,并在 fields 中请求对应字段;必须指定区块范围,建议配合地址或 sighash 过滤并使用合理范围(约 100 至 100,000 个区块),避免查询过多交易。相关技能包括 portal-query-evm-logs、portal-query-evm-traces、portal-dataset-discovery。API 文档见 https://beta.docs.sqd.dev/api/catalog/stream,函数选择器数据库见 https://www.4byte.directory/。