Morpho Blue Bundlers

Morpho Blue is a new lending primitive that offers better rates, high capital efficiency and extended flexibility to lenders & borrowers. morpho-blue-bundlers hosts the logic that builds alongside the core protocol like MetaMorpho and bundlers.

Structure

Each Bundler is a domain-specific abstract layer of contract that implements some functions that can be bundled in a single call by EOAs to a single contract. They all inherit from BaseBundler that enables bundling multiple function calls into a single multicall(bytes[] calldata data) call to the end bundler contract. Each chain-specific bundler is available under their chain-specific folder (e.g. ethereum).

Some chain-specific domains are also scoped to the chain-specific folder, because they are not expected to be used on any other chain (e.g. DAI and its specific permit function is only available on Ethereum - see EthereumPermitBundler).

User-end bundlers are provided in each chain-specific folder, instantiating all the intermediary domain-specific bundlers and associated parameters (such as chain-specific protocol addresses, e.g. EthereumBundlerV2).

Deployments

• EthereumBundler
• EthereumBundlerV2
• (TODO) AgnosticBundlerV2 on Base

Getting Started

Package installation

npm install @morpho-org/morpho-blue-bundlers

yarn add @morpho-org/morpho-blue-bundlers

Usage

Bundle a collateral supply and a borrow:

import { BundlerAction } from "@morpho-org/morpho-blue-bundlers";

const collateral = 1_000000000000000000n;
const borrowedAssets = 1000_000000n;

const borrower = "0x...";
const marketParams = {
  collateralToken: "0x...",
  loanToken: "0x...",
  irm: "0x...",
  oracle: "0x...",
  lltv: 86_0000000000000000n,
};

await bundler
  .connect(supplier)
  .multicall([
    BundlerAction.transferFrom(marketParams.collateralToken, collateral),
    BundlerAction.morphoSupplyCollateral(marketParams, collateral, borrower, "0x"),
    BundlerAction.morphoBorrow(marketParams, borrowedAssets, 0n, borrower, borrower),
  ]);

Bundle a permit2 signature approval and a ERC-4626 deposit:

import { Signature } from "ethers";

import { BundlerAction } from "@morpho-org/morpho-blue-bundlers";

const permit2Address = "0x000000000022D473030F116dDEE9F6B43aC78BA3";

const permit2Config = {
  domain: {
    name: "Permit2",
    chainId: "0x1",
    verifyingContract: permit2Address,
  },
  types: {
    PermitSingle: [
      {
        name: "details",
        type: "PermitDetails",
      },
      {
        name: "spender",
        type: "address",
      },
      {
        name: "sigDeadline",
        type: "uint256",
      },
    ],
    PermitDetails: [
      {
        name: "token",
        type: "address",
      },
      {
        name: "amount",
        type: "uint160",
      },
      {
        name: "expiration",
        type: "uint48",
      },
      {
        name: "nonce",
        type: "uint48",
      },
    ],
  },
};

const assetAddress = "0x...";
const assets = 1000_000000n;

const supplier = "0x...";
const bundlerAddress = "0x...";
const permitSingle = {
  details: {
    token: assetAddress,
    amount: assets,
    nonce: 0n,
    expiration: 2n ** 48n - 1,
  },
  spender: bundlerAddress,
  sigDeadline: 2n ** 48n - 1,
};

await bundler
  .connect(supplier)
  .multicall([
    BundlerAction.approve2(
      permitSingle,
      Signature.from(await supplier.signTypedData(permit2Config.domain, permit2Config.types, permitSingle)),
      false,
    ),
    BundlerAction.transferFrom2(assetAddress, assets),
    BundlerAction.erc4626Deposit(erc4626Address, assets, 0, supplier),
  ]);

Development

Install dependencies with yarn.

Run tests with yarn test:forge --chain <chainid> (chainid can be 1 or 8453).

Note that the EthereumBundlerV2 has been deployed with 80 000 optimizer runs. To compile contracts with the same configuration, run FOUNDRY_PROFILE=ethereumBundlerV2 forge b.

Audits

All audits are stored in the audits' folder.

License

Bundlers are licensed under GPL-2.0-or-later, see LICENSE.