name: evm description: “Read-only EVM client: wallets, tokens, gas across 8 chains.” version: 1.0.0 author: Mibayy (@Mibayy), youssefea (@youssefea), ethernet8023 (@ethernet8023), Hermes Agent license: MIT platforms: [linux, macos, windows] metadata: hermes: tags: [EVM, Ethereum, BNB, BSC, Base, Arbitrum, Polygon, Optimism, Avalanche, zkSync, Blockchain, Crypto, Web3, DeFi, NFT, ENS, Whale, Security] category: blockchain related_skills: [solana] requires_toolsets: [terminal]

EVM区块链技能

可查询8条支持EVM协议的区块链数据，并以美元为单位显示价格。提供14种命令功能：钱包资产概览、代币信息查询、交易记录查看、网络活动监测、Gas费用追踪、网络统计信息、价格查询、多链扫描、大额地址检测、ENS域名解析、权限检查、合约分析以及交易解码。

支持的区块链包括：Ethereum、BNB Chain（BSC）、Base、Arbitrum One、Polygon、Optimism、Avalanche（C-Chain）和zkSync Era。

无需API密钥，且无任何外部依赖——仅使用Python标准库（urllib、json、argparse、threading）即可运行。

该技能已取代独立的base技能。 之前位于optional-skills/blockchain/base/目录下的所有与Base链相关的代币（AERO、DEGEN、TOSHI、BRETT、WELL、cbETH、cbBTC、wstETH、rETH）以及Base链的各类RPC功能，均已整合到此技能中。如需使用Base链相关功能，可在任意命令后添加--chain 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

# Network & prices
python $SCRIPT stats                            # Ethereum stats
python $SCRIPT stats --chain arbitrum           # Arbitrum stats
python $SCRIPT compare                          # Gas + prices ALL 8 chains

# Wallet
python $SCRIPT wallet 0xd8dA...96045            # Portfolio (ETH + ERC-20)
python $SCRIPT wallet 0xd8dA...96045 --chain bsc
python $SCRIPT multichain 0xd8dA...96045        # Same wallet on ALL chains

# Tokens & prices
python $SCRIPT price ETH
python $SCRIPT price 0xdAC1...1ec7              # By contract address
python $SCRIPT token 0xdAC1...1ec7              # ERC-20 metadata + market cap

# Transactions
python $SCRIPT tx 0x5c50...f060                 # Transaction details
python $SCRIPT decode 0x5c50...f060             # Decode input data (4byte.directory)
python $SCRIPT activity 0xd8dA...96045          # Recent transactions

# Gas
python $SCRIPT gas                              # Gas prices + cost estimates
python $SCRIPT gas --chain optimism

# Security
python $SCRIPT allowance 0xd8dA...96045         # Dangerous ERC-20 approvals
python $SCRIPT contract 0xdAC1...1ec7           # Contract inspection (proxy? standards?)

# ENS
python $SCRIPT ens vitalik.eth                  # Name -> address + profile
python $SCRIPT ens 0xd8dA...96045               # Address -> ENS name

# Whale detection
python $SCRIPT whale                            # Large transfers (last 20 blocks, >$10k)
python $SCRIPT whale --blocks 50 --min-usd 100000 --chain arbitrum

操作步骤

0. 设置检查

python --version   # 3.8+ required
python ~/.hermes/skills/blockchain/evm/scripts/evm_client.py stats

1. 钱包资产组合

显示原生代币余额以及已识别的 ERC-20 代币，按美元价值进行排序。

python $SCRIPT wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
python $SCRIPT wallet 0xd8dA... --chain bsc --no-prices   # faster

2. 多链扫描

通过线程技术，同时对同一地址在8条区块链上展开扫描。

python $SCRIPT multichain 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

输出内容：每条链的本地余额 + 代币持有量 + 美元总价值。

3. 对比（Gas费用 + 价格）

同时查询全部8条区块链，显示成本最低/最高的区块链。

python $SCRIPT compare

4. 交易详情与解码

python $SCRIPT tx 0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060
python $SCRIPT decode 0x5c504ed...   # Shows human-readable function signature

Decode功能会使用4byte.directory将0xa9059cbb转换为transfer(address,uint256)格式。

5. ENS解析

需对完整的输入内容进行转换，不得提前终止处理。

python $SCRIPT ens vitalik.eth          # -> 0xd8dA... + avatar + social links
python $SCRIPT ens 0xd8dA...96045       # -> vitalik.eth

6. 准许度检查器（安全功能）

用于检测已授予已知去中心化交易所/桥接合约的 ERC-20 授权情况。

python $SCRIPT allowance 0xYourWallet

将该选项标记为“UNLIMITED approvals”，并将其风险等级设定为“HIGH”。

7. 合同审查工具

python $SCRIPT contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48   # USDC (proxy)
python $SCRIPT contract 0xdAC17F958D2ee523a2206206994597C13D831ec7   # USDT (ERC-20)

可检测类型：代理合约（EIP-1967/EIP-1167）、ERC-20、ERC-721、ERC-165。同时会显示代理合约的字节码大小及实现地址。

8. 大额资产持有者检测

python $SCRIPT whale                                    # ETH, last 20 blocks, >$10k
python $SCRIPT whale --blocks 50 --min-usd 50000 --chain bsc

9. 燃气追踪器

python $SCRIPT gas
python $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等rollup网络中，实际交易成本还包括取决于calldata大小及当前L1层气费价格的L1层数据上传费用。gas命令不包含对该L1层费用的估算。针对Base网络，可参考该网络的L1层费用预言机（合约地址：0x420000000000000000000000000000000000000F）。
地址/交易哈希输入会经过验证，确保其以0x开头、长度正确且为十六进制格式，但不会强制要求遵循EIP-55校验和的大小写规范（RPC节点可接受任意大小写的十六进制字符串）。

# Should print current block, gas price, ETH price
python ~/.hermes/skills/blockchain/evm/scripts/evm_client.py stats

# Should resolve vitalik.eth to 0xd8dA...
python ~/.hermes/skills/blockchain/evm/scripts/evm_client.py ens vitalik.eth

Hermes Agent Docs i18n