UNPKG

@lifi/composer-sdk

Version:

Public Composer SDK for building and submitting flows

278 lines (251 loc) • 11.3 kB
import { type ComposeCompileRequest, flashloanMaxFee, type Flow, } from '@lifi/compose-spec'; import { createComposeSdk, materialisers, resources } from '../../index.js'; import type { Address } from '../../types.js'; import { padForAaveDebtRounding, trimForAaveWithdrawalRounding, } from '../aaveRounding.js'; import { API_KEY, BASE_URL } from '../config.js'; // Base mainnet token addresses. const BASE_WETH = '0x4200000000000000000000000000000000000006'; const BASE_USDC = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'; // Circle EURC on Base (6 decimals). const BASE_EURC = '0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42'; // Aave V3 on Base (pool + aWETH receipt + variable-debt USDC). const AAVE_V3_POOL_BASE = '0xA238Dd80C259a72e81d7e4664a9801593F98d1c5'; const A_BAS_WETH = '0xD4a0e0b9149BCee3C920d2E00b5dE09138fd8bb7'; const VDEBT_BAS_USDC = '0x59dca05b6c26dbd64b5381374aAaC5CD05644C28'; // Morpho Blue WETH/EURC market on Base. Real listed market — borrow APY // ~1.02% at the time of writing vs ~5.30% on the WETH/USDC market, which is // what makes this migration economically interesting. Market ID: // 0xa9b5142fa687a24c275faf731f13b52faa9873252bb4e1cb6077aa1f412edb0b // (= keccak256(MarketParams) of the values below). const ADAPTIVE_CURVE_IRM_BASE = '0x46415998764C29aB2a25CbeA6254146D50D22687'; const WETH_EURC_ORACLE = '0xE1bb8E5b4930eC9FeC7f7943FCF6227649F14B37'; const WETH_EURC_LLTV = '860000000000000000'; const MORPHO_WETH_EURC_MARKET = { loanToken: BASE_EURC, collateralToken: BASE_WETH, oracle: WETH_EURC_ORACLE, irm: ADAPTIVE_CURVE_IRM_BASE, lltv: WETH_EURC_LLTV, }; // Slippage budget on the EURC → USDC swap. The caller must size // `morphoBorrowAmount` such that the swap's slippage-adjusted minimum covers // the USDC leg's reserve: `debtAmount + maxFee`, where the Aave leg's default // `maxFee` is `flashloanMaxFee` (5 bps, rounded up). const SWAP_SLIPPAGE = 0.03; export interface AaveToMorphoDebtMigrationWithSwapInput { readonly owner: Address; /** WETH collateral the user posts (in smallest units, 18 decimals). */ readonly collateralAmount: `${bigint}`; /** USDC principal borrowed from Aave (6 decimals). */ readonly debtAmount: `${bigint}`; /** * EURC to borrow from Morpho (6 decimals). Must be large enough that, after * the EURC → USDC swap at `SWAP_SLIPPAGE`, the swap's minimum output covers * `debtAmount + maxFee` (the USDC leg's reserve). Caller sizes this * off-chain from a live LI.FI quote, e.g. * morphoBorrowAmount = * ceil((debtAmount + maxFee) * eurcPerUsdc / (1 - slippage)) * Note: EUR/USD is not 1:1 — the example fixture assumes ~1.075 USD/EUR. */ readonly morphoBorrowAmount: `${bigint}`; } /** * Atomically migrate an Aave V3 USDC borrow on Base into the Morpho Blue * WETH/EURC market — same WETH collateral, different stablecoin debt. At the * time of writing Morpho's WETH/EURC borrow APY is ~1.02% vs ~5.30% on * USDC-denominated WETH-collateral markets, so a long-running borrow position * can be made materially cheaper by migrating the debt asset. * * Topology mirrors `aaveToMorphoDebtMigration`, with one extra step: after * Morpho mints EURC debt, the borrow proceeds are swapped to USDC via * `lifi.swap`, and the swap's `amountOut` (which carries the slippage-adjusted * minimum) settles the USDC flashloan leg. * * Phase 1 — provision the source position on Aave V3: * - User direct-deposits WETH. * - `lifi.zap` supplies the WETH to Aave (WETH → aBasWETH routing edge). * - `aave.borrow` mints USDC debt; the borrowed USDC stays on the proxy * until the payout at the end of the flow. * * Phase 2 — migrate to Morpho using two concurrent flashloans: * - Flashloan #1 (Aave V3, USDC) bridges the Aave debt payoff before the * Morpho borrow + swap exists. * - Flashloan #2 (Balancer V2, WETH) bridges the Morpho collateral supply * before the Aave collateral is freed. * - `aave.repay` clears the Aave USDC debt with flashloan #1. * - `lifi.zap` withdraws the freed WETH from Aave (aBasWETH → WETH). * - `morphoBlue.supplyCollateral` deposits flashloan #2's WETH into Morpho. * - `morphoBlue.borrow` mints `morphoBorrowAmount` EURC. * - `lifi.swap` converts the borrowed EURC into USDC. `amountOut` carries the * slippage-adjusted minimum that must cover the USDC leg's reserve. * - Two `lifi.flashloanRepay` ops earmark each leg's funds: the USDC leg's * from the swap output, the WETH leg's from the Aave withdrawal (Balancer * V2 charges no fee, so the withdrawn principal alone covers it). They move * nothing: the funds stay in the proxy and the flashloan runtime repays both * lenders after the program. * - The payout reads the proxy's USDC balance, splits the USDC leg's reserve * off it with `core.splitAt`, and transfers the rest to the signer: the * loan proceeds, the swap's USDC above the reserve, and the `mode: 'max'` * repay's leftover. * * After execution the signer holds a Morpho Blue position with * `collateralAmount` WETH collateral and `morphoBorrowAmount` EURC debt; the * Aave position is closed. Dust stays on the proxy: the few wei of WETH the * withdrawal returns above the collateral leg, and any EURC the swap leaves * unsold (its `unspentIn`). */ export const buildAaveToMorphoDebtMigrationWithSwap = ({ owner, collateralAmount, debtAmount, morphoBorrowAmount, }: AaveToMorphoDebtMigrationWithSwapInput): { flow: Flow; request: ComposeCompileRequest; } => { const sdk = createComposeSdk({ baseUrl: BASE_URL, apiKey: API_KEY }); // Both flashloan legs absorb Aave's 2-wei scaled-balance skew: the USDC // leg funds a max-mode repay, the WETH leg is covered by a withdrawal. const debtFlashloanAmount = padForAaveDebtRounding(debtAmount); const collateralFlashloanAmount = trimForAaveWithdrawalRounding(collateralAmount); // The USDC leg's reserve: its principal plus the default fee cap. The // request states the same `maxFee` on the leg, so client and server agree // on the cap, and the payout splits exactly this reserve off. const maxFee = flashloanMaxFee({ providerKind: 'aave-v3', amount: debtFlashloanAmount, }); const debtReserve = ( BigInt(debtFlashloanAmount) + maxFee ).toString() as `${bigint}`; const builder = sdk.flow(8453, { name: 'aave-to-morpho-debt-migration-with-swap', inputs: { initialCollateral: resources.erc20(BASE_WETH, 8453), debtFlashloan: resources.erc20(BASE_USDC, 8453), collateralFlashloan: resources.erc20(BASE_WETH, 8453), }, }); // --- Phase 1: provision the Aave V3 borrow position ---------------------- // WETH → aBasWETH via the aave routing edge family (Aave V3 supply). const supplyToAave = builder.lifi.zap('supply-to-aave', { bind: { amountIn: builder.inputs.initialCollateral }, config: { resourceOut: resources.erc20(A_BAS_WETH, 8453) }, }); // Borrow USDC against the freshly supplied collateral. The `borrowed` // resource is left unbound: it stays on the proxy as the user's loan // proceeds, and `payout-borrow-proceeds` forwards it to the signer. builder.aave.borrow('borrow-from-aave', { bind: {}, config: { pool: AAVE_V3_POOL_BASE, asset: BASE_USDC, variableDebtToken: VDEBT_BAS_USDC, amount: debtAmount, }, }); // --- Phase 2: migrate to Morpho with two concurrent flashloans ----------- // Settle the Aave USDC debt with flashloan #1. mode: 'max' makes Aave's // Pool clamp paybackAmount to userVariableDebt exactly, so any unspent // flashloan principal stays on the proxy and reaches the payout below. builder.aave.repay('repay-aave', { bind: { assetIn: builder.inputs.debtFlashloan, onBehalfOf: builder.context.executionAddress, }, config: { pool: AAVE_V3_POOL_BASE, mode: 'max' }, }); // Withdraw the freed WETH from Aave (aBasWETH → WETH) via routing. const withdrawFromAave = builder.lifi.zap('withdraw-from-aave', { bind: { amountIn: supplyToAave.amountOut }, config: { resourceOut: resources.erc20(BASE_WETH, 8453) }, }); // Open the Morpho Blue position with flashloan #2's WETH. builder.morphoBlue.supplyCollateral('supply-to-morpho', { bind: { assetIn: builder.inputs.collateralFlashloan }, config: { marketParams: MORPHO_WETH_EURC_MARKET, mode: 'exact' }, }); // Borrow EURC at the destination's (cheaper) APR. const morphoBorrow = builder.morphoBlue.borrow('borrow-from-morpho', { bind: {}, config: { marketParams: MORPHO_WETH_EURC_MARKET, amount: morphoBorrowAmount, }, }); // Swap EURC → USDC so the borrow proceeds can settle the USDC flashloan // leg. `amountOut` carries `providesMinimum: true`; the caller is // responsible for sizing `morphoBorrowAmount` so the slippage-adjusted // minimum covers the leg's reserve, `debtAmount + maxFee`. const swapDebt = builder.lifi.swap('swap-borrow-to-usdc', { bind: { amountIn: morphoBorrow.borrowed }, config: { resourceOut: resources.erc20(BASE_USDC, 8453), slippage: SWAP_SLIPPAGE, }, }); // Earmark the swap output for the USDC flashloan leg. The payout returns // whatever the proxy holds above the leg's reserve to the signer. builder.experimental.lifi.flashloanRepay('repay-debt-flashloan', { bind: { funds: swapDebt.amountOut }, }); // Earmark the Aave withdrawal for the WETH flashloan leg. Balancer V2 // charges no fee, so the withdrawn principal alone covers the leg. builder.experimental.lifi.flashloanRepay('repay-collateral-flashloan', { bind: { funds: withdrawFromAave.amountOut }, }); // Forward the USDC above the leg's reserve to the signer. The proxy's live // USDC balance holds the loan proceeds, the swap output and the repay's // leftover; the reserve must stay in the proxy for the runtime to repay // Aave. The split keeps `min(balance, reserve)` as its head and pays out // only the tail. // // A request-level `sweepTo` cannot do this: `outputs` reports the unbound // `borrowed` and `residual` ports in full, but the sweep withholds the // reserve, so it moves less than they report and compose rejects the flow. const usdcBalance = builder.core.balanceOf('read-usdc-balance', { bind: {}, config: { token: BASE_USDC }, }); const { tail: usdcProceeds } = builder.core.splitAt( 'exclude-flashloan-reserve', { bind: { source: usdcBalance.balance }, config: { amount: debtReserve }, }, ); builder.core.transfer('payout-borrow-proceeds', { bind: { amount: usdcProceeds, recipient: builder.context.sender, }, config: {}, }); const flow = builder.build(); const request = sdk.request(flow, { signer: owner, inputs: { initialCollateral: materialisers.directDeposit({ amount: collateralAmount, }), debtFlashloan: materialisers.experimental.flashloan({ providerKind: 'aave-v3', amount: debtFlashloanAmount, maxFee, }), collateralFlashloan: materialisers.experimental.flashloan({ providerKind: 'balancer-v2', amount: collateralFlashloanAmount, }), }, }); return { flow, request }; };