Vault Factory

Technical reference for the Aleph Vault Factory smart contract.

Overview

The AlephVaultFactory is responsible for deploying new Aleph Vault instances with consistent configuration and tracking all deployed vaults.

Interface

IAlephVaultFactory

interface IAlephVaultFactory {
    // View functions
    function isValidVault(address _vault) external view returns (bool);
    
    // Deployment
    function deployVault(
        IAlephVault.UserInitializationParams calldata _userInitializationParams
    ) external returns (address);
    
    // Configuration (Operations Multisig only)
    function setOperationsMultisig(address _operationsMultisig) external;
    function setOracle(address _oracle) external;
    function setGuardian(address _guardian) external;
    function setAuthSigner(address _authSigner) external;
    function setModuleImplementation(bytes4 _module, address _implementation) external;
}

Data Structures

InitializationParams

Factory-level configuration set during factory deployment:

struct InitializationParams {
    address beacon;                              // Vault implementation beacon
    address operationsMultisig;                  // System admin
    address oracle;                              // NAV oracle
    address guardian;                            // Emergency pause
    address authSigner;                          // Signature signer
    address accountant;                          // Fee collection
    address alephVaultDepositImplementation;     // Deposit module
    address alephVaultRedeemImplementation;      // Redeem module
    address alephVaultSettlementImplementation;  // Settlement module
    address feeManagerImplementation;            // Fee module
    address migrationManagerImplementation;      // Migration module
}

UserInitializationParams

Parameters provided by the manager when deploying a vault:

struct UserInitializationParams {
    string name;                           // Vault name
    string configId;                       // Configuration identifier
    address underlyingToken;               // Deposit token
    address custodian;                     // Where vault funds are held
    address vaultTreasury;                 // Where fees are collected
    ShareClassParams shareClassParams;     // Default share class config
    AuthLibrary.AuthSignature authSignature;  // Deployment authorization
}

ShareClassParams

Configuration for the default share class:

struct ShareClassParams {
    uint32 managementFee;      // Basis points per year
    uint32 performanceFee;     // Basis points on profits
    uint48 noticePeriod;       // Batches before redemption
    uint48 lockInPeriod;       // Minimum holding period
    uint256 minDepositAmount;  // Per-deposit minimum
    uint256 minUserBalance;    // Ongoing balance minimum
    uint256 maxDepositCap;     // Vault capacity
    uint256 minRedeemAmount;   // Per-redemption minimum
}

Functions

deployVault

Deploys a new Aleph Vault with the specified configuration.

function deployVault(
    IAlephVault.UserInitializationParams calldata _userInitializationParams
) external returns (address)

isValidVault

Checks if an address is a vault deployed by this factory.

function isValidVault(address _vault) external view returns (bool)

Module Identifiers

Identifier	Module
0x00000001	AlephVaultDeposit
0x00000002	AlephVaultRedeem
0x00000003	AlephVaultSettlement
0x00000004	FeeManager
0x00000005	MigrationManager

Events

// Vault deployment
event VaultDeployed(address indexed vault, address indexed manager, string name, string configId);

// Configuration changes
event OperationsMultisigSet(address indexed operationsMultisig);
event OracleSet(address indexed oracle);
event GuardianSet(address indexed guardian);
event AuthSignerSet(address indexed authSigner);
event ManagementFeeSet(uint32 indexed managementFee);
event PerformanceFeeSet(uint32 indexed performanceFee);
event ModuleImplementationSet(bytes4 indexed module, address indexed implementation);