Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/olegabu/fabric-starter
Starter Application and Deployment Scripts for Hyperledger Fabric
https://github.com/olegabu/fabric-starter
blockchain fabric hyperledger hyperledger-fabric
Last synced: 8 days ago
JSON representation
Starter Application and Deployment Scripts for Hyperledger Fabric
- Host: GitHub
- URL: https://github.com/olegabu/fabric-starter
- Owner: olegabu
- License: apache-2.0
- Created: 2017-08-29T11:30:06.000Z (about 7 years ago)
- Default Branch: stable
- Last Pushed: 2022-12-21T10:37:54.000Z (almost 2 years ago)
- Last Synced: 2024-10-15T06:20:52.398Z (24 days ago)
- Topics: blockchain, fabric, hyperledger, hyperledger-fabric
- Language: Shell
- Homepage:
- Size: 40.5 MB
- Stars: 240
- Watchers: 25
- Forks: 184
- Open Issues: 35
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-baas - fabric-starter
- awesome-hyperledger-fabric - Fabric starter - Starter Application and Deployment Scripts. (Boilerplates / Network)
README
# Starter Application for Hyperledger Fabric
*(!) The project has switched to Hyperledger Fabric v2.3. For using previous versions see **snapshot-xxx** branches*
Create a Hyperledger Fabric network to jump start development of your decentralized application on
[Hyperledger Fabric](https://www.hyperledger.org/projects/fabric) platform.
The network is run by docker containers and can be deployed to one host for development or to multiple hosts for testing
or production.
Scripts of this starter generate crypto material and config files, start the Hyperledger Fabric node and deploy your chaincodes.
Additional nodes can be started and automatically connected to a Blockchain network.
Developers can use [REST API](https://github.com/olegabu/fabric-starter-rest) to invoke and query chaincodes,
explore blocks and transactions.
What's left is to develop your chaincodes and place them into the [chaincode](./chaincode) folder,
and user interface as a single page web app that you can serve by by placing the sources into the [www](./www) folder.
See also
- [fabric-starter-rest](https://github.com/olegabu/fabric-starter-rest) REST API server and client built with NodeJS SDK
- [fabric-starter-web](https://github.com/olegabu/fabric-starter-web) Starter web application to work with the REST API
- [chaincode-node-storage](https://github.com/olegabu/chaincode-node-storage) Base class for node.js chaincodes with CRUD functionality
## Blockchain network deployment
The following sections describe Fabric Starter possibilities in more details:
- [Prerequisites](#install)
- [Network with one organization (and orderer) for development](#example1org)
- [Adding other organizations to the Network](#addorgs)
- [REST API to query and invoke chaincodes](#restapi)
- [Using LDAP for user authentication and management](#restapi)
- [Consensus Types. RAFT consensus algorithm](#consensus-types)
- [Prepare and install chaincode packages ](#chaincode-packages)
- [Development\Release cycle](#releasecycle)
## Install
See [Prerequisites](docs/install.md)
## Using a particular version of Hyperledger Fabric
By default Fabric starter uses the 2.3 version of HL Fabric. If you want to deploy network with another version of HL Fabric then export it in the
FABRIC_VERSION environment variable, e.g.:
```bash
export FABRIC_VERSION=1.4.8
```
## Create a network with one organization
See [Start an organization node](docs/network-node-start.md)
## Add other organizations to the Network
See [Add organizations to Network](docs/network-add-orgs.md)
## Use REST API to query and invoke chaincodes
See [Use REST Api](docs/rest-api.md)
## Use LDAP for user authentication and management
LDAP and Hyperledger Fabric Certification Authority are the two options for user management and membership.
See [Use LDAP](docs/ldap.md) for LDAP details.
## Consensus Types. RAFT consensus algorithm.
Two types of consensus are used for ordering: Raft and Solo. For using Raft consensus see
instructions in [Start Raft Ordering Service](docs/raft.md)
## Prepare and install chaincodes
See [Install Chaincodes](docs/chaincodes.md)
When the code is stable for release or before introducing major changes\new features the branches
`stable`, `hlf-{fabric-version}-stable` and `hlf-{fabric-version}-snapshot-{version}` are created.
Up to the snapshot-0.13-2.3 the `snapshot-{version}-{fabric-version}` tempate was used.
`Note`, the Hyperledger Fabric version and the Fabric Starter version which the snapshot
depends on are defined in the `.env` file.