114 lines
4.6 KiB
Rust
114 lines
4.6 KiB
Rust
//! ACC-20C兼容层模块
|
||
|
||
///! # ACC-20C: ACC-20兼容层协议
|
||
///!
|
||
///! UID: nac.acc20c.v1
|
||
///!
|
||
///! ACC-20C是NAC与以太坊生态之间的战略性桥梁，而非妥协。
|
||
///!
|
||
///! ## 核心理念
|
||
///!
|
||
///! **NAC是核心，ACC-20C是流动性入口**
|
||
///!
|
||
///! ### 为什么需要ACC-20C？
|
||
///!
|
||
///! 1. **现实情况**
|
||
///! - 以太坊生态拥有数百万用户和成熟基础设施
|
||
///! - NAC是新生态，需要冷启动
|
||
///! - 完全隔离会导致流动性不足
|
||
///!
|
||
///! 2. **战略价值**
|
||
///! - **短期（1-2年）**: 让ACC-20资产在OpenSea等市场流通
|
||
///! - **中期（2-3年）**: 逐步引导用户使用NAC原生工具
|
||
///! - **长期（3年+）**: ACC-20C变成可选而非必需
|
||
///!
|
||
///! 3. **合规不妥协**
|
||
///! - 即使包装成ERC-721，仍保留KYC/AML检查
|
||
///! - 合规状态在NAC链上验证
|
||
///! - 冻结机制跨链同步
|
||
///!
|
||
///! ## 架构
|
||
///!
|
||
///! ```text
|
||
///! ┌─────────────────────────────────────────────────────────┐
|
||
///! │ NAC原生生态（核心） │
|
||
///! │ ┌──────────────────────────────────────────────────┐ │
|
||
///! │ │ ACC-20 Enhanced + GNACS + 主权管理 + 合规引擎 │ │
|
||
///! │ └──────────────────────────────────────────────────┘ │
|
||
///! │ ↕ │
|
||
///! │ ┌──────────────────────────────────────────────────┐ │
|
||
///! │ │ ACC-20C兼容层（战略桥梁） │ │
|
||
///! │ │ - 包装器合约 │ │
|
||
///! │ │ - 状态同步引擎 │ │
|
||
///! │ │ - 元数据生成器 │ │
|
||
///! │ └──────────────────────────────────────────────────┘ │
|
||
///! └─────────────────────────────────────────────────────────┘
|
||
///! ↕
|
||
///! ┌─────────────────────────────────────────────────────────┐
|
||
///! │ 以太坊生态（流动性来源） │
|
||
///! │ ERC-721标准 + OpenSea + MetaMask + DeFi协议 │
|
||
///! └─────────────────────────────────────────────────────────┘
|
||
///! ```
|
||
///!
|
||
///! ## 核心组件
|
||
///!
|
||
///! ### 1. 包装器合约（Wrapper）
|
||
///! - 锁定ACC-20资产
|
||
///! - 铸造ERC-721 NFT
|
||
///! - 管理包装/解包装流程
|
||
///!
|
||
///! ### 2. 状态同步引擎（SyncEngine）
|
||
///! - 监听两条链的事件
|
||
///! - 同步状态变更
|
||
///! - 处理跨链消息
|
||
///!
|
||
///! ### 3. 元数据生成器（MetadataGenerator）
|
||
///! - 生成ERC-721元数据
|
||
///! - 包含GNACS信息
|
||
///! - 符合OpenSea标准
|
||
///!
|
||
///! ### 4. 权限代理系统（PermissionProxy）
|
||
///! - 跨链权限验证
|
||
///! - 合规检查代理
|
||
///! - 主权规则验证
|
||
///!
|
||
///! ## 使用流程
|
||
///!
|
||
///! ### 包装（Wrap）
|
||
///! ```text
|
||
///! 1. 用户在NAC链上调用wrap()
|
||
///! 2. 锁定ACC-20资产
|
||
///! 3. 生成包装记录
|
||
///! 4. 同步引擎监听事件
|
||
///! 5. 在以太坊链铸造ERC-721
|
||
///! 6. 用户可在OpenSea交易
|
||
///! ```
|
||
///!
|
||
///! ### 解包装（Unwrap）
|
||
///! ```text
|
||
///! 1. 用户在以太坊链销毁ERC-721
|
||
///! 2. 同步引擎监听事件
|
||
///! 3. 在NAC链验证合规性
|
||
///! 4. 解锁ACC-20资产
|
||
///! 5. 转回用户账户
|
||
///! ```
|
||
///!
|
||
///! ## 重要说明
|
||
///!
|
||
///! ⚠️ **ACC-20C不是NAC的核心，而是生态扩展**
|
||
///!
|
||
///! - NAC的核心是ACC-20 Enhanced + GNACS + 主权管理
|
||
///! - ACC-20C只是为了冷启动和流动性
|
||
///! - 随着NAC生态成熟，ACC-20C的重要性会逐渐降低
|
||
///! - 最终目标是建立完全独立的NAC原生生态
|
||
|
||
pub mod wrapper;
|
||
pub mod sync_engine;
|
||
pub mod metadata_generator;
|
||
pub mod permission_proxy;
|
||
|
||
pub use wrapper::*;
|
||
pub use sync_engine::*;
|
||
pub use metadata_generator::*;
|
||
pub use permission_proxy::*;
|