跳到主要内容

Base

查询 Base（以太坊 L2）区块链数据，附带美元定价——钱包余额、代币信息、交易详情、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 在触发此技能时加载的完整技能定义。这是 Agent 在技能激活时看到的指令。

Base 区块链技能

查询 Base（以太坊 L2）链上数据，并通过 CoinGecko 补充美元定价。 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

# 可选：设置私有 RPC 以获得更好的速率限制
export BASE_RPC_URL="https://mainnet.base.org"

# 确认连接
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py stats

1. 钱包投资组合​

获取 ETH 余额和 ERC-20 代币持仓，附带美元价值。 通过链上 balanceOf 调用检查约 15 种 Base 知名代币（USDC、WETH、AERO、DEGEN 等）。代币按价值排序，已过滤小额持仓。

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

输出：哈希、区块、发送方、接收方、价值（ETH + USD）、Gas 价格、Gas 用量、手续费、状态、合约创建地址（如有）、代币转账。

3. 代币信息​

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

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

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

4. Gas 分析​

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

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

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

注意：Base 是 L2 —— 实际交易成本包含 L1 数据发布费用，该费用取决于 calldata 大小和 L1 Gas 价格。此处显示的估算仅针对 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. 大额转账探测​

扫描最新区块，查找大额 ETH 转账及其 USD 价值。

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 次，采用指数退避策略。

验证​

# 应输出 Base 链 ID (8453)、最新区块、Gas 价格和 ETH 价格
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py stats