NAC_Blockchain/nvm_v2/nvm-l1/README.md

246 lines
6.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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**
*为真实世界资产的数字化未来而构建*