# 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 个稳定币/储备协议为完整实现 |