Development Tools

Featured technologies

• Hyperledger Fabric (https://www.hyperledger.org/use/fabric) is intended as a foundation for developing applications or solutions with a modular architecture. Its modular and versatile design satisfies a broad range of industry use cases.

• Nodejs (https://www.nodejs.org/) is an open-source, cross-platform JavaScript run-time environment that executes JavaScript code server-side.

• TypeScript (https://www.typescriptlang.org/) is an open-source language which builds on JavaScript, one of the world’s most used tools, by adding static type definitions.

• Docker (https://www.docker.com/) is a computer program that performs operating-system-level virtualization, also known as Containerization.

More info:

• Docker - latest

• Docker Compose - latest

• NPM - latest

• nvm - latest

• Node.js - v14.17

• TypeScript - v4.3.4

• HyperLedger Read the Docs

• HyperLedger Test Network

You could use your local docker containers or create a cloud account in IBM Cloud, Azure, AWS or Google Cloud Platform.

Cloud Dev Environment Setup

The development environment for this application is Google Cloud Platform which can provide enough resources to run the Hyperledger Fabric.

• Create an instance in Google Cloud Platform

• Install Pony SSH plugin in VSC

Create key pair in Mac

ssh-keygen -t rsa
cat /home/username/.ssh/id rsa.pub

Install IBM Blockchain Platform VS Code extension

The IBM Blockchain Platform Developer Tools can be installed as a VS Code extension on your local system to make easier your development:

• Microsoft Visual Studio Code

• IBM Blockchain plugin

• Install Pony SSH plugin in VSC

• Install Docker Plugin in VSC

Blockchain Explorer

Blockchain explorer provides a dashboard for viewing information about transactions, blocks, node logs, statistics, and smart contracts available on the network. Users will be able to query for specific blocks or transactions and view the complete details. Blockchain explorer can also be integrated with any authentication/authorization platforms (commercial/open source) and will provide appropriate functionality based on the privileges available to the user.

# Create explorer directory
mkdir explorer
cd explorer

# Download configuration files
wget https://raw.githubusercontent.com/hyperledger/blockchain-explorer/main/examples/net1/config.json
wget https://raw.githubusercontent.com/hyperledger/blockchain-explorer/main/examples/net1/connection-profile/test-network.json -P connection-profile
wget https://raw.githubusercontent.com/hyperledger/blockchain-explorer/main/docker-compose.yaml

# Change network name to net_test
vim docker-compose.yaml

cd fabric-samples/test-network/

# Certify to clean everything
./network.sh down
# Bring up the network with the channels, CA and CouchDB
./network.sh up createChannel -ca -s couchdb
# Deploy the Chain Code
./network.sh deployCC -ccn basic -ccp ../asset-transfer-basic/chaincode-javascript -ccl javascript

# Return to the explorer directory
cd ..
cd ..
cd explorer

# Copy organization folder from the test network
# We want the criptographic stuff
# This should run inside explorer directory
sudo cp -r ../fabric-samples/test-network/organizations/ .

# Create a KEY
sudo ls organizations/peerOrganizations/org1.example.com/users/[e-mail]/msp/keystore/
885760d2b14aada616bd20db85d263668634b8b385f825591a516684dfac425d_sk

# Change the KEY in organizations/Org1MSP/adminPrivateKey
vi connection-profile/test-network.json

# 
sudo docker network create docker_test
852cb9532712f64fbd744b2081c5ec41a7ec676be97ad2d8f70130fe033368aa

# Change name to net_test in networks    <<<<<<<<<<<<<<
sudo vim docker-compose.yaml

# Start Docker Compose
sudo docker-compose up
# To run as a deamon use -d
# sudo docker-compose up -d

# To view the Docker Networks
sudo docker network ls

Remember to create a firewall rule in your cloud platform before that.

1. VPC network/ Firewall / Create a firewall rule

2. Target: All instances

3. Source: 0.0.0.0/0

4. Specified protocols and ports: tcp : 8080

These are the default user and password. Change it in your first access:

• Username: exploreradmin

• Password: exploreradminpw

CouchDB and Fauxton GUI

Hyperledger Fabric ledger data can be viewed using the Apache CouchDB and Fauxton Web GUI.

Fauxton provides full access to all of CouchDB’s features and makes it easy to work with some of the more complex ideas involved. With Fauxton we can create and destroy databases; view and edit documents; compose and run MapReduce views; and trigger replication between databases.

To load Fauxton in your browser, visit:

http://[your-ip-address/]:5984/utils/

Remember to create a firewall rule in your cloud platform before that.

1. VPC network/ Firewall / Create a firewall rule

2. Target: All instances

3. Source: 0.0.0.0/0

4. Specified protocols and ports: TCP: 5984

These are the default user and password. Change it in your first access:

• Username: admin

• Password: adminpw

More information about Fauxton can be found in the link. You could also try Futon Web GUI as a Fauxton alternative.

Connect VM with GUI

In order to improve development experience of the GCP Linux VM a GUI component can be installed.

Connect your Linux VM remotely through NoMachine

sudo apt-get install ubuntu-desktop
sudo adduser demo
sudo usermod -aG sudo,adm demo
sudo -i
#find passwordauthentication "no" change to "yes"
vim /etc/ssh/sshd_config
sudo apt update
sudo apt -y install wget
hostnamectl

wget https://download.nomachine.com/download/7.6/Linux/nomachine_7.6.2_4_amd64.deb
sudo dpkg -i nomachine_7.6.2_4_amd64.deb
sudo reboot

Remember to create a firewall rule in your cloud platform.

1. VPC network/ Firewall / Create a firewall rule

2. Target: All instances

3. Source: 0.0.0.0/0

4. Specified protocols and ports: TCP: 4000