celo-defi

name	celo-defi
description	Integrate DeFi protocols on Celo. Use when building swaps, lending, or liquidity applications with Uniswap, Aave, Ubeswap, or other DeFi protocols.
license	Apache-2.0
metadata	{"author":"celo-org","version":"1.0.0"}

Celo DeFi Integration

This skill covers integrating DeFi protocols on Celo, including Uniswap for swaps, Aave for lending/borrowing, and other protocols.

When to Use

• Building swap functionality with Uniswap or Ubeswap
• Integrating lending/borrowing with Aave
• Creating liquidity provision features
• Building DeFi aggregators

DeFi Protocols on Celo

Decentralized Exchanges

Protocol	Description
Uniswap V3/V4	Primary DEX with concentrated liquidity
Ubeswap	Celo-native DEX, mobile-optimized
Velodrome	Superchain DEX with liquidity mining
Carbon DeFi	Orderbook-like automated trading

Lending & Borrowing

Protocol	Description
Aave V3	Decentralized lending (launched March 2025)
Credit Collective	On-chain private credit for RWAs
PWN	Fixed-rate lending

DEX Aggregators

Protocol	Description
LI.FI	Cross-chain aggregator

Liquidity & Yield

Protocol	Description
Steer Protocol	Automated liquidity strategies
Merkl	Liquidity provider rewards

Uniswap V3 Integration

Contract Addresses - Mainnet (Chain ID: 42220)

Contract	Address
Factory	0xAfE208a311B21f13EF87E33A90049fC17A7acDEc
SwapRouter02	0x5615CDAb10dc425a742d643d949a7F474C01abc4
QuoterV2	0x82825d0554fA07f7FC52Ab63c961F330fdEFa8E8
NonfungiblePositionManager	0x3d79EdAaBC0EaB6F08ED885C05Fc0B014290D95A
UniversalRouter	0x643770E279d5D0733F21d6DC03A8efbABf3255B4
Permit2	0x000000000022D473030F116dDEE9F6B43aC78BA3
TickLens	0x5f115D9113F88e0a0Db1b5033D90D4a9690AcD3D
Multicall2	0x633987602DE5C4F337e3DbF265303A1080324204

Contract Addresses - Alfajores Testnet

Contract	Address
Factory	0x229Fd76DA9062C1a10eb4193768E192bdEA99572
SwapRouter02	0x8C456F41A3883bA0ba99f810F7A2Da54D9Ea3EF0
QuoterV2	0x3c1FCF8D6f3A579E98F4AE75EB0adA6de70f5673
NonfungiblePositionManager	0x0eC9d3C06Bc0A472A80085244d897bb604548824
UniversalRouter	0x84904B9E85F76a421223565be7b596d7d9A8b8Ce
Permit2	0x000000000022D473030F116dDEE9F6B43aC78BA3

Simple Swap Example

import { createWalletClient, custom, encodeFunctionData } from "viem";
import { celo } from "viem/chains";

const SWAP_ROUTER = "0x5615CDAb10dc425a742d643d949a7F474C01abc4";

const SWAP_ROUTER_ABI = [
  {
    name: "exactInputSingle",
    type: "function",
    stateMutability: "payable",
    inputs: [
      {
        name: "params",
        type: "tuple",
        components: [
          { name: "tokenIn", type: "address" },
          { name: "tokenOut", type: "address" },
          { name: "fee", type: "uint24" },
          { name: "recipient", type: "address" },
          { name: "amountIn", type: "uint256" },
          { name: "amountOutMinimum", type: "uint256" },
          { name: "sqrtPriceLimitX96", type: "uint160" },
        ],
      },
    ],
    outputs: [{ type: "uint256" }],
  },
] as const;

async function swapExactInput(
  tokenIn: string,
  tokenOut: string,
  amountIn: bigint,
  amountOutMin: bigint,
  fee: number = 3000
): Promise<string> {
  const walletClient = createWalletClient({
    chain: celo,
    transport: custom(window.ethereum),
  });

  const [address] = await walletClient.getAddresses();

  const hash = await walletClient.sendTransaction({
    account: address,
    to: SWAP_ROUTER,
    data: encodeFunctionData({
      abi: SWAP_ROUTER_ABI,
      functionName: "exactInputSingle",
      args: [
        {
          tokenIn: tokenIn as `0x${string}`,
          tokenOut: tokenOut as `0x${string}`,
          fee,
          recipient: address,
          amountIn,
          amountOutMinimum: amountOutMin,
          sqrtPriceLimitX96: 0n,
        },
      ],
    }),
  });

  return hash;
}

Ubeswap Integration

Celo-native DEX with V2 and V3 support.

Contract Addresses - Mainnet

Contract	Address
V3 Factory	0x67FEa58D5a5a4162cED847E13c2c81c73bf8aeC4
V3 Universal Router	0x3C255DED9B25f0BFB4EF1D14234BD2514d7A7A0d
V3 NFT Position Manager	0x897387c7B996485c3AAa85c94272Cd6C506f8c8F
V2 Factory	0x62d5b84bE28a183aBB507E125B384122D2C25fAE
V2 Router	0xE3D8bd6Aed4F159bc8000a9cD47CffDb95F96121
UBE Token	0x71e26d0E519D14591b9dE9a0fE9513A398101490

Aave V3 Integration

Contract Addresses - Mainnet

Contract	Address
Pool	0x3E59A31363E2ad014dcbc521c4a0d5757d9f3402
PoolAddressesProvider	0x9F7Cf9417D5251C59fE94fB9147feEe1aAd9Cea5
PoolConfigurator	0x7567E3434CC1BEf724AB595e6072367Ef4914691
Oracle	0x1e693D088ceFD1E95ba4c4a5F7EeA41a1Ec37e8b
ACLManager	0x7a12dCfd73C1B4cddf294da4cFce75FcaBBa314C
PoolDataProvider	0x2e0f8D3B1631296cC7c56538D6Eb6032601E15ED
Collector	0xC959439207dA5341B74aDcdAC59016aa9Be7E9E7

Supported Assets

Asset	Address	aToken
USDC	0xcebA9300f2b948710d2653dD7B07f33A8B32118C	0xFF8309b9e99bfd2D4021bc71a362aBD93dBd4785
USDT	0x48065fbbe25f71c9282ddf5e1cd6d6a887483d5e	-
USDm	0x765de816845861e75a25fca122bb6898b8b1282a	-
EURm	0xd8763cba276a3738e6de85b4b3bf5fded6d6ca73	-
CELO	0x471EcE3750Da237f93B8E339c536989b8978a438	-
WETH	0xD221812de1BD094f35587EE8E174B07B6167D9Af	-

Supply Assets

const AAVE_POOL = "0x3E59A31363E2ad014dcbc521c4a0d5757d9f3402";

const POOL_ABI = [
  {
    name: "supply",
    type: "function",
    stateMutability: "nonpayable",
    inputs: [
      { name: "asset", type: "address" },
      { name: "amount", type: "uint256" },
      { name: "onBehalfOf", type: "address" },
      { name: "referralCode", type: "uint16" },
    ],
    outputs: [],
  },
] as const;

async function supplyToAave(asset: string, amount: bigint): Promise<string> {
  const walletClient = createWalletClient({
    chain: celo,
    transport: custom(window.ethereum),
  });

  const [address] = await walletClient.getAddresses();

  // First approve the Pool to spend tokens
  const hash = await walletClient.writeContract({
    address: AAVE_POOL,
    abi: POOL_ABI,
    functionName: "supply",
    args: [asset as `0x${string}`, amount, address, 0],
  });

  return hash;
}

Borrow Assets

const POOL_ABI_BORROW = [
  {
    name: "borrow",
    type: "function",
    stateMutability: "nonpayable",
    inputs: [
      { name: "asset", type: "address" },
      { name: "amount", type: "uint256" },
      { name: "interestRateMode", type: "uint256" },
      { name: "referralCode", type: "uint16" },
      { name: "onBehalfOf", type: "address" },
    ],
    outputs: [],
  },
] as const;

async function borrowFromAave(
  asset: string,
  amount: bigint,
  interestRateMode: number = 2 // 2 = variable rate
): Promise<string> {
  const walletClient = createWalletClient({
    chain: celo,
    transport: custom(window.ethereum),
  });

  const [address] = await walletClient.getAddresses();

  const hash = await walletClient.writeContract({
    address: AAVE_POOL,
    abi: POOL_ABI_BORROW,
    functionName: "borrow",
    args: [asset as `0x${string}`, amount, BigInt(interestRateMode), 0, address],
  });

  return hash;
}

Token Approval

Before interacting with DeFi protocols, approve token spending:

const ERC20_ABI = [
  {
    name: "approve",
    type: "function",
    stateMutability: "nonpayable",
    inputs: [
      { name: "spender", type: "address" },
      { name: "amount", type: "uint256" },
    ],
    outputs: [{ type: "bool" }],
  },
] as const;

async function approveToken(
  token: string,
  spender: string,
  amount: bigint
): Promise<string> {
  const walletClient = createWalletClient({
    chain: celo,
    transport: custom(window.ethereum),
  });

  const [address] = await walletClient.getAddresses();

  const hash = await walletClient.writeContract({
    address: token as `0x${string}`,
    abi: ERC20_ABI,
    functionName: "approve",
    args: [spender as `0x${string}`, amount],
  });

  return hash;
}

Fee Tiers (Uniswap V3)

Fee	Use Case
100 (0.01%)	Stable pairs (USDm/USDC)
500 (0.05%)	Stable pairs
3000 (0.3%)	Most pairs
10000 (1%)	Exotic pairs

Dependencies

{
  "dependencies": {
    "viem": "^2.0.0"
  }
}

For Aave integration:

{
  "dependencies": {
    "@bgd-labs/aave-address-book": "^4.0.0"
  }
}

Additional Resources

• contract-addresses.md - All DeFi contract addresses