Skip to content

mvivek07/BlockAid-Blockchain-Based-Disaster-Relief-System

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

13 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌐 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

LayerTechnologies Used
BlockchainHyperledger Fabric, Polygon, Solidity
Smart ContractsSolidity on Polygon (Mumbai Testnet)
BackendSupabase, Node.js, Express
FrontendReact.js, React Native, Lovable AI
AuthenticationWeb3Auth (wallet & social login)
PaymentsTransak (Fiat-to-Crypto gateway)
IoTMQTT / WebSockets
AILovable AI
HostingVercel, 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

Transak Widget Overview BlockAid DApp Interface User Roles Overview Beneficiary UI Donation Flow

About

A decentralized Web3 DApp that brings transparency, efficiency, and accountability to disaster relief. Built using Polygon, Hyperledger Fabric, smart contracts, Web3Auth, Transak, and IoT, BlockAid enables secure donations, real-time aid tracking, and verifiable beneficiary support.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors