# @aztec-foundation/aztec-standards 中文文档

规范地址：https://npmcn.com/package/%40aztec-foundation/aztec-standards/

版本：6\.0\.0
npm 元数据更新时间：2026-10-22T16:11:05.613Z
中文译文更新时间：2026-11-07T19:16:15.996Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：54 MB，59 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-07-16T13:02:12.744Z
- 最新版本发布：2026-10-22T16:11:05.134Z
- 近 30 天下载量：3025（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

[![npm version](https://img.shields.io/npm/v/@aztec-foundation/aztec-standards.svg)](https://www.npmjs.com/package/@aztec-foundation/aztec-standards)

## 安装

```sh
npm install @aztec-foundation/aztec-standards
```

也可以使用：`pnpm add @aztec-foundation/aztec-standards`、`yarn add @aztec-foundation/aztec-standards`、`bun add @aztec-foundation/aztec-standards`

## README

# 阿兹特克标准

[![npm version](https://img.shields.io/npm/v/@aztec-foundation/aztec-standards.svg)](https://www.npmjs.com/package/@aztec-foundation/aztec-standards)

阿兹特克标准(Aztec Standards)是阿兹特克网络的可再使用,标准化合同的综合集合. 它为象征原始物和公用事业奠定了坚实的基础,支持私人和公共业务,使开发者能够轻松地建立创新的隐私保护应用程序.

Npm 包件船编译了合同文物和类型Script 包件,但没有声明依赖性: 包件导入 `@aztec-labs/aztec.js` (Aztec 6 将 SDK 范围从 `@aztec/*`),所以在软件包的版本安装 `config.aztecVersion`。 。 。 .

## 安全状态:未审计

> \[尖叫声\] **此代码尚未审计 。 在生产中不要使用,也不要保证有价值资产的安全.**
> 
> 该存储库中的合同是正在积极开发的实验性未经审计的软件. 它们没有经过任何外部安全审查、审计或正式核查,它们可能含有错误、安全弱点或经济缺陷,可能导致无法挽回的资金损失.
> 
> 该软件是在“AS IS”基础上提供的,没有明示或暗示的任何类型的警告或条件(见 [自由主义](https://npmcn.com/package/%40aztec-foundation/aztec-standards/LICENSE)) (中文(简体) ). 部署或与这些合同互动的任何人都完全冒着风险这样做,并负责获得自己的独立安全审查。 没有说明该守则没有缺陷,在此不应作为安全、法律或财务建议.
> 
> 这项通知将在审计完成后予以更新.

## 发展

**先决条件**: 在单独的终端中启动 Aztec 本地网络 :

```bash
aztec start --local-network
```

**测试**数字 : `yarn test` nOIR和JS测试。 JS测试预计网络运行于 `http://localhost:8080` (或 `NODE_URL`) (中文(简体) ).

**基准**数字 : `yarn bench` 连接到同一个运行中的网络.

设定 `NODE_URL` 以覆盖默认值(例如). `http://localhost:9000`) (中文(简体) ).

## 目录

-   [安全状况:未审计](https://npmcn.com/package/%40aztec-foundation/aztec-standards/#readme-%EF%B8%8F-security-status-unaudited)
-   [发展](https://npmcn.com/package/%40aztec-foundation/aztec-standards/#readme-development)
-   [标准命名( AIP vs ARC)](https://npmcn.com/package/%40aztec-foundation/aztec-standards/#readme-standards--naming-aip-vs-arc)
-   [钻井合同](https://npmcn.com/package/%40aztec-foundation/aztec-standards/#readme-dripper-contract)
-   [托肯合同](https://npmcn.com/package/%40aztec-foundation/aztec-standards/#readme-token-contract)
-   [多托肯合同](https://npmcn.com/package/%40aztec-foundation/aztec-standards/#readme-multitoken-contract)
-   [破损合同](https://npmcn.com/package/%40aztec-foundation/aztec-standards/#readme-vault-contract)
-   [故障部署合同](https://npmcn.com/package/%40aztec-foundation/aztec-standards/#readme-vault-deployer-contract)
-   [NFT合同](https://npmcn.com/package/%40aztec-foundation/aztec-standards/#readme-nft-contract)
-   [代理标准合同和库](https://npmcn.com/package/%40aztec-foundation/aztec-standards/#readme-escrow-standard-contract--library)
-   [范围和维护](https://npmcn.com/package/%40aztec-foundation/aztec-standards/#readme-scope--maintenance)
-   [许可证](https://npmcn.com/package/%40aztec-foundation/aztec-standards/#readme-license)

## 标准命名( AIP vs ARC)

有两个建议编号的音轨出现在这个存储处,它们不能互换:

-   **AIP - x 系统** - Aztec改进提案,作为关于 [阿兹特克论坛](https://forum.aztec.network/)。此寄存器执行 [AIP-20 (中文(简体) )](https://forum.aztec.network/t/request-for-comments-aip-20-aztec-token-standard/7737) (托肯语)和 [AIP-4626 (中文(简体) )](https://forum.aztec.network/t/request-for-comments-aip-4626-tokenized-vault/8079) (发作). 这两项草案都在讨论之中,没有批准标准.
-   **ARC- x 数据** ——阿兹特克征求意见请求,一个单独的音轨. 执行托肯和多托肯合同 [ARC-403 (韩语)](https://forum.aztec.network/t/arc-403-authtoken/7887),可选择的许可延期(通过外部授权合同对转让的遵守情况进行检查)。 ARC-403规格仍在积极讨论之中;这里的执行跟踪了草案。 犬钩界面位于 `src/arc403_interface`。 。 。 .

> \[叹息\] 这个 `Arc403Authorizer` 财务报告和审定财务报表 `Arc403MultiTokenAuthorizer` 随此包裹运送的文物 **有空体的接口根**它们的存在是为了定义ABI. 永远不要部署它们,不要用电线作为象征 `auth_contract` - 空钩子批准每个操作。 部署你自己的接口.

没有"AIP-403"——如果你见过这个名字,它指的是ARC-403.

## 钻井合同

这个 `Dripper` 合同提供了一种方便的水龙头机制,用于将信使放入私人或公共平衡。 任何人都可以轻易地援引这些功能,为测试或开发目的索取代币.

📖 **[查看详细的 Dripper 文档](https://npmcn.com/package/%40aztec-foundation/aztec-standards/src/dripper/README.md)**

## 托肯合同

这个 `Token` 合同执行一个类似 ERC-20 的代号,并带有阿兹特克特定隐私扩展. 它通过私人平衡和公共平衡明确支持转让和互动,全面涵盖阿兹特克的保密特征.

我们出版了 [AIP-20 阿兹特克托肯标准](https://forum.aztec.network/t/request-for-comments-aip-20-aztec-token-standard/7737) 给论坛。 随便你看看,然后讨论一下 符号可选择执行 [ARC-403 (韩语)](https://forum.aztec.network/t/arc-403-authtoken/7887) 授权钩 (草案).

📖 **[查看详细的托肯文档](https://npmcn.com/package/%40aztec-foundation/aztec-standards/src/token_contract/README.md)**

## 多托肯合同

这个 `MultiToken` 合同执行类似ERC-1155的多托肯(一个合同下的许多代号),并附有Aztec特有的隐私扩展:每个代号的私人和公共平衡,公/私人转让的部分注解承诺,以及 [ARC-403 (韩语)](https://forum.aztec.network/t/arc-403-authtoken/7887) 授权钩 (草案).

📖 **[查看详细的多功能文档](https://npmcn.com/package/%40aztec-foundation/aztec-standards/src/multitoken_contract/README.md)**

## 破损合同

这个 `Vault` 合同是一个独立的有收益的金库,它持有AIP-20基本资产,并向储户发放AIP-20股票代币。 保险库和股票代币是单独的合同——金库管理存款/提取/复制逻辑,同时将股票代币业务(薄荷、燃烧、转让)委托给外部的AIP-20 `Token` 合同配置为金库作为薄荷.

我们出版了 [AIP-4626: 托肯化地铁标准](https://forum.aztec.network/t/request-for-comments-aip-4626-tokenized-vault/8079) 给论坛。 随便你看看,然后讨论一下.

> \[尖叫声\] 断层是 **生产未就绪**即使按照这个仓库未经审计的标准 接触过 [配置 ARC-403 授权钩后, 相关资产符牌会重新存在](https://npmcn.com/package/%40aztec-foundation/aztec-standards/src/vault_contract/README.md) (其基于订单的保护并不存在,因为钩子运行) _期间_ 在余额转移之前,转出将停止在接近a处进行 `u128` 容量上限大于 `vault_offset` 并知道隐私的局限性。 目前没有定出任何修补计划——在包裹任何已上钩的符件或选择去除之前,请查看它的README.

📖 **[查看详细的默认文档](https://npmcn.com/package/%40aztec-foundation/aztec-standards/src/vault_contract/README.md)**

## 故障部署合同

这个 `VaultDeployer` 合同部署和联系a `Vault` 及其份额 `Token` 在一次交易中。 它作为工作存在到 [公共合同登记](https://github.com/AztecProtocol/aztec-packages/issues/20771) 没有它,就不能布设一个金库和它的股票代号,并进行解剖.

📖 **[查看详细的 Vault 部署器文档](https://npmcn.com/package/%40aztec-foundation/aztec-standards/src/vault_deployer/README.md)**

## NFT合同

这个 `NFT` 合同执行一种ERC-721式的不可反光符号,并带有阿兹特克特有的隐私扩展. 它通过私人和公共所有权支持转让和互动,为独特的数字资产全面提供Aztec的保密功能.

📖 **[查看详细的 NFT 文档](https://npmcn.com/package/%40aztec-foundation/aztec-standards/src/nft_contract/README.md)**

## 代理标准合同和库

代管标准包含两个要素:

-   代管合同(Escorrow Contract):一种最低限度的私人合同,旨在有钥匙,被授权的呼叫者可以将AIP-20信使和NFT合同的私人余额花在这个寄存处.
-   逻辑图书馆:一套合同图书馆方法,将另一合同(a.k.a.逻辑合同)的代管合同标准化并便利管理.

📖 **[查看详细的代管文档](https://npmcn.com/package/%40aztec-foundation/aztec-standards/src/escrow_contract/README.md)**

逻辑合同执行的例子,例如线性背包合同或回扣代管合同,见存档副本 [aztec-scrow-扩展](https://github.com/defi-wonderland/aztec-escrow-extensions) 寄存器,上次针对 Aztec 5.0.0-rc.1 构建.

## 范围和维护

上述合同是该存放处的完整和预定范围。 阿兹特克基金会维护它们(依赖性撞出,错误修正,光谱对齐),但 **没有规划新的标准,除非有明确的生态系统需求**如果您需要一个不在此地的标准——或者想要其中一个规格草案(AIP-20、AIP-4626、ARC-403)推动定稿——请在下文中这样说 [阿兹特克论坛](https://forum.aztec.network/) 或打开此寄存器上的 GitHub 问题 。 需求是建造东西的原因.

## 许可证

释放 [MIT 许可证](https://npmcn.com/package/%40aztec-foundation/aztec-standards/LICENSE). Wonderland最初开发了该项目,并于2026年将其版权分配给了Aztec基金会.

## 常见问题

### 如何安装 @aztec-foundation/aztec-standards？

在项目目录运行 npm install @aztec-foundation/aztec-standards，或使用 pnpm add / yarn add / bun add。

### @aztec-foundation/aztec-standards 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/aztec-foundation\_\_aztec-standards 是否存在。

### @aztec-foundation/aztec-standards 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @aztec-foundation/aztec-standards 可以商用吗？

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

### @aztec-foundation/aztec-standards 的下载量有多少？

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

### @aztec-foundation/aztec-standards 还在维护吗？

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