Unichain Migrator

The Unichain Migrator allows users to:

• migrate base tokens to Unichain
• migrate Uniswap liquidity positions to Unichain and Uniswap V4 pools.

​

How it Works

The Uniswap Migrator Widget is an interface to an orchestration of Enso’s routing capacities, Stargate bridging system, and Layer0’s notification system. Roughly, the flow is as follows:

1. The user selects the asset to migrate, and the destination Uniswap V4 pool. The user approves Enso’s contracts to spend the asset.
   
2. The user initiates the migration.
   2.1. The user initiates the migration.
   Enso issues a transaction bundle that:
     2.2. Redeems the assets underlying the user’s position on Uniswap V3.
     2.3. Swaps the assets to bridge tokens.
   
3. Bridging takes place
   3.1. Enso sends the assets to Stargate.
   3.2. Stargate bridges them to the destination chain.
   3.3. Stargate notifies Layer0, which notifies Enso.
   
4. Enso issues a transaction on the destination chain that deposits the assets into the destination V4 pool.

​

Integrate

To integrate the Uniswap yield migrator widget, follow the steps below.

pnpm i @ensofinance/uniswap-migrator

pnpm install @rainbow-me/rainbowkit wagmi viem@2.x @tanstack/react-query

"viem": "2.x",

import { ConnectButton } from '@rainbow-me/rainbowkit';
import type { NextPage } from 'next';
import styles from '../styles/Home.module.css';
import dynamic from 'next/dynamic';

const WidgetWrapper = dynamic(
  () =>
    import("@ensofinance/uniswap-migrator").then((mod) => mod.WidgetWrapper),
  {
    ssr: false,
  }
);

const apiKey = process.env.NEXT_PUBLIC_ENSO_API_KEY || "1e02632d-6feb-4a75-a157-documentation";

const Home: NextPage = () => {
  return (
    <div className={styles.container}>
      <main className={styles.main}>
        <ConnectButton />
        <WidgetWrapper apiKey={apiKey}/>
      </main>
    </div>
  );
};

export default Home;

pnpm run dev

​

Next Steps

• Try the Unichain Migrator Widget
• Learn more about Stargate
• Explore Layer0
• Find more about Enso’s routing capabilities