Skip to main content

Deployment & Management of EulerEarn Vaults

EulerEarn is a fork of MetaMorpho that provides a permissionless, role-based, and immutable way to curate yield strategies on top of ERC-4626 vaults. The recommended way to deploy and manage Earn vaults is via the EulerEarn Creator UI.

Deployment Workflow

Figure 1: The landing page of the EulerEarn Creator UI

  1. Dashboard & Quick Start

    • Connect your wallet and set the network you want to deploy on to get started.
    • The landing page displays a list of all the vaults the connected address has a role (e.g., owner, curator).

  2. Vault Creation

    • Click on "Deploy Vault"
    • Enter the asset address, vault name, symbol, and owner's address.
    • Click "Submit" to deploy your vault.

  3. Vault Configuration

    • Once deployed, your vault will appear in the dashboard. Click on the EulerEarn vault you want to configure.
    • From here, you'll be able to see a quick overview of your vault and management tools at your disposal.
      • Strategy: Actions that allow you to modify how your EulerEarn strategy operates
      • Roles: Actions that allow you to set the roles
      • Fee & Rewards: Actions that allow you to define how much fees are charged and handled
      • Security: Set a timelock (by default, this is set to 0 days)

Management Tools

Figure 2: The vault overview page

Strategy​

Strategy Management

From here, an owner or a curator will be able to view the current strategies, add or remove strategies, and review pending removals and cap changes. If desired, they can accept or reject pending actions.

If strategies have been added or removed, the supply and withdraw queues should be adjusted.

Change Supply Caps

From here, an owner or another curator can adjust caps for strategies. Useful for managing the different strategy exposures the vault.

Adjust Supply Queue

An owner or allocators will be able to adjust how user deposits will be allocated to the vault's underlying strategies.

note

If there is an escrow strategy, typically it should be assigned to the end of the queue.

Adjust Withdraw Queue

An owner or allocators will be able to adjust how user withdrawals will be taken from the vault's underlying strategies.

note

If there is an escrow strategy, typically it should be assigned to the front of the queue.

Reallocate Funds

An owner, a curator, or allocator will be able to reallocate how liquidity in the vault is allocated to the strategies.

Roles​

Each vault can be managed by several different addresses with a different role.

List of Roles

  • Owner: Has global powers over the vault. This is initially set at creation-time.
  • Curator: Has the ability to add new markets, adjust supply caps, and reallocate liquidity.
  • Guardian: Has the ability to veto critical actions.
  • Allocators: Has the ability to reallocate liquidity and change withdrawal/supply queues. Vaults can have multiple allocators.

Fee & Rewards​

Performance Fee & Recipient

Under this page, the owner will be able to modify the performance fee they charge from the interest earned. Additionally, they can change where fees get sent to by changing the fee receiver.

Valid fee ranges are 0% - 50%.

Security​

Timelock

In this page, an owner can set a timelock for certain actions. Timelock lengths are represented in days and once set, cannot be set to 0.