crypto-watcher

核心用法

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 价格波动剧烈时，阈值设置不当可能导致频繁通知，建议根据历史数据动态调整参数。