Electronic Health Record Blockchain Based Platform

A blockchain-powered Electronic Health Record (EHR) platform built using Hyperledger Fabric, Node.js, Docker, and IPFS.

This project demonstrates how enterprise blockchain can be used for:

Secure patient record management
Decentralized healthcare data sharing
Role-based access control
Immutable medical audit logs
Multi-organization healthcare ecosystems

Tech Stack

Technology	Purpose
Hyperledger Fabric	Enterprise blockchain framework
Node.js	Backend APIs and SDK integration
Fabric Node SDK	Blockchain interaction
Docker	Containerized blockchain deployment
Hyperledger Explorer	Blockchain visualization and monitoring
Angular / Next.js Frontend	User interface
CouchDB	State database
IPFS	Decentralized file storage
WSL2	Linux development environment on Windows

Project Architecture

Frontend UI
    ↓
Node.js Backend APIs
    ↓
Hyperledger Fabric SDK
    ↓
Smart Contracts (Chaincode)
    ↓
Fabric Blockchain Network
 ├── Org1 (Hospital)
 ├── Org2 (Insurance)
 ├── Orderer
 ├── Certificate Authorities
 ├── CouchDB
 └── Hyperledger Explorer

Project Structure

EHR-Hyperledger-Fabric-Project/
│
├── fabric-samples/                  # Hyperledger Fabric samples and network
├── server-node-sdk/                 # Backend APIs and Fabric SDK scripts
├── fabric-explorer/                 # Hyperledger Explorer setup
├── backup/                          # Backup utility scripts
├── screenshots/                     # Project screenshots
├── README.md
└── install-fabric.sh

Prerequisites

Before starting, install:

Docker Desktop
WSL2 Ubuntu
Node.js >= 20
npm >= 10
Git
VS Code with WSL Extension

Steps to Setup Project

1. Download Fabric Binaries and Samples

./install-fabric.sh

This downloads:

Fabric binaries
Docker images
Fabric samples repository

2. Start Fabric Test Network

cd fabric-samples/test-network
./network.sh up

Check containers:

docker ps

Stop network:

./network.sh down

3. Create Channel and Start CA

cd fabric-samples/test-network
./network.sh up createChannel -ca

This will:

Start peers
Start orderer
Start CA servers
Create mychannel

4. Deploy Chaincode

./network.sh deployCC -ccn ehrChainCode -ccp ../asset-transfer-basic/chaincode-javascript/ -ccl javascript

If deployment succeeds, you should see:

Chaincode initialization is not required

5. Register Admin Identities

cd server-node-sdk/

node cert-script/registerOrg1Admin.js
node cert-script/registerOrg2Admin.js

6. Onboard Network Participants

node cert-script/onboardHospital01.js
node cert-script/onboardDoctor.js
node cert-script/onboardInsuranceCompany.js
node cert-script/onboardInsuranceAgent.js

These scripts:

Register identities
Enroll users
Store credentials in wallet
Invoke blockchain transactions

7. Start Backend Server

npm install
npm run dev

Backend runs on:

http://localhost:5000

API List

API	Purpose
registerPatient	Register patient
loginPatient	Login patient
grantAccess	Grant access to doctor
addRecord	Add patient medical record
getRecordById	Fetch record by ID
getAllRecordByPatienId	Fetch patient records
fetchLedger	Fetch blockchain ledger

Chaincode Logic

Read/Write Permissions

Actor	Permissions
Government	Admin Access
Hospital	Read/Write Doctor Data
Doctor	Read/Write Patient Data
Diagnostics Center	Read/Write Diagnostic Records
Pharmacies	Read/Write Prescriptions
Researchers	Read-only based on consent
Insurance Companies	Read/Write Claims
Patient	Full access to own data

Ledger Object Structure

Hospital Object

{
  "recordType": "hospital",
  "createdBy": "hospitalId",
  "data": {
    "name": "ABC Hospital",
    "address": "ABC Location"
  }
}

Physician Object

{
  "recordType": "physician",
  "createdBy": "physicianID",
  "data": {
    "name": "Doctor Name",
    "hospital": "ABC Hospital"
  }
}

Hyperledger Explorer Setup

Step 1: Go to Explorer Folder

cd fabric-explorer/

Step 2: Copy Organizations Folder

sudo cp -r ../fabric-samples/test-network/organizations/ .
cp -r ../fabric-samples/test-network/organizations/ .

Step 3: Export Environment Variables

export EXPLORER_CONFIG_FILE_PATH=./config.json
export EXPLORER_PROFILE_DIR_PATH=./connection-profile
export FABRIC_CRYPTO_PATH=./organizations

Step 4: Configure test-network.json

Inside adminPrivateKey:

verify certificate path
ensure key filename matches crypto materials

Step 5: Start Explorer

Without logs:

docker-compose up -d

With logs:

docker-compose up

Step 6: Stop Explorer

docker-compose down

Project Features Demonstrated

✅ Multi-Organization Fabric Network

✅ Chaincode Deployment

✅ Smart Contract Invocation

✅ Node SDK Integration

✅ Blockchain Explorer Monitoring

✅ Dockerized Infrastructure

✅ CA-Based Identity Management

✅ CouchDB State Database

✅ Healthcare Role Management

Docker Containers Used

The project uses multiple containers:

peer0.org1.example.com
peer0.org2.example.com
orderer.example.com
ca_org1
ca_org2
ca_orderer
couchdb0
couchdb1
fabric-explorer
chaincode containers

Major Problems Faced & Solutions

One of the biggest learning experiences in this project was debugging and fixing real enterprise blockchain setup issues.

⚠️ 1. WSL Issues

Problem

VS Code was not opening properly in WSL.

Solution

Installed:

WSL2
VS Code WSL extension

Used:

code .

Also fixed PATH configuration issues.

⚠️ 2. Docker Socket Broken Pipe Error

Problem

write unix @->/var/run/docker.sock: write: broken pipe

while deploying chaincode.

Cause

Corrupted/stale Fabric Docker images.

Solution

Removed old images:

docker rmi hyperledger/fabric-peer:latest -f
docker rmi hyperledger/fabric-orderer:latest -f
docker rmi hyperledger/fabric-ca:latest -f

Then restarted Docker Desktop.

⚠️ 3. npm + WSL Path Conflict

Problem

npm was using Windows binaries inside WSL.

Errors:

UNC paths are not supported

Solution

Disabled Windows PATH integration in WSL.

Verified:

which node
which npm

Expected:

/usr/bin/node
/usr/bin/npm

⚠️ 4. Angular Version Mismatch

Problem

Angular CLI and Angular core versions were incompatible.

Solution

Installed compatible versions:

npm install --legacy-peer-deps
npm install @types/node@16 --save-dev

⚠️ 5. Git Submodule Problem

Problem

fabric-samples was treated as embedded Git repository.

Solution

Removed nested Git metadata:

rm -rf fabric-samples/.git

Then re-added project files.

⚠️ 6. Chaincode Function Not Found

Problem

You've asked to invoke a function that does not exist: onboardDoctor

Cause

Backend SDK called function not implemented in deployed chaincode.

Solution

Updated and redeployed correct chaincode.

⚠️ 7. Node.js Version Compatibility

Problem

Old Node.js versions caused Fabric SDK failures.

Solution

Upgraded to:

Node.js v20+

⚠️ 8. Explorer Crypto Path Errors

Problem

Explorer failed to load network.

Solution

Correctly copied:

organizations/

and updated:

adminPrivateKey path

inside Explorer connection profile.

Key Learning Outcomes

This project provided practical experience in:

Enterprise blockchain development
Smart contract deployment
Docker container orchestration
Distributed ledger architecture
Blockchain identity management
Hyperledger Fabric administration
Real-world debugging
WSL Linux development
Node SDK integration
Blockchain monitoring and analytics

Future Improvements

Planned enhancements:

Full healthcare frontend UI
JWT authentication
IPFS encrypted medical file storage
Role-based dashboards
Patient consent workflows
Blockchain analytics
Audit reports
REST API documentation
Kubernetes deployment
CI/CD pipelines

Author

Murari Guna

GitHub Repository:

https://github.com/murariguna/blockchain-system

References & Credits

Hyperledger Fabric Official Repository

Hyperledger Fabric GitHub Repository:
https://github.com/hyperledger/fabric
Hyperledger Fabric Samples Repository:
https://github.com/hyperledger/fabric-samples
Hyperledger Explorer Repository:
https://github.com/hyperledger-labs/blockchain-explorer
Hyperledger Fabric Documentation:
https://hyperledger-fabric.readthedocs.io/
Additional Architecture & Implementation Reference:
https://github.com/akshaykurhekar/EHR-Hyperledger-Fabric-Project.git

📜 License & Attribution

This project uses components and tools from the Hyperledger Fabric ecosystem.

Hyperledger Fabric is licensed under the Apache License 2.0.

Apache License 2.0:
https://www.apache.org/licenses/LICENSE-2.0
Hyperledger Project Website:
https://www.hyperledger.org/

Name		Name	Last commit message	Last commit date
Latest commit History 3 Commits
backup		backup
fabric-explorer		fabric-explorer
fabric-samples		fabric-samples
server-node-sdk		server-node-sdk
.gitignore		.gitignore
EHR-APIs.postman_collection.json		EHR-APIs.postman_collection.json
LICENSE		LICENSE
README.md		README.md
install-fabric.sh		install-fabric.sh

Folders and files

Latest commit

History

Repository files navigation

Electronic Health Record Blockchain Based Platform

Tech Stack

Project Architecture

Project Structure

Prerequisites

Steps to Setup Project

1. Download Fabric Binaries and Samples

2. Start Fabric Test Network

3. Create Channel and Start CA

4. Deploy Chaincode

5. Register Admin Identities

6. Onboard Network Participants

7. Start Backend Server

API List

Chaincode Logic

Actors in Network

Read/Write Permissions

Ledger Object Structure

Hospital Object

Physician Object

Hyperledger Explorer Setup

Step 1: Go to Explorer Folder

Step 2: Copy Organizations Folder

Step 3: Export Environment Variables

Step 4: Configure test-network.json

Step 5: Start Explorer

Step 6: Stop Explorer

Project Features Demonstrated

Docker Containers Used

Major Problems Faced & Solutions

⚠️ 1. WSL Issues

Problem

Solution

⚠️ 2. Docker Socket Broken Pipe Error

Problem

Cause

Solution

⚠️ 3. npm + WSL Path Conflict

Problem

Solution

⚠️ 4. Angular Version Mismatch

Problem

Solution

⚠️ 5. Git Submodule Problem

Problem

Solution

⚠️ 6. Chaincode Function Not Found

Problem

Cause

Solution

⚠️ 7. Node.js Version Compatibility

Problem

Solution

⚠️ 8. Explorer Crypto Path Errors

Problem

Solution

Key Learning Outcomes

Future Improvements

Author

References & Credits

Hyperledger Fabric Official Repository

📜 License & Attribution

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages