基于 viem 和 DefiLlama 的零私钥加密资产监控工具，支持多链钱包追踪与 DeFi 仓位预警，让用户无需暴露敏感凭证即可实时掌握资产动态。
说明：
## 核心用法
crypto-watcher 是一款面向加密货币持有者的轻量级监控 CLI 工具，通过公开 RPC 端点实现零私钥设计的资产追踪。用户仅需配置钱包地址即可监控 ETH 及多链代币余额、DeFi 仓位健康度、Gas 价格波动及大额转账预警。核心工作流包括：通过 `add` 命令添加待监控地址（支持 Ethereum、Arbitrum、Base、Optimism、Polygon 五条链），使用 `config` 设置 Gas 阈值与余额变动百分比触发条件，日常通过 `status` 查看聚合仓位，或集成至 HEARTBEAT.md 实现自动化巡检。
## 显著优点
**安全架构领先**：最大亮点在于完全不接触私钥或助记词，仅依赖公开区块链数据，从根本上杜绝了私钥泄露风险。这一设计使其区别于绝大多数需要签名权限的 DeFi 工具，适合安全意识极强的用户。
**依赖精简可信**：仅依赖 viem 一个主流以太坊交互库，无臃肿的依赖树，降低了供应链攻击面。数据源均选用行业标杆——DefiLlama 聚合 DeFi 数据、CoinGecko 提供价格、官方 RPC 保障节点可信性。
**多链原生支持**：覆盖以太坊 L1 及四大主流 L2（Arbitrum、Base、Optimism、Polygon），满足跨链资产配置用户的统一监控需求，无需切换多个浏览器标签页。
**自动化友好**：内置 `–quiet` 模式与 HEARTBEAT.md 集成方案，便于接入现有运维巡检体系，实现”静默监控+异常告警”的 DevOps 风格工作流。
## 潜在缺点与局限性
**功能边界明确**：作为只读监控工具，无法执行任何链上操作（如补仓、领取奖励、紧急退出），用户仍需配合其他钱包软件完成交易。DeFi 仓位数据依赖 DefiLlama 的覆盖范围，小众协议可能缺失。
**网络稳定性依赖**：所有数据均来自外部 API 与公共 RPC，未内置请求超时、重试或降级机制。若 CoinGecko 免费额度耗尽或 RPC 临时故障，监控可能中断。
**配置管理待完善**：钱包地址以明文 JSON 存储于用户目录，虽无资产风险，但缺乏加密选项，多用户共享设备时存在隐私顾虑。
**参数解析鲁棒性**：命令行参数依赖位置索引解析，复杂输入场景下存在误解析可能，建议增强输入过滤与验证。
## 适合的目标群体
– **DeFi 重度用户**：持有多个 LP 仓位、借贷头寸，需要统一健康度监控
– **多链资产配置者**：在以太坊主网及 L2 间分散资产，希望一站式查看
– **安全敏感型投资者**：拒绝向任何工具暴露私钥，坚持”观察钱包”与”操作钱包”分离
– **自动化运维爱好者**：希望将加密资产监控纳入现有服务器/本地巡检体系
## 使用风险
**数据延迟风险**：公共 RPC 与免费 API 存在速率限制，极端行情下数据更新可能滞后，不适合高频交易决策。
**RPC 端点可用性**：虽选用官方或知名 RPC，但第三方节点仍可能遭遇劫持或故障，建议高级用户自行配置私有 RPC 备用。
**API 额度限制**：CoinGecko 免费版有调用频率上限，重度使用可能触发限流，需关注文档中的额度管理建议。
**误告警可能**：Gas 价格波动剧烈时，阈值设置不当可能导致频繁通知，建议根据历史数据动态调整参数。
