143 lines
4.3 KiB
Rust
143 lines
4.3 KiB
Rust
//! # XTZH AI汇率定价模型系统
|
||
//!
|
||
//! XTZH AI汇率定价模型是NAC公链的核心价值稳定机制，通过双层嵌套注意力机制
|
||
//! 实现基于50维宏观状态向量的汇率预测。系统采用可验证计算架构，确保链上
|
||
//! 汇率的可信性与透明性。
|
||
//!
|
||
//! ## 架构层级
|
||
//!
|
||
//! 本模块属于NAC四层架构中的**L1协议层（Protocol Layer）**，与NVM、CBPP、
|
||
//! ACC-20等核心协议处于同一层级。
|
||
//!
|
||
//! ## 核心模块
|
||
//!
|
||
//! - [`data`]: 数据工程层 - 50维宏观状态向量的采集、清洗、对齐、标准化
|
||
//! - [`model`]: AI模型层 - 双层嵌套注意力机制的汇率预测模型
|
||
//! - [`training`]: 训练系统 - 模型训练、验证与评估
|
||
//! - [`export`]: ONNX导出 - 模型导出为ONNX格式，支持zkML编译与TEE部署
|
||
//! - [`oracle`]: 预言机集成 - 混合预言机网络，提供可验证的汇率数据
|
||
//!
|
||
//! ## 设计原则
|
||
//!
|
||
//! 遵循NAC记忆系统中的核心原则：
|
||
//!
|
||
//! - **ARCH_001**: 四层架构体系（本模块属于L1协议层）
|
||
//! - **ARCH_003**: Blake3哈希统一（所有哈希计算使用Blake3）
|
||
//! - **ARCH_004**: 代码保留原则（永远不要删除代码）
|
||
//! - **ARCH_005**: NAC原生设计（不模仿任何其他公链）
|
||
//! - **ARCH_006**: 测试驱动开发（单元测试覆盖率 > 80%）
|
||
//!
|
||
//! ## 快速开始
|
||
//!
|
||
//! ```rust,no_run
|
||
//! use xtzh_ai::model::XTZHModel;
|
||
//! use xtzh_ai::data::MacroFeatures;
|
||
//!
|
||
//! # async fn example() -> Result<(), Box<dyn std::error::Error>> {
|
||
//! // 1. 加载模型
|
||
//! let model = XTZHModel::load("xtzh_model_v1.0.onnx")?;
|
||
//!
|
||
//! // 2. 准备50维宏观特征
|
||
//! let features = MacroFeatures::fetch_latest().await?;
|
||
//!
|
||
//! // 3. 执行推理
|
||
//! let result = model.infer(&features)?;
|
||
//!
|
||
//! println!("XTZH汇率: {} SDR", result.rate_sdr);
|
||
//! println!("货币层权重: {}%", result.w_fx / 100.0);
|
||
//! println!("黄金层权重: {}%", result.w_au / 100.0);
|
||
//! println!("商品层权重: {}%", result.w_com / 100.0);
|
||
//! # Ok(())
|
||
//! # }
|
||
//! ```
|
||
//!
|
||
//! ## 性能指标
|
||
//!
|
||
//! | 指标 | 目标 |
|
||
//! |------|------|
|
||
//! | 宏观预测R² | ≥ 0.65 |
|
||
//! | 模型推理时间 | < 100ms |
|
||
//! | ZK证明生成时间 | < 10秒 |
|
||
//! | TEE推理时间 | < 500ms |
|
||
//! | 单元测试覆盖率 | > 80% |
|
||
|
||
#![deny(missing_docs)]
|
||
#![deny(unsafe_code)]
|
||
#![warn(clippy::all)]
|
||
|
||
// ============================================================================
|
||
// 公开模块
|
||
// ============================================================================
|
||
|
||
/// 数据工程层 - 50维宏观状态向量的采集、清洗、对齐、标准化
|
||
pub mod data;
|
||
|
||
/// AI模型层 - 双层嵌套注意力机制的汇率预测模型
|
||
pub mod model;
|
||
|
||
/// 训练系统 - 模型训练、验证与评估
|
||
pub mod training;
|
||
|
||
/// ONNX导出 - 模型导出为ONNX格式，支持zkML编译与TEE部署
|
||
// pub mod export; // 将在Phase 6实现
|
||
|
||
/// 预言机集成 - 混合预言机网络，提供可验证的汇率数据
|
||
// pub mod oracle; // 将在Phase 8实现
|
||
|
||
// ============================================================================
|
||
// 内部模块
|
||
// ============================================================================
|
||
|
||
/// 错误类型定义
|
||
mod error;
|
||
|
||
/// 常量定义
|
||
mod constants;
|
||
|
||
/// 工具函数
|
||
mod utils;
|
||
|
||
// ============================================================================
|
||
// 公开导出
|
||
// ============================================================================
|
||
|
||
pub use error::{Error, Result};
|
||
pub use constants::*;
|
||
|
||
// ============================================================================
|
||
// 版本信息
|
||
// ============================================================================
|
||
|
||
/// 模块版本
|
||
pub const VERSION: &str = env!("CARGO_PKG_VERSION");
|
||
|
||
/// 模块名称
|
||
pub const NAME: &str = env!("CARGO_PKG_NAME");
|
||
|
||
/// 模块描述
|
||
pub const DESCRIPTION: &str = env!("CARGO_PKG_DESCRIPTION");
|
||
|
||
// ============================================================================
|
||
// 测试
|
||
// ============================================================================
|
||
|
||
#[cfg(test)]
|
||
mod tests {
|
||
use super::*;
|
||
|
||
#[test]
|
||
fn test_version() {
|
||
assert_eq!(VERSION, "1.0.0");
|
||
}
|
||
|
||
#[test]
|
||
fn test_name() {
|
||
assert_eq!(NAME, "xtzh-ai");
|
||
}
|
||
|
||
#[test]
|
||
fn test_description() {
|
||
assert!(!DESCRIPTION.is_empty());
|
||
}
|
||
}
|