aaveclaw

核心用法

aaveclaw 是基于 Base Sepolia 测试网的 Aave V3 借贷协议交互工具，提供完整的借贷生命周期管理功能。

功能模块

| 命令 | 用途 | 示例 |

|:---|:---|:---|

| `health.sh` | 查询健康因子（只读） | `bash scripts/health.sh` |

| `faucet.sh` | 铸造测试代币 | `bash scripts/faucet.sh weth 1` |

| `deposit.sh` | 存入 WETH 抵押品 | `bash scripts/deposit.sh 0.5` |

| `borrow.sh` | 借入 USDC | `bash scripts/borrow.sh 100` |

| `repay.sh` | 偿还 USDC 债务 | `bash scripts/repay.sh max` |

| `withdraw.sh` | 提取 WETH 抵押品 | `bash scripts/withdraw.sh max` |

标准操作流程

首次使用：运行 setup.sh 安装依赖 → faucet.sh 获取测试代币 → deposit.sh 存入抵押品 → borrow.sh 借款 → 定期 health.sh 监控 → repay.sh/withdraw.sh 退出

显著优点

• 完整借贷闭环：覆盖 DeFi 借贷全部核心场景，从入金到清算风险监控一应俱全
• 自动化集成：自动 ETH→WETH 封装、自动健康因子展示、自动余额检查
• 测试网零成本：基于 Base Sepolia，使用测试代币无真实资金风险
• 开发者友好：纯 Bash 脚本实现，依赖 ethers v6，易于审计和二次开发

潜在局限

• 仅限测试网：主网操作需自行部署，存在合约地址差异风险
• 单一抵押品：仅支持 WETH 作为抵押品，USDC 作为借款资产，策略受限
• 无闪电贷功能：缺失 Aave V3 高级特性如 eMode、隔离模式等
• 私钥本地存储：依赖 ~/.x402-config.json 明文存储私钥，存在泄露风险

适合人群

• DeFi 协议开发者进行集成测试
• 智能合约学习者理解借贷机制
• 量化策略研究员验证算法逻辑
• 前端开发者对接借贷 UI

常规风险

| 风险类型 | 说明 | 缓解措施 |

|:---|:---|:---|

| 清算风险 | 健康因子<1.0 触发自动清算 | 脚本预警阈值设为 1.5 |

| 利率波动 | 可变利率导致借款成本变化 | 定期监控债务增长 |

| 合约风险 | 测试网合约可能重置或失效 | 关注官方公告 |

| 私钥泄露 | 本地明文存储私钥 | 使用专用测试钱包，勿用主网账户 |

> 注意：健康因子<1.5 时脚本发出警告，但 Aave 实际清算阈值为 1.0，需保持充足缓冲。

核心用法

aaveclaw 是一款面向 Base Sepolia 测试网的 Aave V3 协议交互技能，完整覆盖 DeFi 借贷生命周期。用户通过六个核心脚本实现全链路操作：faucet.sh 铸造测试代币（WETH/USDC）、deposit.sh 存入 WETH 抵押品、borrow.sh 借出 USDC、repay.sh 偿还债务、withdraw.sh 取回抵押品，以及 health.sh 实时监控仓位健康因子。技能自动处理 ETH 到 WETH 的包装转换，并在每笔状态变更交易后自动输出最新健康因子。

显著优点

协议级安全保障：直接对接 Aave V3 智能合约，借贷利率、清算阈值等核心参数由链上协议自动执行，避免人为干预风险。测试网零成本体验：所有操作均在 Base Sepolia 测试网进行，用户可免费获取测试代币，无真实资金损失风险。模块化设计：六个独立脚本职责清晰，支持组合调用与自动化集成，开发者可快速嵌入测试流水线。实时风控提示：内置健康因子预警机制（<1.5 风险阈值），帮助用户直观理解 DeFi 清算机制。

潜在缺点与局限性

网络硬编码限制：合约地址与 RPC 端点固定为 Base Sepolia，不支持主网或其他 L2 网络，如需多网部署需自行修改源码。私钥本地存储风险：依赖 ~/.x402-config.json 明文存储私钥，虽为标准实践但存在文件权限不当导致的泄露隐患。无交互式确认：状态变更交易直接执行，缺少二次确认环节，误操作可能导致测试仓位异常（虽无资金损失但需手动重建）。测试网稳定性依赖：水龙头合约存在铸造限额，高峰期可能出现代币领取失败。

适合的目标群体

• DeFi 协议开发者：需要快速验证 Aave 集成逻辑、测试清算场景或构建前端原型
• 智能合约审计人员：验证借贷池交互边界、健康因子计算准确性
• Web3 学习者：零成本理解抵押借贷机制、体验链上金融操作全流程
• 量化策略研究员：在测试网验证杠杆策略、清算套利逻辑

使用风险

私钥管理风险：配置文件若设置为全局可读（权限 >600），可能导致私钥被同服务器其他用户读取，建议严格设置文件权限并定期轮换测试密钥。交易不可逆性：区块链状态变更一旦确认无法撤销，尽管测试网无资金损失，但频繁误操作会消耗测试网 ETH 作为 Gas。依赖漂移风险：ethers.js 使用语义版本锁定（^6.13.0），未来 minor 版本更新可能引入行为变更，建议生产环境锁定精确版本。健康因子误读：测试网价格预言机可能与主网存在偏差，模拟的清算场景仅供参考，不应直接外推至主网风控参数。