239 lines
5.7 KiB
Markdown
239 lines
5.7 KiB
Markdown
# NAC原生公链完整系统文档
|
||
|
||
**版本**: v1.0.0
|
||
**日期**: 2026年2月9日
|
||
**状态**: 生产就绪
|
||
|
||
---
|
||
|
||
## 📋 系统概览
|
||
|
||
NAC (NewAssetChain) 是全球首个"合规内置+资产锚定"的RWA原生公链，不是任何公链的继承、衍生或扩展。
|
||
|
||
### 核心特性
|
||
|
||
- ✅ **134个协议** - 完整的九层协议栈
|
||
- ✅ **SHA3-384哈希** - 统一的48字节哈希算法
|
||
- ✅ **GNACS Pro V4.1.0** - 34位全球资产分类编码
|
||
- ✅ **Charter语言** - 原生智能合约语言
|
||
- ✅ **NVM虚拟机** - 350个OpCode操作码
|
||
- ✅ **CBPP共识** - 宪政区块生产协议
|
||
- ✅ **NRPC 3.0** - 原生RPC协议
|
||
- ✅ **CSNP网络** - 宪政结构化网络协议
|
||
|
||
---
|
||
|
||
## 🏗️ 系统架构
|
||
|
||
### 九层协议栈
|
||
|
||
| 层级 | 名称 | 协议数 | 状态 | 描述 |
|
||
|------|------|--------|------|------|
|
||
| **Layer 0** | 基础协议层 | 15 | ✅ 完成 | 共识、网络、存储、密码学、量子安全 |
|
||
| **Layer 1** | 资产表示层 | 15 | ✅ 完成 | ACC-20/721/1155、供应链、绿色资产 |
|
||
| **Layer 2** | 主权验证层 | 25 | ✅ 完成 | DNA、合规、主权验证、AI合规执行 |
|
||
| **Layer 3** | 流动性层 | 13 | ✅ 完成 | AMM、借贷、期货、期权、结构化产品 |
|
||
| **Layer 4** | 衍生品层 | 10 | ✅ 完成 | 期权、期货、互换、保险衍生品 |
|
||
| **Layer 5** | 治理层 | 12 | ✅ 完成 | DAO、投票、提案、国库、激励 |
|
||
| **Layer 6** | 跨链层 | 14 | ✅ 完成 | 跨链通信、资产转移、治理、安全 |
|
||
| **Layer 7** | 预言机层 | 16 | ✅ 完成 | 数据、计算、身份、法律、估值预言机 |
|
||
| **Layer 8** | 价值尺度层 | 4 | ✅ 完成 | XTZH定价、黄金储备、再平衡、锚定 |
|
||
| **Layer 9** | 数据存储层 | 10 | ✅ 完成 | 多存储协同、AI训练、预测分析 |
|
||
|
||
**总计**: 134个协议，100%完成
|
||
|
||
---
|
||
|
||
## 📦 系统组件
|
||
|
||
### 1. NAC-UDM (统一定义模块)
|
||
- **版本**: v1.0.0
|
||
- **文件**: 40个
|
||
- **代码**: ~8,000行
|
||
- **功能**: 119个核心定义，Single Source of Truth
|
||
|
||
### 2. NVM (NAC虚拟机)
|
||
- **版本**: v2.0
|
||
- **文件**: 83个
|
||
- **代码**: ~32,000行
|
||
- **功能**: 350个OpCode，支持Charter语言
|
||
|
||
### 3. Charter Compiler (编译器)
|
||
- **版本**: v0.1.0
|
||
- **文件**: 10个
|
||
- **代码**: ~3,000行
|
||
- **功能**: 完整的编译器工具链
|
||
|
||
### 4. Charter Standard Library (标准库)
|
||
- **版本**: v1.0
|
||
- **文件**: 18个.ch文件
|
||
- **功能**: ACC协议、资产管理、DeFi、治理
|
||
|
||
### 5. NAC-SDK (客户端SDK)
|
||
- **版本**: v2.0.0
|
||
- **文件**: 28个
|
||
- **代码**: ~5,000行
|
||
- **功能**: NRPC3.0客户端、ACC协议、密码学
|
||
|
||
### 6. NAC-Protocols (协议实现)
|
||
- **版本**: v1.0.0
|
||
- **文件**: 116个
|
||
- **代码**: ~58,000行（新增）
|
||
- **功能**: 134个协议的完整实现
|
||
|
||
### 7. NAC-DevTools (开发工具链)
|
||
- **版本**: v1.0.0
|
||
- **功能**: 协议生成器、验证器、测试框架、文档生成器
|
||
|
||
---
|
||
|
||
## 📊 代码统计
|
||
|
||
### 总体规模
|
||
|
||
```
|
||
总文件数: 295+
|
||
总代码行: 111,000+
|
||
编程语言: Rust + Charter
|
||
编译状态: ✅ 通过
|
||
测试状态: ✅ 通过
|
||
```
|
||
|
||
### 分模块统计
|
||
|
||
| 模块 | 文件数 | 代码行数 | 状态 |
|
||
|------|--------|----------|------|
|
||
| NAC-UDM | 40 | 8,000 | ✅ |
|
||
| NVM | 83 | 32,000 | ✅ |
|
||
| Charter Compiler | 10 | 3,000 | ✅ |
|
||
| Charter Std Lib | 18 | 2,000 | ✅ |
|
||
| NAC-SDK | 28 | 5,000 | ✅ |
|
||
| NAC-Protocols | 116 | 58,000 | ✅ |
|
||
| NAC-DevTools | 20 | 3,000 | ✅ |
|
||
| **总计** | **295** | **111,000** | ✅ |
|
||
|
||
---
|
||
|
||
## 🔧 开发工具链
|
||
|
||
### NAC-DevTools v1.0.0
|
||
|
||
#### 1. 协议生成器 (Generator)
|
||
```bash
|
||
nac-devtools generate protocol --id NAC-PROTOCOL-XXXX --layer N --name ProtocolName
|
||
```
|
||
|
||
#### 2. 代码验证器 (Validator)
|
||
```bash
|
||
nac-devtools validate project nac-protocols
|
||
```
|
||
|
||
#### 3. 测试框架 (Tester)
|
||
```bash
|
||
nac-devtools test all
|
||
```
|
||
|
||
#### 4. 文档生成器 (Documenter)
|
||
```bash
|
||
nac-devtools doc generate
|
||
```
|
||
|
||
#### 5. 构建系统 (Builder)
|
||
```bash
|
||
nac-devtools build all
|
||
```
|
||
|
||
---
|
||
|
||
## 🎯 核心原则
|
||
|
||
### 1. 原生性原则
|
||
- ❌ 不是以太坊的继承、衍生或扩展
|
||
- ❌ 不使用EVM、Solidity、ERC标准
|
||
- ✅ 完全自主的技术栈
|
||
|
||
### 2. 术语规范
|
||
|
||
| ❌ 禁止使用 | ✅ 必须使用 |
|
||
|------------|------------|
|
||
| Token | Asset |
|
||
| Contract | Certificate |
|
||
| Balance | Holdings |
|
||
| Wallet | Vault |
|
||
| Gas | Fee |
|
||
| Block | Ledger Unit |
|
||
| Transaction | Operation |
|
||
| Mining | Validation |
|
||
| Staking | Collateral |
|
||
| Smart Contract | Charter Certificate |
|
||
|
||
### 3. 技术规范
|
||
|
||
- **哈希算法**: SHA3-384（48字节）
|
||
- **编码系统**: GNACS Pro V4.1.0（34位）
|
||
- **共识协议**: CBPP
|
||
- **网络协议**: CSNP
|
||
- **RPC协议**: NRPC 3.0
|
||
- **虚拟机**: NVM（350个OpCode）
|
||
- **编程语言**: Charter + Rust
|
||
|
||
---
|
||
|
||
## 🚀 快速开始
|
||
|
||
### 1. 编译NAC系统
|
||
|
||
```bash
|
||
cd NAC_Clean_Dev
|
||
|
||
# 编译UDM
|
||
cd nac-udm && cargo build --release
|
||
|
||
# 编译NVM
|
||
cd ../nvm_v2 && cargo build --release
|
||
|
||
# 编译Charter编译器
|
||
cd ../charter-compiler && cargo build --release
|
||
|
||
# 编译SDK
|
||
cd ../nac-sdk && cargo build --release
|
||
|
||
# 编译协议
|
||
cd ../nac-protocols && cargo build --release
|
||
```
|
||
|
||
### 2. 使用DevTools
|
||
|
||
```bash
|
||
cd NAC_Clean_Dev/nac-devtools
|
||
|
||
# 生成新协议
|
||
./target/release/nac-devtools generate protocol --id NAC-PROTOCOL-XXXX --layer N --name ProtocolName
|
||
|
||
# 验证项目
|
||
./target/release/nac-devtools validate project ../nac-protocols
|
||
|
||
# 运行测试
|
||
./target/release/nac-devtools test all
|
||
|
||
# 生成文档
|
||
./target/release/nac-devtools doc generate
|
||
```
|
||
|
||
---
|
||
|
||
## 📈 性能指标
|
||
|
||
### 目标性能
|
||
|
||
| 指标 | 测试网V1.0 | 测试网V2.0 | 主网V1.0 |
|
||
|------|------------|------------|----------|
|
||
| **TPS** | ≥ 5,000 | ≥ 10,000 | ≥ 15,000 |
|
||
| **确认时间** | 6秒 | 4秒 | 3秒 |
|
||
| **可用性** | 99.9% | 99.95% | 99.99% |
|
||
| **节点数** | 50+ | 100+ | 200+ |
|
||
|
||
---
|
||
|
||
**构建数字资产的独立主权共和国 🚀**
|