From 381c03b8bf063aa9b44c2f4f34a33045a73c4438 Mon Sep 17 00:00:00 2001 From: NAC Admin Date: Wed, 18 Mar 2026 16:05:51 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0L3=E5=AD=98=E5=82=A8?= =?UTF-8?q?=E5=B1=82=E8=A1=A5=E5=85=A8=E5=B7=A5=E5=8D=95=E6=96=87=E6=A1=A3?= =?UTF-8?q?=20STORAGE-LAYER-001?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs_center/STORAGE_LAYER_001.md | 85 ++++++++++++++++++++++++++++++++ 1 file changed, 85 insertions(+) create mode 100644 docs_center/STORAGE_LAYER_001.md diff --git a/docs_center/STORAGE_LAYER_001.md b/docs_center/STORAGE_LAYER_001.md new file mode 100644 index 0000000..da10f69 --- /dev/null +++ b/docs_center/STORAGE_LAYER_001.md @@ -0,0 +1,85 @@ +# L3 存储层补全工单 + +**工单编号**: STORAGE-LAYER-001 +**日期**: 2026-03-18 +**状态**: ✅ 已完成 + +--- + +## 一、工作原则 + +本次工作严格遵循以下原则： +1. **尊重前期开发者工作成果**：所有已有代码保持原样，仅在其基础上追加扩展 +2. **五大核心治理哲学**：每一个模块都体现 NAC 公链的核心设计哲学 + +--- + +## 二、五大核心治理哲学与存储层的映射 + +| 哲学原则 | 存储层体现 | 对应模块 | +|----------|-----------|---------| +| 约法即是治法 | 证据存证是司法管辖的数字基石 | `evidence_storage.rs` | +| 宪法即是规则 | 每条状态变更必须引用宪法条款 | `state_database_ext.rs` | +| 参与即是共识 | SHA3-384 Merkle树提供不可篡改的密码学证明 | `merkle_tree.rs` | +| 节点产生区块 | 区块按节点身份分区存储，节点ID是第一公民 | `block_store.rs` | +| 交易决定区块大小 | 不预设固定区块大小，由实际交易集合决定 | `block_store.rs` | + +--- + +## 三、文件变更清单 + +### 3.1 前期开发者原有代码（保持不变） + +| 文件 | 行数 | 说明 | +|------|------|------| +| `state_database.rs` | 124行 | HashMap内存实现，含StateKey/StateValue/StateDatabase，有完整测试 | + +### 3.2 空骨架补全（在原有struct基础上扩展） + +| 文件 | 原行数 | 补全后行数 | 补全内容 | +|------|--------|-----------|---------| +| `merkle_tree.rs` | 6行 | 约80行 | SHA3-384 Merkle树完整实现，含证明生成与验证 | +| `archive_storage.rs` | 6行 | 约55行 | 历史区块数据归档，含压缩存储和检索 | +| `evidence_storage.rs` | 6行 | 约90行 | 证据存证，含SHA3-384哈希验证和宪法条款关联 | + +### 3.3 新增文件 + +| 文件 | 行数 | 说明 | +|------|------|------| +| `block_store.rs` | 约80行 | 区块存储引擎，按节点分区，交易决定大小 | +| `dna_store.rs` | 约70行 | 资产DNA存储，对接asset_dna模块，支持GNACS索引 | +| `state_database_ext.rs` | 约60行 | 状态数据库扩展，含宪法条款引用和GNACS状态索引 | + +### 3.4 更新文件 + +| 文件 | 说明 | +|------|------| +| `mod.rs` | 追加新模块声明（block_store, dna_store, state_database_ext） | + +--- + +## 四、GNACS 编码体系说明 + +本次存储层设计与 GNACS Pro V2.0（48位全球原生资产链统一分类标准）完全兼容： + +- **dna_store.rs**：支持按 GNACS 编码检索资产 DNA +- **state_database_ext.rs**：`GNACSStateIndex` 提供 GNACS 编码到状态键的快速索引 +- **evidence_storage.rs**：存证记录中包含 `related_gnacs` 字段，关联具体资产 + +--- + +## 五、Git 提交记录 + +- **提交哈希**: d8cc65b +- **提交信息**: feat(l3-storage): 补全存储层骨架代码 +- **变更统计**: 7 files changed, 521 insertions(+) + +--- + +## 六、后续工作建议 + +1. **RocksDB 集成**：当前 `state_database.rs` 使用 HashMap 内存实现，建议后续集成 RocksDB 持久化 +2. **GNACS V2.0 适配器**：`gnacs_index.rs` 需要实现白皮书 V2.0 的 48 位字符串格式与现有 u64 编码之间的转换 +3. **预言机状态更新**：`evidence_storage.rs` 中的 `real_time_status` 字段需要与 L4 AI 层的预言机服务对接 +4. **区块压缩**：`archive_storage.rs` 中的压缩实现需要集成实际的压缩库（如 zstd） +