🌐 BlockAid - Blockchain-Based Disaster Relief System

🚨 Problem Statement

Natural disasters often reveal systemic issues in humanitarian aid, including:

• 🕒 Delays in fund release and aid delivery
• 💸 Corruption and misallocation of resources
• ❌ Lack of transparency and accountability
• 🧾 Inefficient tracking of aid and donations

BlockAid aims to revolutionize disaster relief using decentralized, transparent, and secure blockchain technology.

✅ Solution Overview

BlockAid is a decentralized platform leveraging blockchain, smart contracts, Web3 authentication, and IoT-based real-time tracking to make disaster relief:

• Transparent 🔍
• Efficient ⚡
• Tamper-proof 🔐
• User-verified 📲

✨ Core Features

• Immutable Recordkeeping using Hyperledger Fabric / Polygon
• Smart Contracts for automated fund release
• Web3Auth for secure wallet & social login
• Transak Integration for fiat-to-crypto donations
• IoT Integration for real-time aid tracking
• Beneficiary Feedback via mobile/web apps
• Polygon Smart Contracts for donation verification
• Lovable AI for decision logic & interactivity
• Supabase backend for scalable user data

🧠 Tech Stack

Layer	Technologies Used
Blockchain	Hyperledger Fabric, Polygon, Solidity
Smart Contracts	Solidity on Polygon (Mumbai Testnet)
Backend	Supabase, Node.js, Express
Frontend	React.js, React Native, Lovable AI
Authentication	Web3Auth (wallet & social login)
Payments	Transak (Fiat-to-Crypto gateway)
IoT	MQTT / WebSockets
AI	Lovable AI
Hosting	Vercel, Supabase, IPFS

🚀 Getting Started

1. Clone the Repository

   git clone https://github.com/<your-username>/blockaid.git
   cd blockaid

2. Install Dependencies

   cd backend
   npm install
   cd ../frontend
   npm install

3. Environment Setup

   /backend/.env
   SUPABASE_URL=your-supabase-url
   SUPABASE_KEY=your-supabase-service-role-key
   WEB3AUTH_CLIENT_ID=your-web3auth-client-id
   TRANSAK_API_KEY=your-transak-key
   /frontend/.env
   REACT_APP_SUPABASE_URL=your-supabase-url
   REACT_APP_SUPABASE_ANON_KEY=your-supabase-anon-key
   REACT_APP_WEB3AUTH_CLIENT_ID=your-web3auth-client-id
   REACT_APP_POLYGON_CHAIN_ID=80001

4. Smart Contract Deployment (Polygon)

   cd smart-contracts
   npx hardhat run scripts/deploy.js --network mumbai

💻 Usage Flow

• Donors log in via Web3Auth, donate via Transak, and track fund usage via dashboard.
• Aid agencies upload plans and track aid via IoT sensors.
• Beneficiaries confirm receipt using mobile app.
• Smart contracts release/revoke funds upon verification.
• All transactions are recorded on Polygon blockchain.

🔐 Security & Privacy

• Role-based access for donors, agencies, and recipients.
• Web3Auth for decentralized, secure logins.
• Supabase encryption & blockchain cryptography.
• Smart contract testing (reentrancy, overflow prevention).

📱 Mobile App (React Native)

• Cross-platform support
• Low-bandwidth UI for disaster zones
• Push notifications for aid updates
• QR verification for delivery agents

📈 Future Goals

• 🔄 Automated government API reconciliation
• 🌍 Regional language support
• 🤖 AI-driven supply forecasting
• 📡 Satellite-based aid tracking
• 🏦 On-chain insurance claims
• 💬 Feedback chatbots (WhatsApp/Telegram)

🧪 Testing

• Smart contracts: Hardhat & Mocha
• Backend APIs: Postman & Jest
• Frontend: React Testing Library
• Integration: Mumbai Testnet

🤝 Contributing

We welcome contributions!

1. Fork the repo
2. Create a new branch (feature/<feature-name>)
3. Submit a PR with clear documentation

🖼️ Screenshots