300 lines
10 KiB
Rust
300 lines
10 KiB
Rust
|
||
//! # NAC Unified Definition Module (UDM)
|
||
//!
|
||
//! NAC统一定义模块（UDM）是NewAssetChain区块链生态系统的单一真理来源（Single Source of Truth），
|
||
//! 统一管理所有类型定义、函数签名、常量、版本信息和协议规范。
|
||
//!
|
||
//! ## 核心特性
|
||
//!
|
||
//! - ❌ **不使用任何ERC标准**（ERC-20、ERC-721、ERC-1155等）
|
||
//! - ❌ **不继承以太坊或其他链的实现**
|
||
//! - ❌ **不是P2P网络** - 使用CSNP宪政结构化网络协议
|
||
//! - ✅ **100% NAC原生设计**
|
||
//! - ✅ **专注于RWA（真实世界资产）应用场景**
|
||
//! - ✅ **基于CBPP宪政共识，不需要投票治理**
|
||
//!
|
||
//! ## NAC 5层架构体系
|
||
//!
|
||
//! NAC采用5层架构（L0-L5），从底层基础设施到顶层应用，层层递进：
|
||
//!
|
||
//! ### L5: 应用层 (Application Layer)
|
||
//!
|
||
//! 最高层级，提供用户交互和业务应用：
|
||
//! - **DApps**: 去中心化应用（资产交易、资产管理、资产估值等）
|
||
//! - **钱包**: 用户资产管理工具
|
||
//! - **浏览器**: 区块链数据查询和可视化
|
||
//! - **Charter合约**: 智能合约执行环境
|
||
//!
|
||
//! ### L4: AI层 (AI Layer)
|
||
//!
|
||
//! AI服务层，统一管理所有AI功能（NAC是AI公链）：
|
||
//! - **宪法执行引擎(CEE)**: AI驱动的宪法规则执行
|
||
//! - **AI合规审批**: KYC/AML自动审核、欺诈检测
|
||
//! - **AI估值**: 资产估值、风险评估、市场预测
|
||
//! - **XTZH AI**: 宏观感知AI、汇率预测
|
||
//! - **AI预言机**: 多节点AI共识、zkML证明
|
||
//! - **AI治理**: 提案分析、投票建议、审计AI
|
||
//!
|
||
//! ### L3: 存储层 (Storage Layer)
|
||
//!
|
||
//! 独立的存储层，负责所有持久化数据的存储与证明：
|
||
//! - **状态数据库**: 账户状态、资产状态、合约状态
|
||
//! - **Merkle树**: 状态证明、交易证明
|
||
//! - **归档存储**: 历史区块、历史交易
|
||
//! - **证据存证**: 法典、合规证据、审计日志
|
||
//!
|
||
//! ### L2: 宪法规则层 (Constitutional Governance Layer)
|
||
//!
|
||
//! 宪法治理层，定义整个系统的治理规则（**不是投票治理，而是规则定义层**）：
|
||
//! - **CNNL宪法语言**: 宪法条款的定义语言
|
||
//! - **宪法状态机**: 宪法规则的执行引擎
|
||
//! - **辖区协商接口**: 多司法辖区的协商机制
|
||
//! - **法典管理**: 宪法法典、条款法典、主权法典、AI治理法典等
|
||
//!
|
||
//! ### L1: 协议层 (Protocol Layer)
|
||
//!
|
||
//! 核心协议层，实现"宪法即共识"：
|
||
//! - **CBPP**: 宪政区块生产协议（宪法收据CR、OPN、FBM、RVGP）
|
||
//! - **CSNP**: 宪政结构化网络协议（GIDS、MA-RCM、AA-PE、FTAN、UCA）
|
||
//! - **NVM**: 虚拟机层（225个基础操作码 + 125个RWA专属指令）
|
||
//! - **ACC**: 13个原生资产协议（ACC-20, ACC-721, ACC-1155, ACC-RWA等）
|
||
//! - **XTZH**: 资产稳定币系统（SDR锚定 + 黄金储备）
|
||
//!
|
||
//! ### L0: 基础设施层 (Foundation Layer)
|
||
//!
|
||
//! 最底层，提供所有上层依赖的基础设施（包含4个子层）：
|
||
//! - **密码学子层**: Hash（SHA3-384）、签名（Ed25519）、随机数、加密
|
||
//! - **网络子层**: P2P通信、Gossip协议、节点发现
|
||
//! - **序列化子层**: nac_serde（NAC专用序列化）
|
||
//! - **存储子层**: 持久化接口（为L3存储层提供底层接口）
|
||
//!
|
||
//! ## 设计哲学
|
||
//!
|
||
//! "宪法治下，节点产生区块，参与即是共识，交易扩张区块的大小和高度。"
|
||
//!
|
||
//! ## 快速开始
|
||
//!
|
||
//! ```rust
|
||
//! use nac_udm::primitives::{Hash, Timestamp, Signature};
|
||
//! use nac_udm::l1_protocol::cbpp::ConstitutionalReceipt;
|
||
//! use nac_udm::l1_protocol::gnacs::{GNACSCode, AssetCategory, Jurisdiction, ComplianceLevel, RiskLevel};
|
||
//!
|
||
//! // 创建宪法收据
|
||
//! let transaction_hash = Hash::sha3_384(b"tx");
|
||
//! let constitutional_hash = Hash::sha3_384(b"constitution");
|
||
//! let execution_result_hash = Hash::sha3_384(b"result");
|
||
//! let issuer_pubkey = vec![1u8; 33];
|
||
//!
|
||
//! let mut receipt = ConstitutionalReceipt::new(
|
||
//! transaction_hash,
|
||
//! constitutional_hash,
|
||
//! execution_result_hash,
|
||
//! issuer_pubkey,
|
||
//! 3600, // validity_window
|
||
//! );
|
||
//!
|
||
//! // 签名收据
|
||
//! receipt.sign(Signature::new(vec![0u8; 64]));
|
||
//!
|
||
//! // 验证收据
|
||
//! let current_time = Timestamp::now();
|
||
//! assert!(receipt.verify(current_time, &constitutional_hash));
|
||
//!
|
||
//! // 创建GNACS资产编码（实物资产，中国司法辖区，高合规，低风险）
|
||
//! let gnacs = GNACSCode::new(
|
||
//! AssetCategory::Physical,
|
||
//! 0x01, // 子类别
|
||
//! Jurisdiction::CN,
|
||
//! ComplianceLevel::High,
|
||
//! RiskLevel::Low,
|
||
//! );
|
||
//!
|
||
//! // 验证GNACS编码
|
||
//! assert!(gnacs.verify_checksum());
|
||
//! assert_eq!(gnacs.category(), AssetCategory::Physical);
|
||
//! assert_eq!(gnacs.jurisdiction(), Jurisdiction::CN);
|
||
//! println!("GNACS: {}", gnacs.format_readable());
|
||
//! ```
|
||
|
||
#![cfg_attr(not(feature = "std"), no_std)]
|
||
#![warn(missing_docs)]
|
||
#![warn(rustdoc::missing_crate_level_docs)]
|
||
|
||
/// 核心注册表系统
|
||
pub mod registry;
|
||
|
||
/// 基础原语类型
|
||
pub mod primitives;
|
||
|
||
/// 工具函数
|
||
pub mod utils;
|
||
|
||
/// L5: 应用层 (Application Layer) - DApps、钱包、浏览器、Charter合约
|
||
pub mod l5_application;
|
||
|
||
/// L4: AI层 (AI Layer) - CEE、AI合规、AI估值、XTZH AI、AI预言机
|
||
pub mod l4_ai;
|
||
|
||
/// L3: 存储层 (Storage Layer) - 状态数据库、Merkle树、归档存储、证据存证
|
||
pub mod l3_storage;
|
||
|
||
/// L2: 宪法规则层 (Constitutional Governance Layer) - CNNL、宪法状态机、法典管理
|
||
pub mod l2_governance;
|
||
|
||
/// L1: 协议层 (Protocol Layer) - CBPP、CSNP、NVM、ACC、XTZH
|
||
pub mod l1_protocol;
|
||
|
||
/// L0: 基础设施层 (Foundation Layer) - 密码学、网络、序列化、存储接口
|
||
pub mod l0_native;
|
||
/// 资产加密DNA管理系统模块
|
||
pub mod asset_dna;
|
||
|
||
/// 预导入模块，包含最常用的类型和trait
|
||
pub mod prelude {
|
||
pub use crate::registry::{UID, Version, DefinitionRegistry};
|
||
pub use crate::primitives::prelude::*;
|
||
#[allow(unused_imports)]
|
||
pub use crate::utils::*;
|
||
pub use crate::l2_governance::*;
|
||
pub use crate::l1_protocol::*;
|
||
pub use crate::l0_native::*;
|
||
}
|
||
|
||
/// UDM版本信息
|
||
pub const VERSION: &str = env!("CARGO_PKG_VERSION");
|
||
|
||
/// UDM名称
|
||
pub const NAME: &str = env!("CARGO_PKG_NAME");
|
||
|
||
/// UDM描述
|
||
pub const DESCRIPTION: &str = env!("CARGO_PKG_DESCRIPTION");
|
||
|
||
/// NAC区块链架构层级（5层架构）
|
||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
||
/// ArchitectureLayer
|
||
pub enum ArchitectureLayer {
|
||
/// L5: 应用层（DApps、钱包、浏览器、Charter合约）
|
||
L5Application,
|
||
/// L4: AI层（CEE、AI合规、AI估值、XTZH AI、AI预言机）
|
||
L4AI,
|
||
/// L3: 存储层（状态数据库、Merkle树、归档存储、证据存证）
|
||
L3Storage,
|
||
/// L2: 宪法规则层（CNNL、宪法状态机、法典管理）
|
||
L2Governance,
|
||
/// L1: 协议层（CBPP、CSNP、NVM、ACC、XTZH）
|
||
L1Protocol,
|
||
/// L0: 基础设施层（密码学、网络、序列化、存储接口）
|
||
L0CSNP,
|
||
}
|
||
|
||
impl std::fmt::Display for ArchitectureLayer {
|
||
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
||
match self {
|
||
Self::L5Application => write!(f, "L5: Application Layer (DApps, Wallet, Explorer, Charter)"),
|
||
Self::L4AI => write!(f, "L4: AI Layer (CEE, AI Compliance, AI Valuation)"),
|
||
Self::L3Storage => write!(f, "L3: Storage Layer (State DB, Merkle Tree, Archive)"),
|
||
Self::L2Governance => write!(f, "L2: Constitutional Governance Layer (Rule Definition)"),
|
||
Self::L1Protocol => write!(f, "L1: Multi-Chain Protocol Layer (CBPP Consensus)"),
|
||
Self::L0CSNP => write!(f, "L0: CSNP Structured Network Layer (Not P2P)"),
|
||
}
|
||
}
|
||
}
|
||
|
||
/// 网络类型
|
||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
||
/// NetworkType
|
||
pub enum NetworkType {
|
||
/// CSNP宪政结构化网络（NAC使用）
|
||
CSNP,
|
||
/// P2P对等网络（NAC不使用）
|
||
#[deprecated(note = "NAC does not use P2P network, use CSNP instead")]
|
||
/// P2P
|
||
P2P,
|
||
}
|
||
|
||
impl std::fmt::Display for NetworkType {
|
||
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
||
match self {
|
||
Self::CSNP => write!(f, "CSNP (Constitutional Structured Network Protocol)"),
|
||
#[allow(deprecated)]
|
||
Self::P2P => write!(f, "P2P (Peer-to-Peer) - NOT USED IN NAC"),
|
||
}
|
||
}
|
||
}
|
||
|
||
/// 共识类型
|
||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
||
/// ConsensusType
|
||
pub enum ConsensusType {
|
||
/// CBPP宪政区块生产协议（NAC使用）
|
||
CBPP,
|
||
/// PoS权益证明（NAC不使用）
|
||
#[deprecated(note = "NAC does not use PoS, use CBPP instead")]
|
||
/// PoS
|
||
PoS,
|
||
/// PoW工作量证明（NAC不使用）
|
||
#[deprecated(note = "NAC does not use PoW, use CBPP instead")]
|
||
/// PoW
|
||
PoW,
|
||
}
|
||
|
||
impl std::fmt::Display for ConsensusType {
|
||
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
||
match self {
|
||
Self::CBPP => write!(f, "CBPP (Constitutional Block Production Protocol)"),
|
||
#[allow(deprecated)]
|
||
Self::PoS => write!(f, "PoS (Proof of Stake) - NOT USED IN NAC"),
|
||
#[allow(deprecated)]
|
||
Self::PoW => write!(f, "PoW (Proof of Work) - NOT USED IN NAC"),
|
||
}
|
||
}
|
||
}
|
||
|
||
#[cfg(test)]
|
||
mod tests {
|
||
use super::*;
|
||
|
||
#[test]
|
||
fn test_version() {
|
||
assert!(!VERSION.is_empty());
|
||
assert_eq!(VERSION, "1.0.0");
|
||
}
|
||
|
||
#[test]
|
||
fn test_name() {
|
||
assert_eq!(NAME, "nac-udm");
|
||
}
|
||
|
||
#[test]
|
||
fn test_architecture_layers() {
|
||
assert_eq!(
|
||
ArchitectureLayer::L2Governance.to_string(),
|
||
"L2: Constitutional Governance Layer (Rule Definition)"
|
||
);
|
||
assert_eq!(
|
||
ArchitectureLayer::L1Protocol.to_string(),
|
||
"L1: Multi-Chain Protocol Layer (CBPP Consensus)"
|
||
);
|
||
assert_eq!(
|
||
ArchitectureLayer::L0CSNP.to_string(),
|
||
"L0: CSNP Structured Network Layer (Not P2P)"
|
||
);
|
||
}
|
||
|
||
#[test]
|
||
fn test_network_type() {
|
||
assert_eq!(
|
||
NetworkType::CSNP.to_string(),
|
||
"CSNP (Constitutional Structured Network Protocol)"
|
||
);
|
||
}
|
||
|
||
#[test]
|
||
fn test_consensus_type() {
|
||
assert_eq!(
|
||
ConsensusType::CBPP.to_string(),
|
||
"CBPP (Constitutional Block Production Protocol)"
|
||
);
|
||
}
|
||
}
|