Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bigchaindb/bigchaindb-hyperledger
BigchainDB integration with HyperLedger Fabric. In collaboration with TheLedger
https://github.com/bigchaindb/bigchaindb-hyperledger
bigchaindb blockchain decentralized-storage hyperledger-fabric integration
Last synced: 2 days ago
JSON representation
BigchainDB integration with HyperLedger Fabric. In collaboration with TheLedger
- Host: GitHub
- URL: https://github.com/bigchaindb/bigchaindb-hyperledger
- Owner: bigchaindb
- License: apache-2.0
- Created: 2018-08-16T08:21:45.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2018-09-20T12:54:47.000Z (about 6 years ago)
- Last Synced: 2024-08-02T22:27:28.370Z (3 months ago)
- Topics: bigchaindb, blockchain, decentralized-storage, hyperledger-fabric, integration
- Language: TypeScript
- Homepage:
- Size: 1.64 MB
- Stars: 25
- Watchers: 7
- Forks: 18
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# BigchainDB-Hyperledger Fabric Integration
This project is the outcome of a mini-hackathon in which the BigchainDB and TheLedger teams participated on the 16-17 of August 2018.
## Design
**The high level design specification is available at - [./specs/design.md](./specs/design.md)**
## Directory Structure
The directory structure of this project is as below :
```
.
├── LICENSE
├── README.md
├── bdb-hyperledger-oracle/
│
├── data_job/
│
├── hyperledger-chainservice/
│
├── specs/
│
└── ui/
```
### data_job/
This is a node based cron job that posts transactions to BigchainDB network.
### ui/
This is a react based app to access REST API of Hyperledger Fabric chain service. This UI is for demo usage of the BigchainDB-Hyperledger Fabric oracle. The web form first creates a BigchainDB asset by taking passphrase and asset data (a number). Once the asset is created, the asset id is passed to a Hyperledger chain-code which internally passes it to the oracle. The oracle then queries BigchainDB with the asset id and executes a callback passed by the Hyperledger chain-code. The oracle then sends back the results to Hyperledger chain service.
### hyperledger-chainservice/
This is hyperledger chain-service that interacts with the fabric network.
### bdb-hyperledger-oracle/
This project is an express API that functions as an oracle between Hyperledger Fabric (here in `hyperledger-chainservice/`) and BigchainDB.
In a real scenario, the chain-code can do pre-processing and create a dynamic callback before sending the request to the oracle.
## Installation & Usage
### Prerequisites
* BigchainDB network is up and running
* Hyperledger network is up and running (to run the Hyperledger fabric network, run the `startFabric.sh` script in the `/hyperledger-network/scripts` directory)
### Installation
* Create `.env` files in the root of each of oracle, chainservice and ui based on their `.env.example` files, respectively.
* Update the `.env` values as per your network and node IP addresses and ports.
* From new terminal, in `hyperledger-chainservice/` execute `yarn` and `yarn run start:watch`. This will start Hyperledger-chaincode REST server to be consumed by UI.
* From new terminal, in `ui/`, execute `npm install` and then `npm start`. This will start react application on port 3000.
* From another new terminal, run `docker-compose build` and `docker-compose up` from the root directory. This will bring up the oracle.
### Usage
* In your browser, visit `http://localhost:3000`, you will see UI for this project.
* Follow the instructions on the web page.