MyHealthID is a revolutionary decentralized health identity platform that puts YOU in control of your medical data. Built on Ethereum Sepolia blockchain and secured with IPFS, MyHealthID ensures your health information is:
- 🛡️ Secure - Military-grade encryption + blockchain immutability
- 👤 Private - You own and control your data, not corporations
- 🌐 Decentralized - No central authority or single point of failure
- 🔓 Interoperable - Share with any healthcare provider seamlessly
- 📱 Accessible - Your health records, anytime, anywhere
Your health identity is stored on the Ethereum blockchain, ensuring:
- Permanent, tamper-proof records
- No central database vulnerabilities
- True data ownership
- Cross-platform compatibility
Store and manage all your health data:
- Medical history & diagnoses
- Prescriptions & medications
- Lab results & imaging
- Vaccination records
- Allergies & conditions
Your data is encrypted and secure:
- End-to-end encryption
- Zero-knowledge proofs
- Granular access controls
- Audit trails for all access
- HIPAA-compliant architecture
Access your health data anywhere:
- Mobile app (iOS & Android)
- Web portal
- Emergency access protocols
- Provider integrations
- International compatibility
| Document | Description | Link |
|---|---|---|
| 📋 Project Overview | Concept, features, and architecture | View |
| 💻 Code Documentation | Tech stack, folder structure, configuration | View |
| 🔧 API Reference | Backend endpoints and usage | Coming Soon |
| 🎨 UI/UX Guide | Design system and components | Coming Soon |
Required Software
Before you begin, ensure you have these installed:
- ✅ Node.js (v16 or higher) & npm
- ✅ MongoDB (Local installation or MongoDB Atlas account)
- ✅ Expo Go app on your mobile device (iOS | Android)
- ✅ MetaMask or any Ethereum wallet (for deployment)
- ✅ Git for cloning the repository
git clone https://github.com/YOUR_USERNAME/MyHealthID.git
cd MyHealthID# Install root dependencies
npm install
# Install backend dependencies
cd backend
npm install
cd ..Create a .env file in the backend directory:
# MongoDB Configuration
MONGODB_URI=mongodb://localhost:27017/myhealthid
# or for MongoDB Atlas:
# MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/myhealthid
# Ethereum Sepolia Configuration
SEPOLIA_RPC_URL=https://sepolia.infura.io/v3/YOUR_INFURA_KEY
PRIVATE_KEY=your_wallet_private_key
CONTRACT_ADDRESS=0x6389b44A56E1bb6BCff56FDE4A563CCF41b15825
# IPFS Configuration
IPFS_API_URL=https://ipfs.infura.io:5001
IPFS_GATEWAY=https://ipfs.io/ipfs/
# JWT Secret
JWT_SECRET=your_secure_random_secret
# Server Configuration
PORT=3000
NODE_ENV=development
Open a terminal and run:
cd backend
npm startYou should see:
✅ Server running on port 3000
✅ Connected to MongoDB
✅ Contract deployed at: 0x6389b44A56E1bb6BCff56FDE4A563CCF41b15825
Open a new terminal window and run:
# From the root directory
npm startThis will start the Expo development server. You'll see a QR code in the terminal.
- Open Expo Go app on your phone
- Scan the QR code displayed in the terminal
- Wait for the app to build and launch
- 🎉 Start using MyHealthID!
MyHealthID is configured for Ethereum Sepolia Testnet (Chain ID: 11155111)
You need Sepolia ETH to deploy smart contracts and make transactions.
Official Faucets:
Steps:
- Visit any faucet above
- Enter your wallet address:
0x6389b44A56E1bb6BCff56FDE4A563CCF41b15825 - Complete captcha/verification
- Receive 0.5-1.0 Sepolia ETH
# Navigate to contracts directory
cd backend/contracts
# Compile contracts
npx hardhat compile
# Deploy to Sepolia
npx hardhat run scripts/deploy.js --network sepoliaExpected Output:
🔨 Compiling contracts...
✅ Compilation successful
🚀 Deploying HealthIDContract...
✅ Contract deployed to: 0xYOUR_NEW_CONTRACT_ADDRESS
📝 Transaction hash: 0x...
⛽ Gas used: ~2,500,000
After successful deployment, update your backend/.env file:
CONTRACT_ADDRESS=0xYOUR_NEW_CONTRACT_ADDRESSThen restart your backend server:
cd backend
npm startPopulate the database with pilot users and sample health records:
cd backend
node scripts/seedPilotData.jsThis will create:
- 👥 5 test patient accounts
- 🏥 3 test healthcare provider accounts
- 📋 Sample medical records
- 💊 Sample prescriptions
- 🧪 Sample lab results
Test Accounts:
Patient 1: patient1@test.com / password123
Patient 2: patient2@test.com / password123
Doctor 1: doctor1@test.com / password123
| Feature | Status | Details |
|---|---|---|
| 🌐 Network | ✅ Live | Ethereum Sepolia (Chain ID: 11155111) |
| 💰 Wallet | ✅ Funded | ~100 PYUSD (Sepolia Testnet) |
| 🏗️ Smart Contract | ✅ Deployed | 0x6389b44A56E1bb6BCff56FDE4A563CCF41b15825 |
| 📱 Mobile App | ✅ Working | React Native + Expo |
| 🖥️ Backend API | ✅ Running | Node.js + Express |
| 💾 Database | ✅ Active | MongoDB |
| 🔐 Authentication | ✅ Secure | JWT + Blockchain signatures |
| 📦 IPFS Storage | ✅ Integrated | Decentralized file storage |
- ✅ Migrated from: Polygon Mumbai → Ethereum Sepolia
- ✅ Codebase Updated: All references updated to Sepolia/Ethereum
- ✅ Testing Complete: Full functionality verified on Sepolia
- ✅ Documentation Updated: All guides reflect current setup
📱 Mobile App (React Native)
↕
🔐 Authentication Layer (JWT + Blockchain)
↕
🖥️ Backend API (Node.js + Express)
↕
┌───┴───┬───────┬──────┐
↓ ↓ ↓ ↓
💾 MongoDB ⛓️ Ethereum 📦 IPFS 🔒 Encryption
- 🔒 End-to-End Encryption - AES-256 encryption for all health data
- ⛓️ Blockchain Immutability - Tamper-proof record keeping
- 🎫 JWT Authentication - Secure session management
- 🔑 Private Key Management - Hardware wallet support
- 📝 Audit Logs - Complete access history
- 🛡️ Smart Contract Security - Audited and tested code
- 🚫 Zero-Knowledge Proofs - Verify without revealing data
- 🔐 Multi-Signature - Critical operations require multiple approvals
We welcome contributions from the community! Here's how you can help:
# Fork the repository
git clone https://github.com/YOUR_USERNAME/MyHealthID.git
# Create a feature branch
git checkout -b feature/amazing-feature
# Make your changes and commit
git commit -m "Add amazing feature"
# Push to your fork
git push origin feature/amazing-feature
# Open a Pull Request- 🐛 Bug Reports - Found a bug? Let us know!
- ✨ Feature Requests - Have an idea? Share it!
- 📝 Documentation - Help improve our docs
- 🎨 UI/UX - Design improvements
- 🔒 Security - Security audits and improvements
- 🧪 Testing - Write tests, find edge cases
- 🌍 Translations - Help make it multilingual
- ✅ Core platform development
- ✅ Ethereum Sepolia integration
- ✅ Mobile app MVP
- ✅ Basic health record management
- 🔄 Healthcare provider integrations
- 🔄 Advanced encryption features
- 🔄 Emergency access protocols
- 🔄 Multi-language support
- 📅 AI-powered health insights
- 📅 Wearable device integration
- 📅 Telemedicine integration
- 📅 Insurance claim automation
- 📅 Mainnet deployment
- 🐛 Report Bugs: GitHub Issues
- 💬 Discussions: GitHub Discussions
- 📧 Email: support@myhealthid.io
- 📚 Documentation: Full Docs
- 💼 Business Inquiries: partnerships@myhealthid.io
This project is licensed under the MIT License - see the LICENSE file for details.
- ✅ Free to use, modify, and distribute
- ✅ Commercial use allowed
- ✅ No warranty provided
⚠️ License and copyright notice must be included
Special thanks to:
- 🌐 Ethereum Foundation - For the blockchain infrastructure
- 📦 IPFS Protocol Labs - For decentralized storage
- 🏥 Healthcare Community - For feedback and support
- 💻 Open Source Community - For amazing tools and libraries
MyHealthID is currently in active development and deployed on the Sepolia testnet. This means:
⚠️ Not for production use - Do not store real medical data yet⚠️ Testnet only - Using test cryptocurrencies, not real money⚠️ Breaking changes possible - APIs and features may change⚠️ Security audit pending - Full security audit in progress
- 📋 This platform is for health record management only
- 🚫 Not a substitute for professional medical advice
- 🚫 Not intended for diagnosis or treatment
- 👨⚕️ Always consult healthcare professionals for medical decisions
- 🔐 Your data is encrypted and stored securely
- 👤 You maintain full ownership of your health data
- 🔓 You control who accesses your information
- 📊 See our Privacy Policy for details
Your Health. Your Identity. Your Control. ✨
