CrosFi - Cross-Currency Lending Protocol on Celo

A comprehensive DeFi lending and borrowing platform built on the Celo blockchain, featuring cross-currency lending, AI-powered yield optimization, and automated yield farming strategies.

🌟 Overview

CrosFi is a next-generation DeFi protocol that enables users to lend and borrow across multiple currencies on the Celo network. The platform combines traditional lending mechanics with innovative AI-driven yield optimization and automated strategies to maximize returns for users.

🎯 Key Features

Core Lending Protocol

Cross-Currency Lending - Lend and borrow across CELO, cUSD, USDC, cEUR, cREAL, and eXOF
Dynamic Interest Rates - Algorithmic interest rate models based on supply and demand
Collateral Management - Flexible collateral system with multiple supported assets
Liquidation Protection - Automated liquidation system to maintain protocol health
Real-time Oracle Integration - Chainlink-powered price feeds for accurate valuations

AI-Powered Yield Generator 🤖

Intelligent Recommendations - AI analyzes market data to suggest optimal lending strategies
Risk Profiling - Personalized recommendations based on user risk tolerance
Market Trend Analysis - Real-time analysis of DeFi trends and yield opportunities
Yield Forecasting - Predictive models for future yield potential
NVIDIA Nemotron Integration - Advanced AI model for market analysis

Automated Yield Strategies

Mento Yield Strategy - Automated yield farming through Mento protocol
Multi-Token Vault - Unified vault for managing multiple token positions
Strategy Optimization - Dynamic strategy adjustments based on market conditions
Gas Optimization - Efficient transaction batching and optimization

User Experience

Modern UI/UX - Beautiful, responsive interface with dark/light themes
Real-time Updates - Live data feeds and instant transaction updates
Mobile-First Design - Optimized for all devices and screen sizes
Wallet Integration - Support for MetaMask, WalletConnect, and other popular wallets
Transaction Management - Comprehensive transaction history and status tracking

🏗️ Architecture

Smart Contracts

LendingPool - Core lending and borrowing logic
MultiTokenVault - Unified vault for yield farming strategies
InterestModel - Dynamic interest rate calculations
OracleAdapter - Price feed integration and management
CollateralManager - Collateral tracking and liquidation logic
DebtTokens - Individual debt token contracts for each supported currency

Frontend Stack

Next.js 16 - React framework with App Router
TypeScript - Full type safety and developer experience
Tailwind CSS 4 - Utility-first styling framework
Framer Motion - Smooth animations and transitions
Recharts - Data visualization and analytics
Ethers.js - Ethereum/Celo blockchain interaction

Backend Services

Node.js/Express - API server for off-chain data
WebSocket - Real-time data streaming
Prisma - Database ORM for user data
Cron Jobs - Automated maintenance tasks

AI & Analytics

OpenRouter API - AI model integration
CoinGecko API - Market data aggregation
DeFiLlama API - DeFi protocol analytics
Custom ML Models - Yield prediction and optimization

📋 Contract Addresses

Celo Sepolia Testnet

Deployment Information

Network: Celo Sepolia Testnet
Deployer: 0x7140F4EEaAbeAa746dF7F743b568cC3D096161df
Deployed At: 2025-10-25T21:55:09.008Z
Block Explorer: CeloScan Sepolia

Contract Verification Instructions

To verify the smart contracts, judges can:

Click on any contract address in the list above to view it on CeloScan Sepolia
Check the "Contract" tab to view the verified source code
Verify the contract matches the expected functionality:
- LendingPool: Core lending and borrowing logic
- MultiTokenVault: Yield farming vault with multi-token support
- InterestModel: Dynamic interest rate calculations
- OracleAdapter: Price feed integration
- CollateralManager: Collateral tracking and liquidation
- DebtTokens: Individual debt token contracts
- MentoYieldStrategy: Automated yield farming strategy
Verify deployment details:
- All contracts deployed by: 0x7140F4EEaAbeAa746dF7F743b568cC3D096161df
- Network: Celo Sepolia Testnet
- Deployment timestamp: 2025-10-25T21:55:09.008Z

🚀 Quick Start

Prerequisites

Node.js 18.0 or later
npm or yarn or pnpm
Git
MetaMask or compatible Web3 wallet

Installation

Clone the repository

git clone https://github.com/your-username/crosfi.git
cd crosfi

Install dependencies

npm install
# or
yarn install
# or
pnpm install

Set up environment variables

cp .env.example .env.local

Configure your .env.local:

# Celo Network Configuration
NEXT_PUBLIC_CELO_RPC_URL=https://sepolia-forno.celo-testnet.org
NEXT_PUBLIC_CELO_CHAIN_ID=44787

# Contract Addresses (Sepolia Testnet)
NEXT_PUBLIC_LENDING_POOL=0x46e9007E67ac1fd5F63Ec817809FA15aE65F62B5
NEXT_PUBLIC_VAULT=0x32D94e8c16370b718041246C18ee914283DFEAa7
NEXT_PUBLIC_INTEREST_MODEL=0x292677b28485D8d2dDF9F93D44361704C546ca4f
NEXT_PUBLIC_ORACLE_ADAPTER=0xFE175E3377051Bd38E97b2ea2668f59214c06Db6
NEXT_PUBLIC_COLLATERAL_MANAGER=0x519B3d3b3493707F4F335cbbF98B13e80C0d65B2

# AI Configuration
NEXT_PUBLIC_OPENROUTER_API_KEY=your_openrouter_api_key

# Backend Configuration
NEXT_PUBLIC_API_URL=http://localhost:3001

Start the development server
```
npm run dev
# or
yarn dev
# or
pnpm dev
```

Start the backend server (optional)

npm run backend
# or run both frontend and backend
npm run dev:full

Open your browser Navigate to http://localhost:3000

Getting Testnet Tokens

Celo Faucet: Visit Celo Faucet
Chainlink Faucet: Chainlink Faucet
Add to MetaMask: Use the contract addresses above to add tokens to your wallet

📁 Project Structure

crosfi/
├── app/                          # Next.js App Router
│   ├── (lending)/               # Lending pages
│   │   ├── borrow/              # Borrowing interface
│   │   └── lend/                # Lending interface
│   ├── ai-yield/                # AI Yield Generator
│   ├── analytics/               # Protocol analytics
│   ├── api/                     # API routes
│   ├── dashboard/               # User dashboard
│   ├── markets/                 # Market overview
│   ├── positions/               # User positions
│   ├── rates/                   # Interest rates
│   ├── vault/                   # Yield farming vault
│   └── ...                      # Other pages
├── components/                   # React components
│   ├── ai/                      # AI-related components
│   │   ├── RecommendationCard.tsx
│   │   ├── MarketTrendAnalyzer.tsx
│   │   ├── YieldForecastChart.tsx
│   │   └── RiskProfileSelector.tsx
│   ├── currency/                # Currency components
│   ├── lending/                 # Lending components
│   ├── vault/                   # Vault components
│   ├── ui/                      # UI components
│   └── ...                      # Other components
├── contracts/                    # Smart contracts
│   ├── lending/                 # Lending contracts
│   ├── vault/                   # Vault contracts
│   ├── libraries/               # Contract libraries
│   ├── mocks/                   # Mock contracts
│   ├── oracles/                 # Oracle contracts
│   └── strategies/              # Yield strategies
├── lib/                         # Utility libraries
│   ├── contracts/               # Contract interactions
│   ├── token-icons.ts           # Token icon configuration
│   ├── currency-config.ts       # Currency configuration
│   ├── api-client.ts            # API client
│   └── ...                      # Other utilities
├── backend/                     # Backend services
│   ├── src/                     # Backend source code
│   ├── prisma/                  # Database schema
│   └── scripts/                 # Backend scripts
├── keeper/                      # Keeper service
│   ├── src/                     # Keeper source code
│   └── tasks/                   # Automated tasks
├── scripts/                     # Deployment scripts
├── public/                      # Static assets
└── ...                          # Configuration files

🎨 Design System

Color Palette

/* Primary Colors */
--celo-green: #35D07F
--celo-gold: #FBCC5C
--celo-blue: #4285F4

/* Semantic Colors */
--success: #10B981
--warning: #F59E0B
--error: #EF4444
--info: #3B82F6

Typography

Font Family: Inter (Google Fonts)
Headings: Bold, responsive sizing
Body Text: Regular weight, optimized for readability
Code: JetBrains Mono for technical content

Components

Buttons: Primary, secondary, outline, and ghost variants
Cards: Consistent padding, borders, and hover effects
Forms: Accessible inputs with proper validation
Navigation: Responsive header with mobile menu
Token Icons: Official token icons with fallback support

🔧 Development

Available Scripts

# Frontend Development
npm run dev          # Start development server
npm run build        # Build for production
npm run start        # Start production server
npm run lint         # Run ESLint

# Backend Development
npm run backend      # Start backend server
npm run dev:full     # Start both frontend and backend

# Smart Contract Development
npx hardhat compile  # Compile contracts
npx hardhat test     # Run tests
npx hardhat deploy   # Deploy contracts
npx hardhat verify   # Verify contracts on block explorer

Smart Contract Development

Install Hardhat dependencies

npm install --save-dev hardhat @nomicfoundation/hardhat-toolbox

Compile contracts
```
npx hardhat compile
```
Run tests
```
npx hardhat test
```

Deploy to Alfajores

npx hardhat run scripts/deploy-alfajores.js --network sepolia

Code Style

ESLint - Code linting and error detection
Prettier - Code formatting
TypeScript - Type checking
Conventional Commits - Commit message format

🚀 Deployment

Frontend Deployment (Vercel)

Connect repository to Vercel
Configure build settings:
- Build Command: npm run build
- Output Directory: .next
Set environment variables in Vercel dashboard
Deploy - Automatic deployments on push

Smart Contract Deployment

Set up environment variables

PRIVATE_KEY=your_private_key
CELO_RPC_URL=https://sepolia-forno.celo-testnet.org
CELOSCAN_API_KEY=your_celoscan_api_key

Deploy contracts

npx hardhat run scripts/deploy-alfajores.js --network sepolia

Verify contracts

npx hardhat verify --network sepolia <CONTRACT_ADDRESS>

Backend Deployment

The backend can be deployed to any Node.js hosting platform:

Railway
Heroku
DigitalOcean App Platform
AWS EC2

📊 Features Deep Dive

AI Yield Generator

The AI Yield Generator uses advanced machine learning to analyze market conditions and provide personalized yield recommendations:

Market Analysis: Real-time analysis of DeFi protocols, yield rates, and market trends
Risk Assessment: Comprehensive risk profiling based on volatility, liquidity, and market conditions
Yield Forecasting: Predictive models for future yield potential using historical data
Personalization: Recommendations tailored to user risk tolerance and investment goals

Cross-Currency Lending

CrosFi enables seamless lending and borrowing across multiple currencies:

Multi-Asset Support: CELO, cUSD, USDC, cEUR, cREAL, eXOF
Dynamic Interest Rates: Algorithmic rates based on supply and demand
Flexible Collateral: Use any supported asset as collateral
Liquidation Protection: Automated liquidation system with health factor monitoring

Automated Yield Strategies

Mento Integration: Automated yield farming through Mento protocol
Strategy Optimization: Dynamic adjustments based on market conditions
Gas Optimization: Efficient transaction batching and optimization
Risk Management: Automated risk assessment and position management

🔒 Security

Smart Contract Security

OpenZeppelin Libraries - Battle-tested security patterns
Reentrancy Protection - Protection against reentrancy attacks
Access Control - Role-based access control for administrative functions
Oracle Integration - Secure price feed integration with Chainlink
Liquidation Logic - Robust liquidation system to maintain protocol health

Frontend Security

Input Validation - Comprehensive form validation
XSS Protection - Content Security Policy implementation
HTTPS Only - Secure connections enforced
Wallet Security - Secure wallet integration with proper error handling

🧪 Testing

Smart Contract Testing

# Run all tests
npx hardhat test

# Run specific test file
npx hardhat test test/LendingPool.test.js

# Run tests with coverage
npx hardhat coverage

Frontend Testing

# Run component tests
npm run test

# Run E2E tests
npm run test:e2e

📈 Performance

Optimizations

Image Optimization - Next.js Image component with WebP support
Code Splitting - Automatic route-based splitting
Lazy Loading - Components loaded on demand
Bundle Analysis - Optimized bundle sizes
Caching - Proper cache headers and service worker

Metrics

Lighthouse Score: 95+ across all categories
Core Web Vitals: Excellent performance
Bundle Size: Optimized for fast loading
Accessibility: WCAG 2.1 AA compliant

🤝 Contributing

We welcome contributions! Please follow these steps:

Fork the repository
Create a feature branch
```
git checkout -b feature/amazing-feature
```
Make your changes
Add tests if applicable
Commit your changes
```
git commit -m 'Add amazing feature'
```
Push to the branch
```
git push origin feature/amazing-feature
```
Submit a pull request

Contribution Guidelines

Follow the existing code style
Write meaningful commit messages
Add documentation for new features
Test your changes thoroughly
Update README if needed

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Celo Foundation - For the amazing blockchain platform
Next.js Team - For the excellent React framework
Tailwind CSS - For the utility-first CSS framework
OpenZeppelin - For secure smart contract libraries
Chainlink - For reliable oracle services
NVIDIA - For AI model integration
shadcn/ui - For the component library

📞 Support

Documentation: docs.crosfi.com
Community: Discord
Issues: GitHub Issues
Email: support@crosfi.com

🔮 Roadmap

Phase 1 ✅

Core lending protocol
Multi-token vault
Basic UI/UX
Smart contract deployment

Phase 2 ✅

AI Yield Generator
Advanced analytics
Mobile optimization
Backend services

Phase 3 🚧

Governance token
Advanced strategies
Cross-chain integration
Mobile app

Phase 4 📋

Institutional features
Advanced AI models
Layer 2 integration
Global expansion

Built with ❤️ for the Celo ecosystem

CrosFi - Revolutionizing cross-currency lending in DeFi

Name		Name	Last commit message	Last commit date
Latest commit History 10 Commits
app		app
artifacts		artifacts
backend		backend
cache		cache
components		components
contexts		contexts
contracts		contracts
hooks		hooks
lib		lib
public		public
scripts		scripts
src		src
styles		styles
test		test
.gitignore		.gitignore
.npmrc		.npmrc
README.md		README.md
components.json		components.json
hardhat.config.js		hardhat.config.js
next.config.mjs		next.config.mjs
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
start-backend.js		start-backend.js
tailwind.config.js		tailwind.config.js
test-api-client.js		test-api-client.js
tsconfig.json		tsconfig.json
vercel.json		vercel.json

Folders and files

Latest commit

History

Repository files navigation

CrosFi - Cross-Currency Lending Protocol on Celo

🌟 Overview

🎯 Key Features

Core Lending Protocol

AI-Powered Yield Generator 🤖

Automated Yield Strategies

User Experience

🏗️ Architecture

Smart Contracts

Frontend Stack

Backend Services

AI & Analytics

📋 Contract Addresses

Celo Sepolia Testnet

Core Protocol Contracts

Debt Token Contracts

Token Contracts

Deployment Information

Contract Verification Instructions

🚀 Quick Start

Prerequisites

Installation

Getting Testnet Tokens

📁 Project Structure

🎨 Design System

Color Palette

Typography

Components

🔧 Development

Available Scripts

Smart Contract Development

Code Style

🚀 Deployment

Frontend Deployment (Vercel)

Smart Contract Deployment

Backend Deployment

📊 Features Deep Dive

AI Yield Generator

Cross-Currency Lending

Automated Yield Strategies

🔒 Security

Smart Contract Security

Frontend Security

🧪 Testing

Smart Contract Testing

Frontend Testing

📈 Performance

Optimizations

Metrics

🤝 Contributing

Contribution Guidelines

📄 License

🙏 Acknowledgments

📞 Support

🔮 Roadmap

Phase 1 ✅

Phase 2 ✅

Phase 3 🚧

Phase 4 📋

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages