Skip to content

Financial inclusion platform for LATAM built on Celo blockchain. Mobile-first PWA for payments, remittances, and microfinance using cUSD/cREAL stablecoins. Built with Next.js 14, TypeScript, Solidity smart contracts, and deployed on Celo Sepolia Testnet.

License

Notifications You must be signed in to change notification settings

Edgadafi/enerpay-celo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

104 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ’š LatamFi - Financial Inclusion Platform for LATAM

Β‘EnvΓ­a, Paga, Crece! Remesas, Servicios, CrΓ©dito. Comisiones Ultra Bajos. Potenciado por Celo

LatamFi is a decentralized financial platform built on Celo, designed to bring financial services to underserved communities in Latin America. Through a lightweight mobile wallet, instant payments, simplified remittances, and community-based microfinance, LatamFi enables financial inclusion for millions.


🌟 Vision

Financial inclusion for everyone, everywhere.

LatamFi leverages Celo's mobile-first blockchain and stablecoins to provide:

  • πŸ’³ Instant Payments - Send and receive money instantly using cUSD/cREAL
  • 🌍 Simplified Remittances - Low-cost cross-border transfers
  • πŸ’° Microfinance - Access to credit based on on-chain reputation
  • πŸ† Reputation System - Build creditworthiness through blockchain activity

πŸš€ Key Features

1. Lightweight Mobile Wallet

  • Create/import wallet in seconds
  • View balances (cUSD, cREAL, CELO)
  • Transaction history
  • QR code for receiving payments
  • PWA-first design (works offline)

2. Instant Payments

  • Send/receive payments between users
  • Pay merchants via QR scanning
  • Pay cooperatives (multi-sig support)
  • Push notifications (optional)

3. Simplified Remittances

  • Select origin/destination country
  • Convert local currency β†’ cUSD
  • Instant settlement
  • Transaction tracking
  • Low fees (<1%)

4. On-Chain Reputation System

  • Credit score based on:
    • Payment history
    • Transaction volume
    • Time on platform
    • User references
  • Stored as Soulbound Token (SBT)
  • Non-transferable, verifiable
  • Used for microcredit eligibility

5. Decentralized Microfinance

  • Request microcredit (reputation-based)
  • Community liquidity pools
  • Flexible terms (APR based on score)
  • Auto-repayment with stablecoins
  • Rewards for responsible consumption

πŸ—οΈ Architecture

Tech Stack

Frontend:

  • Next.js 14 (PWA-first)
  • TypeScript
  • Tailwind CSS
  • Celo Wallet Connect / Valora SDK

Blockchain:

  • Celo (Alfajores testnet β†’ Mainnet)
  • Solidity smart contracts
  • Hardhat/Foundry for development

Stablecoins:

  • cUSD (Celo Dollar)
  • cREAL (Celo Real)
  • cEUR (Celo Euro)

Storage:

  • IPFS (metadata)
  • Celo blockchain (on-chain data)

System Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚   Frontend (Next.js PWA)            β”‚
β”‚   - Wallet Integration              β”‚
β”‚   - Payment UI                      β”‚
β”‚   - Remittance Flow                 β”‚
β”‚   - Microfinance Dashboard          β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
               β”‚
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚   Smart Contracts (Solidity)         β”‚
β”‚   - PaymentRouter.sol                β”‚
β”‚   - RemittancePool.sol               β”‚
β”‚   - CreditScore.sol                  β”‚
β”‚   - ReputationSystem.sol             β”‚
β”‚   - MicrofinancePool.sol             β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
               β”‚
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚   Celo Blockchain                     β”‚
β”‚   - cUSD/cREAL transfers              β”‚
β”‚   - On-chain reputation               β”‚
β”‚   - Transaction history               β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸ“¦ Installation & Setup

Prerequisites

  • Node.js 18+
  • npm or yarn
  • Git
  • Celo wallet (Valora or Celo Wallet)

Quick Start

# Clone repository
git clone https://github.com/YOUR_USERNAME/latamfi.git
cd latamfi

# Install dependencies
cd frontend
npm install

# Setup environment
cp .env.example .env.local
# Edit .env.local with your config

# Run development server
npm run dev

Smart Contracts

# Setup contracts
cd contracts
npm install

# Compile
npx hardhat compile

# Deploy to Alfajores
npx hardhat run scripts/deploy.js --network alfajores

🎯 Use Cases

1. Daily Payments

Scenario: Maria pays for groceries at a local store

  • Opens LatamFi wallet
  • Scans merchant QR code
  • Sends 50 cUSD
  • Transaction confirmed in <3 seconds
  • Merchant receives payment instantly

2. Remittances

Scenario: Juan sends money from USA to Mexico

  • Opens remittance flow
  • Selects USA β†’ Mexico
  • Enters $200 USD
  • Converts to cUSD
  • Sends to recipient's wallet
  • Recipient receives 200 cUSD (~3,600 MXN)
  • Cost: <$2 (vs $10-15 traditional)

3. Microcredit

Scenario: Carlos needs a small loan

  • Has good reputation (Gold level)
  • Requests 500 cUSD microcredit
  • Approved based on on-chain score
  • Receives funds instantly
  • Repays over 6 months
  • Builds better reputation

4. Cooperative Payments

Scenario: Community cooperative receives payments

  • Multiple members sign transactions
  • Multi-sig wallet for security
  • Transparent on-chain accounting
  • Members can verify payments

πŸ” Security

  • Non-custodial - Users control their keys
  • On-chain verification - All transactions verifiable
  • Reputation system - Prevents fraud
  • Multi-sig support - For cooperatives
  • Smart contract audits - Before mainnet

πŸ“– Ver SECURITY_CHECKLIST.md para el checklist completo de seguridad


πŸ›£οΈ Roadmap

Phase 1: MVP (Nov-Dec 2025)

  • Project setup
  • Smart contracts (PaymentRouter, ReputationSystem)
  • Frontend wallet integration
  • Basic payment flow
  • Remittance flow
  • Deploy to Alfajores

Phase 2: Microfinance (Q1 2026)

  • CreditScore contract
  • MicrofinancePool contract
  • Credit application UI
  • Reputation dashboard
  • Testing & security audit

Phase 3: Mainnet & Growth (Q2 2026)

  • Mainnet deployment
  • Mobile app (React Native)
  • Partnerships with cooperatives
  • User acquisition
  • Marketing campaign

πŸ“– Ver MAINNET_DEPLOYMENT.md para el plan completo de despliegue a mainnet


🀝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Priority Areas:

  • Smart contract development
  • Frontend improvements
  • Mobile app development
  • Documentation
  • Testing

πŸ“„ License

MIT License - see LICENSE for details.


πŸ™ Acknowledgments

  • Celo Foundation - For the mobile-first blockchain
  • Mento Protocol - For stablecoin infrastructure
  • Valora - For wallet SDK
  • Buildathon Celo MΓ©xico - For the opportunity

πŸ“ž Contact & Links


🎯 Built for Celo Buildathon 2026

Project: LatamFi
Team: Edgadafi
Category: Payments & Finance / Impact & Sustainability
Blockchain: Celo
Status: Beta - In Development

Timeline:

  • Pre-registro: 18 Dic 2025 β†’ 16 Ene 2026
  • Buildathon: 19 Ene β†’ 27 Feb 2026
  • Demo Day: 6 Mar 2026

Made with ❀️ for financial inclusion in LATAM

About

Financial inclusion platform for LATAM built on Celo blockchain. Mobile-first PWA for payments, remittances, and microfinance using cUSD/cREAL stablecoins. Built with Next.js 14, TypeScript, Solidity smart contracts, and deployed on Celo Sepolia Testnet.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published