Hyperledger Fabric入門實戰（六）——創建通道且將節點加入通道中,安裝鏈碼，鏈碼初始化，調用鏈碼

1. Peer操作命令

1.1 創建通道

$ peer channel create [flags], 常用參數爲:
	`-o, --orderer: orderer節點的地址
	`-c, --channelID: 要創建的通道的ID, 必須小寫, 在250個字符以內
	`-f, --file: 由configtxgen 生成的通道文件, 用於提交給orderer
	-t, --timeout: 創建通道的超時時長, 默認爲5s
	`--tls: 通信時是否使用tls加密
	`--cafile: 當前orderer節點pem格式的tls證書文件, 要使用絕對路徑.
# orderer節點pem格式的tls證書文件路徑參考: 
crypto-config/ordererOrganizations/zjnu.com/orderers/orderer.zjnu.com/msp/tlscacerts/tlsca.zjnu.com-cert.pem
# example
$ peer channel create -o orderer節點地址:端口 -c 通道名 -f 通道文件 --tls true --cafile orderer節點pem格式的證書文件
	- orderer節點地址: 可以是IP地址或者域名
	- orderer節點監聽的是7050端口
$ peer channel create -o orderer.zjnu.com:7050 -c zjnuchannel -f ./channel-artifacts/channel.tx --tls true --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/zjnu.com/msp/tlscacerts/tlsca.zjnu.com-cert.pem
# 在當前工作目錄下生成一個文件: 通道名.block, 本例: zjnuchannel.block
$ ls
channel-artifacts  crypto  `zjnuchannel.block` --> 生成的文件

1.2 加入通道

$ peer channel join[flags], 常用參數爲:
	`-b, --blockpath: 通過 peer channel create 命令生成的通道文件 
# example
$ peer channel join -b 生成的通道block文件
$ peer channel join -b zjnuchannel.block

補充客戶端切換節點的代碼

其他的節點，加入通道

# 第1個節點 Go組織的 peer0
export CORE_PEER_ADDRESS=peer0.orggo.zjnu.com:7051
export CORE_PEER_LOCALMSPID=OrgGoMSP
export CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/orggo.zjnu.com/users/[email protected]/msp
export CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/orggo.zjnu.com/peers/peer0.orggo.zjnu.com/tls/ca.crt
export CORE_PEER_TLS_CERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/orggo.zjnu.com/peers/peer0.orggo.zjnu.com/tls/server.crt
export CORE_PEER_TLS_KEY_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/orggo.zjnu.com/peers/peer0.orggo.zjnu.com/tls/server.key

# 第2個節點 Go組織的 peer1
export CORE_PEER_ADDRESS=peer1.orggo.zjnu.com:7051
export CORE_PEER_LOCALMSPID=OrgGoMSP
export CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/orggo.zjnu.com/users/[email protected]/msp
export CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/orggo.zjnu.com/peers/peer1.orggo.zjnu.com/tls/ca.crt
export CORE_PEER_TLS_CERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/orggo.zjnu.com/peers/peer1.orggo.zjnu.com/tls/server.crt
export CORE_PEER_TLS_KEY_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/orggo.zjnu.com/peers/peer1.orggo.zjnu.com/tls/server.key

# 第3個節點 Cpp組織的 peer0 注意：cli爲自己定義的客戶端名稱，根據自己的命名進行修改
export CORE_PEER_ID=cli
export CORE_PEER_ADDRESS=peer0.orgcpp.zjnu.com:7051
export CORE_PEER_LOCALMSPID=OrgCppMSP
export CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/orgcpp.zjnu.com/users/[email protected]/msp
export CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/orgcpp.zjnu.com/peers/peer0.orgcpp.zjnu.com/tls/ca.crt
export CORE_PEER_TLS_CERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/orgcpp.zjnu.com/peers/peer0.orgcpp.zjnu.com/tls/server.crt
export CORE_PEER_TLS_KEY_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/orgcpp.zjnu.com/peers/peer0.orgcpp.zjnu.com/tls/server.key

# 第4個節點 Cpp組織的 peer1 注意：cli爲自己定義的客戶端名稱，根據自己的命名進行修改
export CORE_PEER_ID=cli
export CORE_PEER_ADDRESS=peer1.orgcpp.zjnu.com:7051
export CORE_PEER_LOCALMSPID=OrgCppMSP
export CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/orgcpp.zjnu.com/users/[email protected]/msp
export CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/orgcpp.zjnu.com/peers/peer1.orgcpp.zjnu.com/tls/ca.crt
export CORE_PEER_TLS_CERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/orgcpp.zjnu.com/peers/peer1.orgcpp.zjnu.com/tls/server.crt
export CORE_PEER_TLS_KEY_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/orgcpp.zjnu.com/peers/peer1.orgcpp.zjnu.com/tls/server.key

1.3 更新錨節點

$ peer channel update [flags], 常用參數爲:
	`-o, --orderer: orderer節點的地址
	`-c, --channelID: 要創建的通道的ID, 必須小寫, 在250個字符以內
	`-f, --file: 由configtxgen 生成的組織錨節點文件, 用於提交給orderer
	`--tls: 通信時是否使用tls加密
	`--cafile: 當前orderer節點pem格式的tls證書文件, 要使用絕對路徑.
# orderer節點pem格式的tls證書文件路徑參考: 
crypto-config/ordererOrganizations/zjnu.com/orderers/orderer.zjnu.com/msp/tlscacerts/tlsca.zjnu.com-cert.pem
# example
$ peer channel update -o orderer節點地址:端口 -c 通道名 -f 錨節點更新文件 --tls true --cafile orderer節點pem格式的證書文件

1.4 安裝鏈碼

$ peer chaincode install [flags], 常用參數爲:
	-c, --ctor: JSON格式的構造參數, 默認是"{}"
	`-l, --lang: 編寫chaincode的編程語言, 默認值是 golang
	`-n, --name: chaincode的名字
	`-p, --path: chaincode源代碼的目錄, 從 $GOPATH/src 路徑後開始寫
	`-v, --version: 當前操作的chaincode的版本, 適用這些命令install/instantiate/upgrade
# example
$ peer chaincode install -n 鏈碼的名字 -v 鏈碼的版本 -l 鏈碼的語言 -p 鏈碼的位置
	- 鏈碼名字自己起
	- 鏈碼的版本, 自己根據實際情況指定
$ peer chaincode install -n testcc -v 1.0 -l golang -p github.com/chaincode

1.5 鏈碼初始化

$ peer chaincode instantiate [flags], 常用參數爲:
	`-C，--channelID：當前命令運行的通道，默認值是“testchainid"。
	`-c, --ctor：JSON格式的構造參數，默認值是“{}"
	`-l，--lang：編寫Chaincode的編程語言，默認值是golang
	`-n，--name：Chaincode的名字。
	`-P，--policy：當前Chaincode的背書策略。
	`-v，--version：當前操作的Chaincode的版本，適用於install/instantiate/upgrade等命令
	`--tls: 通信時是否使用tls加密
	`--cafile: 當前orderer節點pem格式的tls證書文件, 要使用絕對路徑.
	 
# example
# -c '{"Args":["init","a","100","b","200"]}' 
# -P "AND ('OrgGoMSP.member', 'OrgCppMSP.member')"

$ peer chaincode instantiate -o orderer節點地址:端口 --tls true --cafile orderer節點pem格式的證書文件 -C 通道名稱 -n 鏈碼名稱 -l 鏈碼語言 -v 鏈碼版本 -c 鏈碼Init函數調用 -P 背書策略

$ peer chaincode instantiate -o orderer.zjnu.com:7050 --tls true --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/zjnu.com/msp/tlscacerts/tlsca.zjnu.com-cert.pem -C zjnu
channel -n testcc -l golang -v 1.0 -c '{"Args":["init","a","100","b","200"]}' -P "AND ('OrgGoMSP.member', 'OrgCppMSP.member')"

1.6 查詢

$ peer chaincode query [flags], 常用參數爲:
	`-n，--name：Chaincode的名字。
	`-C，--channelID：當前命令運行的通道，默認值是“testchainid"
	`-c, --ctor：JSON格式的構造參數，默認值是“{}"
	-x，--hex：是否對輸出的內容進行編碼處理
	-r，--raw：是否輸出二進制內容
	-t, --tid: 指定當前查詢的編號
# example
# '{"Args":["query","a"]}'
$ peer chaincode query -C 通道名稱 -n 鏈碼名稱 -c 鏈碼調用

1.7 交易

$ peer chaincode invoke [flags], 常用參數爲:
	`-o, --orderer: orderer節點的地址
	`-C，--channelID：當前命令運行的通道，默認值是“testchainid"
	`-c, --ctor：JSON格式的構造參數，默認值是“{}"
	`-n，--name：Chaincode的名字
	`--tls: 通信時是否使用tls加密
	`--cafile: 當前orderer節點pem格式的tls證書文件, 要使用絕對路徑.
	`--peerAddresses: 指定要連接的peer節點的地址
	`--tlsRootCertFiles: 連接的peer節點的TLS根證書
# 連接的peer節點的TLS根證書查找路徑參考:
/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/orggo.zjnu.com/peers/peer0.orggo.zjnu.com/tls/ca.crt
# example
# -c '{"Args":["invoke","a","b","10"]}'
$ peer chaincode invoke -o orderer節點地址:端口 --tls true --cafile orderer節點pem格式的證書文件 -C 通道名稱 -n 鏈碼名稱 --peerAddresses 背書節點1:端口 --tlsRootCertFiles 背書節點1的TLS根證書    --peerAddresses 背書節點2:端口 --tlsRootCertFiles 背書節點2的TLS根證書 -c 交易鏈碼調用

2. 通過客戶端操作各節點

客戶端對Peer節點的操作流程:

創建通道, 通過客戶端節點來完成
將每個組織的每個節點都加入到通道中 -> 客戶端來完成的
- 一個客戶端同時只能連接一個peer節點
給每個peer節點安裝智能合約 -> 鏈代碼(程序: go, node.js, java)
（從官方示例中拷貝一個智能合約到手動開發的項目裏）
對智能合約進行初始化 , 對應智能合約中的 Init 函數
- 只需要在任意節點初始化一次, 數據會自動同步的各個組織的各個節點
對數據進行查詢 -> 讀
對數據進行調用 -> 寫

經過前面的講解我們都知道, 一個客戶端只能連接一個指定的節點, 如果想要該客戶端連接其他節點, 那麼就必須修改當前客戶端中相關的環境變量

創建通道的操作只要登錄到客戶端容器中就可以進行操作.

2.1 對peer0.OrgGo的操作

要保證客戶端操作的是peer0.OrgGo
- 可以查看: echo $CORE_PEER_ADDRESS
將當前節點加入到通道中
- peer channel join -b xxx.block
安裝鏈代碼
- peer chaincode install [flags]
鏈代碼的初始化 -> 只需要做一次
- peer chaincode instantiate [flag]
查詢/調用

2.2 對peer1.OrgGo的操作

要保證客戶端操作的是peer1.OrgGo
- 可以查看: echo $CORE_PEER_ADDRESS
- 不是修改環境變量
將當前節點加入到通道中
- peer channel join -b xxx.block
安裝鏈代碼
- peer chaincode install [flags]
查詢/調用

2.3 對peer0.OrgCpp的操作

要保證客戶端操作的是peer1.OrgGo
- 可以查看: echo $CORE_PEER_ADDRESS
- 不是修改環境變量
將當前節點加入到通道中
- peer channel join -b xxx.block
安裝鏈代碼
- peer chaincode install [flags]
查詢/調用

2.4 對peer1.OrgCpp的操作

要保證客戶端操作的是peer1.OrgGo
- 可以查看: echo $CORE_PEER_ADDRESS
- 不是修改環境變量
將當前節點加入到通道中
- peer channel join -b xxx.block
安裝鏈代碼
- peer chaincode install [flags]
查詢/調用

3. 智能合約

3.1 常識

鏈代碼的包名的指定
```
// xxx.go
package main
```

必須要引入的包

// go get github.com/hyperledger/fabric/core/chaincode/shim
import (
    // 客戶端需要和 Fabric框架通信
    "github.com/hyperledger/fabric/core/chaincode/shim"
    pb "github.com/hyperledger/fabric/protos/peer"
)

鏈碼的書寫要求

// 自定義一個結構體 - 類, 基於這個類實現一些接口函數
type Test struct {
    // 空着即可
}
func (t* Test) Init(stub ChaincodeStubInterface) pb.Response;
func (t* Test) Invoke(stub ChaincodeStubInterface) pb.Response;

鏈碼 API 查詢

https://godoc.org/github.com/hyperledger/fabric-chaincode-go/shim

背書策略

# 指定背書策略
peer chaincode instantiate -o oraderer.test.com:7050 -C mychannel -n mycc —v 1.0 -c '{"Args":["init", "a", "100", "b", "200"]}' -P "AND ('OrgGoMSP.member', 'OrgCppMSP.member')" 
# 調用
# 調用示例
$ peer chaincode invoke -o orderer.zjnu.com:7050  -C mychannel -n testcc --tls true --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/zjnu.com/orderers/orderer.zjnu.com/msp/tlscacerts/tlsca.zjnu.com-cert.pem --peerAddresses peer0.orggo.zjnu.com:7051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/orggo.zjnu.com/peers/peer0.orggo.zjnu.com/tls/ca.crt --peerAddresses peer0.orgcpp.zjnu.com:7051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/orgcpp.zjnu.com/peers/peer0.orgcpp.zjnu.com/tls/ca.crt -c '{"Args":["invoke","a","b","10"]}'

AND("org1.member", "org2.member")
OR("org1.member", "org2.member")
AND(" .member", OR("org1.member", "org2.member"))

main函數編寫

func main() { 
    // SimpleChaincode 自定義 的結構體
    err := shim.Start(new(SimpleChaincode))	// 最重要的一句話
    if err != nil {
    fmt.Printf("Error starting Simple chaincode: %s", err)
    }
}
如果要自定義函數,函數格式
func (t* xxx) funcName(stub shim.ChaincodeStubInterface, args []string) pb.Response {
}

3.2 常用接口

// 操作賬本的
// shim -> ChaincodeStubInterface

示例鏈碼

package main

import (
	"fmt"
	"strconv"
	"github.com/hyperledger/fabric/core/chaincode/shim"
	pb "github.com/hyperledger/fabric/protos/peer"
)

// SimpleChaincode example simple Chaincode implementation
type SimpleChaincode struct {
}

func (t *SimpleChaincode) Init(stub shim.ChaincodeStubInterface) pb.Response {
	fmt.Println("ex02 Init")
	_, args := stub.GetFunctionAndParameters()
	var A, B string    // Entities
	var Aval, Bval int // Asset holdings
	var err error

	if len(args) != 4 {
		return shim.Error("Incorrect number of arguments. Expecting 4")
	}

	// Initialize the chaincode
	A = args[0]
	Aval, err = strconv.Atoi(args[1])
	if err != nil {
		return shim.Error("Expecting integer value for asset holding")
	}
	B = args[2]
	Bval, err = strconv.Atoi(args[3])
	if err != nil {
		return shim.Error("Expecting integer value for asset holding")
	}
	fmt.Printf("Aval = %d, Bval = %d\n", Aval, Bval)

	// Write the state to the ledger
	err = stub.PutState(A, []byte(strconv.Itoa(Aval)))
	if err != nil {
		return shim.Error(err.Error())
	}

	err = stub.PutState(B, []byte(strconv.Itoa(Bval)))
	if err != nil {
		return shim.Error(err.Error())
	}

	return shim.Success(nil)
}

func (t *SimpleChaincode) Invoke(stub shim.ChaincodeStubInterface) pb.Response {
	fmt.Println("ex02 Invoke")
	function, args := stub.GetFunctionAndParameters()
	if function == "invoke" {
		// Make payment of X units from A to B
		return t.invoke(stub, args)
	} else if function == "delete" {
		// Deletes an entity from its state
		return t.delete(stub, args)
	} else if function == "query" {
		// the old "Query" is now implemtned in invoke
		return t.query(stub, args)
	}

	return shim.Error("Invalid invoke function name. Expecting \"invoke\" \"delete\" \"query\"")
}

// Transaction makes payment of X units from A to B
func (t *SimpleChaincode) invoke(stub shim.ChaincodeStubInterface, args []string) pb.Response {
	var A, B string    // Entities
	var Aval, Bval int // Asset holdings
	var X int          // Transaction value
	var err error

	if len(args) != 3 {
		return shim.Error("Incorrect number of arguments. Expecting 3")
	}

	A = args[0]
	B = args[1]

	// Get the state from the ledger
	// TODO: will be nice to have a GetAllState call to ledger
	Avalbytes, err := stub.GetState(A)
	if err != nil {
		return shim.Error("Failed to get state")
	}
	if Avalbytes == nil {
		return shim.Error("Entity not found")
	}
	Aval, _ = strconv.Atoi(string(Avalbytes))

	Bvalbytes, err := stub.GetState(B)
	if err != nil {
		return shim.Error("Failed to get state")
	}
	if Bvalbytes == nil {
		return shim.Error("Entity not found")
	}
	Bval, _ = strconv.Atoi(string(Bvalbytes))

	// Perform the execution
	X, err = strconv.Atoi(args[2])
	if err != nil {
		return shim.Error("Invalid transaction amount, expecting a integer value")
	}
	Aval = Aval - X
	Bval = Bval + X
	fmt.Printf("Aval = %d, Bval = %d\n", Aval, Bval)

	// Write the state back to the ledger
	err = stub.PutState(A, []byte(strconv.Itoa(Aval)))
	if err != nil {
		return shim.Error(err.Error())
	}

	err = stub.PutState(B, []byte(strconv.Itoa(Bval)))
	if err != nil {
		return shim.Error(err.Error())
	}

	return shim.Success(nil)
}

// Deletes an entity from state
func (t *SimpleChaincode) delete(stub shim.ChaincodeStubInterface, args []string) pb.Response {
	if len(args) != 1 {
		return shim.Error("Incorrect number of arguments. Expecting 1")
	}

	A := args[0]

	// Delete the key from the state in ledger
	err := stub.DelState(A)
	if err != nil {
		return shim.Error("Failed to delete state")
	}

	return shim.Success(nil)
}

// query callback representing the query of a chaincode
func (t *SimpleChaincode) query(stub shim.ChaincodeStubInterface, args []string) pb.Response {
	var A string // Entities
	var err error

	if len(args) != 1 {
		return shim.Error("Incorrect number of arguments. Expecting name of the person to query")
	}

	A = args[0]

	// Get the state from the ledger
	Avalbytes, err := stub.GetState(A)
	if err != nil {
		jsonResp := "{\"Error\":\"Failed to get state for " + A + "\"}"
		return shim.Error(jsonResp)
	}

	if Avalbytes == nil {
		jsonResp := "{\"Error\":\"Nil amount for " + A + "\"}"
		return shim.Error(jsonResp)
	}

	jsonResp := "{\"Name\":\"" + A + "\",\"Amount\":\"" + string(Avalbytes) + "\"}"
	fmt.Printf("Query Response:%s\n", jsonResp)
	return shim.Success(Avalbytes)
}

func main() {
	err := shim.Start(new(SimpleChaincode))
	if err != nil {
		fmt.Printf("Error starting Simple chaincode: %s", err)
	}
}

) pb.Response {
	if len(args) != 1 {
		return shim.Error("Incorrect number of arguments. Expecting 1")
	}

	A := args[0]

	// Delete the key from the state in ledger
	err := stub.DelState(A)
	if err != nil {
		return shim.Error("Failed to delete state")
	}

	return shim.Success(nil)
}

// query callback representing the query of a chaincode
func (t *SimpleChaincode) query(stub shim.ChaincodeStubInterface, args []string) pb.Response {
	var A string // Entities
	var err error

	if len(args) != 1 {
		return shim.Error("Incorrect number of arguments. Expecting name of the person to query")
	}

	A = args[0]

	// Get the state from the ledger
	Avalbytes, err := stub.GetState(A)
	if err != nil {
		jsonResp := "{\"Error\":\"Failed to get state for " + A + "\"}"
		return shim.Error(jsonResp)
	}

	if Avalbytes == nil {
		jsonResp := "{\"Error\":\"Nil amount for " + A + "\"}"
		return shim.Error(jsonResp)
	}

	jsonResp := "{\"Name\":\"" + A + "\",\"Amount\":\"" + string(Avalbytes) + "\"}"
	fmt.Printf("Query Response:%s\n", jsonResp)
	return shim.Success(Avalbytes)
}

func main() {
	err := shim.Start(new(SimpleChaincode))
	if err != nil {
		fmt.Printf("Error starting Simple chaincode: %s", err)
	}
}

Hyperledger Fabric入門實戰（六）——創建通道且將節點加入通道中,安裝鏈碼，鏈碼初始化，調用鏈碼

1. Peer操作命令

1.1 創建通道

1.2 加入通道

補充客戶端切換節點的代碼

1.3 更新錨節點

1.4 安裝鏈碼

1.5 鏈碼初始化

1.6 查詢

1.7 交易

2. 通過客戶端操作各節點

2.1 對peer0.OrgGo的操作

2.2 對peer1.OrgGo的操作

2.3 對peer0.OrgCpp的操作

2.4 對peer1.OrgCpp的操作

3. 智能合約

3.1 常識

3.2 常用接口

示例鏈碼

公司剛入職了一名 Java 中級開發，短短 4 行代碼居然湊齊了 3 個 bug！我哭了~~

公衆號5月C#/.NET熱文一覽

git 下載大陸鏡像地址

關於SpringAop中JoinPoint的使用

第三章多服務器分佈式部署——服務器A和服務器C實現羣組2的搭建

第二章多服務器分佈式部署——服務器A和服務器B實現羣組1的搭建

第一章單羣組FISCO BCOS聯盟鏈的搭建

第五章 WeBASE的部署與使用

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結