Evm
只读 EVM 客户端：支持 8 条链的钱包、代币与汽油费。
技能元数据
| 源码 | 可选 — 使用 hermes skills install official/blockchain/evm 安装 |
| 路径 | optional-skills/blockchain/evm |
| 版本 | 1.0.0 |
| 作者 | Mibayy (@Mibayy), youssefea (@youssefea), ethernet8023 (@ethernet83), Hermes 智能体 |
| 许可证 | MIT |
| 平台 | linux, macos, windows |
| 标签 | EVM, Ethereum, BNB, BSC, Base, Arbitrum, Polygon, Optimism, Avalanche, zkSync, Blockchain, Crypto, Web3, DeFi, NFT, ENS, Whale, Security |
| 相关技能 | solana |
参考：完整 SKILL.md
以下是赫尔墨斯在触发此技能时加载的完整技能定义。这是智能体在技能激活时看到的说明。
EVM 区块链技能
跨 8 条链查询 EVM 兼容的区块链数据，并提供美元定价。 包含 14 个命令：钱包组合、代币信息、交易查询、活动历史、汽油费追踪器、 网络状态、价格查询、多链扫描、鲸鱼检测、ENS 解析、 授权检查、合约检查器和交易解码器。
支持 8 条链：Ethereum, BNB Chain (BSC), Base, Arbitrum One, Polygon, Optimism, Avalanche (C-Chain), zkSync Era。
无需 API 密钥。零外部依赖 — 仅使用 Python 标准库 (urllib, json, argparse, threading)。
取代了独立的
base技能。 Base 特有的代币 (AERO, DEGEN, TOSHI, BRETT, WELL, cbETH, cbBTC, wstETH, rETH) 以及之前位于optional-skills/blockchain/base/下的所有 Base RPC 功能已被整合 到此技能中。通过向任何命令传递--chain base来覆盖 Base 网络。
何时使用
- 用户在任意 EVM 链上查询钱包余额或投资组合
- 用户希望同时在所有链上检查同一个钱包
- 用户想通过哈希检查交易（或解码其执行内容）
- 用户查询 ERC-20 代币的元数据、价格、供应量或市值
- 用户查询某个地址的近期交易历史 -用户查询当前汽油费或跨链比较手续费
- 用户想在最近区块中找到大额鲸鱼转账
- 用户要求解析 ENS 名称 (vitalik.eth) 或反向查找地址
- 用户想检查合约是否有危险的代币授权
- 用户想检查一个智能合约（是代理？ERC-20? ERC-721? 字节码大小？）
- 用户想在交易前比较跨链汽油费成本
前提条件
仅需 Python 3.8+ 标准库。无需 pip 安装。 定价：CoinGecko 免费 API (有限速，约 10-30 请求/分钟)。 ENS：ensideas.com 公共 API。 交易解码：4byte.directory 公共 API。
覆盖 RPC 端点：export EVM_RPC_URL=https://your-rpc.com
辅助脚本路径：~/.hermes/skills/blockchain/evm/scripts/evm_client.py
快速参考
SCRIPT=~/.hermes/skills/blockchain/evm/scripts/evm_client.py
# 网络与价格
python3 $SCRIPT stats # Ethereum 统计信息
python3 $SCRIPT stats --chain arbitrum # Arbitrum 统计信息
python3 $SCRIPT compare # 所有 8 条链的汽油费 + 价格
# 钱包
python3 $SCRIPT wallet 0xd8dA...96045 # 投资组合 (ETH + ERC-20)
python3 $SCRIPT wallet 0xd8dA...96045 --chain bsc
python3 $SCRIPT multichain 0xd8dA...96045 # 同一钱包在所有链上
# 代币与价格
python3 $SCRIPT price ETH
python3 $SCRIPT price 0xdAC1...1ec7 # 通过合约地址查询
python3 $SCRIPT token 0xdAC1...1ec7 # ERC-20 元数据 + 市值
# 交易
python3 $SCRIPT tx 0x5c50...f060 # 交易详情
python3 $SCRIPT decode 0x5c50...f060 # 解码输入数据 (4byte.directory)
python3 $SCRIPT activity 0xd8dA...96045 # 近期交易
# 汽油费
python3 $SCRIPT gas # 汽油价格 + 成本估算
python3 $SCRIPT gas --chain optimism
# 安全
python3 $SCRIPT allowance 0xd8dA...96045 # 危险的 ERC-20 授权
python3 $SCRIPT contract 0xdAC1...1ec7 # 合约检查 (代理? 标准?)
# ENS
python3 $SCRIPT ens vitalik.eth # 名称 -> 地址 + 个人资料
python3 $SCRIPT ens 0xd8dA...96045 # 地址 -> ENS 名称
# 鲸鱼检测
python3 $SCRIPT whale # 大额转账 (最后 20 个区块, >$10k)
python3 $SCRIPT whale --blocks 50 --min-usd 100000 --chain arbitrum
流程
0. 设置检查
python3 --version # 需要 3.8+
python3 ~/.hermes/skills/blockchain/evm/scripts/evm_client.py stats
1. 钱包投资组合
原生代币余额 + 已知 ERC-20 代币，按美元价值排序。
python3 $SCRIPT wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
python3 $SCRIPT wallet 0xd8dA... --chain bsc --no-prices # 更快
2. 多链扫描
使用线程同时扫描所有 8 条链上的同一地址。
python3 $SCRIPT multichain 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
输出：每条链的原生代币余额 + 代币持有量 + 总美元价值。
3. 比较（汽油费 + 价格）
并行查询所有 8 条链。显示最便宜/最昂贵的链。
python3 $SCRIPT compare
4. 交易详情与解码
python3 $SCRIPT tx 0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060
python3 $SCRIPT decode 0x5c504ed... # 显示人类可读的函数签名
解码使用 4byte.directory 将 0xa9059cbb 翻译为 transfer(address,uint256)。
5. ENS 解析
python3 $SCRIPT ens vitalik.eth # -> 0xd8dA... + 头像 + 社交链接
python3 $SCRIPT ens 0xd8dA...96045 # -> vitalik.eth
6. 授权检查器（安全）
检查授予已知 DEX/桥接合约的 ERC-20 授权。
python3 $SCRIPT allowance 0xYourWallet
将无限制授权标记为高风险。
7. 合约检查器
python3 $SCRIPT contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 # USDC (代理)
python3 $SCRIPT contract 0xdAC17F958D2ee523a2206206994597C13D831ec7 # USDT (ERC-20)
检测：代理 (EIP-1967/EIP-1167), ERC-20, ERC-721, ERC-165。显示字节码大小和代理的实现地址。
8. 鲸鱼检测
python3 $SCRIPT whale # ETH, 最后 20 个区块, >$10k
python3 $SCRIPT whale --blocks 50 --min-usd 50000 --chain bsc
9. 汽油费追踪器
python3 $SCRIPT gas
python3 $SCRIPT gas --chain polygon
显示 gwei 价格和以下操作的美元成本：转账、ERC-20 转账、授权、兑换、NFT 铸造、NFT 转账。
支持的链
| 键 | 名称 | 原生代币 | 链 ID |
|---|---|---|---|
| ethereum | Ethereum | ETH | 1 |
| bsc | BNB Chain | BNB | 56 |
| base | Base | ETH | 8453 |
| arbitrum | Arbitrum One | ETH | 42161 |
| polygon | Polygon | POL | 137 |
| optimism | Optimism | ETH | 10 |
| avalanche | Avalanche C | AVAX | 43114 |
| zksync | zkSync Era | ETH | 324 |
注意事项
- CoinGecko 免费层：约 10-30 请求/分钟。使用
--no-prices可以更快地扫描钱包。 - 公共 RPC 可能会被限流。在生产环境中请设置 EVM_RPC_URL 为私有端点。
wallet和allowance只检查已知的代币列表（每条链约 30 个代币）。要发现所有代币，请使用区块浏览器。activity只扫描最近的区块（最多 200 个）。要获取完整历史记录，请使用 Etherscan API。multichain运行 8 个并行线程 — 可能会触发公共 RPC 的限速。- ENS 解析依赖于单个公共端点 (ensideas.com / ens.vitalik.ca)，没有备用方案。如果该端点宕机，
ens命令将失败 — 请稍后重试或使用区块浏览器。 - 交易解码依赖于单个公共端点 (4byte.directory)，没有备用方案。不在其数据库中的选择器将显示为
unknown。 - L2 汽油费估算仅为 L2 执行部分。 在 Base, Arbitrum, Optimism, zkSync 等 L2 Rollup 上，实际交易成本还包括 L1 数据发布费，该费用取决于 calldata 大小和当前 L1 汽油价格。
gas命令不估算 L1 部分。关于 Base，请参阅该网络的 L1 费用预言机（合约0x420000000000000000000000000000000000000F）。 - 地址/交易哈希输入会验证是否包含
0x前缀、长度正确且为十六进制，但不强制要求 EIP-55 校验和大小写（RPC 端点接受任何大小写的十六进制）。
验证
# 应打印当前区块、汽油价格、ETH 价格
python3 ~/.hermes/skills/blockchain/evm/scripts/evm_client.py stats
# 应将 vitalik.eth 解析为 0xd8dA...
python3 ~/.hermes/skills/blockchain/evm/scripts/evm_client.py ens vitalik.eth