Skip to content

README.md

Latest commit

 

History

History
181 lines (132 loc) · 5.21 KB

README.md

File metadata and controls

181 lines (132 loc) · 5.21 KB

Uni Vamp PoC

What's Uni Vamp?

Uni Vamp is a proof of concept that shows how to migrate liquidity from Balancer to Uniswap V4 on Base mainnet — in one smooth, gas-optimized flow. Built with dappBooster, Balancer SDK, Uniswap V4 SDK, Permit2 SDK, and leveraging Subgraphs, it connects everything you need into a fast, developer-friendly experience.

With just a few clicks, users can:

  • See their Balancer positions on Base mainnet
  • Exit pools and collect the tokens
  • Batch-sign token approvals with Permit2 using Permit2 SDK
  • Create new pool or use existing ones depending on the token pair, fee, tickSpacing, and hooks on Uniswap V4
  • Create new Uniswap V4 liquidity position with the tokens previously collected
  • Track their Uniswap V4 positions easily

This project is about making migrations simple, efficient, and delightful ✨.

animated gif flow

Tech Stack

How it works (the hooks)

  • useBalancerPositions

    • Fetches all user's liquidity positions on Balancer V3 using the Base mainnet Subgraph

  • useExitBalancerPool

    • Removes liquidity from a selected Balancer pool on Base mainnet
    • Supports "permit" signatures to avoid expensive approval transactions

  • usePermit2BatchSignature

    • Batch-signs token allowances with Permit2
    • Avoids multiple ERC20 approve transactions

  • useV4Pool

    • Calculates and checks if a Uniswap V4 pool exists for the selected token pair on Base mainnet

  • useUniswapV4Deposit

    • Handles the creation of a Uniswap V4 liquidity position on Base mainnet
    • Combines token amounts, Permit2 signature, and pool data to create and send the addLiquidity transaction

  • useUniswapV4Positions

    • Lists the user's active Uniswap V4 positions by fetching tokenIds from the Base mainnet Subgraph and reading on-chain pool and liquidity info

Quick Start

git clone <repo-url>
cd uni-vamp-poc
pnpm install
pnpm dev

Requirements:

  • Base mainnet RPC endpoint
  • Access to Balancer and Uniswap Subgraphs on Base mainnet
  • Environment variables: 
    NEXT_PUBLIC_RPC_URL=https://mainnet.base.org
NEXT_PUBLIC_SUBGRAPH_API_KEY=your-api-key

Examples (Real usage)

1. Listing Balancer Positions

const { data: positions, isLoading } = useBalancerPositions(userAddress);

return (
  <div>
    {isLoading ? 'Loading...' : positions?.map((p) => <div key={p.pool.address}>{p.pool.tokens.map(t => t.symbol).join(' / ')}</div>)}
  </div>
);

2. Exiting a Balancer Pool

const { removeOne } = useExitBalancerPool();

await removeOne({
  address: poolAddress,
  amount: '1000000000000000000' // 1 BPT in wei
});

3. Batch Signing Token Approvals with Permit2

const { sign } = usePermit2BatchSignature({
  tokens: [token0Address, token1Address],
  spender: V4_POSITION_MANAGER_ADDRESS_BASE,
});

const permitSignature = await sign();

4. Checking if a Uniswap V4 Pool Exists

const { data: pool, isLoading } = useV4Pool({
  tokenA: { token: token0, amount: amount0 },
  tokenB: { token: token1, amount: amount1 },
  fee: 100,
  tickSpacing: 1,
  hooks: ZERO_ADDRESS,
});

if (pool) {
  console.log('Pool exists:', pool);
}

5. Creating a Uniswap V4 Position

const sendDeposit = useUniswapV4Deposit(pool, { token: token0, amount: amount0 }, { token: token1, amount: amount1 });

await sendDeposit();

6. Listing Uniswap V4 Positions

const { positions } = useUniswapV4Positions(userAddress);

return (
  <div>
    {positions?.map(p => (
      <div key={p.poolId}>{p.token0.symbol} / {p.token1.symbol}: {p.amounts.amount0} - {p.amounts.amount1}</div>
    ))}
  </div>
);

Possible Roadmap

  • Show all uniswap v4 pools on the selected token pair and allow users to select the best one.
  • Allow users to select custom price ranges when creating Uniswap V4 positions.
  • Allow users to select custom hooks when creating Uniswap V4 positions. (can be create a new pool)
  • Better error handling and transaction feedback.
  • Multi-position migration flow (batch exit + batch deposit).
  • Slippage tolerance configuration.
  • Improved UI/UX for liquidity migration steps.
  • Add anothers networks support.
  • Add anothers protocols support to start the migration to uniswap v4. (now only Balancer)

License

This is a PoC for research and demonstration purposes. Feel free to explore, fork, and improve it.

(c) 2025