核心功能与用法
DeFi Yield Monitor 是一款面向去中心化金融用户的跨链持仓监控工具，无需API密钥即可通过公共端点获取链上数据。核心功能包括：
- 多协议覆盖：支持 Aave v3（ETH/BSC）、SparkLend（ETH/Base）、Spark Savings（ETH）及 Kamino（Solana）四大主流借贷与储蓄协议
- 实时数据追踪：自动拉取各钱包的 supplied/borrowed 余额、实时 APY、健康因子（health factor）及净值
- 收益计算：基于历史快照计算 7 天/30 天实际 PnL 与年化 APY，区别于预估 APY
- 风险预警：可配置健康因子阈值（默认 1.25）与最大日回撤限制，触发时自动警报
使用流程
1. 配置 config.json：添加 EVM/Solana 钱包地址，启用目标协议
2. 首次运行生成快照：python main.py --config config/config.json
3. 设置定时任务（建议每日两次）：积累 7 天后可查看 --yield-summary
4. 防火墙环境下需配置代理（如 QuickQ）以访问 DefiLlama 和 Aave GraphQL
显著优点
- 零门槛接入：无需中心化交易所 API 或私钥，仅依赖公开链上数据
- 跨链整合：单工具覆盖 Ethereum、BSC、Base、Solana 多生态
- 真实收益计算：基于实际持仓变化计算 PnL，避免 APY 虚高误导
- 开源透明：代码完全公开，可自行审计数据流与计算逻辑
潜在局限
- 数据时效性：依赖公共 RPC/GraphQL，网络拥堵时可能延迟
- 协议覆盖有限：暂不支持 Compound、Morpho、EigenLayer 等新兴协议
- 快照依赖：7/30 天收益需持续运行 cron 任务，冷启动无历史数据
- 无交易功能：纯监控工具，不支持一键还款、调仓等链上操作
- 代理依赖：中国大陆等网络受限地区需手动配置代理
适合人群
- 多链 DeFi 借贷用户（Aave/Spark/Kamino 重度使用者）
- 追求被动收益监控的 stablecoin 理财者
- 需要定期报告持仓风险的机构或 DAO 财库管理者
- 对数据主权敏感、不愿授权中心化 API 的用户
常规风险提示
- 智能合约风险：监控协议本身无托管资金，但用户持仓面临底层协议合约漏洞风险
- 预言机与数据风险：APY 数据来自 DefiLlama 及协议官方端点，极端市场下可能存在滞后
- 配置泄露风险：
config.json包含钱包地址明文，建议设置文件权限 600 并避免版本控制提交 - 代理安全风险：使用第三方代理工具时存在流量劫持可能，建议优先使用可信节点或 VPN
- 健康因子误读：清算线因资产而异，统一阈值（如 1.25）可能不适用于所有抵押品组合