SDK Integration

import {
  createClient,
  getQuote,
  convertQuoteToRoute,
  executeRoute,
} from "@lifi/sdk";
import { EthereumProvider } from "@lifi/sdk-provider-ethereum";

// Configure once at app startup.
// walletClient: a viem WalletClient for the user's account (https://viem.sh/docs/clients/wallet)
const client = createClient({ integrator: "YourAppName" });
client.setProviders([
  EthereumProvider({ getWalletClient: () => Promise.resolve(walletClient) }),
]);

const quote = await getQuote(client, {
  fromChain: 8453, // Base
  toChain: 8453, // Base
  fromToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // USDC on Base
  toToken: "0x7BfA7C4f149E7415b73bdeDfe609237e29CBF34A", // Morpho vault token
  fromAmount: "1000000", // 1 USDC
  fromAddress: "0xYOUR_WALLET_ADDRESS",
});

const usesComposer = quote.includedSteps.some((step) => step.tool === "composer");

// executeRoute handles allowance, submission and status tracking.
const executedRoute = await executeRoute(client, convertQuoteToRoute(quote), {
  // Called on every state change; use it to update your UI.
  updateRouteHook(updatedRoute) {
    for (const step of updatedRoute.steps) {
      for (const action of step.execution?.actions ?? []) {
        switch (action.status) {
          case "STARTED":
            console.log(`${action.type} started`);
            break;
          case "PENDING":
            console.log(`${action.type} pending - tx: ${action.txHash}`);
            break;
          case "DONE":
            if (action.substatus === "PARTIAL") {
              // The bridge delivered, but the destination deposit did not run
              console.warn(`${action.type} partial: ${action.substatusMessage}`);
            } else {
              console.log(`${action.type} complete`);
            }
            break;
          case "FAILED":
            console.error(`${action.type} failed: ${action.error?.message}`);
            break;
        }
      }
    }
  },
});

import { getRoutes } from "@lifi/sdk";

const result = await getRoutes(client, {
  fromChainId: 8453,
  toChainId: 8453,
  fromTokenAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  toTokenAddress: "0x7BfA7C4f149E7415b73bdeDfe609237e29CBF34A",
  fromAmount: "1000000",
  fromAddress: "0xYOUR_WALLET_ADDRESS",
});

const route = result.routes[0]; // Routes are sorted best first

const crossChainQuote = await getQuote(client, {
  fromChain: 1, // Ethereum
  toChain: 8453, // Base
  fromToken: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", // USDC on Ethereum
  toToken: "0x7BfA7C4f149E7415b73bdeDfe609237e29CBF34A", // Morpho vault on Base
  fromAmount: "1000000000", // 1000 USDC
  fromAddress: "0xYOUR_WALLET_ADDRESS",
  slippage: 0.01,
});

await executeRoute(client, convertQuoteToRoute(crossChainQuote), {
  updateRouteHook(updatedRoute) {
    console.log("Route updated:", updatedRoute.steps.map((s) => s.tool));
  },
});