用途:查询 Base(以太坊 L2)链上数据,并通过 CoinGecko 附加美元价格。适用于查询 Base 钱包余额、代币持仓与组合价值,按哈希查看交易,获取 ERC-20 元数据、价格、供应量与市值,了解 Base Gas 成本与 L1 数据费,检查合约(ERC 类型检测、代理解析),发现大额 ETH 转账,查看网络健康、Gas 价格与 ETH 价格,以及查询 USDC/AERO/DEGEN/ETH 等价格。
主要能力:提供 8 个命令——wallet(钱包组合)、tx(交易详情)、token(代币信息)、gas(Gas 分析)、contract(合约检查)、whales(巨鲸检测)、stats(网络统计)、price(价格查询)。无需 API 密钥,仅使用 Python 标准库(urllib、json、argparse)。
使用方式:默认 RPC 为 https://mainnet.base.org,可通过 export BASE_RPC_URL=https://your-private-rpc.com 覆盖。脚本路径为 ~/.hermes/skills/blockchain/base/scripts/base_client.py。命令示例:python3 base_client.py wallet <address> [--limit N] [--all] [--no-prices];python3 base_client.py tx <hash>;python3 base_client.py token <contract_address>;python3 base_client.py gas;python3 base_client.py contract <address>;python3 base_client.py whales [--min-eth N];python3 base_client.py stats;python3 base_client.py price <contract_address_or_symbol>。
限制:CoinGecko 免费层约每分钟 10-30 次请求,价格查询每代币 1 次请求,可用 --no-prices 加速;公共 RPC 有限流,生产环境建议设置私有端点。wallet 仅检查约 15 个已知 Base 代币,未知 ERC-20 不会出现,需用 token 命令指定合约。代币名称从合约读取,未实现 name()/symbol() 时可能为空。Gas 估算仅含 L2 执行成本,不含 L1 数据发布费。巨鲸检测仅扫描最新区块,非历史数据,默认阈值 1.0 ETH。代理检测仅支持 EIP-1967。RPC 与 CoinGecko 遇 429 会以指数退避重试最多 2 次。