跳到主要内容

Base

查询 Base（以太坊 L2）区块链数据并附带 USD 定价——包括钱包余额、代币信息、交易详情、Gas 分析、合约检查、巨鲸检测以及实时网络统计。使用 Base RPC + CoinGecko。无需 API 密钥。

技能元数据​

来源可选 — 使用 hermes skills install official/blockchain/base 安装
路径optional-skills/blockchain/base
版本0.1.0
作者youssefea
许可证MIT
标签Base, Blockchain, Crypto, Web3, RPC, DeFi, EVM, L2, Ethereum

参考：完整 SKILL.md​

信息

以下是 Hermes 在触发此技能时加载的完整技能定义。这是技能激活时代理所看到的指令。

Base 区块链技能

查询 Base（以太坊 L2）链上数据，并通过 CoinGecko enrich 以 USD 定价。 8 条命令：钱包投资组合、代币信息、交易、Gas 分析、 合约检查、巨鲸检测、网络统计和价格查询。

无需 API 密钥。仅使用 Python 标准库（urllib, json, argparse）。

何时使用​

  • 用户询问 Base 钱包余额、代币持有情况或投资组合价值
  • 用户希望通过哈希检查特定交易
  • 用户希望获取 ERC-20 代币元数据、价格、供应量或市值
  • 用户希望了解 Base Gas 成本和 L1 数据费用
  • 用户希望检查合约（ERC 类型检测、代理解析）
  • 用户希望查找大额 ETH 转账（巨鲸检测）
  • 用户希望获取 Base 网络健康状况、Gas 价格或 ETH 价格
  • 用户询问“USDC/AERO/DEGEN/ETH 的价格是多少？”

前提条件​

辅助脚本仅使用 Python 标准库（urllib, json, argparse）。 无需外部包。

定价数据来自 CoinGecko 的免费 API（无需密钥，速率限制 约为 ~10-30 次请求/分钟）。为了更快的查询，请使用 --no-prices 标志。

快速参考​

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>

流程​

0. 设置检查​

python3 --version

# Optional: set a private RPC for better rate limits
export BASE_RPC_URL="https://mainnet.base.org"

# Confirm connectivity
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py stats

1. 钱包投资组合​

获取 ETH 余额和带有 USD 价值的 ERC-20 代币持有情况。 通过链上 balanceOf 调用检查约 15 种知名的 Base 代币（USDC, WETH, AERO, DEGEN 等）。 代币按价值排序，过滤掉粉尘代币（dust）。

python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py \
  wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

标志：

  • --limit N — 显示前 N 个代币（默认：20）
  • --all — 显示所有代币，无粉尘过滤，无限制
  • --no-prices — 跳过 CoinGecko 价格查询（更快，仅 RPC）

输出包括：ETH 余额 + USD 价值、按价值排序的带价格代币列表、粉尘代币数量、以 USD 计的总投资组合价值。

注意：仅检查已知代币。不会发现未知的 ERC-20 代币。 对于任何代币，请使用带有特定合约地址的 token 命令。

2. 交易详情​

通过哈希检查完整交易。显示转移的 ETH 价值、 使用的 Gas、ETH/USD 费用、状态以及解码后的 ERC-20/ERC-721 转账。

python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py \
  tx 0xabc123...your_tx_hash_here

输出：哈希、区块、from、to、价值（ETH + USD）、Gas 价格、使用的 Gas、 费用、状态、合约创建地址（如果有）、代币转账。

3. 代币信息​

获取 ERC-20 代币元数据：名称、符号、小数位数、总供应量、价格、 市值和合约代码大小。

python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py \
  token 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

输出：名称、符号、小数位数、总供应量、价格、市值。 通过 eth_call 直接从合约读取名称/符号/小数位数。

4. Gas 分析​

详细的 Gas 分析及常见操作的成本估算。 显示当前 Gas 价格、过去 10 个区块的基础费用趋势、区块 利用率，以及 ETH 转账、ERC-20 转账和交换的估算成本。

python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py gas

输出：当前 Gas 价格、基础费用、区块利用率、10 区块趋势、 以 ETH 和 USD 计的成本估算。

注意：Base 是 L2 — 实际交易成本包括取决于 calldata 大小和 L1 Gas 价格的 L1 数据发布费用。显示的估算值仅针对 L2 执行。

5. 合约检查​

检查地址：确定它是 EOA 还是合约，检测 ERC-20/ERC-721/ERC-1155 接口，解析 EIP-1967 代理 实现地址。

python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py \
  contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

输出：is_contract、代码大小、ETH 余额、检测到的接口 （ERC-20, ERC-721, ERC-1155）、ERC-20 元数据、代理实现地址。

6. 巨鲸检测器​

扫描最新区块中具有 USD 价值的大额 ETH 转账。

python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py \
  whales --min-eth 1.0

注意：仅扫描最新区块—时间点快照，非历史数据。 默认阈值为 1.0 ETH（低于 Solana 的默认值，因为 ETH 价值较高）。

7. 网络统计​

实时 Base 网络健康状况：最新区块、链 ID、Gas 价格、基础费用、 区块利用率、交易计数和 ETH 价格。

python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py stats

8. 价格查询​

通过合约地址或已知符号快速查询任何代币的价格。

python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py price ETH
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py price USDC
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py price AERO
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py price DEGEN
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py price 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

已知代币符号：ETH、WETH、USDC、cbETH、AERO、DEGEN、TOSHI、BRETT、 WELL、wstETH、rETH、cbBTC。

注意事项​

  • CoinGecko 速率限制 — 免费层级允许每分钟约 10-30 次请求。 价格查询每个代币消耗 1 次请求。使用 --no-prices 以提高速度。
  • 公共 RPC 速率限制 — Base 的公共 RPC 对请求有限制。 生产环境中，请将 BASE_RPC_URL 设置为私有端点 （Alchemy、QuickNode、Infura）。
  • 钱包仅显示已知代币 — 与 Solana 不同，EVM 链没有内置的“获取所有代币”RPC。钱包命令通过 balanceOf 检查约 15 种流行的 Base 代币。未知的 ERC-20 代币不会显示。对任何特定合约使用 token 命令。
  • 从合约读取代币名称 — 如果合约未实现 name() 或 symbol()，这些字段可能为空。已知代币具有硬编码标签作为后备。
  • Gas 估算仅针对 L2 — Base 交易成本包括 L1 数据发布费用（取决于 calldata 大小和 L1 Gas 价格）。gas 命令仅估算 L2 执行成本。
  • 巨鲸探测器仅扫描最新区块 — 非历史数据。结果因查询时刻而异。默认阈值为 1.0 ETH。
  • 代理检测 — 仅检测 EIP-1967 代理。其他代理模式（EIP-1167 最小代理、自定义存储槽）未被检查。
  • 429 错误重试 — RPC 和 CoinGecko 调用在遇到速率限制错误时，最多重试 2 次，并采用指数退避策略。

验证​

# Should print Base chain ID (8453), latest block, gas price, and ETH price
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py stats