Vaults

Product Overview

Vaults are specialized asset managers in the ZeUSD protocol, implementing the BaseVault interface to handle specific asset types and their interactions. The current implementation focuses on USYC vault management with support for secondary assets.

Core Components

1. Asset Management System

The Asset Management System handles both primary (USYC) and secondary assets through a structured approach:

1.1 Asset Registry

// Supported assets tracking
mapping(address => bool) private _supportedAssets;
address private immutable _primaryAsset;

Key Features:

Primary asset immutability
Dynamic secondary asset support
Asset validation checks
Event emission for tracking

2. Deposit Flow

Key Components:

Asset type detection
Amount validation
Slippage protection
Transfer security

3. Emergency Control System

Features:

Emergency mode activation
Time-delayed withdrawals
Admin-only controls
Event logging

4. Asset Support Management

Implementation:

function addAsset(
    address asset,
    string calldata reason
) external override {
    // Validation and addition logic
    emit Vault_AssetAdded(asset, reason);
}

5. Error Handling

Comprehensive error system:

error Vault_Unauthorized(address caller);
error Vault_AssetNotSupported(address asset);
error Vault_InvalidAmount();
error Vault_EmergencyModeActive(uint256 timestamp);
error Vault_SlippageExceeded(uint256 expected, uint256 actual, uint256 maxSlippage);

6. Events

event VaultPrimaryAssetOperation(
    address indexed user,
    uint256 amount,
    bool isDeposit
);

event VaultSecondaryAssetOperation(
    address indexed asset,
    address indexed user,
    uint256 amount,
    bool isDeposit
);