# NAC Blockchain - NewAssetChain 原生公链

[![Rust](https://img.shields.io/badge/rust-1.70%2B-orange.svg)](https://www.rust-lang.org/)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Tests](https://img.shields.io/badge/tests-147%20passed-brightgreen.svg)](tests/)

**NAC (NewAssetChain)** 是一条专为RWA（真实世界资产）通证化打造的高性能原生区块链基础设施。基于CBPP共识协议，集成XTZH黄金储备机制和GNACS资产分类编码系统，为资产数字化提供完整的主权级解决方案。

## 🌟 核心特性

### 完全原生架构
- ❌ **不使用任何ERC标准**（ERC-20、ERC-721、ERC-1155等）
- ❌ **不继承以太坊或其他链的实现**
- ✅ **100% Rust原生开发**
- ✅ **专注于RWA应用场景**

### CBPP共识协议
- **宪法收据（CR）**: 主权级合规验证层
- **开放生产网络（OPN）**: 去中心化生产者网络
- **流体区块模型（FBM）**: 三维区块坐标(Epoch, Round, Branch)支持DAG并行

### XTZH价值尺度
- **SDR锚定**: 与国际货币基金组织特别提款权挂钩
- **黄金储备**: 62.5%实物黄金支撑，1.25倍杠杆
- **双层稳定**: 链上质押 + 链下实物储备

### GNACS编码系统
- **30位编码**: 完整的资产分类编码体系
- **20+资产类别**: 涵盖不动产、动产、金融资产等
- **60+司法辖区**: 全球主要市场合规支持

## 📊 性能指标

| 指标 | 数值 |
|------|------|
| TPS（吞吐量） | 3,000+ |
| 区块确认时间 | 6秒 |
| 交易成功率 | 99.9% |
| 支持司法辖区 | 60+ |
| 资产类别 | 20+ |

## 🏗️ 架构设计

### Phase 14: 主权验证层
- 宪法执行引擎（CEE）- 10种规则验证类型
- DID+KYC系统 - 5级验证，AML检查
- XIC治理系统 - 8种提案类型，投票委托
- ACC-Minting协议 - RWA资产铸造（非ERC-721）
- ACC-CrossChain协议 - 跨链桥接

**代码**: 2,860行 | **测试**: 62个 ✅

### Phase 15: 价值尺度层
- XTZH质押机制 - SDR锚定，黄金储备
- 资产上链流程 - 评估、确权、铸造
- 价格预言机系统 - 多源聚合，异常检测

**代码**: 2,000行 | **测试**: 32个 ✅

### Phase 16: 预言机与跨链层
- 多节点共识 - 3/5节点确认
- 跨链消息传递 - 锁定-铸造-销毁-解锁
- 数据验证 - 签名验证，时间戳检查

**代码**: 2,820行 | **测试**: 33个 ✅

### Phase 17: 流动性与衍生品层
- RWA资产交易市场 - 资产份额化交易
- 流动性池 - AMM做市商（XTZH基础）
- 抵押借贷 - RWA资产抵押借XTZH
- GNACS编码管理 - 30位编码系统
- 收益分配系统 - 租金/利息/分红自动分配

**代码**: 2,370行 | **测试**: 21个 ✅

### Phase 18: 治理与数据层
- XIC治理增强 - 提案生命周期管理
- 链上数据索引 - 区块、交易、事件索引
- 事件订阅系统 - 实时事件推送
- 数据分析引擎 - 链上数据统计分析

**代码**: 1,160行 | **测试**: 8个 ✅

### Phase 19: 性能优化与安全审计
- 性能基准测试 - TPS、延迟、吞吐量
- 代码优化 - 热点分析，并发优化
- 安全审计 - 漏洞扫描，风险评估
- 压力测试 - 负载测试，稳定性测试

**代码**: 600行 | **测试**: 12个 ✅

### Phase 20: 测试网部署与生态启动
- 部署脚本生成器 - Docker/K8s/Systemd
- 生态工具 - 水龙头、浏览器、钱包
- 文档生成器 - 部署/API/开发者指南

**代码**: 700行 | **测试**: 12个 ✅

## 📈 项目统计

```
总代码量: 12,510行
总测试数: 180个
测试通过率: 100%
模块数量: 6个Phase
```

## 🚀 快速开始

### 系统要求

- **操作系统**: Ubuntu 20.04+ / CentOS 8+ / macOS 12+
- **Rust**: 1.70+
- **CPU**: 4核心以上
- **内存**: 8GB以上
- **存储**: 100GB以上SSD

### 安装

```bash
# 克隆项目
git clone https://github.com/newassetchain/nac-blockchain.git
cd nac-blockchain

# 编译项目
cargo build --release

# 运行测试
cargo test

# 生成文档
cargo doc --no-deps --open
```

### 快速部署

```bash
# 使用一键部署脚本
./deploy.sh
```

## 📚 文档

- [部署文档](docs/DEPLOYMENT.md)
- [API文档](docs/API.md)
- [开发者指南](docs/DEVELOPER_GUIDE.md)
- [架构设计](docs/ARCHITECTURE.md)

## 🧪 测试

```bash
# 运行所有测试
cargo test

# 运行特定模块测试
cargo test phase14
cargo test phase15
cargo test phase16

# 运行性能基准测试
cargo bench

# 生成测试覆盖率报告
cargo tarpaulin --out Html
```

## 🔧 开发

### 项目结构

```
nac-blockchain/
├── src/
│   ├── consensus/              # 共识机制
│   ├── network/                # 网络层
│   ├── storage/                # 存储层
│   ├── phase14_sovereignty/    # 主权验证层
│   ├── phase15_value_standard/ # 价值尺度层
│   ├── phase16_oracle_crosschain/ # 预言机与跨链
│   ├── phase17_liquidity_derivatives/ # 流动性与衍生品
│   ├── phase18_governance_data/ # 治理与数据
│   ├── phase19_performance/    # 性能优化
│   ├── phase20_deployment/     # 部署工具
│   └── lib.rs                  # 库入口
├── tests/                      # 集成测试
├── docs/                       # 文档
├── Cargo.toml                  # 项目配置
├── deploy.sh                   # 部署脚本
└── README.md                   # 本文件
```

### 代码规范

```bash
# 格式化代码
cargo fmt

# 检查代码
cargo clippy -- -D warnings

# 运行测试
cargo test
```

## 🌐 生态系统

- **NAC Testnet**: 测试网络（Chain ID: 20260131）
- **NAC Explorer**: 区块浏览器
- **NAC Wallet**: 官方钱包
- **NAC Faucet**: 测试币水龙头
- **NAC SDK**: JavaScript/Python/Go SDK

## 🤝 贡献

欢迎贡献代码！请遵循以下步骤：

1. Fork项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建Pull Request

## 📄 许可证

本项目采用MIT许可证 - 详见 [LICENSE](LICENSE) 文件

## 🔗 链接

- **官方网站**: https://newassetchain.io
- **文档**: https://docs.newassetchain.io
- **GitHub**: https://github.com/newassetchain
- **Discord**: https://discord.gg/newassetchain
- **Twitter**: https://twitter.com/newassetchain

## 📧 联系我们

- **邮箱**: dev@newassetchain.io
- **Telegram**: https://t.me/newassetchain
- **微信公众号**: NewAssetChain

---

**Built with ❤️ by the NewAssetChain Team**

*为真实世界资产的数字化未来而构建*