From 8a22e1fa902cbbb74c2676e0acab2203539ea12d Mon Sep 17 00:00:00 2001 From: NAC Admin Date: Fri, 6 Mar 2026 16:21:13 +0800 Subject: [PATCH] =?UTF-8?q?docs(acc):=20=E6=B7=BB=E5=8A=A0=20ACC=20?= =?UTF-8?q?=E5=8D=8F=E8=AE=AE=E6=97=8F=E5=AE=8C=E6=95=B4=E6=9D=83=E5=A8=81?= =?UTF-8?q?=E6=96=87=E6=A1=A3=20v2.0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 包含 19 个协议的完整说明： - 基础代币协议（5个）：ACC-20、ACC-20Enhanced、ACC-721、ACC-1155、ACC-20C - RWA 专用协议族（8个）：ACC-RWA、Compliance、Valuation、Custody、Collateral、Redemption、Insurance、Governance - 稳定币与储备协议（2个）：ACC-XTZH、ACC-Reserve - 证券代币协议族（5个）：ACC-1410、ACC-1400、ACC-1594、ACC-1643、ACC-1644 三层架构（L1 nac-udm + L2 charter-std + L3 nac-sdk）全部编译通过（0 errors） --- docs/protocols/ACC_PROTOCOL_FAMILY.md | 184 ++++++++++++++++++++++++++ 1 file changed, 184 insertions(+) create mode 100644 docs/protocols/ACC_PROTOCOL_FAMILY.md diff --git a/docs/protocols/ACC_PROTOCOL_FAMILY.md b/docs/protocols/ACC_PROTOCOL_FAMILY.md new file mode 100644 index 0000000..87076f1 --- /dev/null +++ b/docs/protocols/ACC_PROTOCOL_FAMILY.md @@ -0,0 +1,184 @@ +# NAC ACC 协议族完整清单 + +> 文档版本：v2.0 | 更新日期：2026-03-06 | 编译状态：全部通过（0 errors） + +## 概述 + +ACC（Asset Compliance Contract）协议族是 NAC 公链的核心资产协议标准，完全基于 NAC 原生技术栈开发，不继承、不模仿任何以太坊/ERC 标准。 + +**核心设计原则：** +- 使用 NAC 原生类型系统（Address 32字节，Hash 48字节 SHA3-384） +- 使用 CBPP 执行上下文（非 msg.sender） +- 使用 ConstitutionalReceipt 作为每次操作的宪法凭证 +- 使用 GNACSCode 作为资产全球分类编码 +- 使用 CSNP 网络层广播协议事件 +- 使用 CNNL 神经网络语言接口（AI 合规/估值） + +--- + +## 三层架构 + +| 层级 | 模块 | 职责 | +|------|------|------| +| **L1 协议定义层** | `nac-udm/src/l1_protocol/acc/` | Rust 完整实现，协议逻辑 | +| **L2 Charter 标准库** | `charter-std/acc/` | Charter 语言接口（.ch 文件） | +| **L3 开发者 SDK** | `nac-sdk/src/protocols/` | NRPC4.0 客户端接口 | + +--- + +## 第一组：基础代币协议（5个） + +### ACC-20 — 同质化代币标准 +- **文件**：`acc20.rs`（164行） +- **核心结构**：`ACC20Token` +- **功能**：transfer、approve、mint、burn、holdings 查询 +- **状态**：✅ 完整 + +### ACC-20 Enhanced — 增强型同质化代币 +- **文件**：`acc20_enhanced.rs`（994行） +- **核心结构**：`ACC20Enhanced` +- **功能**：GNACS 分类、主权授权、AI 合规验证、AI 估值、碎片化、冻结/解冻、跨链桥接 +- **状态**：✅ 完整（参考实现） + +### ACC-721 — 唯一资产证书 +- **文件**：`acc721.rs`（487行） +- **核心结构**：`ACC721Certificate` +- **功能**：AssetDNA、AI 估值、托管、保险、碎片化、元数据管理 +- **状态**：✅ 完整 + +### ACC-1155 — 多代币标准 +- **文件**：`acc1155.rs`（254行） +- **核心结构**：`ACC1155` +- **功能**：Fungible/NFT 混合、批量操作 +- **状态**：⚠️ 基础版（可用，待增强） + +### ACC-20C — 兼容层协议 +- **文件**：`acc20c.rs` +- **功能**：为旧版 ACC-20 合约提供向后兼容接口 +- **状态**：✅ 完整 + +--- + +## 第二组：RWA 专用协议族（8个） + +### ACC-RWA — 真实世界资产主协议 +- **文件**：`acc_rwa.rs`（L1: 完整实现，L3: AccRwaClient） +- **功能**：资产注册（含 GNACS 编码、司法管辖区、法律文件哈希、AI 合规分数）、资产转移、冻结/解冻、持仓查询 +- **状态**：✅ 完整 + +### ACC-Compliance — 七层合规验证协议 +- **文件**：`acc_compliance.rs`（L1: 完整实现，L3: AccComplianceClient） +- **七层验证**：身份合规、资产合规、交易合规、监管合规、跨境合规、反洗钱、AI 合规 +- **状态**：✅ 完整 + +### ACC-Valuation — AI 估值协议 +- **文件**：`acc_valuation.rs`（L1: 完整实现，L3: AccValuationClient） +- **功能**：AI 实时估值、历史估值记录、多司法管辖区估值、XTZH 计价 +- **状态**：✅ 完整 + +### ACC-Custody — 资产托管协议 +- **文件**：`acc_custody.rs`（L1: 完整实现，L3: AccCustodyClient） +- **功能**：创建托管、托管转移、托管释放、托管记录查询 +- **状态**：✅ 完整 + +### ACC-Collateral — 抵押品管理协议 +- **文件**：`acc_collateral.rs`（L1: 完整实现，L3: AccCollateralClient） +- **功能**：锁定抵押品、抵押品估值、释放抵押品、清算抵押品 +- **状态**：✅ 完整 + +### ACC-Redemption — 赎回协议 +- **文件**：`acc_redemption.rs`（L1: 完整实现，L3: AccRedemptionClient） +- **功能**：申请赎回、批准赎回、取消赎回、赎回历史查询 +- **状态**：✅ 完整 + +### ACC-Insurance — 资产保险协议 +- **文件**：`acc_insurance.rs`（L1: 完整实现，L3: AccInsuranceClient） +- **功能**：创建保险策略、理赔申请、理赔处理、保险历史查询 +- **状态**：✅ 完整 + +### ACC-Governance — 治理协议 +- **文件**：`acc_governance.rs`（L1: 完整实现，L3: AccGovernanceClient） +- **功能**：创建提案、投票、执行提案、提案历史查询 +- **状态**：✅ 完整 + +--- + +## 第三组：稳定币与储备协议（2个） + +### ACC-XTZH — XTZH 稳定币协议 +- **文件**：`acc_xtzh.rs`（L1: 完整实现，L3: AccXtzhClient） +- **功能**：SDR 锚定汇率查询、XTZH 铸造、XTZH 赎回、储备率查询 +- **XTZH 锚定机制**：SDR 篮子（USD 41.73% + EUR 30.93% + CNY 10.92% + JPY 8.33% + GBP 8.09%）+ 黄金储备保障 +- **状态**：✅ 完整 + +### ACC-Reserve — 储备管理协议 +- **文件**：`acc_reserve.rs`（L1: 完整实现，L3: AccReserveClient） +- **功能**：储备信息查询、增加储备、提取储备、储备构成查询 +- **状态**：✅ 完整 + +--- + +## 第四组：证券代币协议族（5个） + +### ACC-1410 — 分区代币协议 +- **文件**：`acc1410/`（10个子文件，L3: Acc1410Client） +- **分区类型**：CommonStock、PreferredStock、RestrictedStock、EmployeeOption、IncomeRight、VotingRight +- **功能**：分区余额查询、分区间转账、创建分区、批量操作、事件通知 +- **状态**：✅ 完整 + +### ACC-1400 — 证券代币协议 +- **文件**：`acc1400/`（6个子文件，L3: Acc1400Client） +- **功能**：证券发行、合规转让、can_transfer 验证、股息分配 +- **状态**：✅ 完整 + +### ACC-1594 — 收益分配协议 +- **文件**：`acc1594/`（4个子文件，L3: Acc1594Client） +- **功能**：收益分配、待领取收益查询、收益领取 +- **状态**：✅ 完整 + +### ACC-1643 — 文档管理协议 +- **文件**：`acc1643/`（4个子文件，L3: Acc1643Client） +- **功能**：链上文档存储、文档版本控制、文档查询、文档删除 +- **状态**：✅ 完整 + +### ACC-1644 — 监管控制协议 +- **文件**：`acc1644/`（4个子文件，L3: Acc1644Client） +- **功能**：账户冻结/解冻、强制转移（监管命令）、冻结状态查询 +- **状态**：✅ 完整 + +--- + +## 编译状态汇总 + +| 模块 | 编译状态 | 错误数 | 备注 | +|------|----------|--------|------| +| nac-udm（L1 协议定义） | ✅ Finished | 0 | 155 warnings（正常） | +| charter-std（L2 Charter 库） | ✅ Finished | 0 | | +| nac-sdk（L3 SDK） | ✅ Finished | 0 | | +| charter-compiler | ✅ Finished | 0 | 新增 ACC 类型操作码 | + +--- + +## 依赖关系图 + +``` +ACC-1594 → ACC-1410 + ACC-1400 +ACC-1400 → ACC-1410 +ACC-RWA → ACC-Compliance + ACC-Valuation +ACC-XTZH → ACC-Reserve +ACC-20Enhanced → GNACS + CNNL + CBPP +所有协议 → nac-udm::primitives (Address, Hash, Timestamp) +所有协议 → CBPP ExecutionContext +所有协议 → CSNP ProtocolEvent +``` + +--- + +## 变更历史 + +| 日期 | 变更内容 | +|------|----------| +| 2026-03-06 | 完成所有 19 个协议的三层实现，修复所有编译错误，推送到 Gitea | +| 2026-03-06 | 将 nac-acc-1400/1410/1594/1643/1644 五个独立模块整合进入 nac-udm | +| 2026-03-06 | 补全 8 个 RWA 骨架协议为完整实现 | +| 2026-03-06 | 补全 2 个稳定币/储备协议为完整实现 |