From a09b59bd1522dd1e76922cafb8cc411007b1232d Mon Sep 17 00:00:00 2001 From: NAC Admin Date: Sat, 7 Mar 2026 15:36:37 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E4=B8=BB=E7=BD=91=E9=83=A8=E7=BD=B2?= =?UTF-8?q?=E6=97=A5=E5=BF=97+CEE=E6=9E=B6=E6=9E=84=E6=96=87=E6=A1=A3+API?= =?UTF-8?q?=E5=8F=82=E8=80=83=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - docs/deployment/MAINNET_DEPLOY_LOG_20260307.md: 2026-03-07主网部署日志 - docs/architecture/NAC_CEE_ARCHITECTURE.md: CEE集成服务架构文档 - docs/api/CEE_API_REFERENCE.md: CEE API参考文档 部署摘要: - 6个核心服务全部运行 - 31个辖区宪法规则验证在线 - 258个测试全部通过 - NAC_Lens/4.0协议集成完成 --- docs/api/CEE_API_REFERENCE.md | 94 ++++++++++++++++ docs/architecture/NAC_CEE_ARCHITECTURE.md | 101 +++++++++++++++++ .../deployment/MAINNET_DEPLOY_LOG_20260307.md | 105 ++++++++++++++++++ 3 files changed, 300 insertions(+) create mode 100644 docs/api/CEE_API_REFERENCE.md create mode 100644 docs/architecture/NAC_CEE_ARCHITECTURE.md create mode 100644 docs/deployment/MAINNET_DEPLOY_LOG_20260307.md diff --git a/docs/api/CEE_API_REFERENCE.md b/docs/api/CEE_API_REFERENCE.md new file mode 100644 index 0000000..890b5f8 --- /dev/null +++ b/docs/api/CEE_API_REFERENCE.md @@ -0,0 +1,94 @@ +# NAC CEE 集成服务 API 参考 + +**版本**: 1.0.0 +**协议**: NAC_Lens/4.0 +**端口**: 9558 +**状态**: 生产级 + +--- + +## 健康检查接口 + +**端点**: `GET /health` +**描述**: 返回 CEE 集成服务的完整健康状态 + +**响应示例**: +```json +{ + "service": "nac-cee-integration", + "version": "1.0.0", + "status": "healthy", + "jurisdictions_loaded": 31, + "total_tests_passed": 252, + "cbpp_principles": { + "constitutional_law_is_governance": true, + "constitution_is_rules": true, + "participation_is_consensus": true, + "nodes_produce_blocks": true + }, + "modules": { + "nac-jurisdiction-rules": { + "name": "NAC辖区宪法规则验证插件集（31辖区）", + "status": "running", + "test_count": 225, + "version": "1.0.0" + } + } +} +``` + +--- + +## 交易验证接口 + +**端点**: `POST /validate` +**描述**: 对指定辖区的交易进行宪法规则验证 + +**请求体**: +```json +{ + "jurisdiction": "CN", + "tx_hash": "0xabcdef1234567890", + "amount_usd": 5000.0, + "asset_type": "RWA_REAL_ESTATE", + "kyc_level": "Institutional", + "aml_cleared": true, + "is_cross_border": false, + "sanctions_cleared": true +} +``` + +**响应体**: +```json +{ + "jurisdiction": "CN", + "tx_hash": "0xabcdef1234567890", + "valid": true, + "cr_issued": true, + "rules_passed": ["CN_AML_001", "CN_KYC_001", "CN_SANCTIONS_001"], + "violation": null, + "protocol": "NAC_Lens/4.0" +} +``` + +--- + +## 支持的辖区列表 + +| 层级 | 辖区代码 | +|------|---------| +| 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 | + +--- + +## 错误码 + +| 错误码 | 描述 | +|--------|------| +| `{JUR}_AML_001` | AML 金额超限，需要反洗钱清除 | +| `{JUR}_KYC_001` | KYC 验证缺失 | +| `{JUR}_SANCTIONS_001` | 制裁筛查未通过 | +| `Jurisdiction not supported` | 不支持的辖区代码 | + diff --git a/docs/architecture/NAC_CEE_ARCHITECTURE.md b/docs/architecture/NAC_CEE_ARCHITECTURE.md new file mode 100644 index 0000000..4d4bc7a --- /dev/null +++ b/docs/architecture/NAC_CEE_ARCHITECTURE.md @@ -0,0 +1,101 @@ +# 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证明 | + diff --git a/docs/deployment/MAINNET_DEPLOY_LOG_20260307.md b/docs/deployment/MAINNET_DEPLOY_LOG_20260307.md new file mode 100644 index 0000000..7a9d885 --- /dev/null +++ b/docs/deployment/MAINNET_DEPLOY_LOG_20260307.md @@ -0,0 +1,105 @@ +# NAC 主网部署日志 — 2026-03-07 + +**部署时间**: 2026-03-07 15:34:44 CST +**部署人员**: NAC 开发团队 +**服务器**: 103.96.148.7:22000 +**协议版本**: NAC_Lens/4.0 +**状态**: ✅ 全部服务正常运行 + +--- + +## 一、本次部署内容 + +本次部署完成了 Issue #71 至 #77 的全部工单，实现了 NAC 公链全球 31+ 辖区合规验证体系的生产级部署。 + +### 新增服务 + +| 服务名 | 端口 | 描述 | 状态 | +|--------|------|------|------| +| `nac-cee-integration` | 9558 | CEE集成服务（31辖区+NAC_Lens路由） | ✅ 运行中 | + +### 新增模块（库） + +| 模块 | 版本 | 测试数 | 描述 | +|------|------|--------|------| +| `nac-jurisdiction-rules` | 1.0.0 | 225 | 31辖区宪法规则验证插件集 | +| `nac-cee-plugin-loader` | 0.1.0 | 7 | CEE插件动态加载器 | +| `nac-jurisdiction-version` | 0.1.0 | 6 | 辖区规则版本管理 | +| `nac-jurisdiction-compat` | 0.1.0 | 6 | 跨版本兼容性检测 | +| `nac-lens-jurisdiction-router` | 0.1.0 | 8 | NAC_Lens辖区路由层 | +| `nac-cee-integration` | 1.0.0 | 6 | 生产级CEE集成服务 | + +**总测试通过数**: 258 个（全部通过，0 失败） + +--- + +## 二、服务状态验证 + +``` +✅ nac-cbpp-node: active (端口 9545) +✅ nac-l0-csnp: active (端口 9546) +✅ nac-l1-nvm: active (端口 9547) +✅ nac-constitution-service: active (端口 9548) +✅ nac-api-server: active (端口 9550) +✅ nac-cee-integration: active (端口 9558) [新增] +``` + +--- + +## 三、辖区覆盖范围 + +### Tier 1 — 高度成熟监管框架（11个） + +| 辖区 | 国家/地区 | 监管机构 | +|------|---------|---------| +| CN | 中国 | PBOC/CSRC | +| HK | 香港 | SFC/HKMA | +| SG | 新加坡 | MAS | +| AE | 阿联酋 | VARA/CBUAE | +| US | 美国 | SEC/CFTC | +| EU | 欧盟 | MiCA/EBA | +| JP | 日本 | FSA/JFSA | +| KR | 韩国 | FSC/FSS | +| AU | 澳大利亚 | ASIC/AUSTRAC | +| CH | 瑞士 | FINMA | +| GB | 英国 | FCA/PRA | + +### Tier 2 — 离岸金融中心（10个） + +BM（百慕大）、KY（开曼群岛）、VG（英属维京群岛）、MT（马耳他）、LU（卢森堡）、GI（直布罗陀）、JE（泽西岛）、IM（马恩岛）、PA（巴拿马）、MU（毛里求斯） + +### Tier 3 — 新兴市场（10个） + +BR（巴西）、IN（印度）、TH（泰国）、ID（印度尼西亚）、NG（尼日利亚）、MX（墨西哥）、ZA（南非）、TR（土耳其）、SA（沙特阿拉伯）、RU（俄罗斯） + +--- + +## 四、CBPP 合规验证 + +| 原则 | 状态 | 说明 | +|------|------|------| +| 约法即是治法 | ✅ | CA签名直接生效，无需链上投票 | +| 宪法即是规则 | ✅ | 每辖区独立宪法规则，节点注册须GIDS证明 | +| 参与即是共识 | ✅ | 验证通过即出具CR，无多签机制 | +| 节点产生区块交易决定区块大小 | ✅ | 节点独立处理，无全局锁 | + +--- + +## 五、系统资源状态 + +- **内存使用**: 2.1Gi / 7.8Gi (27%) +- **磁盘使用**: 43G / 69G (66%) +- **CPU 负载**: 1.07, 0.72, 0.36 +- **量子浏览器**: https://explorer.newassetchain.io/ ✅ 在线 + +--- + +## 六、后台管理账号 + +| 服务 | 地址 | 账号 | 密码 | +|------|------|------|------| +| SSH | 103.96.148.7:22000 | root | XKUigTFMJXhH | +| 宝塔面板 | http://103.96.148.7:12/btwest | cproot | vajngkvf | +| Gitea | http://localhost:3333 | nacadmin | NACadmin2026! | +| 代码库 | https://git.newassetchain.io/nacadmin/NAC_Blockchain | — | — | +