girumgizachew1/african-liquidity-research-framework

# African Liquidity Research Framework (ALRF) ## 🎯 Project Overview This repository demonstrates a comprehensive approach to analyzing African payment orchestration companies' liquidity sourcing and efficiency, using M-Pesa (Safaricom) as a case study. The project showcases real-world data organization, de-noising, and structuring techniques as requested by Andy from LAVA. **✅ IMPLEMENTED: Now includes comprehensive onchain data integration!** ## 🔍 Research Questions Addressed 1. **Where can and do African payment orchestration companies source liquidity?** 2. **How efficiently is this liquidity used?** 3. **✅ How does onchain data integration enhance liquidity analysis? (IMPLEMENTED)** ## 📁 Repository Structure ``` african-liquidity-research-framework/ ├── 📋 README.md # This file - Project overview ├── ✅ SUBMISSION_CHECKLIST.md # Submission verification ├── 🚀 core_framework/ # Core research methodology │ ├── liquidity_research_methodology.py # Main research functions (v2.0 with onchain!) │ ├── demonstrate_research_framework.py # Framework demonstration (enhanced!) │ ├── sample_onchain_data.json # Sample blockchain/DeFi data │ ├── ONCHAIN_INTEGRATION_GUIDE.md # Comprehensive onchain guide │ └── requirements.txt # Python dependencies ├── 📊 data_sources/ # Data source references │ └── DATA_SOURCES_REFERENCE.md # Official source URLs ├── 📈 analysis_outputs/ # Processed deliverables │ ├── real_world_mpesa_research_*.json # Comprehensive analysis │ ├── mpesa_real_world_research_*.xlsx # Excel workbook (8 sheets) │ └── kenya_mpesa_2024_wb_findex_*.json # World Bank data └── 📚 documentation/ # Project documentation └── README.md # Original project README ``` ## 🚀 Quick Start ### **Installation:** ```bash cd core_framework python3 -m venv venv source venv/bin/a …