https://github.com/0xjonaseb11/fabric.2.0.net
Build a basic Hyperledger fabric 2.0 network
https://github.com/0xjonaseb11/fabric.2.0.net
blockchain chaincode enterprise-blockchain golang hyperledger-fabric smartcontracts
Last synced: 3 months ago
JSON representation
Build a basic Hyperledger fabric 2.0 network
- Host: GitHub
- URL: https://github.com/0xjonaseb11/fabric.2.0.net
- Owner: 0xJonaseb11
- License: mit
- Created: 2024-02-02T22:43:40.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-05-16T05:03:47.000Z (about 1 year ago)
- Last Synced: 2025-01-20T14:58:38.718Z (5 months ago)
- Topics: blockchain, chaincode, enterprise-blockchain, golang, hyperledger-fabric, smartcontracts
- Language: Go
- Homepage:
- Size: 143 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# fabric.2.0.net
## `IMPORTANT SDK READMEs`
[NODE.JS SDK README](https://github.com/hyperledger/fabric-sdk-node#build-and-test) |
[JAVA SDK README](https://github.com/hyperledger/fabric-gateway-java/blob/main/README.md) |
[GO SDK README](https://github.com/hyperledger/fabric-sdk-go/blob/main/README.md)
## `Setting up a basic hyperledger fabric 2.0 network`
## Prerequisites
- cURL installed
- golang installed
- python v3 installed
- node.js LTS installed
- npm LTS installed
### Getting started - full guide
```sh
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
source ~/.bashrc || . ~/.bashrc || vim ~/.bashrc || pico ~/.bashrc
```
_**Installation**_
`Docker Engine`
```sh
# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
# Add the repository to Apt sources:
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
```
```sh
# Install the latest docker packages
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```
```sh
# Verify that the docker engine installation is succesful
sudo docker run hello-world
```
```sh
# To uninstall the docker engine
sudo apt-get purge docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras
# Delete all the images, containers and volumes
sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd
```
`Install docker-compose from docker - snap`
```sh
# Install it with docker
sudo snap install docker
# docker will come with it in this case
```
`Or install it separately`
```sh
# Install it separately
sudo apt install docker-compose
```
`Verify the versions`
```sh
curl --version
npm --version
node --version
docker version
docker-compose version
go --version
python3 --version
```
`Some docker images used`
```sh
curl -sSL https://bit.ly/2ysbOFE | bash -s
```
`Installation of hyperledger fabric`
```sh
# update apt packages
sudo apt update
sudo apt upgrade
# create new user(fabric)
sudo adduser fabric
sudo usermod -aG sudo fabric
su - fabric
# Install overall prerequisites
sudo apt-get update
sudo apt-get install git curl docker.io docker-compose nodejs npm python
# start && enable docker
sudo usermod -a -G docker $USER
sudo systemctl start docker
sudo systemctl enable docker
```
`Dealing with platform specific binaries`
```sh
# Make sre you have a latest curl version
# Install it with this command
wget https://github.com/hyperledger/fabric/blob/master/scripts/bootstrap.sh
# Note: You can use this command for any published version of Hyperledger Fabric. Simply replace ‘1.1.0’ with the version identifier of the version you wish to install
# Execute this in the very exact directory
curl -sSL https://goo.gl/6wtTN5 | bash -s
curl -sSL https://goo.gl/6wtTN5 | bash -s 1.1.0 1.1.0 0.4.6
```
`Binaries downloaded are`
- cryptogen,
- configtxgen,
- configtxlator,
- peer
- orderer and
- fabric-ca-client
`You may want to add that to your PATH`
```sh
export PATH=/bin:$PATH
```
### `Hyperledger fabric sdks`
- [Hyperledger fabric Node SDK](https://github.com/hyperledger/fabric-sdk-node) and [Node SDK Documentation](https://fabric-sdk-node.github.io)
- [Hyperledger fabric Java SDK](https://github.com/hyperledger/fabric-sdk-node)
- [Hyperledger fabric Python SDK](https://github.com/hyperledger/fabric-sdk-py)
- [Hyperledger fabric Go SDK](https://github.com/hyperledger/fabric-sdk-go)
- [Hyperledger fabric REST SDK](https://github.com/hyperledger/fabric-sdk-rest)
### `Note`
Hyperledger fabric also offers CA - Certificate of Authoriry for the network to manage and configure identity on your blockchain network
[Hyperledger fabrc CA service](http://hyperledger-fabric-ca.readthedocs.io/en/latest)
## Getting started
`Install fabric images and binaries`
```sh
mkdir -p $HOME/go/src/github.com/
cd $HOME/go/src/github.com/
# `Getting install script`
curl -sSLO https://raw.githubusercontent.com/hyperledger/fabric/main/scripts/install-fabric.sh && chmod +x install-fabric.sh
```
`Alternative script || advanced`
```sh
curl -sSL https://raw.githubusercontent.com/hyperledger/fabric/main/scripts/bootstrap.sh| bash -s
```
`Pull docker containers and clone samples`
```sh
./install-fabric.sh docker samples binary
or
./install-fabric.sh d s b
```
`Specify the version of binaries you want to install`
```sh
./install-fabric.sh --fabric-version binary # in this case we used 2.5.0
```
`Remove any containers or artifacts from recent runs`
```sh
cd fabric-samples/test-network
./network.sh down
```
`Bring up the network`
```sh
./network.sh up
# If ir is successfull, you shoulf see different components of the output
## See the nodes and containers created by `./network.sh` script
docker ps -a
``
**Getting error while bringing up network??**
```sh
./network.sh up
Using docker and docker-compose
Starting nodes with CLI timeout of '5' tries and CLI delay of '3' seconds and using database 'leveldb' with crypto from 'cryptogen'
```
[Follow the instructions in the Fabric docs to install the Fabric Binaries](https://hyperledger-fabric.readthedocs.io/en/latest/install.html)
`Creating a new channel`
```sh
./network.sh createChannel -c
```
**NOTE: Make sure the name of the channel applies the following restrictions:**
- contains only lower case ASCII alphanumerics, dots ‘.’, and dashes ‘-‘
- is shorter than 250 characters
- starts with a letter
`Starting a chaincode on the channel`
```sh
./network.sh deployCC -ccn basid -cpp ../asset-transfer-basic/chaincode-go -ccl go
```
`Using other languages not Go??`
```sh
./network.sh deployCC -ccn basic -ccp ../asset-transfer-basic/chaincode- -ccl
# In this case - fabric -> Javascript, typescript or Java
```
**After bringing up the network, you cab use `peer`CLI to interact with the network**
_**The peer CLI allows you to invoke deployed smart contracts, update channels, or install and deploy new smart contracts from the CLI.**_
```sh
# Add downloaded binaries to bin folder
export PATH=${PWD}/../bin:$PATH
```
**Another essential step is to set the `FABRIC_CFG_PATH` to point to the `core.yaml` file in the fabric-samples directory**
```sh
export FABRIC_CFG_PATH=$PWD/../config/
```
`Set the environmental variables for Org1`
```sh
# Environment variables for Org1
export CORE_PEER_TLS_ENABLED=true
export CORE_PEER_LOCALMSPID="Org1MSP"
export CORE_PEER_TLS_ROOTCERT_FILE=${PWD}/organizations/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt
export CORE_PEER_MSPCONFIGPATH=${PWD}/organizations/peerOrganizations/org1.example.com/users/[email protected]/msp
export CORE_PEER_ADDRESS=localhost:7051
```
_The CORE_PEER_TLS_ROOTCERT_FILE and CORE_PEER_MSPCONFIGPATH environment variables point to the Org1 crypto material in the organizations folder._
`Initialize the ledger with assets`
```sh
peer chaincode invoke -o localhost:7050 --ordererTLSHostnameOverride orderer.example.com --tls --cafile "${PWD}/organizations/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem" -C mychannel -n basic --peerAddresses localhost:7051 --tlsRootCertFiles "${PWD}/organizations/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt" --peerAddresses localhost:9051 --tlsRootCertFiles "${PWD}/organizations/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt" -c '{"function":"InitLedger","Args":[]}'
```
_*If successful, you should see output of similar look as this*_
```sh
INFO 001 Chaincode invoke successful. result: status:200
```
_(Note the CLI does not access the Fabric Gateway
peer, so each endorsing peer must be specified.)_
`Query the ledger and get list of assets added to channel ledger`
```sh
peer chaincode query -C myChannel -n basic -c '{"Args": ["GetAllAssets]}'
## If it is sucessful, you'll see a list of assets, their properties and respective owners
```
`change the owner of an asset on the ledger by invoking the asset-transfer (basic)chaincode`
```sh
peer chaincode invoke -o localhost:7050 --ordererTLSHostnameOverride orderer.example.com --tls --cafile "${PWD}/organizations/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem" -C mychannel -n basic --peerAddresses localhost:7051 --tlsRootCertFiles "${PWD}/organizations/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt" --peerAddresses localhost:9051 --tlsRootCertFiles "${PWD}/organizations/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt" -c '{"function":"TransferAsset","Args":["asset6","Christopher"]}'
```
-------
@0xJonaseb11