# @chainlink/ace 中文文档 规范地址：https://npmcn.com/package/%40chainlink/ace/ 版本：1\.2\.0 npm 元数据更新时间：2026-08-03T20:01:30.673Z 中文译文更新时间：2026-11-09T09:33:12.171Z 软件包许可：BUSL-1\.1 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40chainlink/ace 原文对照：https://npmcn.com/package/%40chainlink/ace/?lang=original 项目主页：https://github.com/smartcontractkit/chainlink-ace#readme 源码仓库：https://github.com/smartcontractkit/chainlink-ace ## 关键信息（来自 npm 元数据） - 包体积（解压后）：1.4 MB，203 个文件 - TypeScript 类型：未声明 - 运行依赖：0 个 - 首次发布：2026-01-20T21:02:35.781Z - 最新版本发布：2026-07-23T21:29:13.777Z - 近 30 天下载量：7495（2026-10-10 至 2026-11-08，npm 官方下载统计） - 已发布版本数：4（近 12 个月 4 个） ## 中文简介 链路自动合规引擎合同 ## 安装 ```sh npm install @chainlink/ace ``` 也可以使用：`pnpm add @chainlink/ace`、`yarn add @chainlink/ace`、`bun add @chainlink/ace` ## README ![Chainlink](https://npmcn.com/package/%40chainlink/ace/assets/chainlink-logo.svg) # ACE核心合同 **利用可编程的、跨链的合规性——由链路自动合规引擎(ACE)驱动,构建下一代财务应用程序.** ## 什么问题能解决? 在区块链上建立符合要求的应用程序需要处理: - **动态政策执行** ——不重新部署核心申请合同 - **身份核查** 跨越链条,没有零碎的证书 - **信任的外部数据** (KYC提供商、制裁清单、价格信息、储备证明等) ## 您的模块工具箱 | 构成部分 | 说明 | 依赖关系 | | --- | --- | --- | | **政策管理** | 动态引擎以创建和执行链上规则. | 独立 | | **跨海峡身份** | EVM链的可移植身份系统;一次附加证书,在任何地方验证. | 需要政策管理 | ## 关键特性 - **模块可编译( C)**:使用一个或全部三个组件。 它们被设计成无缝合作. - **未来证明**:通过更新政策来适应新条例,而不是你的核心应用逻辑. - **跨天准备**: 统一管理多个EVM网络的身份和合规性. - **通过设计保存隐私**: 将敏感的用户数据放出链外,同时验证链上的资格. - **备用政策**: 容量限制和授权等常见合规情景的插件和游戏模块. - **EVM 兼容性**: 与现有工具相配合,支持ZK证明等未来创新. ## 如何发挥作用:一个真实世界的例子 这些组件是如何一起工作的。 想象一下 **艾玛** (机构投资者)想买 **5万美元** 页:1 **结识债券** 在一个DEX. ```mermaid graph TB subgraph "External World" KYC["KYC Provider
✅ Emma: Verified"] Oracle["Bond Price Feed
📊 Current: $1.02"] AML["AML Watchlist
🔍 Emma: Clean"] end subgraph "Chainlink ACE Modular Toolkit" subgraph "Cross-Chain Identity" CCID["Emma's Identity
ID: 0x1a2b... (Portable)"] CredReg["Credentials
✅ KYC ✅ Accredited"] end subgraph "Policy Management ⚙️" PE["Policy Engine
🧠 Decision Maker"] P1["Access Policy
❓ Verified & not sanctioned?"] P2["Volume Rate Policy
❓ $50k within daily limit?"] end end subgraph "Emma's Transaction" Emma["👩‍💼 Emma
Wants: $50k bonds"] BondDEX["Bond DEX
🏦 Tokenized Bonds"] Result["✅ Trade Approved"] end %% Data flows KYC -.->|"Issues Credential"| CredReg Oracle -.->|"Provides Data"| Registry AML -.->|"Provides Data"| Registry %% Transaction flow Emma -->|"1. Buy Bonds"| BondDEX BondDEX -->|"2. Validate Tx"| PE %% Policy Engine orchestration PE --> P1 PE --> P2 %% Policy checks using other components P1 -->|"Checks"| CredReg P1 -->|"Uses"| Registry P2 -->|"Uses"| Registry %% Completion PE -->|"3. All checks pass"| BondDEX BondDEX -->|"4. Execute Trade"| Result classDef default fill:#2b2f37,stroke:#c0c5ce,stroke-width:1px,color:#c0c5ce classDef external fill:#4338ca,stroke:#a5b4fc,stroke-width:1px,color:#e0e7ff classDef user fill:#166534,stroke:#4ade80,stroke-width:1px,color:#dcfce7 classDef result fill:#be123c,stroke:#fda4af,stroke-width:1px,color:#ffe4e6 class KYC,Oracle,AML external class Emma,Result user ``` ### 遵义之行:分步走 1. **启动交易**Emma提交了DEX的购货订单. 执行前,DEX的智能合同称 **政策引擎** 以验证交易. 2. **访问策略执行**: 政策引擎执行 `Access Policy`,使用 **跨海峡身份** 核实Emma所需全权证书的构成部分`✅ KYC`, (中文(简体) ), `✅ Accredited`) (中文(简体) ). _关键是,即使艾玛在不同的EVM链上使用不同的钱包地址,这种相同的身份和证书也是有效的._ 3. **量率政策执行**:接下来,引擎运行 `Volume Rate Policy`追踪艾玛的交易量 证实5万美金的交易量在她每天的限额之内. 4. **核准交易**: 随着所有政策的通过,政策引擎允许交易继续进行. DEX执行交易,艾玛收到她象征性的债券. _这种模式的威力是,如果明天法规改变,DEX的所有人可以增加新的政策(如"时事政策")而不必重新部署或改变主要的DEX合同._ 如果政策检查失败 **政策引擎会直接归还交易**防止出现不符合要求的贸易. ## 准备好了吗? ### 新到ACE吗? 从这里开始 **立即动手.** 我们的初学者友好的General Started Guide用一个简单、工作的例子来引导你通过核心模式. **→ [启动“ 启动指南”](https://npmcn.com/package/%40chainlink/ace/getting_started/GETTING_STARTED.md)** * * * ### 提升现有合同? **已经签了合同** 您想要添加 ACE 合规性 ? 我们的升级指南 让你一步一步地完成这个过程. **最佳服务:** 现有已部署合同(电话、金库、DEX等)的团队需要增加政策合规性. **→ [升级指南](https://npmcn.com/package/%40chainlink/ace/UPGRADE_GUIDE.md)** ### 需要身份验证吗 ? **在完成基本指南之后**更新我们的《先进创业指南》 以KYC检查、制裁筛选和身份管理为主. **最佳服务:** 需要用户核查、经认证的投资人检查或跨链身份的应用程序. **→ [高级启动指南](https://npmcn.com/package/%40chainlink/ace/getting_started/advanced/GETTING_STARTED_ADVANCED.md)** * * * ### 想要研究生产准备的例子吗? 以我们的参考执行作为你们的基础,充满信心地建设起来. **最佳服务:** 有经验的开发者想研究已审计代码并适应他们的需要. - **研究每个组成部分的参考执行情况:** - [政策管理](https://npmcn.com/package/%40chainlink/ace/packages/policy-management/src) - [跨海峡身份](https://npmcn.com/package/%40chainlink/ace/packages/cross-chain-identity/src) - **参见在 [示例符号](https://npmcn.com/package/%40chainlink/ace/packages/tokens)** * * * ### 要先了解建筑吗? 在潜入执行前先了解设计. **继续阅读以下各部分** ## 探索组件 ### 🛡️ [政策管理](https://npmcn.com/package/%40chainlink/ace/packages/policy-management/) 使用此组件执行可以更新的链上规则而无需重新部署您的核心合同 . - **政策引擎**:可累加,可调和的政策执行. - **0 向下更新**: 动态添加、删除或修改规则. - **备用政策**: 允许政策,卷政策,只允许奥纳政策等. **如何作为一个独立的组成部分运作:** ```mermaid graph LR App[Your Contract] -->|inherits| PP[PolicyProtected] App -->|calls| PE[PolicyEngine] PE -->|executes| P1[Policy 1] PE -->|executes| P2[Policy 2] PE -->|executes| P3[Policy N] ``` **使用大小写 :** 访问控制,音量限制,时间限制,可暂停功能,角色权限. → **[QQ 快导](https://npmcn.com/package/%40chainlink/ace/packages/policy-management/README.md)** | **[参考执行](https://npmcn.com/package/%40chainlink/ace/packages/policy-management/src/)** | **[深海潜水器](https://npmcn.com/package/%40chainlink/ace/packages/policy-management/docs/)** | **[\* 准备使用的政策](https://npmcn.com/package/%40chainlink/ace/packages/policy-management/src/policies/README.md)** ### 🔗 [跨海峡身份](https://npmcn.com/package/%40chainlink/ace/packages/cross-chain-identity/) 使用此组件将钱包地址链接到一个单一的身份,并管理像KYC/AML这样的证书. - **洲际身份证(CCID)**: 连接多个链条地址的单一标识符. - **全权证书**:管理直接与用户的CCID绑定的证书(如KYC,AML等). - **隐私第一**:在链外存储敏感数据,只将链上散去. > **要求:** 政策管理部分(上列) **它如何与政策管理相结合:** ```mermaid graph TB App[Your Contract] -->|inherits| PP[PolicyProtected] App -->|calls| PE[PolicyEngine] PE -->|executes| IVP[CredentialRegistryIdentityValidatorPolicy
(single requirement set)] PE -->|executes| GIVP[GroupedIdentityValidatorPolicy
(segmented requirements)] PE -->|executes| SP[SanctionsPolicy] PE -->|executes| OP[Other Policies] IVP -->|reads from| IR[IdentityRegistry] IVP -->|reads from| CR[CredentialRegistry] GIVP -->|routes + reads from| IR GIVP -->|routes + reads from| CR SP -->|reads from| SL[Sanctions List] ``` **使用大小写 :** KYC/AML核查,认证投资人检查,跨链证书核查,制裁筛选. → **[QQ 快导](https://npmcn.com/package/%40chainlink/ace/packages/cross-chain-identity/README.md)** | **[参考执行](https://npmcn.com/package/%40chainlink/ace/packages/cross-chain-identity/src/)** | **[深海潜水器](https://npmcn.com/package/%40chainlink/ace/packages/cross-chain-identity/docs/)** ## [示例键](https://npmcn.com/package/%40chainlink/ace/packages/tokens/) 探索我们的标语合同,看看这些组件是如何在真正的应用中一起工作的. - **[ERC-20 合规托肯](https://npmcn.com/package/%40chainlink/ace/packages/tokens/erc-20)** - 政策保护的ERC-20执行,高级冷冻物品处理 - **[ERC-3643 合规托肯](https://npmcn.com/package/%40chainlink/ace/packages/tokens/erc-3643)** - 执行ERC-3643 T-REX标准 > **关于冻死Token行为的重要说明:** > 在烧伤和强制转移时,这两种象征性的执行处理被冻结的活物的方式不同: > > - **ERC-20 区域**: 在烧伤/武力转移期间被冻结的活物仍被冻结。 这个 `_checkFrozenBalance()` 函数确保在操作开始前有足够的解冻令牌. > - **ERC-3643 (韩语)**: 烧伤/武力转移期间根据需要自动解冻令牌以完成操作. > > 两种方法都是有效的设计选择,取决于您的合规要求. 选择最适合您的使用例的执行 . ## 反馈( R) 我们欢迎社区 **反馈、审计和贡献**。如果对新功能有额外的遵守要求或想法,请随意提出扩展或新模块. ## 常见问题 ### @chainlink/ace 是什么？ 链路自动合规引擎合同 ### 如何安装 @chainlink/ace？ 在项目目录运行 npm install @chainlink/ace，或使用 pnpm add / yarn add / bun add。 ### @chainlink/ace 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/chainlink\_\_ace 是否存在。 ### @chainlink/ace 可以商用吗？ @chainlink/ace 使用 BUSL-1\.1 许可。声明的许可为 BUSL-1\.1，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。 ### @chainlink/ace 的下载量有多少？ 根据 npm 官方下载统计，@chainlink/ace 在 2026/10/10 – 2026/11/08 这 30 天内被下载 7,495 次，日均约 250 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @chainlink/ace 还在维护吗？ 最新版本 1\.2\.0 发布于 2026/07/24（3 个月前）；至今共发布 4 个版本，其中过去 12 个月发布了 4 个；首次发布于 2026/01/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。