evm-balance-skills
高效批量查询多链EVM地址余额的SDK与CLI工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：evm-balance-skills。 它的用途是：高效批量查询多链EVM地址余额的SDK与CLI工具 完整的 Skill 内容见：https://321skill.com/skills/evm-balance-skills/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我需要检查这个BIP-44路径下的1000个地址，在Arbitrum和Optimism上是否有超过1个USDC的余额。'，它会引导你使用CLI命令或SDK代码，通过指定XPUB、派生路径、代币合约和最小余额，快速完成过滤并输出结果列表。或者
对AI说：'帮我写一段代码，用这个SDK获取我项目中所有CREATE2预测地址在Base链上的ETH余额。'，它会生成完整的TypeScript示例代码，包括初始化客户端、配置地址工厂和调用查询函数。
介绍
该Skill旨在解决开发者在多链环境中批量查询地址（包括原生代币和ERC20代币）余额时，面临的手动调用RPC效率低下、代码重复繁琐、多链适配复杂等问题。它通过提供统一的TypeScript SDK和命令行工具，封装了基于Multicall3的高性能批量查询逻辑，用户只需简单配置链、地址列表和代币合约，即可通过单次RPC调用获取大量数据。
使用方式非常灵活：开发者可通过@evm-balance/sdk在Node.js项目或前端应用中集成；非技术用户或需要快速验证的场景，则可直接使用CLI工具，通过简单的命令完成查询。它还支持从XPUB或CREATE2地址工厂批量派生地址进行查询，并内置了按最小余额过滤等智能处理功能。
该Skill非常适合需要处理大量地址余额数据的区块链开发者、量化分析师、空投猎人、项目运营以及安全审计人员。无论是构建钱包看板、进行链上数据分析、验证空投资格，还是监控项目资金状态，都能从中受益。
使用建议：对于大规模地址查询（如上万地址），建议合理设置batchSize参数以避免RPC节点限制或超时。注意，其性能高度依赖于所使用的RPC节点的稳定性和速率限制。查询ERC20余额时，请确保提供正确的代币合约地址和小数位数，否则过滤功能可能不准。
核心特点
核心区别在于其深度集成Multicall3合约，将成千上万次独立的余额查询请求聚合为一次RPC调用，极大提升了查询效率并降低了Gas成本；同时，它原生支持`viem/chains`中的所有链，并提供从BIP-44 XPUB和CREATE2工厂批量派生地址查询的一站式解决方案，这是许多单一功能余额查询工具所不具备的。
注意事项
不适合需要实时、逐区块监听余额变动的事件驱动型场景，其主要用于特定时间点的余额快照查询。
常见问题
如何查询一个地址在多个链上的余额？
使用SDK的`getBalancesForChains`函数或CLI的`--chains`参数，指定多个链ID即可批量查询。
可以只查询余额大于某个值的地址吗？
可以，SDK和CLI都支持`minBalance`参数，并会正确处理代币的小数位数进行精准过滤。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/evm-balance-skills/raw/index.md 读取 evm-balance-skills 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/evm-balance-skills/raw/index.md（查看排版版本）