Blockchain Covid Vaccine Certifications

This project aims to implement a system that solves a known problem of trust in the COVID-19 vaccine supply chain using blockchain technology. Video demo at the end of the readme

Team : Bro code {}

Members : 2

Richard Jeremy Githuba
Eddy Bogonko

Problem

Vaccine certificates can be falsified and some vaccine certificates may not be recognized by destination countries. This affects the 3rd sustainable development goal that is good health and well being.

Languages and Frameworks

Solidity
hardhat
Truffle
JavaScript
ethers.js
Web3.js

Blockchain Protocol Used

Rinkeby Test net

How to run the code

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 output 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 or corepack

Quickstart

git clone https://github.com/githubarj/Blockchain-Covid-Certificates
cd Blockchain-Covid-Certificates
yarn
yarn hardhat

Usage

Deploy:

npx hardhat run scripts/deploy.js

Local Deployment

If you'd like to run your own local hardhat network, you can run:

npx hardhat node

And then in a different terminal

npx hardhat run scripts/deploy.js --network localhost

And you should see transactions happen in your terminal that is running npx hardhat node

Important localhost note

If you use metamask with a local network, everytime you shut down your node, you'll need to reset your account. Settings -> Advanced -> Reset account. Don't do this with a metamask you have real funds in. And maybe don't do this if you're a little confused by this.

Deployment to a testnet or mainnet

1. Setup environment variables

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

• 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.
• RINKEBY_RPC_URL: This is url of the rinkeby testnet node you're working with. You can get setup with one for free from Alchemy

2. Get testnet ETH

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

3. Deploy

yarn hardhat run scripts/deploy.js --network rinkeby

Verify on etherscan

If you deploy to a testnet or mainnet, you can verify it if you get an API Key from Etherscan and set it as an environment variable named ETHERSCAN_API_KEY. You can pop it into your .env file as seen in the .env.example.

In it's current state, if you have your api key set, it will auto verify rinkeby contracts!

However, you can manual verify with:

npx hardhat verify --constructor-args arguments.js DEPLOYED_CONTRACT_ADDRESS

Video submission

An demo of the project is done in the video below
https://youtu.be/gQKEgJWgm0E