"SaveMe" - A token for Health

This is a repository dedicated to "SaveMe", a token for health! The aim of this token is to incentivize diabetes patients to take care of their own health and be more engaged with ensuring they mantain stable glucose levels throughout the day. Combining IoT and Tokens deployed on Decentralized Systems, SaveMe will become the #1 solution to diabetes. A CGM (Continuous Glucose Monitor) is attached to each patient's arm and takes blood measurements every 5 minutes. The glucose level measurements are reported every 5 minutes in the DApp and alert the patient for any abnormalities.

Token Award conditions

For a token to be awarded, the average of the 4 quarter measurements (each quarter measurement is the mean of 3 measurements of 5-minute measurement intervals) must be within the normal range of 70mg/dl (3.9mmol/L) and 180dl/mg(10mmol/L). The ranges are dfined based on the 3 levels of hypoglycemia and hyperglycemia.The sensor sends data, either as measurements or token calculations. Both sources of data are saved in an IPFS file each encrypted with the public key of the patient & the shaddow account.

Required Software

To run the application, you will need the following software:

• VS (Visual Studio)
• Nodejs
• Ganache
• Truffle
• ngrok

Required Hardware

For full functionality, make sure you have:

• Sensor to POST data ( ESP32 or Arduino )

How to run?

1. Download directory either manually or using git clone

   git clone "https://github.com/FuturICT2/susDAO-saveMe"

2. Open project folder with VS

3. Download all necessary packages with npm

   npm start
   npm install

4. Server website and expose localhost to a public address for sensor to send data

   a) Start ngrok in a Terminal, where your localhost:8000 will be exposed

   ./ngrok http 8000

   b) Copy ngrok main public address

5. Change the ngrok public address for all relevant files

   a) Go to HTML files and change public address

   cd FontEnd/BackEnd/public 

   and go to

   index.js
   measurement.js
   tokens.js

   paste the new ngrok public address under: ngrok_address

   b) Go to Arduino file

   main.ino

   and change address by pasting the ngrok public address

6. Update Sensor file main.ino with your home's Network Login details

7. Verify and Upload main.ino in Sensor(ESP32 or Arduino)

8. Go to directory of application file

   cd FrontEnd/BackEnd

9. Run appplication in VS using Node

   node app.js

Sensor & Front End

The sensor source code is written in Processing an dis uploaded to either an Arduino or an ESP32, using the a compatible IDE. At the same time we run the application in VS using Node. Hence the sensor starts sending POST data to the server operating through Node and exposed through ngrok. An ilustration of both the sensor and the website Front End are shown below.

To access the website it is a requirement, to have a Metamask account and login. The unique sensor id of each CGM is associated with a Metamask account that can access real-time measurements from the sensor.

Development Mode & Future Work

1. Add some minor functions to support IPFS access inside the Smart Contracts

2. Add request and approve contracts to ensura that a Data Access request is accepted by the corresponding party

3. For existing contracts and any newly written, in the terminal use

   truffle compile

   to compile the contracts and also

   truffle migrate

   to migrate them

4. Implement detailed testing

   • Check if token is succesfully dpeloyed

   • Run test cases for different token validation from diffent types of users

   • Run test cases for data access and ensure that no bridge of any patient's privacy occurs

   • Run test to check the response of the Smart Contracts and transfer of tokens funds

5. To check the success of any written tests use the truffle comman in the terminal

   truffle test

6. Write more code on the app.js file to support the Smart Contract interaction with the FrontEnd. Specifically:

   • IPFS interaction with the Smart Contracts and the Front End

   • Transfer tokens from one account to the other using the "Send Tokens" button after reading the destination address from the QR code

   • Implement the relevant menu options with the respective Smart Contracts (Data Access , Token Validation , Health Insurance). This means that the Front End must interaact with the Smart Contract and allow the user to view his/her Health Insurance, Validate Tokens upon request or Download and Access any measurements through IPFS.

Coding Background

• Solidity ⮕ Smart Contract Coding
• Javascript ⮕ Back End & Front End Web Developement
• Processing ⮕ Sensor Coding
• HTML ⮕ Front End Web Development
• Bootstrap ⮕ Responsive Front End Web Development

Special Thanks

I would like to thank @benjaminaaron (Benjamin Aaron Degenhart) for his much appreciated help and contribution in the coding part, as well as Dr.Markus M. Dapp and Mark Ballandies for their assistance and guidance in the conceptual development of SaveMe.