celo-defi

# 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 ```typescript 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 ```typescript 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 ```typescript 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: ```typescript 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 ```json { "dependencies": { "viem": "^2.0.0" } } ``` For Aave integration: ```json { "dependencies": { "@bgd-labs/aave-address-book": "^4.0.0" } } ``` ## Additional Resources - [contract-addresses.md](references/contract-addresses.md) - All DeFi contract addresses