# @across-protocol/contracts-v2 中文文档

规范地址：https://npmcn.com/package/%40across-protocol/contracts-v2/

版本：2\.5\.10
npm 元数据更新时间：2026-09-22T04:50:20.302Z
中文译文更新时间：2026-11-06T14:04:52.061Z
软件包许可：AGPL-3\.0-only

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

原始 npm 页面：https://www.npmjs.com/package/%40across-protocol/contracts-v2
原文对照：https://npmcn.com/package/%40across-protocol/contracts-v2/?lang=original
源码仓库：https://github.com/across-protocol/across-smart-contracts-v2

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

- 包体积（解压后）：62.2 MB，2277 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=16\.18\.0
- 运行依赖：14 个
- 首次发布：2022-03-04T17:51:24.561Z
- 最新版本发布：2024-05-29T14:53:54.812Z
- 近 30 天下载量：3059（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：134（近 12 个月 0 个）

## 中文简介

生产方面的最新合同部署将始终列在 `deployed` 标签.

## 安装

```sh
npm install @across-protocol/contracts-v2
```

也可以使用：`pnpm add @across-protocol/contracts-v2`、`yarn add @across-protocol/contracts-v2`、`bun add @across-protocol/contracts-v2`

## README

![Across-logo](https://raw.githubusercontent.com/across-protocol/across-frontend/65abd7772704a9ec243fd370f9e8e76322f0905b/src/assets/logo.svg)

包含智能合同套件,允许任意两个网络之间的即时令牌传输. 中继器被备份 中央流动资金 `HubPool` 在埃特鲁姆,它也充当了所有合同的跨链管理人 系统. `SpokePool` 合同被部署到任何希望产生象征性存款或成为最终存款的网络 代币转让目的地,它们都受 `HubPool` 在以利他岛.

本套合同是第二套 [跨智能合同](https://github.com/across-protocol/across-smart-contracts) 方便从任何L2到L1的象征性转让.

这些合同是: [由 OpenZeppelin 审计](https://blog.openzeppelin.com/uma-across-v2-audit/) 这是了解合同的一大资源.

[这个视频](https://www.youtube.com/watch?v=iuxf6Crv8MI) 也有益于理解技术架构.

## 已部署的合同版本

生产方面的最新合同部署将始终列在 `deployed` 标签.

## 构建

```shell
yarn
yarn hardhat compile
```

## 测试

```shell
yarn test # Run unit tests without gas analysis
yarn test:gas-analytics # Run only tests that count gas costs
yarn test:report-gas # Run unit tests with hardhat-gas-reporter enabled
```

## 林特

```shell
yarn lint
yarn lint-fix
```

## 部署和核查

```shell
NODE_URL_1=https://mainnet.infura.com/xxx yarn hardhat deploy --tags HubPool --network mainnet
ETHERSCAN_API_KEY=XXX yarn hardhat etherscan-verify --network mainnet --license AGPL-3.0 --force-license --solc-input
```

## 任务

##### L2 - > L1(主网-塞波利亚)

```shell
yarn hardhat finalize-scroll-claims --l2-address {operatorAddress}
```

## 斯莱特

[斯莱特](https://github.com/crytic/slither) 是用 Python 3 写的固态静态分析框架 。 它运行着一个 成套脆弱性探测器,打印关于合同细节的可视信息,并提供方便撰写的API 习惯分析。 Slither 使开发者能够发现弱点,增强他们的代码理解,并迅速 原型自定义分析.

已使用 `Slither@0.9.2` 没有找到主要错误。 重新运行分析器,运行:

```sh
slither contracts/SpokePool.sol
\ --solc-remaps @=node_modules/@
\ --solc-args "--optimize --optimize-runs 1000000"
\ --filter-paths "node_modules"
\ --exclude naming-convention
```

您可以替换 `SpokePool.sol` 你要分析的具体合同.

## ZK 同步适配器

这些是汇编和部署合同的特别指示 `zksync`。汇编命令将创建 `artifacts-zk` 财务报告和审定财务报表 `cache-zk` 目录.

### 编译

这个步骤要求 [嵌入桌面](https://www.docker.com/products/docker-desktop/) 正在运行,作为 `solc` docker 图像作为先决条件被获取 .

`yarn compile-zksync`

## 许可证

此寄存器中的所有代码均根据BUSL-1.1许可,除非文件中有不同规定. 风险实验室可以对许可证作个别例外规定 软件和设计。 如果你有兴趣在衍生作品中使用代码或设计, 自由接触 [许可@ risklabs. foundation](mailto:licensing@risklabs.foundation)。 。 。 .

## 常见问题

### @across-protocol/contracts-v2 是什么？

生产方面的最新合同部署将始终列在 deployed 标签\.

### 如何安装 @across-protocol/contracts-v2？

在项目目录运行 npm install @across-protocol/contracts-v2，或使用 pnpm add / yarn add / bun add。

### @across-protocol/contracts-v2 支持 TypeScript 吗？

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

### @across-protocol/contracts-v2 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @across-protocol/contracts-v2 需要什么版本的 Node\.js？

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

### @across-protocol/contracts-v2 可以商用吗？

@across-protocol/contracts-v2 使用 AGPL-3\.0-only 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @across-protocol/contracts-v2 的下载量有多少？

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

### @across-protocol/contracts-v2 还在维护吗？

最新版本 2\.5\.10 发布于 2024/05/29（2 年前）；至今共发布 134 个版本，其中过去 12 个月发布了 0 个；首次发布于 2022/03/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。