@anywalletkit/protocol-lending-aave-evm

中文文档
0.3.1发布于 2026/11/03Apache-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 2106

Aave v3 for@anywalletkit/wallet-evm 账户:供应、退出、借入(可变利率)和偿还任何 Aave v3 市场、通过SrappedTokenGateway V3 的本地硬币、一次性交易供应/以 EIP-2612 许可证偿还、有利率和上限的储备、健康

中文使用文档
文档目录9 节
  1. 安装
  2. 市场
  3. 使用量
  4. 钱移动之前会发生什么
  5. 读取
  6. 配置
  7. 测试
  8. 状态
  9. 活动

@anywalletkit/protocol-lending-ave-evm (英语)

npm

保护 v3 页:1 @anywalletkit/wallet-evm 帐户:供应, 退出、借出(可变利率)并在任何Aave v3市场上偿还 钱包屏幕需要——有利率和上限的储备,账户的健康 要素和借款能力,位置。 执行核心 LendingProtocol (单位:千美元)supply / withdraw / borrow / repay +引号),类似 @anywalletkit/protocol-lending-mellow-evm 做金库.

安装

npm install @anywalletkit/protocol-lending-aave-evm @anywalletkit/core
# or: pnpm add @anywalletkit/protocol-lending-aave-evm @anywalletkit/core  ·  yarn add @anywalletkit/protocol-lending-aave-evm @anywalletkit/core

时间: @anywalletkit/protocol-lending-ave-evm (英语)发表于 发布工作流程 与出处.

由协议本身的接口( ave- v3- 来源) 和官员编写 地址簿(bgd-labs/ave-address-book);没有Aave SDK,一个依赖(viem).

市场

每艘活生生的Aave v3市场船作为预设(AAVE_MARKETS[chainId][key]: 伊特鲁姆core, (中文(简体) ), lido, (中文(简体) ), etherfi(原始内容存档于2013-10-12). Arbitrum, Optimism, Polygon, Base, 雪崩、BNB、克诺斯、斯克罗、莱纳、索尼克、克洛、曼特尔、索尼姆、等离子体, zkSync, Metis, 墨子 (中文(简体) ). 名单上没有的市场需要 addressesProvider 财务报告和审定财务报表 pool 在配置中: 池子得到批准和许可, 所以它是 从来没有从RPC单独取出, 和自定义提供者没有 pool 实值 拒绝(预设供应商在自己的链上取出已运出宝库).

只有 组合地址 从配置中信任。 游泳池,我们, 价格甲骨文和数据提供者在链上读取,预设集 必须与提供者报告的内容相匹配 寄钱给错误的合同.

使用量

import WalletManagerEvm from '@anywalletkit/wallet-evm'
import { AaveProtocolEvm } from '@anywalletkit/protocol-lending-aave-evm'

const account = await new WalletManagerEvm(seed, { provider: 'https://…' }).getAccount(0)
const aave = new AaveProtocolEvm(account)              // chain from the account, market 'core'
// new AaveProtocolEvm(account, { market: 'lido' })    // Ethereum Lido instance
// new AaveProtocolEvm(account, { chainId: 8453 })     // Base, with an explicit chain

const USDT = '0xdAC17F958D2ee523a2206206994597C13D831ec7'

await aave.getSupplyApy(USDT)                          // 3.9 (percent, compounded like Aave's UI)
await aave.quoteSupply({ token: USDT, amount: 100_000_000n })   // { fee, approvals, permit, supplyApy }
await aave.supply({ token: USDT, amount: 100_000_000n })        // approve (exact) → wait → Pool.supply
await aave.supply({ token: 'native', amount: 10n ** 17n })      // WrappedTokenGatewayV3.depositETH

await aave.borrow({ token: USDT, amount: 50_000_000n })         // variable rate, checked against borrowing power
await aave.repay({ token: USDT, amount: 'max' })                // whole debt (+0.1 % approved for accruing interest)
await aave.withdraw({ token: USDT, amount: 'max' })             // uint256.max → everything
await aave.setCollateral({ token: USDT, enabled: false })

const { account: data, supplies, borrows } = await aave.getPosition()
data.healthFactor                                      // 2.6, or Infinity without debt

钱移动之前会发生什么

  • 预备队必须活动,不能暂停,不能被冻结(只允许冻结) 退出并偿还)。 供应和借款上限对照 aToken 检查 债务供应.
  • 借款与 getUserAccountData().availableBorrowsBase 地点 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}所以用数字而不是赤裸裸的 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}所以超额借款被拒绝 回头 信用授权(onBehalfOf)通过 borrowAllowance。 。 。 .
  • 每笔主要交易都通过 eth_call 从账户; Aave 的 返回 – v3.0-3.3 上的数值代码 ('35'),v3.4+上的自定义错误 (单位:千美元)HealthFactorLowerThanLiquidationThreshold())——成为可读 AaveErrors 附有代码.
  • ERC-20津贴为: 准确永远不要无限制 approve(0) 重设它的要求。 当符号支持 EIP-2612 和 账户可以 signPermit (wallet -evm确实如此) 供应和偿还 单笔交易 supplyWithPermit 编号 : repayWithPermit 路边.
  • 原生腿会穿过SrappedTokenGateway V3: depositETH, (中文(简体) ), withdrawETH (在批准aWETH到入口之后), borrowETH (之后) (中文(简体) ) approveDelegation 在WETH 债务令牌上, repayETH (退还过多). 网关ABI是在Ethereum上验证的v3.2+- borrowETH 财务报告和审定财务报表 repayETH 不再使用速率模式,与协议文件仍然显示的情况不同.

读取

方法返回时
getMarket()库、甲骨文、数据提供者、基本货币单位、网关、包裹
getReserves() 编号 : getReserve(token)配置比特已解码( LTV, 阈值, 上限, 旗帜), 速率( ray, APR, APY), aToken / 债务令牌
getUserAccountData(user?)- LTV,清算门槛,健康因素
getPosition()供应(附担保旗)和每个储备借款,加账户数据
getAssetPrice(token), (中文(简体) ), getSupplyApy(token), (中文(简体) ), getBorrowApy(token)甲骨文价格;按百分比计算

预备队读取通过多点调用3(一次往返),返回单曲 调用它不存在的地方 (zkSync) .

配置

键默认含义
chainId账户链,否则1账户必须匹配 eip155:N
market'core'预设链键
addressesProvider, (中文(简体) ), pool, (中文(简体) ), wethGateway从预设明确市场pool 需要使用自定义 addressesProvider(三); wethGateway: null 禁用本地双腿
provider账户的RPC url(s) / EIP-1193 读取通过
usePermittrue单一交易供应/尽可能偿还
referralCode0每个市场上不活跃
waitTimeoutMs180 000 个需要多长时间才能得到批准
multicall多点呼叫3地址,或 false

测试

pnpm test - 38次线下测试,通过模拟市场(EIP-1193)进行 解码调用数据的提供者: Pool, oracle, 网关, 符号, 多调用3, 在两种方言中都回归)加上相容套件. pnpm verify:live 读取 通过公开的RPC:市场发现、储备, 价格 APYs 证明供应计划 eth_call。 。 。 .

状态

2026-10-10: 建成,线下测试为绿色,现场只读验证针对 伊特鲁姆主网. 尚未通过模块获得资金的交易 .

活动

describeActivity(tx, { own }) 标记模块自身对钱包历史、离线和同步的交易:

  • 公认的: 目标为已知Aave v3的呼叫 池头 或者说 已包装的 KokenGateway V3 ——交易链上每一个预设的市场(AAVE_MARKETS加上这个实例配置的市场。 四字节选取者取出: supply 编号 : supplyWithPermit 编号 : deposit 财务报告和审定财务报表 depositETH → supply· ; withdraw 编号 : withdrawETH → withdraw· ; borrow 编号 : borrowETH → borrow· ; repay 编号 : repayWithPermit 编号 : repayWithATokens 编号 : repayETH → repay· ; setUserUseReserveAsCollateral 编号 : setUserEMode → contract。Aave合同中的任何其他方法仍作为 contract ("Ave v3 交易").
  • 标题 实值 "<Verb> <asset>" ("补充ETH","Undrew UDC"):主要资产为: address asset 参数,当存在 calldata时,否则,是移动到动作方向的符号;符号来自源的传输元数据. 字幕 实值 "Aave v3 · <chain>", (中文(简体) ), counterparty 合同要求, protocol 软件包名称.
  • 资产数字 : assetsIn 编号 : assetsOut 包括薄荷薄荷和烧伤.
  • 无 对于其他一切: 另一种协议, 一个简单的转移, 一个连锁,没有市场.

装入 fixtures/activity/ 是测试钱包资助的 Base 运行( Y)depositETH 编号 : withdrawETH, 2026-10-10),并贯穿相容套房活动的一半; fixtures/activity/negatives/ 保持长相,必须失去效果.

版本与发布记录

@anywalletkit/protocol-lending-aave-evm 共发布 12 个版本,首次发布于 2026/10/25;过去 12 个月发布了 12 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.3.1latest2026/11/034 天前
0.3.02026/10/309 天前
0.2.102026/10/2910 天前
0.2.92026/10/2811 天前
0.2.82026/10/2711 天前
0.2.72026/10/2612 天前

关于 @anywalletkit/protocol-lending-aave-evm 的常见问题

@anywalletkit/protocol-lending-aave-evm 是什么?

Aave v3 for@anywalletkit/wallet-evm 账户:供应、退出、借入(可变利率)和偿还任何 Aave v3 市场、通过SrappedTokenGateway V3 的本地硬币、一次性交易供应/以 EIP-2612 许可证偿还、有利率和上限的储备、健康

如何安装 @anywalletkit/protocol-lending-aave-evm?

在项目目录运行 npm install @anywalletkit/protocol-lending-aave-evm,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@anywalletkit/core(0.8.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@anywalletkit/protocol-lending-aave-evm 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@anywalletkit/protocol-lending-aave-evm 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@anywalletkit/protocol-lending-aave-evm 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@anywalletkit/protocol-lending-aave-evm 可以商用吗?

@anywalletkit/protocol-lending-aave-evm 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@anywalletkit/protocol-lending-aave-evm 的下载量有多少?

根据 npm 官方下载统计,@anywalletkit/protocol-lending-aave-evm 在 2026/10/06 – 2026/11/04 这 30 天内被下载 2,106 次,日均约 70 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@anywalletkit/protocol-lending-aave-evm 还在维护吗?

最新版本 0.3.1 发布于 2026/11/03(4 天前);至今共发布 12 个版本,其中过去 12 个月发布了 12 个;首次发布于 2026/10/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。