# @aave-dao/aave-address-book 中文文档

规范地址：https://npmcn.com/package/%40aave-dao/aave-address-book/

版本：4\.77\.0
npm 元数据更新时间：2026-11-09T10:29:41.825Z
中文译文更新时间：2026-11-09T10:30:29.729Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40aave-dao/aave-address-book
原文对照：https://npmcn.com/package/%40aave-dao/aave-address-book/?lang=original
项目主页：https://github.com/aave-dao/aave-address-book#readme
源码仓库：https://github.com/aave-dao/aave-address-book

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

- 包体积（解压后）：18.6 MB，1606 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：viem ^2\.23\.5
- 首次发布：2026-02-19T08:15:20.660Z
- 最新版本发布：2026-11-09T10:29:41.376Z
- 近 30 天下载量：160445（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：588（近 12 个月 588 个）

## 中文简介

该数据库载有Aave生态系统智能合同所有地址的最新登记册,用于团结编码库.

## 安装

```sh
npm install @aave-dao/aave-address-book
```

也可以使用：`pnpm add @aave-dao/aave-address-book`、`yarn add @aave-dao/aave-address-book`、`bun add @aave-dao/aave-address-book`

## README

![Address book logo](https://npmcn.com/package/%40aave-dao/aave-address-book/addressbook_logo.png)

# 保存地址簿

[![npm version](https://img.shields.io/npm/v/@aave-dao/aave-address-book)](https://www.npmjs.com/package/@aave-dao/aave-address-book)

Aave 生态系统智能合同地址的最新登记册,用于Solity和JavaScript/TypeScript项目或通过JSON API使用.

🔍 **[在线搜索地址](https://aave-dao.github.io/aave-address-book/)**

## 安装

### 创建

```sh
forge install aave-dao/aave-address-book
```

### 节点.js

```sh
npm install @aave-dao/aave-address-book
```

## 使用量

### 团结

```solidity
import { AaveV3Ethereum } from "aave-address-book/AaveV3Ethereum.sol";
import { AaveV2Avalanche } from "aave-address-book/AaveV2Avalanche.sol";
import { AaveGovernanceV2 } from "aave-address-book/AaveGovernanceV2.sol";

contract Example {
  function execute() external {
    address pool = AaveV3Ethereum.POOL;
    // ...
  }
}
```

### Java 脚本/ Type 脚本

```typescript
import { AaveV3Ethereum, AaveV2Avalanche } from "@aave-dao/aave-address-book";

console.log(AaveV3Ethereum.POOL); // "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2"
console.log(AaveV3Ethereum.CHAIN_ID); // 1
```

### JSON API (英语)

最新地址簿也作为静态JSON与搜索UI同时出版:

-   [`manifest.json`](https://aave-dao.github.io/aave-address-book/api/v1/manifest.json) 描述已部署的软件包版本、源输入、聚合和可用的模块.
-   [`address-book.json`](https://aave-dao.github.io/aave-address-book/api/v1/address-book.json) 包含每个导出地址簿模块.
-   `modules/<name>.json` 包含一个模块, 例如 [`modules/AaveV3Ethereum.json`](https://aave-dao.github.io/aave-address-book/api/v1/modules/AaveV3Ethereum.json)。 。 。 .

显示路径与显示的 URL 相对, 模块名称对大小写敏感 :

```typescript
const manifestUrl =
  "https://aave-dao.github.io/aave-address-book/api/v1/manifest.json";
const manifest = await fetch(manifestUrl).then((response) => response.json());
const ethereum = manifest.modules.find(
  (module: { name: string }) => module.name === "AaveV3Ethereum",
);
const addresses = await fetch(new URL(ethereum.path, manifestUrl)).then(
  (response) => response.json(),
);
```

这个 `/api/v1` URL 总是代表从 `main`用清单 `commit` 和SHA-256字段,以识别并核实确切内容。 未来对JSON结构或路径的突破性改变会使用新的API版本.

## 发展

### 生成地址

图书馆使用收藏 [脚本](https://npmcn.com/package/%40aave-dao/aave-address-book/scripts) 从各种链上登记册获取地址.

```sh
npm run generate:addresses
```

### 构建

```sh
npm run build
forge build
```

### 测试

该库包括一套测试,可以使用下列命令运行:

```sh
npm test
forge test
```

节点 [测试套件](https://npmcn.com/package/%40aave-dao/aave-address-book/tests/sanity) 是一个收藏 `sanity` 测试,以确保视图函数返回预期值(例如,正确的池正在某个工厂中配置). 除此之外,还有一个 [核查套件](https://npmcn.com/package/%40aave-dao/aave-address-book/tests/verification.spec.ts) 以确保地址簿上列出的所有地址 都能通过我们喜欢的探险者验证.

### 添加新池

1.  添加池配置为 `scripts/configs/<type>/<network>`
2.  运行 `npm run generate:addresses`
3.  提交生成的文件

## 配置

创建一个 `.env` 用于可靠 RPC 连接的文件 :

```sh
ETHERSCAN_API_KEY=your_key_here
EXPLORER_PROXY=your_proxy

## RPC configuration
# Per default the package uses the public rpcs available via viem
# You can opt in to use private/different rpcs by setting the following environment variables
RPC_<NETWORK>=your_rpc_url
ALCHEMY_API_KEY=your_key_here
QUICKNODE_ENDPOINT_NAME=your_quicknode_endpoint_name
QUICKNODE_TOKEN=your_quicknode_token
```

## 用户

交互式用户界面可见于 [欧](https://npmcn.com/package/%40aave-dao/aave-address-book/ui) 软件包。 UI是一个反应应用程序,被编译为静态构建,因此可以在github页面上主机. 你可以罚款一个UI的例子 [surch.onave.com (中文(简体) )](https://search.onaave.com/)

## 地址簿 API

每个版本作为静态JSON文件发布,供方案消费:

```text
https://assets.aave.com/address-book/releases/latest/manifest.json
https://assets.aave.com/address-book/releases/latest/address-book.json
https://assets.aave.com/address-book/releases/latest/modules/AaveV3Ethereum.json
https://assets.aave.com/address-book/releases/v<version>/modules/AaveV3Ethereum.json
```

API包含一个汇总地址簿,每个包模块一个文件,以及包含 包的版本,承诺,字节大小,和SHA-256散列. 这个 `latest` 文件有短暂的缓存 寿命,而版本文件是不可改变的。 部署桶通过 `STATICS_BUCKET` GitHub 动作秘密 .

## 资源

-   **[雷克斯特扩展](https://www.raycast.com/smbdy/aave-search)** - 快速地址查询
-   **[网络搜索](https://search.onaave.com/)** - 浏览所有地址

## 许可证

麻省理工学院

* * *

维护者 [实验室](https://aave.com/)

## 常见问题

### @aave-dao/aave-address-book 是什么？

该数据库载有Aave生态系统智能合同所有地址的最新登记册,用于团结编码库\.

### 如何安装 @aave-dao/aave-address-book？

在项目目录运行 npm install @aave-dao/aave-address-book，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：viem（^2\.23\.5）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @aave-dao/aave-address-book 支持 TypeScript 吗？

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

### @aave-dao/aave-address-book 支持 ESM 还是 CommonJS？

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

### @aave-dao/aave-address-book 可以商用吗？

@aave-dao/aave-address-book 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @aave-dao/aave-address-book 的下载量有多少？

根据 npm 官方下载统计，@aave-dao/aave-address-book 在 2026/10/05 – 2026/11/03 这 30 天内被下载 160,445 次，日均约 5,348 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aave-dao/aave-address-book 还在维护吗？

最新版本 4\.77\.0 发布于 2026/11/09（今天）；至今共发布 588 个版本，其中过去 12 个月发布了 588 个；首次发布于 2026/02/19。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。