MediChain: Decentralized Telemedicine and Medical Records

This repository is one of the three repositories which are part of MediChain Project.
medichain-nextjs: Frontend Repository of MediChain Project»
medichain-thegraph: The Graph Repository of MediChain Project»

Watch Demo Videos
Visit Site · Report Bug · Request Feature

This is the hardhat repository of this project.

If `Application Error` comes after just connecting the wallet, then change the network in metamask to Goerli Testnet and reload the page. This bug is unhandled for now.

Planned Changes

After my minor exams

Rainbowkit + wagmi for connect button
web3.storage for files
Toast for Notifications
DAO integration
XMTP integration
Video call integration

Table of Contents

About The Project
Getting Started
- Requirements
- Quickstart
Deployment to a testnet or mainnet
Contributing
License
Contact
Acknowledgments

About The Project

What Problem does it Solve?

Blockchain being an immutable ledger and with decentralized nature has a great potential for increasing the security, privacy and efficiency of Medical Health Record keeping systems.

Currently existing solutions rely on centralized database which are susceptible to Ransomware attacks, Denial of Service(DoS) attacks and also have significant counterparty risks. Some decentralized solutions are also exist but some of them are not really decentralized that are based on private or permissioned blockchain, while some which are based on public blockchain have not properly addressed the performance and scalability issues. There is also no virtual private and safe way for patients to interact with their doctor and vice-versa. This platform also solves that by integrating this application with the a state of the art decentralized communications channel supported by XMTP and video meeting features by Huddle01. Further, in future I am also planning to add a DAO to this application to even more decentralize the whole system by also making patients involved in medical administration along with doctors, hospital administration and and their governing comittee.

Project Status

Currently, the proposed system is based on EVM compatible public blockchains using IPFS as a decentralized file storage solution and uses 2048 bit RSA encryption to encrypt the IPFS HASH of file metadata on the client-side before uploading the HASH on the blockchain. For supporting fast and complex queries this system uses a decentralized indexing protocol The Graph. The smart contract is currently deployed on Goerli Testnet.

Currently, with this system patients can access their medical records anytime anywhere without the counterparty risk from centralized entity. This system also features QR code for sharing of medical files from patients to doctors. With the proposed implementation the decentralized medical record keeping system provides increased security and privacy compared to centralized systems without loss of significant performance or scalability benefits.

At present, I am actively testing the DAO integration, for this system under a child project named VyroChain. Here is the link to VyroChain.

VyroChain is a Child Project of MediChain Project for testing DAO integration.

The link to VyroChain is here

The links to other repositories of this(MediChain) project is at the top.

This is only the hardhat repository of the project.

(back to top)

Built With

The following is a list of major tools used for developing this repository.

The tools used in the NextJS repository are: -

The major tools used in the The Graph repository are: -

(back to top)

Getting Started

Requirements

git
- You'll know you did it right if you can run git --version and you see a response like git version x.x.x
Nodejs
- You'll know you've installed nodejs right if you can run:
  - node --version and get an ouput like: vx.x.x
Yarn instead of npm
- You'll know you've installed yarn right if you can run:
  - yarn --version and get an output like: x.x.x
  - You might need to install it with npm
Optional Package
- For convenience in development globally install hardhat-shorthand. More info here
```
yarn global add hardhat-shorthand
```

Quickstart

git clone https://github.com/sadityakumar9211/medichain-hardhat
cd medichain-hardhat
yarn

Optional Gitpod

If you can't or don't want to run and install locally, you can work with this repo in Gitpod. If you do this, you can skip the clone this repo part.

(back to top)

Deployment to a testnet or mainnet

Setup environment variabltes

You'll want to set your GOERLI_RPC_URL and OWNER_PRIVATE_KEY as environment variables. You can add them to a .env file, similar to what you see in .env.example.

OWNER_PRIVATE_KEY: The private key of your account (like from metamask). NOTE: FOR DEVELOPMENT, PLEASE USE A KEY THAT DOESN'T HAVE ANY REAL FUNDS ASSOCIATED WITH IT.
- You can learn how to export it here.
GOERLI_RPC_URL: This is url of the kovan testnet node you're working with. You can get setup with one for free from Alchemy
ETHERSCAN_API_KEY: This is the API key generate from here for used for verification of deployed smart contract code.

Get testnet ETH

Head over to faucets.chain.link and get some tesnet ETH. You should see the ETH show up in your metamask.

Deploy

yarn hardhat deploy --network goerli

hh deploy --network goerli

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!