# YT资产金库系统操作流程图 ## 目录 1. [创建Vault流程](#1-创建vault流程) 2. [用户存款流程（depositYT）](#2-用户存款流程deposityt) 3. [用户提款流程（withdrawYT）](#3-用户提款流程withdrawyt) 4. [价格更新流程](#4-价格更新流程) 5. [资产管理流程 - 提取投资](#5-资产管理流程---提取投资) 6. [资产管理流程 - 归还资产](#6-资产管理流程---归还资产) 7. [批量操作流程](#7-批量操作流程) 8. [查询信息流程](#8-查询信息流程) 9. [暂停功能流程](#9-暂停功能流程) --- ## 1. 创建Vault流程 ``` ┌─────────────────────────────────────────────────────────────────────┐ │ Owner (系统管理员) │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 1. 调用 createVault() │ name: "YT-A Token" │ symbol: "YT-A" │ manager: 0x123... │ hardCap: 1,000,000 YT │ wusd: 0x7Cd...（或0使用默认） │ redemptionTime: 2025-02-15 00:00:00 │ initialWusdPrice: 1.05e30 │ initialYtPrice: 1.05e30 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ YTAssetFactory.sol │ │ ───────────────────────────────────────────────────────────────── │ │ function createVault(...) │ │ │ │ 权限检查： │ │ ✓ onlyOwner - 只有Factory owner可以创建 │ │ ✓ manager != address(0) - 管理员地址有效 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 2. 确定硬顶值 │ _hardCap == 0 ? defaultHardCap : _hardCap │ → 使用传入的 1,000,000 YT ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 编码初始化数据 │ │ ───────────────────────────────────────────────────────────────── │ │ bytes memory initData = abi.encodeWithSelector( │ │ YTAssetVault.initialize.selector, │ │ "YT-A Token", │ │ "YT-A", │ │ 0x123..., // manager │ │ 1000000e18, // hardCap │ │ 0x7Cd..., // wusd │ │ 1739577600, // redemptionTime (Unix时间戳) │ │ 1050000000000000000000000000000, // 1.05e30 │ │ 1050000000000000000000000000000 // 1.05e30 │ │ ) │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 3. 部署ERC1967代理合约 │ new ERC1967Proxy(vaultImplementation, initData) ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 部署并初始化YTAssetVault │ │ ───────────────────────────────────────────────────────────────── │ │ 新合约地址: 0xVault001... │ │ │ │ ① __ERC20_init("YT-A Token", "YT-A") │ │ • 初始化ERC20代币 │ │ • name: "YT-A Token" │ │ • symbol: "YT-A" │ │ • decimals: 18 │ │ │ │ ② __UUPSUpgradeable_init() │ │ • 初始化UUPS升级模式 │ │ │ │ ③ __ReentrancyGuard_init() │ │ • 初始化重入保护 │ │ │ │ ④ 设置基本参数 │ │ factory = msg.sender (YTAssetFactory地址) │ │ manager = 0x123... │ │ hardCap = 1,000,000 * 1e18 │ │ wusdAddress = 0x7Cd... │ │ │ │ ⑤ __Pausable_init() │ │ • 初始化暂停功能（默认未暂停） │ │ │ │ ⑥ 设置价格（精度1e30） │ │ wusdPrice = 1.05e30 (初始价格1.05) │ │ ytPrice = 1.05e30 (初始价格1.05) │ │ │ │ ⑦ 设置赎回时间 │ │ nextRedemptionTime = 1739577600 (2025-02-15) │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 4. 记录到Factory ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ Factory状态更新 │ │ ───────────────────────────────────────────────────────────────── │ │ allVaults.push(0xVault001...) │ │ isVault[0xVault001...] = true │ │ │ │ 触发事件： │ │ emit VaultCreated( │ │ 0xVault001..., │ │ 0x123..., // manager │ │ "YT-A Token", │ │ "YT-A", │ │ 1000000e18, // hardCap │ │ 0 // index │ │ ) │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 5. 返回vault地址 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 创建完成 │ │ ───────────────────────────────────────────────────────────────── │ │ 返回值: 0xVault001... │ │ │ │ Vault状态： │ │ • totalSupply: 0 │ │ • totalAssets: 0 WUSD │ │ • wusdPrice: 1.05 (精度1e30) │ │ • ytPrice: 1.05 (精度1e30) │ │ • hardCap: 1,000,000 YT │ │ • nextRedemptionTime: 2025-02-15 00:00:00 │ │ • 可接受用户存款 ✓ │ └─────────────────────────────────────────────────────────────────────┘ ``` --- ## 2. 用户存款流程（depositYT） ``` ┌─────────────────────────────────────────────────────────────────────┐ │ 用户 (User) │ │ 持有: 10,000 WUSD │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 0. 预览操作（可选） │ 调用 previewBuy(10000e18) ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ YTAssetVault.sol │ │ ───────────────────────────────────────────────────────────────── │ │ function previewBuy(10000e18) returns (uint256 ytAmount) │ │ │ │ 计算逻辑： │ │ ytAmount = (wusdAmount × wusdPrice) ÷ ytPrice │ │ = (10,000 × 1.05e30) ÷ 1.05e30 │ │ = 10,000 YT │ │ │ │ 返回预览结果: 10,000 YT │ └─────────────────────────────────────────────────────────────────────┘ │ │ 1. 授权WUSD给Vault │ WUSD.approve(vault, 10000e18) ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ WUSD授权检查 │ │ ✓ allowance[user][vault] >= 10,000 WUSD │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 2. 调用 depositYT(10000e18) ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ YTAssetVault.depositYT() │ │ ───────────────────────────────────────────────────────────────── │ │ function depositYT(uint256 _wusdAmount) │ │ • 非重入保护: nonReentrant │ │ • 暂停检查: whenNotPaused │ │ • 参数: 10,000 WUSD │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 3. 参数验证 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 参数检查 │ │ ───────────────────────────────────────────────────────────────── │ │ ① _wusdAmount > 0 │ │ ✓ 10,000 > 0 通过 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 4. 计算可获得的YT数量 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 计算YT数量 │ │ ───────────────────────────────────────────────────────────────── │ │ 公式：ytAmount = (wusdAmount × wusdPrice) ÷ ytPrice │ │ │ │ 当前价格： │ │ • wusdPrice = 1.05e30 │ │ • ytPrice = 1.05e30 │ │ │ │ 计算过程： │ │ ytAmount = (10,000e18 × 1.05e30) ÷ 1.05e30 │ │ = 10,000e18 │ │ = 10,000 YT │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 5. 检查硬顶限制 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 硬顶检查 │ │ ───────────────────────────────────────────────────────────────── │ │ if (hardCap > 0 && totalSupply() + ytAmount > hardCap) │ │ revert HardCapExceeded() │ │ │ │ 当前状态： │ │ • hardCap = 1,000,000 YT │ │ • totalSupply() = 0 YT (首次存款) │ │ • ytAmount = 10,000 YT │ │ • 0 + 10,000 = 10,000 ≤ 1,000,000 ✓ 通过 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 6. 转入WUSD（CEI模式 - Checks完成） ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 代币转移（Effects） │ │ ───────────────────────────────────────────────────────────────── │ │ IERC20(wusdAddress).safeTransferFrom( │ │ msg.sender, // 用户地址 │ │ address(this), // Vault地址 │ │ 10000e18 // 转入10,000 WUSD │ │ ) │ │ │ │ 结果： │ │ • 用户WUSD余额: 10,000 → 0 │ │ • Vault WUSD余额: 0 → 10,000 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 7. 铸造YT代币给用户 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 铸造YT代币 │ │ ───────────────────────────────────────────────────────────────── │ │ _mint(msg.sender, 10000e18) │ │ │ │ ERC20铸造： │ │ • balanceOf[user] += 10,000 YT │ │ • totalSupply += 10,000 YT │ │ │ │ 结果： │ │ • 用户YT余额: 0 → 10,000 YT │ │ • 总供应量: 0 → 10,000 YT │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 8. 触发事件 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 事件记录（Interactions） │ │ ───────────────────────────────────────────────────────────────── │ │ emit Buy( │ │ msg.sender, // 用户地址 │ │ 10000e18, // WUSD数量 │ │ 10000e18 // YT数量 │ │ ) │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 9. 返回YT数量 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 存款完成 │ │ ───────────────────────────────────────────────────────────────── │ │ 用户最终状态： │ │ • WUSD余额: 0 │ │ • YT余额: 10,000 YT │ │ │ │ Vault最终状态： │ │ • totalSupply: 10,000 YT │ │ • totalAssets: 10,000 WUSD │ │ • idleAssets: 10,000 WUSD │ │ • managedAssets: 0 WUSD │ │ │ │ 返回值: 10,000 YT │ └─────────────────────────────────────────────────────────────────────┘ ``` --- ## 3. 用户提款流程（withdrawYT） ``` ┌─────────────────────────────────────────────────────────────────────┐ │ 用户 (User) │ │ 持有: 5,000 YT │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 0. 预览操作（可选） │ 调用 previewSell(5000e18) ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ YTAssetVault.sol │ │ ───────────────────────────────────────────────────────────────── │ │ function previewSell(5000e18) returns (uint256 wusdAmount) │ │ │ │ 计算逻辑： │ │ wusdAmount = (ytAmount × ytPrice) ÷ wusdPrice │ │ = (5,000 × 1.05e30) ÷ 1.05e30 │ │ = 5,000 WUSD │ │ │ │ 返回预览结果: 5,000 WUSD │ └─────────────────────────────────────────────────────────────────────┘ │ │ 1. 检查赎回时间（可选） │ 调用 canRedeemNow() ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 赎回时间检查 │ │ ───────────────────────────────────────────────────────────────── │ │ function canRedeemNow() returns (bool) │ │ return block.timestamp >= nextRedemptionTime │ │ │ │ 检查： │ │ • 当前时间: 2025-02-16 10:00:00 (1739692800) │ │ • 赎回时间: 2025-02-15 00:00:00 (1739577600) │ │ • 1739692800 >= 1739577600 ✓ 可以赎回 │ │ │ │ getTimeUntilNextRedemption() = 0 秒 │ └─────────────────────────────────────────────────────────────────────┘ │ │ 2. 调用 withdrawYT(5000e18) ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ YTAssetVault.withdrawYT() │ │ ───────────────────────────────────────────────────────────────── │ │ function withdrawYT(uint256 _ytAmount) │ │ • 非重入保护: nonReentrant │ │ • 暂停检查: whenNotPaused │ │ • 参数: 5,000 YT │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 3. 多重验证 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 参数检查 │ │ ───────────────────────────────────────────────────────────────── │ │ ① _ytAmount > 0 │ │ ✓ 5,000 > 0 通过 │ │ │ │ ② balanceOf(msg.sender) >= _ytAmount │ │ ✓ 10,000 >= 5,000 通过 │ │ (用户持有足够的YT) │ │ │ │ ③ block.timestamp >= nextRedemptionTime │ │ ✓ 2025-02-16 >= 2025-02-15 通过 │ │ (已到赎回时间) │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 4. 计算可获得的WUSD数量 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 计算WUSD数量 │ │ ───────────────────────────────────────────────────────────────── │ │ 公式：wusdAmount = (ytAmount × ytPrice) ÷ wusdPrice │ │ │ │ 假设价格已更新： │ │ • wusdPrice = 1.00e30 (WUSD价格回落到1.0) │ │ • ytPrice = 1.10e30 (YT价格上涨到1.1) │ │ │ │ 计算过程： │ │ wusdAmount = (5,000e18 × 1.10e30) ÷ 1.00e30 │ │ = (5,000e18 × 1.10) ÷ 1.00 │ │ = 5,500e18 │ │ = 5,500 WUSD │ │ │ │ 用户获得收益: 5,500 - 5,000 = 500 WUSD (10%增值) │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 5. 检查Vault流动性 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 流动性检查 │ │ ───────────────────────────────────────────────────────────────── │ │ uint256 availableWUSD = IERC20(wusdAddress).balanceOf(vault) │ │ if (wusdAmount > availableWUSD) revert InsufficientWUSD() │ │ │ │ 当前状态： │ │ • Vault中WUSD余额: 10,000 WUSD │ │ • 需要支付: 5,500 WUSD │ │ • 5,500 ≤ 10,000 ✓ 流动性充足 │ │ │ │ 注意： │ │ 如果manager已提取部分资金进行投资，availableWUSD可能不足 │ │ 此时用户需要等待manager归还资金 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 6. 销毁用户的YT（CEI - Effects） ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 销毁YT代币 │ │ ───────────────────────────────────────────────────────────────── │ │ _burn(msg.sender, 5000e18) │ │ │ │ ERC20销毁： │ │ • balanceOf[user] -= 5,000 YT │ │ • totalSupply -= 5,000 YT │ │ │ │ 结果： │ │ • 用户YT余额: 10,000 → 5,000 YT │ │ • 总供应量: 10,000 → 5,000 YT │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 7. 转出WUSD给用户 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 代币转移（Interactions） │ │ ───────────────────────────────────────────────────────────────── │ │ IERC20(wusdAddress).safeTransfer( │ │ msg.sender, // 用户地址 │ │ 5500e18 // 转出5,500 WUSD │ │ ) │ │ │ │ 结果： │ │ • Vault WUSD余额: 10,000 → 4,500 │ │ • 用户WUSD余额: 0 → 5,500 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 8. 触发事件 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 事件记录 │ │ ───────────────────────────────────────────────────────────────── │ │ emit Sell( │ │ msg.sender, // 用户地址 │ │ 5000e18, // YT数量 │ │ 5500e18 // WUSD数量 │ │ ) │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 9. 返回WUSD数量 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 提款完成 │ │ ───────────────────────────────────────────────────────────────── │ │ 用户最终状态： │ │ • YT余额: 5,000 YT (剩余) │ │ • WUSD余额: 5,500 WUSD (获得) │ │ • 收益: 500 WUSD (10%增值) │ │ │ │ Vault最终状态： │ │ • totalSupply: 5,000 YT │ │ • totalAssets: 4,500 WUSD (假设无managedAssets) │ │ • idleAssets: 4,500 WUSD │ │ │ │ 返回值: 5,500 WUSD │ └─────────────────────────────────────────────────────────────────────┘ ``` --- ## 4. 价格更新流程 ``` ┌─────────────────────────────────────────────────────────────────────┐ │ Oracle / Manager │ │ 接收到最新价格数据： │ │ • WUSD价格: $1.02 │ │ • YT-A价格: $1.15 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 方式1: Manager直接更新 │ 调用 vault.updatePrices() │ │ 方式2: Factory批量更新 │ 调用 factory.updateVaultPrices() ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ YTAssetVault.updatePrices() │ │ ───────────────────────────────────────────────────────────────── │ │ function updatePrices( │ │ uint256 _wusdPrice, // 1.02e30 │ │ uint256 _ytPrice // 1.15e30 │ │ ) external onlyManager │ │ │ │ 权限检查： │ │ • msg.sender == manager ✓ 或 │ │ • msg.sender == factory ✓ │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 1. 价格验证 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 价格有效性检查 │ │ ───────────────────────────────────────────────────────────────── │ │ if (_wusdPrice == 0 || _ytPrice == 0) │ │ revert InvalidPrice() │ │ │ │ 检查： │ │ • _wusdPrice = 1.02e30 ≠ 0 ✓ │ │ • _ytPrice = 1.15e30 ≠ 0 ✓ │ │ │ │ 注意： │ │ • 价格必须 > 0 │ │ • 价格精度为1e30 │ │ • 没有时间间隔限制，可随时更新 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 2. 更新价格状态 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 更新存储状态 │ │ ───────────────────────────────────────────────────────────────── │ │ wusdPrice = _wusdPrice │ │ ytPrice = _ytPrice │ │ │ │ 更新前： │ │ • wusdPrice: 1.05e30 → 1.02e30 (下降2.86%) │ │ • ytPrice: 1.05e30 → 1.15e30 (上涨9.52%) │ │ │ │ 影响： │ │ ① 后续depositYT计算变化 │ │ ytAmount = wusdAmount × 1.02 / 1.15 │ │ → 用户用相同WUSD获得更少YT │ │ │ │ ② 后续withdrawYT计算变化 │ │ wusdAmount = ytAmount × 1.15 / 1.02 │ │ → 用户用相同YT获得更多WUSD │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 3. 触发事件 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 事件记录 │ │ ───────────────────────────────────────────────────────────────── │ │ emit PriceUpdated( │ │ 1020000000000000000000000000000, // wusdPrice │ │ 1150000000000000000000000000000, // ytPrice │ │ 1739692800 // timestamp │ │ ) │ │ │ │ 链下监听： │ │ • 前端可监听此事件更新UI显示 │ │ • 用户可看到最新的兑换比率 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 4. 完成更新 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 更新完成 │ │ ───────────────────────────────────────────────────────────────── │ │ 当前兑换比率示例： │ │ │ │ 存款 (depositYT): │ │ • 1,000 WUSD → (1,000 × 1.02) / 1.15 = 886.96 YT │ │ │ │ 提款 (withdrawYT): │ │ • 1,000 YT → (1,000 × 1.15) / 1.02 = 1,127.45 WUSD │ │ │ │ YT持有者收益： │ │ • 价格从1.05到1.15，增值9.52% │ │ • 持有1,000 YT相当于价值1,127.45 WUSD │ └─────────────────────────────────────────────────────────────────────┘ ``` --- ## 5. 资产管理流程 - 提取投资 ``` ┌─────────────────────────────────────────────────────────────────────┐ │ Manager (资产管理员) │ │ 计划: 提取50,000 WUSD进行外部投资 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 1. 调用 withdrawForManagement() │ _to: manager地址 │ _amount: 50,000 WUSD ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ YTAssetVault.withdrawForManagement() │ │ ───────────────────────────────────────────────────────────────── │ │ function withdrawForManagement( │ │ address _to, // 0x123... (manager) │ │ uint256 _amount // 50,000 WUSD │ │ ) external onlyManager nonReentrant whenNotPaused │ │ │ │ 权限检查： │ │ ✓ onlyManager - 只有manager可调用 │ │ ✓ nonReentrant - 重入保护 │ │ ✓ whenNotPaused - 暂停检查 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 2. 参数验证 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 验证检查 │ │ ───────────────────────────────────────────────────────────────── │ │ ① if (_amount == 0) revert InvalidAmount() │ │ ✓ 50,000 > 0 通过 │ │ │ │ ② uint256 availableAssets = vault.balance(WUSD) │ │ if (_amount > availableAssets) revert InvalidAmount() │ │ │ │ Vault当前状态： │ │ • totalAssets: 100,000 WUSD │ │ • idleAssets: 100,000 WUSD (全部在vault中) │ │ • managedAssets: 0 WUSD │ │ │ │ 检查： │ │ • availableAssets = 100,000 WUSD │ │ • 50,000 ≤ 100,000 ✓ 通过 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 3. 更新managedAssets（CEI - Effects） ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 状态更新 │ │ ───────────────────────────────────────────────────────────────── │ │ managedAssets += _amount │ │ │ │ 更新： │ │ • managedAssets: 0 → 50,000 WUSD │ │ │ │ 重要说明： │ │ managedAssets记录了被管理员提取、正在进行外部投资的WUSD数量 │ │ 这部分资产不在vault合约中，但仍计入totalAssets │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 4. 转出WUSD（Interactions） ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 代币转移 │ │ ───────────────────────────────────────────────────────────────── │ │ IERC20(wusdAddress).safeTransfer( │ │ _to, // manager地址 │ │ 50000e18 // 50,000 WUSD │ │ ) │ │ │ │ 转账结果： │ │ • Vault WUSD余额: 100,000 → 50,000 WUSD │ │ • Manager WUSD余额: +50,000 WUSD │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 5. 触发事件 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 事件记录 │ │ ───────────────────────────────────────────────────────────────── │ │ emit AssetsWithdrawn( │ │ 0x123..., // manager地址 │ │ 50000e18 // 提取数量 │ │ ) │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 6. 提取完成 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 提取完成 │ │ ───────────────────────────────────────────────────────────────── │ │ Vault最终状态： │ │ • totalAssets(): 100,000 WUSD (不变!) │ │ 计算: idleAssets + managedAssets │ │ = 50,000 + 50,000 = 100,000 │ │ │ │ • idleAssets(): 50,000 WUSD │ │ (vault合约实际持有的WUSD) │ │ │ │ • managedAssets: 50,000 WUSD │ │ (manager正在管理的WUSD) │ │ │ │ • totalSupply: 100,000 YT (不变) │ │ │ │ 用户影响： │ │ ✓ totalAssets不变，YT价值不受影响 │ │ ✓ 用户依然持有相同价值的YT份额 │ │ ✗ 暂时无法提款（流动性不足），需等待manager归还 │ │ │ │ Manager后续操作： │ │ → 用50,000 WUSD进行DeFi投资 │ │ → 赚取收益 │ │ → 通过depositManagedAssets归还 │ └─────────────────────────────────────────────────────────────────────┘ ``` --- ## 6. 资产管理流程 - 归还资产 ``` ┌─────────────────────────────────────────────────────────────────────┐ │ Manager (资产管理员) │ │ 投资收益情况： │ │ • 提取: 50,000 WUSD │ │ • 投资收益: +5,000 WUSD │ │ • 准备归还: 55,000 WUSD (本金+利润) │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 1. 授权WUSD给Vault │ WUSD.approve(vault, 55000e18) ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ WUSD授权检查 │ │ ✓ allowance[manager][vault] >= 55,000 WUSD │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 2. 调用 depositManagedAssets() │ _amount: 55,000 WUSD ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ YTAssetVault.depositManagedAssets() │ │ ───────────────────────────────────────────────────────────────── │ │ function depositManagedAssets( │ │ uint256 _amount // 55,000 WUSD │ │ ) external onlyManager nonReentrant whenNotPaused │ │ │ │ 权限检查： │ │ ✓ onlyManager - 只有manager可调用 │ │ ✓ nonReentrant - 重入保护 │ │ ✓ whenNotPaused - 暂停检查 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 3. 参数验证 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 验证检查 │ │ ───────────────────────────────────────────────────────────────── │ │ if (_amount == 0) revert InvalidAmount() │ │ ✓ 55,000 > 0 通过 │ │ │ │ 当前Vault状态： │ │ • idleAssets: 50,000 WUSD │ │ • managedAssets: 50,000 WUSD │ │ • totalAssets: 100,000 WUSD │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 4. 更新managedAssets（CEI - Effects） ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 状态更新（关键逻辑） │ │ ───────────────────────────────────────────────────────────────── │ │ if (_amount >= managedAssets) { │ │ // 归还金额 >= 提取金额，清零managedAssets │ │ managedAssets = 0 │ │ } else { │ │ // 归还金额 < 提取金额，部分归还 │ │ managedAssets -= _amount │ │ } │ │ │ │ 本例计算： │ │ • _amount = 55,000 WUSD │ │ • managedAssets = 50,000 WUSD │ │ • 55,000 >= 50,000 ✓ 进入第一个分支 │ │ • managedAssets = 0 │ │ │ │ 多余的5,000 WUSD如何处理？ │ │ → 自动增加到vault余额，成为利润 │ │ → totalAssets会增加 │ │ → 所有YT持有者共享这部分收益 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 5. 转入WUSD（Interactions） ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 代币转移 │ │ ───────────────────────────────────────────────────────────────── │ │ IERC20(wusdAddress).safeTransferFrom( │ │ msg.sender, // manager地址 │ │ address(this), // vault地址 │ │ 55000e18 // 55,000 WUSD │ │ ) │ │ │ │ 转账结果： │ │ • Manager WUSD余额: -55,000 WUSD │ │ • Vault WUSD余额: 50,000 → 105,000 WUSD │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 6. 触发事件 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 事件记录 │ │ ───────────────────────────────────────────────────────────────── │ │ emit AssetsDeposited( │ │ 55000e18 // 归还数量 │ │ ) │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 7. 归还完成 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 归还完成 │ │ ───────────────────────────────────────────────────────────────── │ │ Vault最终状态： │ │ • totalAssets(): 105,000 WUSD (增加了5,000!) │ │ 计算: idleAssets + managedAssets │ │ = 105,000 + 0 = 105,000 │ │ │ │ • idleAssets(): 105,000 WUSD │ │ (vault合约实际持有的WUSD，包含收益) │ │ │ │ • managedAssets: 0 WUSD │ │ (所有资产已归还) │ │ │ │ • totalSupply: 100,000 YT (不变) │ │ │ │ 收益分配： │ │ • 投资收益: 5,000 WUSD │ │ • 收益率: 5,000 / 50,000 = 10% │ │ • 每个YT的价值提升: │ │ 之前: 100,000 WUSD / 100,000 YT = 1.0 WUSD/YT │ │ 现在: 105,000 WUSD / 100,000 YT = 1.05 WUSD/YT │ │ │ │ 用户影响： │ │ ✓ 所有YT持有者自动获得5%增值 │ │ ✓ 可以提款了（流动性恢复） │ │ ✓ 如果用户提取YT，会按1.05的比例获得更多WUSD │ │ │ │ 示例： │ │ 用户持有10,000 YT，提取时可获得： │ │ (10,000 × 1.05 WUSD/YT) = 10,500 WUSD │ │ 相比初始存入的10,000 WUSD，获利500 WUSD (5%) │ └─────────────────────────────────────────────────────────────────────┘ ``` --- ## 7. 批量操作流程 ### 7.1 批量创建Vault ``` ┌─────────────────────────────────────────────────────────────────────┐ │ Owner (系统管理员) │ │ 计划: 批量创建3个不同的YT Vault │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 调用 createVaultBatch() │ • names: ["YT-A", "YT-B", "YT-C"] │ • symbols: ["YTA", "YTB", "YTC"] │ • managers: [0x111, 0x222, 0x333] │ • hardCaps: [1000000e18, 500000e18, 2000000e18] │ • wusd: 0x7Cd... │ • redemptionTimes: [time1, time2, time3] │ • initialWusdPrices: [1.05e30, 1.05e30, 1.05e30] │ • initialYtPrices: [1.05e30, 1.02e30, 1.10e30] ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ YTAssetFactory.createVaultBatch() │ │ ───────────────────────────────────────────────────────────────── │ │ 1. 参数长度验证 │ │ require(所有数组长度相等) │ │ ✓ 所有数组长度都是3 │ │ │ │ 2. 循环创建 │ │ for (i = 0; i < 3; i++) { │ │ vaults[i] = this.createVault(...) │ │ } │ └────────────────────────────┬────────────────────────────────────────┘ │ ├─────────┬─────────┐ │ │ │ 第1个Vault │ 第2个Vault │ 第3个Vault ▼ │ ▼ │ ▼ ┌───────────────────┐ ┌───────────────────┐ ┌───────────────────┐ │ YT-A Token │ │ YT-B Token │ │ YT-C Token │ │ Symbol: YTA │ │ Symbol: YTB │ │ Symbol: YTC │ │ Manager: 0x111 │ │ Manager: 0x222 │ │ Manager: 0x333 │ │ HardCap: 1M YT │ │ HardCap: 500K YT │ │ HardCap: 2M YT │ │ YT Price: 1.05 │ │ YT Price: 1.02 │ │ YT Price: 1.10 │ │ 地址: 0xVault001 │ │ 地址: 0xVault002 │ │ 地址: 0xVault003 │ └───────────────────┘ └───────────────────┘ └───────────────────┘ │ │ │ └─────────┴─────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 批量创建完成 │ │ ───────────────────────────────────────────────────────────────── │ │ 返回值: [0xVault001, 0xVault002, 0xVault003] │ │ │ │ Factory状态： │ │ • allVaults.length: 3 │ │ • isVault[0xVault001] = true │ │ • isVault[0xVault002] = true │ │ • isVault[0xVault003] = true │ │ │ │ 优势： │ │ ✓ 一次交易创建多个vault，节省gas │ │ ✓ 原子操作，全部成功或全部失败 │ │ ✓ 统一管理多个资产池 │ └─────────────────────────────────────────────────────────────────────┘ ``` ### 7.2 批量更新价格 ``` ┌─────────────────────────────────────────────────────────────────────┐ │ Oracle / Owner │ │ 接收到3个vault的最新价格数据 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 调用 updateVaultPricesBatch() │ • vaults: [0xVault001, 0xVault002, 0xVault003] │ • wusdPrices: [1.02e30, 1.03e30, 1.01e30] │ • ytPrices: [1.15e30, 1.08e30, 1.20e30] ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ YTAssetFactory.updateVaultPricesBatch() │ │ ───────────────────────────────────────────────────────────────── │ │ 1. 参数验证 │ │ require(数组长度相等) │ │ ✓ 所有数组长度都是3 │ │ │ │ 2. 循环更新 │ │ for (i = 0; i < 3; i++) { │ │ YTAssetVault(vaults[i]).updatePrices( │ │ wusdPrices[i], │ │ ytPrices[i] │ │ ) │ │ emit PricesUpdated(vaults[i], wusdPrices[i], ytPrices[i]) │ │ } │ └────────────────────────────┬────────────────────────────────────────┘ │ ├─────────┬─────────┐ │ │ │ Vault001 │ Vault002 │ Vault003 价格更新 │ 价格更新 │ 价格更新 ▼ │ ▼ │ ▼ ┌───────────────────┐ ┌───────────────────┐ ┌───────────────────┐ │ WUSD: 1.02 │ │ WUSD: 1.03 │ │ WUSD: 1.01 │ │ YT: 1.15 │ │ YT: 1.08 │ │ YT: 1.20 │ │ 涨幅: +9.52% │ │ 涨幅: +2.88% │ │ 涨幅: +9.09% │ └───────────────────┘ └───────────────────┘ └───────────────────┘ │ │ │ └─────────┴─────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 批量更新完成 │ │ ───────────────────────────────────────────────────────────────── │ │ 优势： │ │ ✓ 一次交易更新多个vault价格 │ │ ✓ 节省gas费用 │ │ ✓ 确保所有vault价格同时更新 │ │ ✓ 适合定时任务批量更新 │ │ │ │ 触发的事件： │ │ • PricesUpdated × 3 │ │ • PriceUpdated × 3 (从各个vault) │ └─────────────────────────────────────────────────────────────────────┘ ``` ### 7.3 批量设置赎回时间 ``` ┌─────────────────────────────────────────────────────────────────────┐ │ Owner (系统管理员) │ │ 统一设置赎回时间: 2025-03-15 00:00:00 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 调用 setVaultNextRedemptionTimeBatch() │ • vaults: [0xVault001, 0xVault002, 0xVault003] │ • nextRedemptionTime: 1741996800 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ YTAssetFactory.setVaultNextRedemptionTimeBatch() │ │ ───────────────────────────────────────────────────────────────── │ │ for (i = 0; i < vaults.length; i++) { │ │ YTAssetVault(vaults[i]).setNextRedemptionTime( │ │ _nextRedemptionTime │ │ ) │ │ emit NextRedemptionTimeSet(vaults[i], _nextRedemptionTime) │ │ } │ └────────────────────────────┬────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 批量设置完成 │ │ ───────────────────────────────────────────────────────────────── │ │ 所有3个vault的赎回时间都设置为: │ │ 2025-03-15 00:00:00 │ │ │ │ 用户影响： │ │ ✓ 所有vault的用户在同一天可以赎回 │ │ ✓ 统一管理赎回周期 │ │ ✓ 类似基金的统一开放日 │ └─────────────────────────────────────────────────────────────────────┘ ``` --- ## 8. 查询信息流程 ### 8.1 查询单个Vault信息 ``` ┌─────────────────────────────────────────────────────────────────────┐ │ 前端应用 / 查询者 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 调用 vault.getVaultInfo() ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ YTAssetVault.getVaultInfo() │ │ ───────────────────────────────────────────────────────────────── │ │ function getVaultInfo() returns ( │ │ uint256 _totalAssets, │ │ uint256 _idleAssets, │ │ uint256 _managedAssets, │ │ uint256 _totalSupply, │ │ uint256 _hardCap, │ │ uint256 _wusdPrice, │ │ uint256 _ytPrice, │ │ uint256 _nextRedemptionTime │ │ ) │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 读取状态 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 返回完整信息 │ │ ───────────────────────────────────────────────────────────────── │ │ 返回示例： │ │ { │ │ totalAssets: 105000e18, // 105,000 WUSD │ │ idleAssets: 105000e18, // 105,000 WUSD │ │ managedAssets: 0, // 0 WUSD │ │ totalSupply: 100000e18, // 100,000 YT │ │ hardCap: 1000000e18, // 1,000,000 YT │ │ wusdPrice: 1020000000000000000000000000000, // 1.02 │ │ ytPrice: 1150000000000000000000000000000, // 1.15 │ │ nextRedemptionTime: 1739577600 // 2025-02-15 00:00:00 │ │ } │ │ │ │ 计算衍生指标： │ │ • 每YT价值: 105,000 / 100,000 = 1.05 WUSD │ │ • 资金利用率: (105,000 - 0) / 105,000 = 100% │ │ • 硬顶使用率: 100,000 / 1,000,000 = 10% │ │ • 当前兑换率: 1 WUSD = 1.02/1.15 = 0.887 YT │ └─────────────────────────────────────────────────────────────────────┘ ``` ### 8.2 通过Factory查询Vault信息 ``` ┌─────────────────────────────────────────────────────────────────────┐ │ 前端应用 / 查询者 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 调用 factory.getVaultInfo(vaultAddress) ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ YTAssetFactory.getVaultInfo() │ │ ───────────────────────────────────────────────────────────────── │ │ function getVaultInfo(address _vault) returns ( │ │ bool exists, │ │ uint256 totalAssets, │ │ uint256 idleAssets, │ │ uint256 managedAssets, │ │ uint256 totalSupply, │ │ uint256 hardCap, │ │ uint256 wusdPrice, │ │ uint256 ytPrice, │ │ uint256 nextRedemptionTime │ │ ) │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 1. 检查vault是否存在 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 存在性检查 │ │ ───────────────────────────────────────────────────────────────── │ │ exists = isVault[_vault] │ │ if (!exists) return (false, 0, 0, 0, 0, 0, 0, 0, 0) │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 2. 调用vault获取信息 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 返回完整信息 │ │ ───────────────────────────────────────────────────────────────── │ │ { │ │ exists: true, // ✓ vault存在 │ │ totalAssets: 105000e18, │ │ idleAssets: 105000e18, │ │ managedAssets: 0, │ │ totalSupply: 100000e18, │ │ hardCap: 1000000e18, │ │ wusdPrice: 1020000000000000000000000000000, │ │ ytPrice: 1150000000000000000000000000000, │ │ nextRedemptionTime: 1739577600 │ │ } │ │ │ │ 优势： │ │ ✓ 通过factory统一查询 │ │ ✓ 可验证vault是否为合法vault │ │ ✓ 一次调用获取所有信息 │ └─────────────────────────────────────────────────────────────────────┘ ``` ### 8.3 查询所有Vault列表 ``` ┌─────────────────────────────────────────────────────────────────────┐ │ 前端应用 / 查询者 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 1. 获取总数量 │ factory.getVaultCount() ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 获取Vault总数 │ │ ───────────────────────────────────────────────────────────────── │ │ function getVaultCount() returns (uint256) │ │ return allVaults.length │ │ │ │ 返回: 3 (有3个vault) │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 2. 获取所有vault地址 │ factory.getAllVaults() ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 获取所有Vault地址 │ │ ───────────────────────────────────────────────────────────────── │ │ function getAllVaults() returns (address[] memory) │ │ return allVaults │ │ │ │ 返回: [0xVault001, 0xVault002, 0xVault003] │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 3. 或分页查询 │ factory.getVaults(0, 2) ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 分页查询Vault地址 │ │ ───────────────────────────────────────────────────────────────── │ │ function getVaults(uint256 _start, uint256 _end) │ │ │ │ 参数: │ │ • _start: 0 (起始索引) │ │ • _end: 2 (结束索引，不包含) │ │ │ │ 返回: [0xVault001, 0xVault002] │ │ │ │ 优势： │ │ ✓ 适合vault数量很多时的分页加载 │ │ ✓ 减少单次调用的gas消耗 │ │ ✓ 改善前端加载性能 │ └─────────────────────────────────────────────────────────────────────┘ ``` --- ## 附录：重要概念说明 ### A. 价格精度 (PRICE_PRECISION) ``` 精度: 1e30 (10^30) 示例： • 价格 1.0 表示为: 1000000000000000000000000000000 (1e30) • 价格 1.05 表示为: 1050000000000000000000000000000 (1.05e30) • 价格 0.98 表示为: 980000000000000000000000000000 (0.98e30) 为什么使用1e30而不是1e18？ ✓ 更高的精度，减少舍入误差 ✓ 适合复杂的价格计算 ✓ 支持更精确的价格波动 ``` ### B. 兑换计算公式 ``` 存款 (depositYT): ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ytAmount = (wusdAmount × wusdPrice) ÷ ytPrice 示例： • 存入1,000 WUSD • wusdPrice = 1.05e30 • ytPrice = 1.10e30 • ytAmount = (1,000 × 1.05) ÷ 1.10 = 954.55 YT 提款 (withdrawYT): ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ wusdAmount = (ytAmount × ytPrice) ÷ wusdPrice 示例： • 提取1,000 YT • ytPrice = 1.10e30 • wusdPrice = 1.05e30 • wusdAmount = (1,000 × 1.10) ÷ 1.05 = 1,047.62 WUSD ``` ### C. 资产状态计算 ``` Vault资产状态： ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ totalAssets = idleAssets + managedAssets • idleAssets: vault合约中实际持有的WUSD • managedAssets: manager提取、正在投资的WUSD • totalAssets: 用户可赎回的总价值 示例： vault余额: 50,000 WUSD managedAssets: 50,000 WUSD totalAssets: 100,000 WUSD (不变) 用户持有10,000 YT，价值: (10,000 / 100,000) × 100,000 = 10,000 WUSD ``` ### D. 硬顶机制 ``` 硬顶 (Hard Cap): ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 限制YT代币的最大供应量 作用： ✓ 控制vault规模 ✓ 风险管理 ✓ 防止过度铸造 检查时机： • 每次depositYT时检查 • if (totalSupply + ytAmount > hardCap) revert 动态调整： • Factory owner可以通过setHardCap调整 • 但不能低于当前totalSupply ``` ### E. 统一赎回时间 ``` 赎回时间 (nextRedemptionTime): ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 所有用户统一的赎回开放时间 特点： ✓ 类似基金的开放日 ✓ 所有用户同时可赎回 ✓ 不是个人锁定期 检查： • block.timestamp >= nextRedemptionTime • 未到时间调用withdrawYT会revert 管理： • Factory owner可以设置 • 支持批量设置多个vault ``` ### F. CEI模式 ``` CEI模式 (Checks-Effects-Interactions): ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 安全的合约编写模式，防止重入攻击 1. Checks (检查) • 验证参数 • 检查权限 • 检查余额 2. Effects (状态更新) • 更新合约状态 • 修改余额 • 记录变化 3. Interactions (外部交互) • 转账代币 • 调用外部合约 • 触发事件 配合nonReentrant modifier，确保安全 ``` ### G. UUPS升级模式 ``` UUPS (Universal Upgradeable Proxy Standard): ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 可升级合约的标准实现方式 结构： ┌─────────────┐ │ ERC1967Proxy│ ← 用户交互的地址（不变） └──────┬──────┘ │ delegatecall ▼ ┌─────────────┐ │ Implementation│ ← 逻辑合约（可升级） └─────────────┘ 优势： ✓ 合约地址不变 ✓ 状态数据保留 ✓ 可以修复bug和添加功能 ✓ 升级权限由Factory控制 注意： • 不能在状态变量声明时初始化 • 必须使用initialize函数 • 保留__gap数组用于未来扩展 ``` --- ## 9. 暂停功能流程 ### 9.1 暂停单个Vault ``` ┌─────────────────────────────────────────────────────────────────────┐ │ Factory Owner (紧急情况) │ │ 检测到: YT-A Vault 存在安全问题 │ └────────────────────────────────┬────────────────────────────────────┘ │ │ 1. 调用 pauseVault(vaultAddress) ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ YTAssetFactory.pauseVault() │ │ ───────────────────────────────────────────────────────────────── │ │ function pauseVault(address _vault) external onlyOwner │ │ │ │ 权限检查： │ │ ✓ onlyOwner - 只有Factory owner可调用 │ │ ✓ isVault[_vault] - 验证vault存在 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 2. 调用 vault.pause() ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ YTAssetVault.pause() │ │ ───────────────────────────────────────────────────────────────── │ │ internal _pause() │ │ • 设置 paused = true │ │ • 触发 Paused 事件 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 3. 暂停生效 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ Vault已暂停 │ │ ───────────────────────────────────────────────────────────────── │ │ 被阻止的操作（revert EnforcedPause）： │ │ ✗ depositYT() - 用户无法存款 │ │ ✗ withdrawYT() - 用户无法提款 │ │ ✗ withdrawForManagement() - Manager无法提取资产 │ │ ✗ depositManagedAssets() - Manager无法归还资产 │ │ │ │ 仍可用的操作： │ │ ✓ balanceOf() - 查询余额 │ │ ✓ totalSupply() - 查询总供应 │ │ ✓ totalAssets() - 查询总资产 │ │ ✓ getVaultInfo() - 查询详细信息 │ │ ✓ previewBuy() - 预览存款 │ │ ✓ previewSell() - 预览提款 │ │ ✓ canRedeemNow() - 检查赎回状态 │ │ │ │ 用户影响： │ │ • 所有资金操作暂停 │ │ • 资产安全锁定 │ │ • 可以查看但无法操作 │ └─────────────────────────────────────────────────────────────────────┘ ``` ### 9.2 恢复单个Vault ``` ┌─────────────────────────────────────────────────────────────────────┐ │ Factory Owner (问题已解决) │ │ 安全问题已修复，可以恢复正常运行 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 1. 调用 unpauseVault(vaultAddress) ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ YTAssetFactory.unpauseVault() │ │ ───────────────────────────────────────────────────────────────── │ │ function unpauseVault(address _vault) external onlyOwner │ │ │ │ 权限检查： │ │ ✓ onlyOwner - 只有Factory owner可调用 │ │ ✓ isVault[_vault] - 验证vault存在 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 2. 调用 vault.unpause() ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ YTAssetVault.unpause() │ │ ───────────────────────────────────────────────────────────────── │ │ internal _unpause() │ │ • 设置 paused = false │ │ • 触发 Unpaused 事件 │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 3. 恢复完成 ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ Vault恢复正常 │ │ ───────────────────────────────────────────────────────────────── │ │ 所有功能恢复： │ │ ✓ depositYT() - 用户可以存款 │ │ ✓ withdrawYT() - 用户可以提款（如已过赎回时间） │ │ ✓ withdrawForManagement() - Manager可以提取资产 │ │ ✓ depositManagedAssets() - Manager可以归还资产 │ │ │ │ 系统状态： │ │ • 所有操作恢复正常 │ │ • 用户资产未受影响 │ │ • 暂停期间的价格更新仍然有效 │ └─────────────────────────────────────────────────────────────────────┘ ``` ### 9.3 批量暂停Vaults ``` ┌─────────────────────────────────────────────────────────────────────┐ │ Factory Owner (系统级紧急) │ │ 检测到系统性风险，需要暂停多个Vault │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 1. 调用 pauseVaultBatch(vaultAddresses) │ vaults: [0xVault001, 0xVault002, 0xVault003] ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ YTAssetFactory.pauseVaultBatch() │ │ ───────────────────────────────────────────────────────────────── │ │ function pauseVaultBatch(address[] memory _vaults) │ │ │ │ 批量处理： │ │ for (i = 0; i < _vaults.length; i++) { │ │ require(isVault[_vaults[i]]) // 验证每个vault │ │ YTAssetVault(_vaults[i]).pause() │ │ } │ └────────────────────────────┬────────────────────────────────────────┘ │ ├─────────┬─────────┐ │ │ │ Vault001 │ Vault002 │ Vault003 暂停 │ 暂停 │ 暂停 ▼ │ ▼ │ ▼ ┌───────────────────┐ ┌───────────────────┐ ┌───────────────────┐ │ YT-A Vault │ │ YT-B Vault │ │ YT-C Vault │ │ 状态: PAUSED │ │ 状态: PAUSED │ │ 状态: PAUSED │ │ 所有操作冻结 │ │ 所有操作冻结 │ │ 所有操作冻结 │ └───────────────────┘ └───────────────────┘ └───────────────────┘ │ │ │ └─────────┴─────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 批量暂停完成 │ │ ───────────────────────────────────────────────────────────────── │ │ 优势： │ │ ✓ 一次交易暂停多个vault │ │ ✓ 节省gas费用 │ │ ✓ 原子操作，全部成功或全部失败 │ │ ✓ 快速响应系统性风险 │ │ │ │ 系统影响： │ │ • 所有指定vault的资金操作立即冻结 │ │ • 用户资产安全保护 │ │ • 管理员可以调查和修复问题 │ └─────────────────────────────────────────────────────────────────────┘ ``` ### 9.4 批量恢复Vaults ``` ┌─────────────────────────────────────────────────────────────────────┐ │ Factory Owner (风险已消除) │ │ 问题已解决，恢复所有暂停的Vault │ └────────────────────────────┬────────────────────────────────────────┘ │ │ 1. 调用 unpauseVaultBatch(vaultAddresses) ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ YTAssetFactory.unpauseVaultBatch() │ │ ───────────────────────────────────────────────────────────────── │ │ 批量恢复所有vault │ │ • 验证每个vault存在 │ │ • 调用每个vault的unpause() │ │ • 原子操作执行 │ └────────────────────────────┬────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────────┐ │ 系统全面恢复 │ │ ───────────────────────────────────────────────────────────────── │ │ 所有vault恢复正常运行 │ │ 用户可以继续所有操作 │ └─────────────────────────────────────────────────────────────────────┘ ``` ### 暂停功能的应用场景： ``` ┌─────────────────────────────────────────────────────────────────────┐ │ 使用场景和最佳实践 │ │ │ │ 何时使用暂停功能： │ │ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │ │ │ │ 1️⃣ 安全漏洞发现 │ │ • 发现合约安全问题 │ │ • 暂停受影响的vault │ │ • 保护用户资产 │ │ • 修复后恢复 │ │ │ │ 2️⃣ 价格异常 │ │ • 价格预言机故障 │ │ • 价格剧烈波动 │ │ • 暂停交易防止损失 │ │ • 价格稳定后恢复 │ │ │ │ 3️⃣ 系统升级 │ │ • 准备合约升级 │ │ • 暂停所有操作 │ │ • 执行升级 │ │ • 验证后恢复 │ │ │ │ 4️⃣ 流动性危机 │ │ • Manager提取资金后未及时归还 │ │ • 暂停提款防止挤兑 │ │ • 等待资金回流 │ │ • 流动性恢复后解除 │ │ │ │ 5️⃣ 监管要求 │ │ • 配合监管调查 │ │ • 临时冻结操作 │ │ • 保留完整记录 │ │ │ │ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │ │ │ │ 最佳实践： │ │ ✓ 暂停前公告（如有时间） │ │ ✓ 记录暂停原因 │ │ ✓ 快速调查和修复 │ │ ✓ 恢复前全面测试 │ │ ✓ 恢复后公告说明 │ │ │ │ 注意事项： │ │ ⚠️ 暂停不影响已持有的资产价值 │ │ ⚠️ 暂停期间价格仍可更新（由Factory） │ │ ⚠️ Manager在暂停期间也无法操作 │ │ ⚠️ 查询功能不受影响 │ └─────────────────────────────────────────────────────────────────────┘ ```