Health-chain-stellar

HealthDonor Protocol is an open-source platform built on Stellar Soroban smart contracts that enables transparent health donations, secure fund escrow, and immutable healthcare supply chain tracking.

The protocol is designed for blood donations, medical supplies, vaccines, and healthcare funding, ensuring that every donation is:

Traceable

Auditable

Released only when real-world conditions are met

🎯 Problem Statement

Healthcare donation systems today suffer from:

❌ Lack of transparency

❌ Centralized control and trust issues

❌ Poor donor visibility into impact

❌ Limited auditability of supply chains

Donors often cannot verify:

Where funds go

Whether supplies reach recipients

If medical standards are followed

✅ Solution

HealthDonor Protocol leverages Stellar + Soroban smart contracts to provide:

🔐 On-chain escrow for medical donations

📊 Donor impact tracking

🧾 Immutable healthcare supply chain events

🏥 Verified healthcare actor registry

🕒 Time-locked fund releases

🔒 Privacy-preserving donor identifiers

All critical actions are enforced by smart contracts, reducing fraud and manual intervention.

Getting Started

Prerequisites

Dependency	Version	Purpose
Node.js	>= 18.x	Backend and frontend runtime
Docker + Docker Compose	latest	PostgreSQL (:5432) and Redis (:6379)
Rust + Cargo	stable	Soroban smart contracts
Stellar CLI (stellar)	>= 21.x	Deploy and invoke contracts

Quick Start

# 1. Start PostgreSQL and Redis
docker-compose up -d

# 2. Set up the backend
cd backend
cp .env.example .env   # edit DATABASE_PASSWORD, JWT_SECRET at minimum
npm install
npm run migration:run
npm run start:dev      # http://localhost:3001 — Swagger UI at /docs

# 3. Set up the frontend (separate terminal)
cd frontend/health-chain
npm install
npm run dev            # http://localhost:3000

For contract deployment, full environment variable reference, and contributor guidelines see CONTRIBUTING.md.

Service Ports

Service	Port
Next.js frontend	:3000
NestJS backend	:3001
Swagger UI	:3001/docs
PostgreSQL	:5432
Redis	:6379

Project Structure

Directory	README
backend/	Backend README
contracts/	Contracts README
lifebank-soroban/	Lifebank Soroban README
docs/contracts/	Contract Reference Docs
docs/architecture.md	Architecture Diagram