Blockchain Interoperability

Usage

from api import store, retrieve, migrate, Blockchain

tx_hash = store('Some Data', Blockchain.STELLAR)    

data = retrieve('[Transaction_Hash]')    

tx_hash = migrate('[Transaction_Hash]', Blockchain.ETHEREUM)

Or use the CLI:

source venv/bin/activate

python3 cli.py

Setup

Python 3.6.6 (also tested with 3.6.5) was used for this project. It was tested on MacOS and Ubuntu 18.

Install Docker

(Linux) Follow this or this manual and then do sudo apt-get install docker-compose

(Mac) Install from https://docs.docker.com/docker-for-mac/install/

Setup virtual environment (venv)

(Linux Only) Install venv:
sudo apt-get install python3-venv
Create environment:
python3 -m venv venv
Activate environment:
source venv/bin/activate
The python version of the environment will be the one with which the environment is created.

Install dependencies

Preparation

First, upgrade pip: pip install --upgrade pip
(Linux only)sudo apt-get install build-essential libssl-dev libffi-dev python3-dev

Upgrade pip on <3.6:
(Mac only) Use this command if upgrading upgrading pip fails due to SSL cert error:
curl https://bootstrap.pypa.io/get-pip.py | python

Install/Export Dependencies

Import/Install depenencies: venv/bin/pip install -r requirements.txt
Export: venv/bin/pip freeze > requirements.txt

Database Setup

(Mac Only) Install sqlite: brew install sqlite3
Then import and setup the DB:

import db.database
db.database.setup()

Calling the setup function of the database module will:

1. drop credentials and transactions tables if they already exist
2. create tables for storing credentials and transactions
3. seed the credentials table with credentials
4. seed the transactions table with input transactions

Seed values are read from the config module.

Blockchain Setup

See descriptions in SETUP.md for instruction to setup the local nodes.