374 lines
12 KiB
Markdown
374 lines
12 KiB
Markdown
# 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
|
||
|
||
```bash
|
||
cd NAC_Clean_Dev/nac-udm
|
||
cargo build --release
|
||
cargo test
|
||
```
|
||
|
||
### 编译Charter编译器
|
||
|
||
```bash
|
||
cd NAC_Clean_Dev/charter-compiler
|
||
cargo build --release
|
||
```
|
||
|
||
### 编译Charter标准库
|
||
|
||
```bash
|
||
cd NAC_Clean_Dev/charter-compiler
|
||
./target/release/charter-compiler ../charter-std/acc/acc20_enhanced.ch
|
||
```
|
||
|
||
### 运行示例
|
||
|
||
```bash
|
||
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）
|
||
|
||
- [x] NAC_UDM三层架构
|
||
- [x] GNACS编码系统
|
||
- [x] ACC协议族
|
||
- [x] Charter标准库（17个模块）
|
||
- [x] ACC-20增强版
|
||
- [x] ACC-20C兼容层
|
||
- [x] 主权管理系统
|
||
- [x] Charter编译器
|
||
- [x] NVM虚拟机
|
||
|
||
### 🔄 进行中（v2.1.0）
|
||
|
||
- [ ] CBPP共识完整实现
|
||
- [ ] CSNP网络协议
|
||
- [ ] 量子浏览器
|
||
- [ ] NRPC3.0
|
||
- [ ] XTZH稳定币机制
|
||
|
||
### 📋 计划中（v3.0.0）
|
||
|
||
- [ ] 七层合规验证框架
|
||
- [ ] AI合规检查引擎
|
||
- [ ] AI估值引擎
|
||
- [ ] 跨链桥接网络
|
||
- [ ] NAC原生钱包
|
||
- [ ] NAC原生交易市场
|
||
|
||
---
|
||
|
||
## 技术支持
|
||
|
||
### 文档
|
||
|
||
- [Charter语言规范](./CHARTER_LANGUAGE_SPECIFICATION.md)
|
||
- [NAC核心原则](../memory/principles/nac_core_principles.md)
|
||
- [开发决策记录](../memory/decisions/)
|
||
|
||
### 示例
|
||
|
||
- [ACC-20增强版完整示例](../examples/acc20_enhanced_complete_example.ch)
|
||
- [上海办公室股权示例](../examples/shanghai_office.charter)
|
||
|
||
### 记忆系统
|
||
|
||
- [NAC核心原则](../memory/principles/)
|
||
- [开发决策](../memory/decisions/)
|
||
- [技术债务](../memory/technical_debt/)
|
||
|
||
---
|
||
|
||
## 许可证
|
||
|
||
MIT License
|
||
|
||
---
|
||
|
||
## 贡献者
|
||
|
||
NewAssetChain Team
|
||
|
||
---
|
||
|
||
**最后更新**: 2026年2月7日
|
||
**文档版本**: v2.0.0
|