SuperAPI AI 工具集

evm-balance

数据与分析

查看项目

更新于 10-16 09:32

技能介绍

用途:evm-balance 用于跨多条 EVM 链批量获取余额,基于 Multicall3 实现,支持原生代币与 ERC20 代币余额,并提供命令行与 SDK 两种使用方式。

主要组件:SDK(@evm-balance/sdk)为核心库,负责余额获取逻辑、Multicall3 编解码、链工具与范围解析格式化;CLI(@evm-balance/cli)为命令行交互工具;另有用于 Multicall3 交互的 Solidity 合约。

命令行用法示例: 查询多链:evm-balance 0-100 --chain mainnet,optimism,arbitrum --xpub $XPUB 查询指定代币:evm-balance 0-100 -c mainnet -t 0xA0b86991...USDC,0xdAC17F9...USDT -X $XPUB 按最小余额过滤:evm-balance 0-1000 -c mainnet -t 0xUSDT,0xUSDC --min 0.1 输出 JSON:evm-balance 0-100 -c mainnet -f json -o balances.json 常用选项包括 -c/--chains、-t/--tokens、-m/--min、-f/--format(table、json、csv)、-X/--xpub,以及 --mode(xpub 或 factory)。

SDK 用法:通过 createBalanceFetcher 与 parseRange 等接口编程获取余额,可配置链、地址生成模式(xpub)、索引范围、代币列表与是否包含原生代币。

开发流程:前置依赖为 bun 与 foundry(forge、anvil)。常用命令:bun install、bun run build、bun run test、bun run test:sol、bun run typecheck、bun run fmt。使用 Anvil 测试时先运行 anvil,再执行 forge script script/DeployTest.s.sol:DeployTest --rpc-url http://127.0.0.1:8545 --broadcast,然后运行 bun run test。

限制:资料未提供具体性能指标、收费、支持链的完整清单或部署细节,这些信息暂未提供。