baby-blockchain

Repo of the Blockchain for Babies hackathon team.

Overview

Blockchain For Babies is a federated identity site for medical records.

The identity is powered by OpenID Connect, and is connected to a permissions system powered by a blockchain. When a baby is born, she has an identity created, but medical record viewing privileges are automatically granted to the parent(s), who have their own federated identities. As the baby grows up, medical record viewing privileges go through automatic changes enforced by blockchain smart contracts, and also some requested actions by the involved parties or the government, which happen through blockchain transactions.

The use of the blockchain results in a secure, auditable source of truth for medical permission transactions. And the federated identities can be used by any or all medical record portals. No longer does a patient have to grant individual portal access.

The system has the following parts:

• BabyID -- the OpenID Connect site that serves two purposes:
  1. Authentication, that the user who she says she is.
  2. Permissioning, where the user can grant access to medical resources to other identities.
• BabyBlock -- code that executes permission transactions on the blockchain
• MedPortal -- a fake medical portal that allows a user to access her own (or her family members') medical records, probably for a specific doctor or practice.

User Stories

The following user stories define doneness:

1. Create Baby: A baby is born, and permissions automatically go to parent(s).
2. When a baby reaches age 16, parent permissions automatically expire.
3. A parent commits a crime, and loses permission for a baby.
4. Parents get a divorce, and one parent loses permission.
5. A baby turns 14, and opts to take her permissions away from her parents.
6. Both parents die, and an uncle gets the baby's permissions.
7. When a baby turns 14, she gets her own login.
8. When a baby turns 78, she is diagnosed with Alzheimer's, and opts to give her permissions to her daughter.

Setup

You will need to set up the following parts:

1. Front end BabyID website.
2. Localhost ethereum blockchain

BabyID website

1. Install mongodb here: https://docs.mongodb.com/manual/installation/
2. cd to the project root directory
3. Initialize the database: ./scripts/initdb.sh You might want to use a different tab for this. It runs the daemon mongod in the background, which will annoyingly log debug info to the screen whenever a command is received.

• Alternatively, if you don't want to initialize the database and just want to use the data you already have in your db directory, Run this command to start mongodb in the background: mongod --dbpath db &

4. From project root directory, npm install
5. npm start
6. In your browser, go to localhost:3000

Ethereum Blockchain

To do development, you should run your own ethereum blockchain. Keep in mind that none of your transactions will be visible to other developers, but they will be persistent on your own blockchain.

Mac OS X

1. Go through these instructions: https://github.com/ethereum/go-ethereum/wiki/Installation-Instructions-for-Mac You should probably use homebrew.
2. Configure your local ethereum environment: https://souptacular.gitbooks.io/ethereum-tutorials-and-tips-by-hudson/content/private-chain.html
3. Link to Ethereum Wallet: https://github.com/ethereum/mist/releases
4. Setup Instructions:
5. Download geth client
6. run geth instance following step 2; be sure to generate the custom genesis.json file
7. While the geth client is running, open the Mist Ethereum Wallet