Locked yvUSD (Cooldown Vault)

Locked yvUSD is a vault that wraps yvUSD shares and restricts withdrawals behind a cooldown period plus a withdrawal window.

Default Parameters

In the current contract code, defaults are:

• Cooldown duration: 14 days
• Withdrawal window: 5 days

These are configurable by management onchain (for example setCooldownDuration and setWithdrawalWindow).


Key Behaviors (Integrator Notes)

• Withdrawals are gated: maxWithdraw / maxRedeem will return 0 unless the owner has started a cooldown and is inside the valid withdrawal window.
• Cooldown is per-owner and will overwrite: starting a new cooldown overwrites the previous cooldown state for that owner.
• Transfer restrictions: shares that are in cooldown cannot be transferred (non-cooldown shares may still be transferable).
• Shutdown bypass: when cooldown is disabled or the strategy is shutdown, the gating checks are bypassed (behavior depends on onchain configuration).

If you integrate Locked yvUSD, assume user withdrawals can revert unless your UI guides them through the cooldown flow.

Cooldown Flow (Contract Methods)

Primary methods to be aware of:

• startCooldown(uint256 shares): starts or overwrites the cooldown for shares owned by msg.sender.
• cancelCooldown(): clears the cooldown state for msg.sender.
• maxWithdraw(address owner) / maxRedeem(address owner): returns 0 if cooldown is not active, still pending, or the withdrawal window has expired.
• getCooldownStatus(address user): returns (cooldownEnd, windowEnd, shares) for UI state.

Management methods (onchain configuration):

• setCooldownDuration(uint256): set to 0 to disable cooldown gating.
• setWithdrawalWindow(uint256): window after cooldown during which withdrawals are allowed.

Links

yvUSD developer docs index yvUSD contract addresses