# @anywalletkit/protocol-lending-aave-evm 中文文档

规范地址：https://npmcn.com/package/%40anywalletkit/protocol-lending-aave-evm/

版本：0\.3\.1
npm 元数据更新时间：2026-11-02T20:13:16.667Z
中文译文更新时间：2026-11-07T01:29:55.897Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40anywalletkit/protocol-lending-aave-evm
原文对照：https://npmcn.com/package/%40anywalletkit/protocol-lending-aave-evm/?lang=original
项目主页：https://docs.anywallet.tech/
源码仓库：https://github.com/ultratestbro/anywalletkit

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：407 kB，10 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：1 个
- peer 依赖：@anywalletkit/core 0\.8\.0
- 首次发布：2026-10-24T18:41:08.518Z
- 最新版本发布：2026-11-02T20:13:16.145Z
- 近 30 天下载量：2106（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

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

## 安装

```sh
npm install @anywalletkit/protocol-lending-aave-evm
```

也可以使用：`pnpm add @anywalletkit/protocol-lending-aave-evm`、`yarn add @anywalletkit/protocol-lending-aave-evm`、`bun add @anywalletkit/protocol-lending-aave-evm`

## README

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

[![npm](https://img.shields.io/npm/v/@anywalletkit/protocol-lending-aave-evm?label=npm)](https://www.npmjs.com/package/@anywalletkit/protocol-lending-aave-evm)

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

## 安装

```sh
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 (英语)](https://www.npmjs.com/package/@anywalletkit/protocol-lending-aave-evm)发表于 [发布工作流程](https://github.com/ultratestbro/anywalletkit/blob/main/RELEASING.md) 与出处.

由协议本身的接口( 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` 实值 拒绝(预设供应商在自己的链上取出已运出宝库).

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

## 使用量

```ts
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()`)——成为可读 `AaveError`s 附有代码.
-   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 读取通过 |
| `usePermit` | `true` | 单一交易供应/尽可能偿还 |
| `referralCode` | `0` | 每个市场上不活跃 |
| `waitTimeoutMs` | 180 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 是什么？

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（5 天前）；至今共发布 12 个版本，其中过去 12 个月发布了 12 个；首次发布于 2026/10/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。