102 lines
5.1 KiB
Markdown
102 lines
5.1 KiB
Markdown
# NAC CEE 合规执行引擎架构文档
|
||
|
||
**版本**: 1.0.0
|
||
**日期**: 2026-03-07
|
||
**协议**: NAC_Lens/4.0
|
||
**状态**: 生产级
|
||
|
||
---
|
||
|
||
## 一、架构概览
|
||
|
||
NAC CEE（Constitutional Execution Engine，宪法执行引擎）是 NAC 公链的核心合规层，负责在交易进入 NVM 执行前进行辖区宪法规则验证。
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ NAC 主网架构（生产级） │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ L0 层 (CSNP 网络) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ nac-l0-csnp (端口 9546) — 节点发现与消息路由 │ │
|
||
│ │ NAC_Lens/4.0 辖区路由层 (nac-lens-jurisdiction-router)│ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ L1 层 (协议层) │
|
||
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────────┐ │
|
||
│ │ CBPP 节点 │ │ NVM 虚拟机 │ │ 宪法服务 │ │
|
||
│ │ (端口 9545) │ │ (端口 9547) │ │ (端口 9548) │ │
|
||
│ └──────────────┘ └──────────────┘ └──────────────────┘ │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ L2 层 (应用层) │
|
||
│ ┌──────────────────────┐ ┌──────────────────────────────┐ │
|
||
│ │ NAC API 网关 │ │ CEE 集成服务 [新] │ │
|
||
│ │ (端口 9550) │ │ (端口 9558) │ │
|
||
│ │ NAC_Lens/4.0 入口 │ │ 31辖区宪法规则验证 │ │
|
||
│ └──────────────────────┘ └──────────────────────────────┘ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 二、CEE 模块依赖关系
|
||
|
||
```
|
||
nac-cee-integration (v1.0.0)
|
||
├── nac-jurisdiction-rules (v1.0.0) ← 31辖区宪法规则
|
||
│ ├── Tier 1: CN/HK/SG/AE/US/EU/JP/KR/AU/CH/GB
|
||
│ ├── Tier 2: BM/KY/VG/MT/LU/GI/JE/IM/PA/MU
|
||
│ └── Tier 3: BR/IN/TH/ID/NG/MX/ZA/TR/SA/RU
|
||
├── nac-cee-plugin-loader (v0.1.0) ← 动态插件加载
|
||
├── nac-jurisdiction-version (v0.1.0) ← 版本管理
|
||
├── nac-jurisdiction-compat (v0.1.0) ← 兼容性检测
|
||
└── nac-lens-jurisdiction-router (v0.1.0) ← NAC_Lens路由
|
||
```
|
||
|
||
---
|
||
|
||
## 三、交易验证流程
|
||
|
||
```
|
||
交易请求
|
||
│
|
||
▼
|
||
NAC_Lens/4.0 路由层
|
||
│
|
||
├── 单辖区交易 ──► 辖区宪法规则验证 ──► CR出具 ──► NVM执行
|
||
│
|
||
└── 跨辖区交易 ──► 源辖区验证 ──► CR(源)
|
||
└── 目标辖区验证 ──► CR(目标)
|
||
└── 双CR确认 ──► NVM执行
|
||
```
|
||
|
||
**CBPP 原则体现**：
|
||
- 参与即是共识：每个辖区节点独立出具CR，无需等待其他节点
|
||
- 约法即是治法：CA签名的规则更新立即生效，无需链上投票
|
||
- 宪法即是规则：每辖区独立的宪法规则文件（constitution_rules.cnnl）
|
||
|
||
---
|
||
|
||
## 四、辖区规则文件结构
|
||
|
||
每个辖区包含以下文件：
|
||
|
||
```
|
||
nac-jurisdiction-rules/{CODE}/
|
||
├── README.md ← 辖区监管框架说明
|
||
├── constitution_rules.cnnl ← CNNL 宪法规则定义
|
||
└── protocol_template.charter ← Charter 合约模板
|
||
```
|
||
|
||
---
|
||
|
||
## 五、NAC_Lens 消息类型
|
||
|
||
| 消息类型 | 描述 | CA签名要求 |
|
||
|---------|------|-----------|
|
||
| `IntraJurisdiction` | 单辖区内部消息 | 否 |
|
||
| `CrossJurisdiction` | 跨辖区消息 | 否（各辖区独立验证）|
|
||
| `JurisdictionRuleUpdate` | 规则更新广播 | **必须** |
|
||
| `ConstitutionalReceiptBroadcast` | CR广播 | 否 |
|
||
| `NodeRegistration` | 节点注册 | 须GIDS证明 |
|
||
|