核心功能
eth-readonly 是一款专为以太坊区块链设计的纯只读查询工具，无需钱包、私钥或任何签名权限，即可安全获取链上数据。该技能整合 Foundry Cast 工具与原生 JSON-RPC/curl 调用双模式，覆盖区块高度、账户余额、交易详情、合约代码、ENS 解析、事件日志、Gas 价格等全维度查询场景，并深度集成 Etherscan API 提供合约源码验证、交易历史追溯等增强功能。
显著优点
安全零风险：设计上完全排除私钥交互，从根本上杜绝误操作转账或签名钓鱼风险，适合在公共环境或教学演示中使用。
工具灵活降级：优先自动检测并使用 cast 命令行工具获得结构化输出与类型安全；当 Cast 不可用时无缝回退至 curl + jq 原始 RPC 调用，确保环境适应性。
数据源丰富：内置公共 RPC 端点（如 PublicNode、Ankr、LlamaNodes）实现零配置即开即用，同时支持 Infura、Alchemy、QuickNode 等专业节点及本地节点，覆盖主网与 Sepolia、Holesky 测试网。
开发者友好：提供链 ID 校验、Nonce 追踪、Calldata 解码、ABI 解析等调试辅助功能，配合 Etherscan 合约源码拉取，形成从数据查询到代码验证的完整工作流。
局限性与注意事项
速率限制约束：公共 RPC 存在严格限流（如 Infura 免费版 10万/天），日志查询若未限定合约地址与区块范围极易触发限流或内存溢出；Etherscan 免费版限 5 请求/秒、10万/天，高频场景需升级 Pro。
功能边界明确：纯只读设计意味着无法模拟交易执行（如 eth_call 状态变更预览虽可行但无 gas 估算）、无法提交交易或部署合约，需搭配 /foundry 等技能完成写操作。
数据延迟与一致性：依赖第三方 RPC 可能面临区块同步延迟或分叉重组风险，关键财务决策建议交叉验证多节点源。
适用人群
- 智能合约开发者：调试合约状态、验证部署结果、追踪事件日志
- 链上分析师：批量查询地址余额、交易模式分析、Gas 趋势研究
- 安全研究员：无需暴露资产即可审计合约代码与交易行为
- Web3 学习者：零成本、零风险理解以太坊数据结构与 RPC 机制
常规风险提示
- RPC 端点可信度：公共节点可能存在日志记录或请求审查，敏感查询建议使用自有节点或可信服务商
- ENS 劫持风险：ENS 解析依赖链上注册表，需确认名称未过期或被转移
- 合约未验证风险：Etherscan 源码仅对主动验证的合约有效，未验证合约需反汇编分析
- API 密钥泄露：Etherscan 等密钥若硬编码于脚本存在泄露风险，建议环境变量管理