Vault
Last updated
Last updated
In the TermMax protocol, a Vault is a smart contract that enables third-party fund management and profit sharing. Vaults are managed by - specialized entities who deploy capital strategically across different markets to generate returns for liquidity providers who deposit assets into the vault.
A Vault in TermMax serves as a managed investment vehicle that:
: Aggregates funds from multiple depositors
Deploys Strategy: Places range orders across different markets based on curator expertise
Shares Returns: Distributes profits to liquidity providers proportionally to their contributions
Implements : Follows the tokenized vault standard for interoperability
Vaults can connect to multiple markets as long as they use the same debt token, allowing for diversified strategies across different markets and risk profiles.
Vaults in the TermMax protocol feature:
ERC-4626 Compliance: Standardized interface for deposit, withdrawal and share accounting
Order Management: Capability to create and manage orders across multiple markets
Queuing System: Priority-based deposit and withdrawal queues for optimal capital allocation
Role-Based Access: Separate permissions for different operational aspects
Timelock Protection: Enforced waiting periods for sensitive parameter changes
Vaults in TermMax have certain restrictions:
Are subject to capacity limits to prevent over-concentration of capital
Must respect timelock periods for parameter changes
Curator: Primary manager with order creation and parameter setting authority
Guardian: Safety oversight role that can block pending changes during timelock periods
Allocator: Manages capital allocation through queue prioritization
The access control for vault-specific roles follows these principles:
The vault owner always has access to all roles
The Curator also has Allocator privileges
Multiple addresses can be assigned as Allocators
Each role has specific permissions that cannot be accessed by other roles
Role verification occurs before any restricted function execution
Many operations initiated by the Curator undergo a timelock period before they can be applied. The timelock system follows a three-step process:
Submit - A change is proposed (typically by the Curator)
Wait - The change enters a timelock period (default: 1 day)
Accept - After timelock expiration, the change can be accepted
During the timelock period, the Guardian role has the ability to review and potentially revoke the pending change.
TermMax employs an innovative asymmetric timelock design, where:
Risk-Reducing Changes - Applied immediately without timelock:
Increasing timelock duration
Decreasing performance fee rate
Removing market whitelisting
Risk-Increasing Changes - Require full timelock period:
Decreasing timelock duration
Increasing performance fee rate
Adding market whitelist
Changing guardian
This allows for quick response to reduce risk while maintaining careful review for changes that increase risk.
The vault is deployed with initial parameters (asset token, name, timelock duration)
A curator is assigned to manage the vault
A guardian is assigned to provide security oversight
Liquidity providers deposit the vault's asset token (e.g., USDC)
They receive vault shares (ERC-4626 tokens) representing their proportional ownership
The curator deploys the capital through range orders based on their strategy
The curator identifies a favorable market opportunity
The order is funded from the vault's capital
As the order is filled, the vault earns fees and spread
Liquidity providers redeem their vault shares
The vault processes withdrawals based on the withdrawal queue priority
The curator may need to adjust orders or redeem positions to fulfill large withdrawals
Liquidity providers receive their principal plus any earned profits
The curator earns performance fees based on profits generated
Performance fees are calculated as a percentage of returns (set by the curator with timelock protection)
The curator can withdraw earned performance fees via a designated function
Asset Token: The ERC-20 token that liquidity providers deposit (e.g., USDC)
Capacity: Maximum total value locked (TVL) in the vault
Performance Fee Rate: Percentage of profits allocated to the curator
Timelock Duration: Waiting period for sensitive parameter changes (1-30 days)
When curators create orders, they specify:
Market: The whitelisted market to interact with
Maximum Supply: Total order size limit
Initial Reserve: Initial amount allocated to the order
Curve Cuts: Pricing curve configuration determining rates offered
Order Type: Lending or Two-Way order
Maintain diversification across multiple markets to reduce concentration risk
Set conservative LTV ratios when creating orders
Monitor market conditions regularly to adjust strategies
Maintain sufficient reserves for withdrawal requests
Set realistic performance fee rates (typically 10-20%)
Implement appropriate timelock durations based on strategy volatility
Gradually adjust parameters to avoid market disruption
Consider liquidity provider interests when configuring orders
Thoroughly evaluate market risk before whitelisting
Consider correlation between markets in the portfolio
Monitor market activity after whitelisting
Revoke whitelist if risks emerge
Maintain clear communication with liquidity providers
Document strategy changes and performance
Regularly review order performance and adjust as needed
Plan for contingencies in case of market disruption
Initial Lending Only: The vault must first act as a lender by providing debt tokens to the market.
Borrowing Through FT Sales: The vault can only borrow by selling FT tokens it has acquired through its lending activities.
No Direct Collateralization: Unlike individual range order setters, vaults cannot directly collateralize tokens to borrow. This restriction exists because the vault itself holds user deposits, making direct collateralization complex from a risk management perspective.
This design choice ensures that vault borrowing is always backed by lending activities first, providing an added layer of security for vault depositors and maintaining a clear capital flow within the vault ecosystem.
Vaults and Curators form the backbone of third-party fund management in the TermMax protocol. Curators leverage their expertise to manage capital efficiently across markets, while the carefully designed governance structure ensures security through timelock protection and role separation. The ERC-4626 standard provides liquidity providers with a familiar and interoperable way to participate in TermMax strategies, while earning returns proportional to their investment.
The system balances curator flexibility with appropriate constraints to protect liquidity providers, creating a sustainable ecosystem for managed fixed-rate lending and borrowing positions.
Can only be associated with and
Cannot create (these can only be created by individual range order setters)
In Two-Way Range Orders, curators can only lend first and then borrow by selling ; they cannot collateralize tokens to borrow directly
They create a with specific pricing curve parameters
In created by vault curators, the borrowing mechanism has a specific restriction: