Akachain Development Tool

Akachain Development Tool (devtool) provides a framework allowing developers to immediately build and test their blockchain applications locally on their local PC. This includes a local Hyperledger Fabric blockchain network with 2 organizations and other tools to support applications development

Table of Contents

• Devtool diagram
• Installation
• How to use
• Development resources
• Known Issues

Devtool Diagram

Devtool consists of following components:

• Blockchain network: Blockchain network is based on Hyperledger Fabric. It can be customized when created using admin tool (create network). Each blockchain network contains the following components:
  • Peers (currently we support two peers)
  • CA: Certificate Authority
  • Orderer: Currently We support Solo orderer type. Raft and Kafka will be supported soon
• Dapp template: Decentralized application template to work with blockchain (It is integrated with devtool backend)
• Admin tool: To manage blockchain network (define network/delete network), Install/update/init/query chaincode.
• Blockchain explorer: To explorer everything on blockchain
• Postgres/Mysql: are databases that running on container serving devtool backend and explorer

Installation

Currently We support running Akachain development tool on Linux (Ubuntu, Fedora, CentOS), Windows and MacOS. We strongly recommend using Ubuntu OS for development as It is well-tested and automation

Prerequisite

• Docker version > 17.x
• Nodejs version > 8.x
• setupEnv.sh script will automatically check and install dependencies on Ubuntu. For other OS, Please follow the link docker, nodejs to complete installation before using.

Install package

• For Linux based:
  • Setup environment or reset network ./setupEnv.sh or ./setupEnv.sh reset
  • Start again (after PC reset, program terminated ...) ./setupEnv.sh start
• For Windows: TO BE UPDATED ...

The installation may take serveral minutes because It downloads many packages and docker images. After installation, please open web browser http://localhost:4500 to get started.

How to use

After installation, please check the Documents tab to learn how to use or checkout this guide

Development resources

• Web: akachain.io
• Devtool: dev.akachain.io
• Explorer: dev-explorer
• Mail: support@akchain.io
• GitHub: https://github.com/Akachain
• Documentation: akachain.readthedocs.org

Known Issues

• Fabric version 1.2, 1.3 and 2.0 may not working porperly, please chose version v1.4.1 because it is well tested.
• When network start up, there may be ten of container running on local PC, It may take long time to complete the process if hardwares are not good enough, please be patient