NAC_Blockchain/docs/NAC_Complete_Technical_Documentation.md

NAC原生技术栈完整技术文档

版本: v2.0.0
日期: 2026年2月7日
状态: ✅ 代码化完成

---

📋 目录

1. 项目概述
2. 技术架构
3. 核心组件
4. 代码统计
5. 使用指南
6. 开发路线图

---

项目概述

NAC (NewAssetChain) 是一条为RWA资产通证化打造的高性能原生区块链基础设施。本项目包含了NAC的完整技术栈实现，从底层虚拟机到上层智能合约语言，100%独立设计，0%以太坊依赖。

核心特性

• ✅ GNACS编码系统: 48位资产"数字基因"
• ✅ 主权管理: A0-G5七种主权类型
• ✅ 合规内置: KYC/AML/司法辖区验证
• ✅ ACC协议族: ACC-20/ACC-721/ACC-1155等
• ✅ Charter语言: RWA专用智能合约语言
• ✅ NVM虚拟机: NAC原生虚拟机
• ✅ CBPP共识: 宪政区块生产协议
• ✅ CSNP网络: 宪政结构化网络协议

---

技术架构

三层架构

┌─────────────────────────────────────────────────────────┐
│                  L2 治理层（Governance Layer）             │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  │
│  │  宪法框架    │  │  条款系统    │  │  规则引擎    │  │
│  └──────────────┘  └──────────────┘  └──────────────┘  │
│  ┌──────────────┐  ┌──────────────┐                    │
│  │  主权管理    │  │  CCRN中继    │                    │
│  └──────────────┘  └──────────────┘                    │
└─────────────────────────────────────────────────────────┘
                          ↕
┌─────────────────────────────────────────────────────────┐
│                  L1 协议层（Protocol Layer）               │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  │
│  │  ACC协议族   │  │  CBPP共识    │  │  GNACS编码   │  │
│  └──────────────┘  └──────────────┘  └──────────────┘  │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  │
│  │  NVM虚拟机   │  │  碎片化协议  │  │  ACC-20C     │  │
│  └──────────────┘  └──────────────┘  └──────────────┘  │
└─────────────────────────────────────────────────────────┘
                          ↕
┌─────────────────────────────────────────────────────────┐
│                  L0 原生层（Native Layer）                 │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  │
│  │  全局身份    │  │  资产注册    │  │  权限引擎    │  │
│  └──────────────┘  └──────────────┘  └──────────────┘  │
│  ┌──────────────┐  ┌──────────────┐                    │
│  │  碎片化网络  │  │  宪政账户    │                    │
│  └──────────────┘  └──────────────┘                    │
└─────────────────────────────────────────────────────────┘

---

核心组件

1. NAC_UDM (统一定义模块)

语言: Rust
代码量: 20,052行
文件数: 88个

功能:

• L0原生层实现
• L1协议层实现（ACC/CBPP/GNACS/NVM）
• L2治理层实现（宪法/主权/规则）
• L2网络层实现（CSNP）

新增模块（本次开发）:

• acc/acc20_enhanced.rs - GNACS增强版ACC-20（1,000+行）
• acc20c/wrapper.rs - ACC-20C包装器（537行）
• acc20c/sync_engine.rs - 状态同步引擎（695行）
• acc20c/metadata_generator.rs - 元数据生成器（328行）
• acc20c/permission_proxy.rs - 权限代理系统（481行）
• l2_governance/sovereignty_rules.rs - 主权规则系统（660行）
• l2_governance/sovereignty_history.rs - 主权历史追踪（441行）

2. Charter标准库

语言: Charter (.ch)
代码量: 11,266行
文件数: 17个

模块列表:

模块	文件	行数	功能
GNACS编码	asset/gnacs.ch	300	48位编码系统
主权规则	sovereignty/rules.ch	592	A0-G5主权类型
ACC-20标准	acc/acc20.ch	557	可替代资产协议
ACC-20增强版	acc/acc20_enhanced.ch	733	GNACS集成
ACC-20C兼容层	acc/acc20c.ch	584	跨链桥接
ACC-721标准	acc/acc721.ch	771	唯一资产协议
数学运算	utils/math.ch	476	安全算术
资产元数据	asset/metadata.ch	556	元数据管理
加密函数	utils/crypto.ch	380	Blake3哈希
资产生命周期	asset/lifecycle.ch	711	状态管理
链上登记	sovereignty/registry.ch	765	登记系统
合规检查	sovereignty/compliance.ch	837	KYC/AML
交易市场	defi/marketplace.ch	875	订单簿
借贷协议	defi/lending.ch	819	抵押借贷
流动性池	defi/liquidity.ch	810	AMM机制
投票系统	governance/voting.ch	771	链上投票
提案管理	governance/proposal.ch	729	提案系统

3. Charter编译器

语言: Rust
代码量: 2,647行
文件数: 7个

组件:

• 词法分析器（lexer.rs）
• 语法分析器（parser.rs）
• 语义分析器（semantic.rs）
• 代码生成器（codegen.rs）
• 优化器（optimizer.rs）
• PEG语法定义（charter.pest）

4. NVM_v2 (NAC虚拟机)

语言: Rust
代码量: 73,557行
文件数: 108个

特性:

• RWA专用操作码
• GNACS指令集
• 主权验证指令
• Gas计量系统
• 状态管理

---

代码统计

总代码量

组件	语言	文件数	代码行数
NAC_UDM	Rust	88	20,052
Charter标准库	Charter	17	11,266
Charter编译器	Rust	7	2,647
NVM_v2	Rust	108	73,557
总计		220	107,522

本次开发新增

阶段	组件	代码行数
阶段1	ACC-20增强版（Rust）	1,000+
阶段2	ACC-20C兼容层（Rust）	2,152
阶段3	主权管理系统（Rust）	1,221
阶段4	Charter标准库扩展	1,317
总计		5,690+

---

使用指南

编译NAC_UDM

cd NAC_Clean_Dev/nac-udm
cargo build --release
cargo test

编译Charter编译器

cd NAC_Clean_Dev/charter-compiler
cargo build --release

编译Charter标准库

cd NAC_Clean_Dev/charter-compiler
./target/release/charter-compiler ../charter-std/acc/acc20_enhanced.ch

运行示例

cd NAC_Clean_Dev
./charter-compiler/target/release/charter-compiler examples/acc20_enhanced_complete_example.ch

---

核心概念

GNACS编码

GNACS (Global NAC Asset Classification System) 是48位的资产"数字基因"：

┌─────────┬─────────┬─────────┬─────────┬─────────┬─────────┐
│ 大类(8) │ 子类(8) │ 辖区(8) │ 合规(8) │ 风险(8) │ 校验(8) │
└─────────┴─────────┴─────────┴─────────┴─────────┴─────────┘
   0-255     0-255     0-255     0-255     0-255     0-255

示例: 0x940101120187

• 94: 股权类资产
• 01: 商业地产股权
• 01: 中国司法辖区
• 12: 高合规要求
• 01: 中等风险
• 87: 校验和

主权类型

类型	名称	描述
A0	绝对所有权	完全控制权，无限制
B1	使用权	有期限的使用权利
C2	收益权	享有资产收益分配权
D0	担保主权	作为抵押品的权利
E3	知识产权	专利、版权、商标等
F4	临时监管权	托管期间的管理权
G5	共有权	多方共同所有

ACC-20C兼容层

ACC-20C是NAC与以太坊生态的战略桥梁：

NAC链                          以太坊链
┌──────────────┐              ┌──────────────┐
│ ACC-20资产   │              │ ERC-721 NFT  │
│              │  ──包装→     │              │
│ 1000股       │              │ TokenId: 1   │
│              │  ←─解包装─   │              │
└──────────────┘              └──────────────┘

包装流程:

1. 锁定NAC链上的ACC-20资产
2. 铸造以太坊链上的ERC-721 NFT
3. 生成符合OpenSea标准的元数据
4. 保持合规状态同步

解包装流程:

1. 验证以太坊链上的NFT所有权
2. 销毁ERC-721 NFT
3. 解锁NAC链上的ACC-20资产
4. 转移给接收者

---

NAC合规性

术语对照表

以太坊术语	NAC术语	说明
Token	Asset	资产
NFT	Certificate	凭证
Balance	Holdings	持有量
Account	Address	地址
Contract	Certificate	合约
SHA256/Keccak256	Blake3	哈希算法

禁止使用的术语

❌ ERC-20/ERC-721/ERC-1155
❌ Ethereum/EVM
❌ Solidity
❌ Token/NFT
❌ Balance
❌ Account

必须使用的术语

✅ ACC-20/ACC-721/ACC-1155
✅ NAC/NVM
✅ Charter
✅ Asset/Certificate
✅ Holdings
✅ Address

---

开发路线图

✅ 已完成（v2.0.0）

• NAC_UDM三层架构
• GNACS编码系统
• ACC协议族
• Charter标准库（17个模块）
• ACC-20增强版
• ACC-20C兼容层
• 主权管理系统
• Charter编译器
• NVM虚拟机

🔄 进行中（v2.1.0）

• CBPP共识完整实现
• CSNP网络协议
• 量子浏览器
• NAC Lens
• XTZH稳定币机制

📋 计划中（v3.0.0）

• 七层合规验证框架
• AI合规检查引擎
• AI估值引擎
• 跨链桥接网络
• NAC原生钱包
• NAC原生交易市场

---

技术支持

文档

• Charter语言规范
• NAC核心原则
• 开发决策记录

示例

• ACC-20增强版完整示例
• 上海办公室股权示例

记忆系统

• NAC核心原则
• 开发决策
• 技术债务

---

许可证

MIT License

---

贡献者

NewAssetChain Team

---

最后更新: 2026年2月7日
文档版本: v2.0.0