129 KiB
129 KiB
YT资产金库系统操作流程图
目录
- 创建Vault流程
- 用户存款流程（depositYT）
- 用户提款流程（withdrawYT）
- 价格更新流程
- 资产管理流程 - 提取投资
- 资产管理流程 - 归还资产
- 批量操作流程
- 查询信息流程
- 暂停功能流程
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在暂停期间也无法操作 │
│ ⚠️ 查询功能不受影响 │
└─────────────────────────────────────────────────────────────────────┘