# NAC RWA资产交易所

NAC RWA资产交易所是一个专为真实世界资产（Real World Assets）设计的去中心化交易平台，基于NAC公链原生技术栈开发，支持RWA资产的上架、交易、撮合、结算等全流程功能。

## 核心特性

### 1. 交易引擎

- **订单簿模型**：支持买卖单队列，价格-时间优先排序
- **撮合引擎**：实时撮合算法，支持限价单和市价单
- **清算结算**：T+0实时结算，资产锁定机制，交割确认流程

### 2. 合规功能

- **KYC验证**：身份认证、实名验证、风险评级
- **交易限额**：单笔限额、日限额、月限额控制
- **黑名单管理**：风险用户管理和监控
- **合规报告**：交易记录、异常交易、监管数据导出

### 3. NAC原生技术

- **虚拟机**：NVM (NAC Virtual Machine)
- **共识协议**：CBPP (Constitutional Byzantine Paxos Protocol)
- **网络协议**：CSNP (Constitutional Secure Network Protocol)
- **RPC协议**：NRPC4.0
- **智能合约**：Charter语言
- **类型系统**：Address (32字节)、Hash (48字节 SHA3-384)、Signature (96字节)

## 项目结构

```
nac-rwa-exchange/
├── src/
│   ├── types/              # 核心类型定义
│   │   └── mod.rs          # Address, Hash, Order, Trade等
│   ├── engine/             # 交易引擎
│   │   ├── mod.rs          # 模块导出
│   │   ├── orderbook.rs    # 订单簿
│   │   ├── matching.rs     # 撮合引擎
│   │   └── settlement.rs   # 清算结算
│   ├── compliance/         # 合规功能
│   │   ├── mod.rs          # 模块导出
│   │   ├── kyc.rs          # KYC验证
│   │   └── limits.rs       # 交易限额控制
│   └── lib.rs              # 库入口
├── tests/                  # 集成测试
├── docs/                   # 文档
│   └── ARCHITECTURE.md     # 架构设计文档
├── Cargo.toml              # 项目配置
└── README.md               # 本文件
```

## 快速开始

### 安装依赖

```bash
# 确保已安装Rust 1.70+
rustc --version

# 构建项目
cd nac-rwa-exchange
cargo build
```

### 运行测试

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

# 运行特定模块测试
cargo test --lib types
cargo test --lib engine
cargo test --lib compliance
```

## 核心模块说明

### 类型模块 (types)

定义了NAC公链原生类型和交易所核心数据模型：

- **NAC原生类型**：`Address` (32字节)、`Hash` (48字节)、`Signature` (96字节)
- **订单模型**：`Order`、`OrderType`、`PriceType`、`OrderStatus`
- **资产模型**：`RWAAsset`、`AssetType`、`ComplianceStatus`
- **交易模型**：`Trade`、`TradeStatus`
- **用户模型**：`User`、`KYCStatus`、`RiskLevel`

### 交易引擎模块 (engine)

实现了交易所的核心交易功能：

- **订单簿** (`orderbook.rs`)：买卖单队列管理、市场深度查询
- **撮合引擎** (`matching.rs`)：价格-时间优先撮合算法、部分成交支持
- **清算结算** (`settlement.rs`)：T+0实时结算、资产锁定、交割确认

### 合规功能模块 (compliance)

实现了交易所的合规功能：

- **KYC验证** (`kyc.rs`)：身份认证、实名验证、风险评级、黑名单管理
- **交易限额** (`limits.rs`)：单笔限额、日限额、月限额控制、交易统计

## 测试

项目包含完整的单元测试，覆盖所有核心功能：

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

# 查看测试详情
cargo test -- --nocapture

# 运行特定测试
cargo test test_orderbook_creation
cargo test test_match_buy_and_sell_full
cargo test test_settle_trade_success
```

## 性能指标

- **订单处理延迟**：< 10ms
- **撮合引擎TPS**：> 10,000
- **结算确认时间**：3个区块（约15秒）
- **KYC验证响应**：< 100ms

## 安全特性

- 所有订单必须使用用户私钥签名
- 资产转移通过Charter智能合约执行
- 资产锁定机制防止双花
- KYC数据加密存储
- 完整的审计日志

## 开发路线图

- [x] 核心类型定义
- [x] 订单簿实现
- [x] 撮合引擎实现
- [x] 清算结算实现
- [x] KYC验证实现
- [x] 交易限额控制实现
- [ ] REST API接口
- [ ] WebSocket实时推送
- [ ] 前端交易界面
- [ ] 数据库持久化
- [ ] 监控告警系统

## 许可证

本项目采用 MIT 许可证

## 联系方式

- 项目主页：https://newassetchain.io
- 技术文档：https://docs.newassetchain.io

---

**维护**: NAC开发团队  
**最后更新**: 2026-02-18