@chainlink/ace

中文文档
1.2.0发布于 2026/07/24BUSL-1.1零依赖构建来源已验证近 30 天下载 7495

链路自动合规引擎合同

中文使用文档
文档目录16 节
  1. 什么问题能解决?
  2. 您的模块工具箱
  3. 关键特性
  4. 如何发挥作用:一个真实世界的例子
  5. 遵义之行:分步走
  6. 准备好了吗?
  7. 新到ACE吗? 从这里开始
  8. 提升现有合同?
  9. 需要身份验证吗 ?
  10. 想要研究生产准备的例子吗?
  11. 要先了解建筑吗?
  12. 探索组件
  13. 🛡️ 政策管理
  14. 🔗 跨海峡身份
  15. 示例键
  16. 反馈( R)
Chainlink

ACE核心合同

利用可编程的、跨链的合规性——由链路自动合规引擎(ACE)驱动,构建下一代财务应用程序.

什么问题能解决?

在区块链上建立符合要求的应用程序需要处理:

  • 动态政策执行 ——不重新部署核心申请合同
  • 身份核查 跨越链条,没有零碎的证书
  • 信任的外部数据 (KYC提供商、制裁清单、价格信息、储备证明等)

您的模块工具箱

构成部分说明依赖关系
政策管理动态引擎以创建和执行链上规则.独立
跨海峡身份EVM链的可移植身份系统;一次附加证书,在任何地方验证.需要政策管理

关键特性

  • 模块可编译( C):使用一个或全部三个组件。 它们被设计成无缝合作.
  • 未来证明:通过更新政策来适应新条例,而不是你的核心应用逻辑.
  • 跨天准备: 统一管理多个EVM网络的身份和合规性.
  • 通过设计保存隐私: 将敏感的用户数据放出链外,同时验证链上的资格.
  • 备用政策: 容量限制和授权等常见合规情景的插件和游戏模块.
  • EVM 兼容性: 与现有工具相配合,支持ZK证明等未来创新.

如何发挥作用:一个真实世界的例子

这些组件是如何一起工作的。 想象一下 艾玛 (机构投资者)想买 5万美元 页:1 结识债券 在一个DEX.

graph TB
    subgraph "External World"
        KYC["<b>KYC Provider</b><br/>✅ Emma: Verified"]
        Oracle["<b>Bond Price Feed</b><br/>📊 Current: $1.02"]
        AML["<b>AML Watchlist</b><br/>🔍 Emma: Clean"]
    end

    subgraph "Chainlink ACE Modular Toolkit"
        subgraph "Cross-Chain Identity"
            CCID["<b>Emma's Identity</b><br/>ID: 0x1a2b... (Portable)"]
            CredReg["<b>Credentials</b><br/>✅ KYC ✅ Accredited"]
        end

        subgraph "Policy Management ⚙️"
            PE["<b>Policy Engine</b><br/>🧠 Decision Maker"]
            P1["<b>Access Policy</b><br/>❓ Verified & not sanctioned?"]
            P2["<b>Volume Rate Policy</b><br/>❓ $50k within daily limit?"]
        end

    end

    subgraph "Emma's Transaction"
        Emma["<b>👩‍💼 Emma</b><br/>Wants: $50k bonds"]
        BondDEX["<b>Bond DEX</b><br/>🏦 Tokenized Bonds"]
        Result["<b>✅ Trade Approved</b>"]
    end

    %% Data flows
    KYC -.->|"<b>Issues Credential</b>"| CredReg
    Oracle -.->|"<b>Provides Data</b>"| Registry
    AML -.->|"<b>Provides Data</b>"| Registry

    %% Transaction flow
    Emma -->|"<b>1. Buy Bonds</b>"| BondDEX
    BondDEX -->|"<b>2. Validate Tx</b>"| PE

    %% Policy Engine orchestration
    PE --> P1
    PE --> P2

    %% Policy checks using other components
    P1 -->|"Checks"| CredReg
    P1 -->|"Uses"| Registry
    P2 -->|"Uses"| Registry

    %% Completion
    PE -->|"<b>3. All checks pass</b>"| BondDEX
    BondDEX -->|"<b>4. Execute Trade</b>"| 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用一个简单、工作的例子来引导你通过核心模式.

→ 启动“ 启动指南”


提升现有合同?

已经签了合同 您想要添加 ACE 合规性 ? 我们的升级指南 让你一步一步地完成这个过程.

最佳服务: 现有已部署合同(电话、金库、DEX等)的团队需要增加政策合规性.

→ 升级指南

需要身份验证吗 ?

在完成基本指南之后更新我们的《先进创业指南》 以KYC检查、制裁筛选和身份管理为主.

最佳服务: 需要用户核查、经认证的投资人检查或跨链身份的应用程序.

→ 高级启动指南


想要研究生产准备的例子吗?

以我们的参考执行作为你们的基础,充满信心地建设起来.

最佳服务: 有经验的开发者想研究已审计代码并适应他们的需要.


要先了解建筑吗?

在潜入执行前先了解设计.

继续阅读以下各部分

探索组件

🛡️ 政策管理

使用此组件执行可以更新的链上规则而无需重新部署您的核心合同 .

  • 政策引擎:可累加,可调和的政策执行.
  • 0 向下更新: 动态添加、删除或修改规则.
  • 备用政策: 允许政策,卷政策,只允许奥纳政策等.

如何作为一个独立的组成部分运作:

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 快导 | 参考执行 | 深海潜水器 | * 准备使用的政策

🔗 跨海峡身份

使用此组件将钱包地址链接到一个单一的身份,并管理像KYC/AML这样的证书.

  • 洲际身份证(CCID): 连接多个链条地址的单一标识符.
  • 全权证书:管理直接与用户的CCID绑定的证书(如KYC,AML等).
  • 隐私第一:在链外存储敏感数据,只将链上散去.

要求: 政策管理部分(上列)

它如何与政策管理相结合:

graph TB
    App[Your Contract] -->|inherits| PP[PolicyProtected]
    App -->|calls| PE[PolicyEngine]
    PE -->|executes| IVP[CredentialRegistryIdentityValidatorPolicy<br/>(single requirement set)]
    PE -->|executes| GIVP[GroupedIdentityValidatorPolicy<br/>(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 快导 | 参考执行 | 深海潜水器

示例键

探索我们的标语合同,看看这些组件是如何在真正的应用中一起工作的.

关于冻死Token行为的重要说明:
在烧伤和强制转移时,这两种象征性的执行处理被冻结的活物的方式不同:

  • ERC-20 区域: 在烧伤/武力转移期间被冻结的活物仍被冻结。 这个 _checkFrozenBalance() 函数确保在操作开始前有足够的解冻令牌.
  • ERC-3643 (韩语): 烧伤/武力转移期间根据需要自动解冻令牌以完成操作.

两种方法都是有效的设计选择,取决于您的合规要求. 选择最适合您的使用例的执行 .

反馈( R)

我们欢迎社区 反馈、审计和贡献。如果对新功能有额外的遵守要求或想法,请随意提出扩展或新模块.

版本与发布记录

@chainlink/ace 共发布 4 个版本,首次发布于 2026/01/21;过去 12 个月发布了 4 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.2.0latest2026/07/243 个月前
1.1.12026/06/065 个月前
1.0.02026/02/069 个月前
0.5.02026/01/219 个月前

关于 @chainlink/ace 的常见问题

@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 和提交记录判断。