用途
dapp-aave 是一个 Aave V3 借贷协议的命令行技能,用于查询借贷市场数据、查看账户持仓,并执行供应(supply)、提取(withdraw)、借款(borrow)、还款(repay)等链上操作。它通过 plugin-store 工具调用,共提供 7 条命令。
主要能力
数据查询(无需认证)
- markets:列出某条链上所有 Aave V3 储备市场,返回字段包括 symbol、underlyingAsset、supplyAPY、borrowAPY、totalSupply、totalBorrow、availableLiquidity、utilizationRate、ltv、liquidationThreshold 等。
- reserve:获取指定资产的储备详情,返回 supplyAPY、variableBorrowAPY、stableBorrowAPY、totalSupply、totalBorrow、availableLiquidity、utilizationRate、ltv、liquidationThreshold、liquidationBonus、reserveFactor、canBeCollateral、borrowingEnabled 等字段。
- account:查看账户持仓,返回 totalSuppliedUSD、totalBorrowedUSD、netWorthUSD、healthFactor、availableBorrowsUSD、currentLTV,以及 supplies 和 borrows 明细列表。
交易操作(需要 EVM 私钥)
- supply:向 Aave 供应资产以赚取收益,返回 txHash、status、supplied、token、chain。
- withdraw:提取已供应的资产,支持 --amount max 全额提取。
- borrow:以抵押品按可变利率借入资产。
- repay:偿还借款,支持 --amount max 全额还款(含累计利息)。
使用方式
安装与更新检查
运行前先确认已安装:which plugin-store。若未找到,执行:
curl -sSL https://raw.githubusercontent.com/purong-huang-1121/skills-store/main/install.sh | sh
若安装脚本失败,可参考 https://github.com/okx/plugin-store 手动安装。
更新检查:读取 ~/.plugin-store/last_check 与当前时间戳比较,若缓存时间距今小于 43200 秒(12 小时)则跳过更新,否则重新运行安装脚本检查更新。
认证
数据命令(markets、reserve、account)无需认证。交易命令(supply、withdraw、borrow、repay)需要在 .env 文件中配置:
EVM_PRIVATE_KEY=0x...
私钥用于在链上签名供应、提取、借款和还款交易。
命令示例
# 列出以太坊上所有 Aave V3 市场
plugin-store aave markets --chain ethereum
# 获取 USDC 储备详情
plugin-store aave reserve USDC --chain ethereum
# 查看账户持仓
plugin-store aave account 0xYourAddress --chain ethereum
# 供应 100 USDC
plugin-store aave supply --token USDC --amount 100 --chain ethereum
# 提取 50 USDC
plugin-store aave withdraw --token USDC --amount 50 --chain ethereum
# 全额提取 USDC
plugin-store aave withdraw --token USDC --amount max --chain ethereum
# 借入 500 USDC(可变利率)
plugin-store aave borrow --token USDC --amount 500 --chain ethereum
# 偿还 200 USDC
plugin-store aave repay --token USDC --amount 200 --chain ethereum
# 全额偿还 USDC 债务
plugin-store aave repay --token USDC --amount max --chain ethereum
操作流程
- 识别意图:浏览市场/利率用 markets;查看资产详情用 reserve;查看账户状态用 account;存入/出借用 supply;提取用 withdraw;抵押借款用 borrow;还款用 repay。
- 收集参数:缺少链时询问用户(ethereum、polygon、arbitrum);缺少 symbol 时先用 markets 获取列表;缺少地址时询问钱包地址;缺少金额时询问数量;缺少私钥时提示在 .env 中设置 EVM_PRIVATE_KEY。
- 执行:数据阶段展示市场信息、利率、持仓,让用户做出知情决策;确认阶段在任何 supply/withdraw 前显示代币、金额、链、预估 APY 并请求确认;执行阶段提交交易并显示结果与 tx hash。
- 建议后续步骤:根据刚完成的命令给出下一步建议(如查看更新后的持仓、查看储备 APY、查看钱包余额等)。
跨技能协作
- 代币搜索/分析 → okx-dex-token
- DEX 兑换 → okx-dex-swap
- 代币价格/图表 → okx-dex-market
- 钱包余额 → okx-wallet-portfolio
- 交易广播 → okx-onchain-gateway
- 预测市场 → okx-dapp-polymarket
典型工作流:先用 okx-wallet-portfolio 查看余额,再用 aave markets 查看利率,最后用 aave supply 供应资产。
适用场景
- 比较不同链(ethereum、polygon、arbitrum)上的 Aave V3 借贷利率。
- 查看特定资产的供应 APY、借款利率、流动性和风险参数。
- 检查账户的健康因子、借贷能力和持仓明细。
- 执行供应、提取、借款、还款等链上借贷操作。
关键概念
- Supply APY:供应资产赚取的年化收益率,随利用率变化。
- Health Factor:持仓安全指标,高于 1.0 安全,低于 1.0 可被清算,建议保持在 1.5 以上。
- aTokens:供应后获得的收据代币(如供应 USDC 获得 aUSDC),余额随时间自动增长以累计利息。
- RAY:Aave 内部使用 27 位小数定点数(1 RAY = 10^27)计算利率,CLI 会转换为可读百分比。
- LTV:可借入的抵押品价值最大百分比。
- Liquidation Threshold:触发清算的 LTV 水平,始终高于最大 LTV。
- Utilization Rate:已借出与已供应的比率,利用率越高利率越高。
限制与边界情况
- 支持链:仅支持 ethereum、polygon、arbitrum,其他链会返回错误。
- 余额不足:供应超过钱包余额的交易会失败,建议先用 okx-wallet-portfolio 检查余额。
- 健康因子风险:提取抵押品或借款时,若健康因子可能降至 1.5 以下会发出警告。
- 借款能力:借款前需有足够抵押品,可通过 account 命令查看可用借款额度。
- 代币授权:首次供应某代币需要 ERC-20 授权交易,CLI 会自动处理但会消耗额外 gas。
- 私钥未设置:交易命令会提示“Set EVM_PRIVATE_KEY in your .env file”。
- 资产未列出:若代币符号不是 Aave V3 储备,建议用 markets 查看可用资产。
- 速率限制:OKX API 有速率限制,需使用退避重试。
- 关于收费、价格等具体信息,资料中暂未提供。