docs(acc): 添加 ACC 协议族完整权威文档 v2.0
包含 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）
This commit is contained in:
NAC Admin
parent
023a1b7926
commit
8a22e1fa90
|
|
@ -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 个稳定币/储备协议为完整实现 |
|
||||||
Loading…
Reference in New Issue