Skip to main content

Integrator Guide

EulerEarn vaults are standard ERC-4626 vaults with meta-allocation logic. Users get a simple deposit/redeem experience; integrators get a familiar interface with extras like Permit2 and EVC batching.

Integrator guide

ERC-4626 Interface​

  • deposit(uint256 assets, address receiver)
  • mint(uint256 shares, address receiver)
  • withdraw(uint256 assets, address receiver, address owner)
  • redeem(uint256 shares, address receiver, address owner)

Vaults also expose totalAssets() and totalSupply(); compute exchange rate as convertToAssets(1e18 shares) or totalAssets/totalSupply.

Approvals & Permit2​

Support Uniswap’s Permit2 for gasless approvals if your wallet/app supports it; otherwise request a standard ERC-20 approval flow.

Batching via EVC​

Advanced flows can batch actions atomically with Euler’s Ethereum Vault Connector (EVC). For simple Earn usage, direct vault calls suffice.

APY & Analytics​

Derive APY from share price growth over time. Consider using subgraphs or Euler APIs where available. Display total assets, exchange rate, strategy allocations, and historical returns.

Withdraw UX​

Surface potential partial-liquidity cases for very large withdrawals. Typical partial withdrawals are rare if an idle reserve is maintained.

Discovery & Listing​

List verified Earn vaults by querying the factory or a registry endpoint. Present underlying, APY, caps, and current strategy set for transparency.

Security Notes​

Highlight non-custodial design, role-based governance with timelocks, and per-strategy risk isolation. Link to Security and Advanced docs from this section.