Decentralized Energy Composer

WARNING: This repository is no longer maintained ⚠️ We are no longer showing the Hyperledger Composer Service.
Alternatives To Decentralized Energy Composer
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Build Blockchain Insurance App715
7 months ago37apache-2.0JavaScript
Sample insurance application using Hyperledger Fabric
Awesome Hyperledger Fabric431
4 months ago
A curated list of resources for creating applications with hyperledger fabric
Non Profit Blockchain355
3 months ago50apache-2.0SCSS
Builds a blockchain network and application to track donations to non-profit organizations, using Amazon Managed Blockchain
a month ago64apache-2.0Jinja
Do fabric network the right and easy way.
Blockchain Application Using Fabric Java Sdk263
a year ago8apache-2.0Java
Create and Deploy a Blockchain Network using Hyperledger Fabric SDK Java
Blockchain Network On Kubernetes256
2 years ago8apache-2.0Shell
Demonstrates the steps involved in setting up your business network on Hyperledger Fabric using Kubernetes APIs on IBM Cloud Kubernetes Service.
Heroes Service234
3 years ago3July 13, 201813apache-2.0Go
Short tutorial to build a blockchain application in Go with Hyperledger Fabric
Fabric Starter229
6 months ago33apache-2.0Shell
Starter Application and Deployment Scripts for Hyperledger Fabric
Blockchainnetwork Compositejourney211
3 years ago6apache-2.0Shell
Part 1 in a series of patterns showing the building blocks of a Blockchain application
Fabric Test150
a month ago13April 01, 202156apache-2.0Go
A collection of utilities used to test the core Hyperledger Fabric projects
Alternatives To Decentralized Energy Composer
Select To Compare

Alternative Project Comparisons

WARNING: This repository is no longer maintained ⚠️

Read this in other languages: 中文.

Decentralized Energy with Hyperledger Composer

A key application of Blockchain being currently explored is a Decentralized Energy network. The idea stems from a neighborhood where certain Residents are producing energy through Solar panels or other means, and can sell excess energy to Residents needing energy. The transactions would be based on coins in each Resident's account. As per a pre-determined contract and rate, the coins would be debited from the consumer and credited to the producer, for a certain billing period. Each transaction would need to be atomic and added to a Blockchain ledger for trust and verification. The network can include Banks to transact coins for Fiat currency (USD). The network can have Utility Company who can buy or provide energy through the network.

In this code pattern, we will create such a Blockchain application using Hyperledger Composer. The network consists of Residents, Banks and Utility Companies. Residents can exchange coins for energy among each other. The application assumes a pre-paid system where transactions occur after the energy is consumed and the values are updated. The Resident can exchange coins for Fiat money (USD) with Banks on the network. The Residents can also transact coins for energy with a Utility company on the network.

This code pattern is for developers looking to start building Blockchain applications with Hyperledger Composer. When the reader has completed this code pattern, they will understand how to:

  • Create business network using Hyperledge Composer and recording transactions on Blockchain ledger
  • Deploying the networking to an instance of Hyperledger Fabric
  • Building an Angular app to interact with the network through REST API

Architecture Flow

  1. The administrator interacts with Decentralized Energy UI comprising of Angular framework
  2. The application processes user requests to the network through a REST API.
  3. Implements requests to the Blockchain state database on Hyperledger Fabric v1
  4. The REST API is used to retrieve the state of the database
  5. The Angular framework gets the data through GET calls to the REST API

Included Components

  • Hyperledger Composer v0.20
  • Hyperledger Fabric v1.2
  • Angular Framework
  • Loopback

Running the Application

Follow these steps to setup and run this code pattern. The steps are described in detail below.


  • Operating Systems: Ubuntu Linux 14.04 / 16.04 LTS (both 64-bit), or Mac OS 10.12
  • Docker (Version 17.03 or higher)
  • npm (v5.x)
  • Node (version 8.9 or higher - note version 9 is not supported)
    • to install specific Node version you can use nvm
  • Hyperledger Composer


  1. Clone the repo
  2. Setup Fabric
  3. Generate the Business Network Archive
  4. Deploy to Fabric
  5. Run Application
  6. Create Participants
  7. Execute Transactions

1. Clone the repo

Clone the Decentralized-Energy-Composer code locally. In a terminal, run:

git clone
cd Decentralized-Energy-Composer

2. Setup Fabric

These commands will kill and remove all running containers, and should remove all previously created Hyperledger Fabric chaincode images:

docker kill $(docker ps -q)
docker rm $(docker ps -aq)
docker rmi $(docker images dev-* -q)

Set the fabric version to v1.2:

export FABRIC_VERSION=hlfv12

All the scripts will be in the directory /fabric-tools. Start fabric and create peer admin card:

cd fabric-dev-servers/

3. Generate the Business Network Archive

Next generate the Business Network Archive (BNA) file from the root directory:

cd ../
npm install

The composer archive create command in package.json has created a file called [email protected].

4. Deploy to Fabric

Now, we are ready to deploy the business network to Hyperledger Fabric. This requires the Hyperledger Composer chaincode to be installed on the peer, then the business network archive (.bna) must be sent to the peer, and a new participant, identity, and associated card must be created to be the network administrator. Finally, the network administrator business network card must be imported for use, and the network can then be pinged to check it is responding.

First, install the business network:

composer network install --card [email protected] --archiveFile [email protected]

Start the business network:

composer network start --networkName decentralized-energy-network --networkVersion 0.1.15 --networkAdmin admin --networkAdminEnrollSecret adminpw --card [email protected] --file networkadmin.card

Import the network administrator identity as a usable business network card:

composer card import --file networkadmin.card

Check that the business network has been deployed successfully, run the following command to ping the network:

composer network ping --card [email protected]

5. Run Application

First, go into the angular-app folder and install the dependency:

cd angular-app/
npm install

To start the application:

npm start

The application should now be running at: http://localhost:4200

The REST server to communicate with network is available here: http://localhost:3000/explorer/

6. Create Participants

Once the application opens, create participants and fill in dummy data. Create Residents, Banks and Utility Companies.

7. Execute Transactions

Execute transactions manually between Residents, Resident and Bank, and Resident and Utility Company. After executing transactions, ensure the participants account values are updated.

At the end of your session, stop fabric:

cd ~/fabric-tools

Extending Code Pattern

This application demonstrates a basic idea of a decentralized energy network using Blockchain and can be expanded in several ways:

  • Adding specific permissions and participant access
  • Setting up real time transactions among participants
  • Integrating with IoT to read from power meter and distribute energy

Deploy to IBM Cloud

The blockchain network can be deployed to IBM Cloud. You can use the IBM Blockchain platform and start for free under Starter Membership Plan. Follow these instructions to deploy the business network to IBM Blockchain platform.

Additional Resources


This code pattern is licensed under the Apache Software License, Version 2. Separate third party code objects invoked within this code pattern are licensed by their respective providers pursuant to their own separate licenses. Contributions are subject to the Developer Certificate of Origin, Version 1.1 (DCO) and the Apache Software License, Version 2.

Apache Software License (ASL) FAQ

Popular Hyperledger Projects
Popular Network Projects
Popular Blockchain Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Hyperledger Fabric