Skip to content

Dev-AdeTutu/Stellar-Aid-Flow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌍 Stellar AidFlow

Transparent, accountable, and efficient aid distribution powered by blockchain.

Stellar AidFlow is a decentralized aid distribution platform built on Soroban (Stellar's smart contract platform). It enables NGOs, donors, and governments to track, disburse, and verify aid funds in real time — ensuring resources reach intended beneficiaries without leakage or corruption.


Problem

Aid distribution systems face critical challenges:

  • Lack of transparency in fund allocation
  • Mismanagement and corruption
  • Delayed disbursement processes
  • Limited accountability to donors
  • Inefficient tracking of impact

Solution

Stellar AidFlow uses Soroban smart contracts to create a fully traceable, programmable aid pipeline where funds are:

  • Allocated with predefined conditions
  • Released automatically based on verified milestones
  • Transparently tracked on-chain

Core Features

  • Smart Contract Escrow — Conditional, milestone-based fund release with multi-sig support
  • Transparency Dashboard — Real-time fund flow tracking with public audit trails
  • Beneficiary Wallet System — Mobile-first, low-bandwidth compatible
  • Proof-of-Impact Verification — Upload reports/images; oracle-triggered payments
  • Tokenized Aid Vouchers — Restricted-use tokens (food, medicine) with expiry controls

Tech Stack

Layer Technology
Smart Contracts Soroban (Rust)
Blockchain Stellar Network
Assets USDC / XLM / local stablecoins
Frontend React + TypeScript
Backend Node.js + Express
Storage IPFS / secure cloud
Identity Decentralized lightweight ID

Project Structure

Stellar-Aid-Flow/
├── contracts/        # Soroban smart contracts
│   ├── escrow/       # Fund escrow & conditional release
│   └── voucher/      # Tokenized aid vouchers
├── frontend/         # React transparency dashboard
├── backend/          # API server & oracle bridge
└── docs/             # Architecture & grant docs

Roadmap

  • Phase 1 (MVP) — Smart contract escrow, basic dashboard, wallet integration
  • Phase 2 — Oracle verification, voucher system, NGO onboarding
  • Phase 3 — Government partnerships, cross-border flows, AI impact analytics

Use Case

  1. Donor allocates $50,000 for rural food aid
  2. Funds locked in Soroban smart contract
  3. NGO sets milestones (e.g., distribute to 1,000 households)
  4. Upon verification, funds released in phases
  5. Beneficiaries receive vouchers redeemable at local vendors
  6. All transactions visible on public dashboard

Why Stellar + Soroban

  • Low transaction costs — critical for micro-disbursements
  • Fast settlement for real-time aid
  • Built-in asset issuance for vouchers
  • Scalable smart contract infrastructure

Getting Started

Prerequisites

Install

# Contracts
cd contracts/escrow && cargo build

# Frontend
cd frontend && npm install && npm run dev

# Backend
cd backend && npm install && npm run dev

Contributing

PRs welcome. Please open an issue first to discuss what you'd like to change.

License

MIT

About

Corruption & lack of transparency in aid distribution Solution: Track every fund from donor → beneficiary on-chain

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors