nacadmin
/
NAC_Blockchain
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
NAC_Blockchain/docs/architecture/NAC_CEE_ARCHITECTURE.md

5.1 KiB
Raw Blame History

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证明