Fabric 2.0中鏈碼操作過程是怎么樣的

這篇文章給大家分享的是有關(guān)Fabric 2.0中鏈碼操作過程是怎么樣的的內(nèi)容。小編覺得挺實用的，因此分享給大家做個參考，一起跟隨小編過來看看吧。

1、鏈碼操作：Fabric 1.4 vs Fabric 2.0

我們將首先快速介紹在HF 1.4和HF 2.0中的整個鏈碼操作過程。

鏈碼操作指的是在Hyperledger fabric網(wǎng)絡(luò)通道上部署鏈碼的操作，這樣區(qū)塊鏈之外的應(yīng)用可以調(diào)用或查詢鏈碼方法。在鏈碼開發(fā)完成并測試后，首先需要將Fabric鏈碼安裝到指定的peer節(jié)點。在這個階段鏈碼還不能使用，直到鏈碼被提交（Fabric 2.0中的術(shù)語）到通道中或在通道上實例化（Fabric 1.4中的術(shù)語），這樣鏈碼就可以被授權(quán)用戶訪問了。

下面是兩個版本的Hyperledger Fabric中鏈碼操作流程的對比圖：

在Hyperledger Fabric 1.4中，鏈碼操作過程包含以下步驟：打包、安裝、實例化。如果鏈碼屬于多個參與方，那么就需要打包這一環(huán)節(jié)。如果不存在多方屬主的問題，那么直接安裝鏈碼就可以（其中隱含了打包環(huán)節(jié)）。在Fabric鏈碼安裝時需要指定要安裝鏈碼的目標節(jié)點。

在這個階段，安裝好的Fabric鏈碼還不能使用，因為它還沒有在通道上實例化。當(dāng)Fabric鏈碼包被安裝在指定的節(jié)點上之后，我們就可以執(zhí)行鏈碼實例化操作，從而讓鏈碼在通道上可用。技術(shù)上來說，鏈碼實例化實際上就是調(diào)用LSCC系統(tǒng)鏈碼的方法來初始化通道上的一個鏈碼。

Fabric鏈碼實例化之后就可以使用了，可以接受通道上的調(diào)用或查詢請求。

下面我們看在Hyperledger Fabric 2.0中的鏈碼操作步驟有何區(qū)別。

寬泛地來講，在Fabric 2.0中鏈碼操作基本遵循同樣的流程，但是在命令和某些后臺處理中做了一些調(diào)整。整體的流程可以分為四個步驟：打包、安裝、機構(gòu)審批、鏈碼提交。大致可以認為前兩個環(huán)節(jié)對應(yīng)于Fabric 1.4中的鏈碼安裝，后面兩個環(huán)節(jié)對應(yīng)于Fabric 1.4中的鏈碼實例化，但是實例化（instantiation）這個詞不再用了。

鏈碼打包這一步是創(chuàng)建一個打包文件（tar格式），其中包含F(xiàn)abric鏈碼以及一些元數(shù)據(jù)。雖然不同的機構(gòu)可以分別進行打包處理，更常見是由一個機構(gòu)打包然后分發(fā)給其他機構(gòu)以便確保所有的機構(gòu)使用相同的鏈碼。

安裝步驟是將打包的Fabric鏈碼文件安裝在指定的peer節(jié)點上。和之前的版本一樣，只有需要接受鏈碼調(diào)用的節(jié)點才需要安裝鏈碼。在這個節(jié)點，F(xiàn)abric鏈碼還不可用，因為還沒有提交到通道中。鏈碼安裝的結(jié)果是得到一個包標識符，其格式為<label>.<hash>。

機構(gòu)審批是在Hyperledger Fabric 2.0中增加的步驟。在之前的版本中我們可以讓一個機構(gòu)實例化鏈碼。在Fabric 2.0中，需要機構(gòu)顯式地審批鏈碼。需要多少機構(gòu)審批則是由生命周期背書策略來決定，默認情況下設(shè)置為需要大多數(shù)機構(gòu)（超過半數(shù)）。如果Fabric網(wǎng)絡(luò)中包含兩個機構(gòu)，那么就需要這兩個機構(gòu)同時批準。在審批過程中需要排序節(jié)點的參與，因為每次審批都會生成一個新的區(qū)塊，這意味著所有的peer節(jié)點都了解審批的狀態(tài)。

當(dāng)審批環(huán)節(jié)完成后，我們就需要指定要在哪個通道上部署鏈碼。這需要提交一些信息，例如背書策略、是否需要執(zhí)行Init代碼等等。在這里也有些與Fabric 1.4不同的地方：在Fabric 1.4中，當(dāng)鏈碼實例化時會自動調(diào)用鏈碼的Init方法，然而在Fabric 2.0中，需要在提交鏈碼后顯式地調(diào)用Init方法。

在批準機構(gòu)達到指定數(shù)量后，鏈碼就可以提交了。我們現(xiàn)在就進入了最后一個步驟：鏈碼提交。

鏈碼提交可以由任何機構(gòu)發(fā)起。該流程首先需要批準機構(gòu)的背書，然后交易提交到排序服務(wù)并生成新的區(qū)塊，最后所有的對等節(jié)點在賬本中提交該區(qū)塊。

現(xiàn)在鏈碼就可以使用了。

2、First Network和SACC鏈碼簡介

出于完整性考慮，下面給出關(guān)于First Network和SACC鏈碼的一些信息，這些內(nèi)容都來自fabric-samples倉庫。

First Network是一個雙機構(gòu)設(shè)置，每個機構(gòu)中包含兩個peer節(jié)點。通道m(xù)ychannel創(chuàng)建后加入所有的4個peer節(jié)點。在byfn.sh中完整的實現(xiàn)了First Network的部署，并包含一些可選的參數(shù)。在下面的演示中，我們不使用默認的鏈碼（在Fabric 1.4中式chaincode_example02，在Fabric 2.0中式abstore），而是使用SACC鏈碼。

SACC式Simple Asset ChainCode的縮寫，表示簡單資產(chǎn)鏈碼。它在賬本中模擬一個鍵/值存儲。當(dāng)初次部署后，需要一個初始的鍵/值對。SACC鏈碼定義了兩個方法：Set()和Get()，分別用來設(shè)置或讀取某個鍵的值。

好了，現(xiàn)在我們可以開始演示Fabric 1.4和Fabric 2.0中鏈碼操作的不同了。

3、Fabric 1.4.4鏈碼操作演示

我們首先以無鏈碼方式（使用-n選項）啟動First Network，然后我們再加載SACC鏈碼以便聚焦鏈碼的生命周期。

下面是演示步驟：

• 無鏈碼方式啟動First Network

• 在指定的peer節(jié)點上安裝SACC鏈碼

• 在mychannel通道上實例化SACC鏈碼并查詢結(jié)果

• 調(diào)用set()設(shè)置新值并從另一個peer節(jié)點查詢結(jié)果

STEP 1：首先啟動First Network：

cd fabric-samples/first-network
./byfn.sh up -n

上面的命令會啟動First Network、創(chuàng)建通道m(xù)ychannel并將所有的peer節(jié)點加入該通道。注意在Fabric 1.4.4中，F(xiàn)irst Network使用solo排序服務(wù)實現(xiàn)，只有一個排序節(jié)點。另外，我們看到有4個對等節(jié)點在運行，以及一個CLI用于鏈碼操作。

現(xiàn)在我們可以開始鏈碼部署操作。

STEP 2：在指定peer節(jié)點上安裝鏈碼

這里我們跳過打包環(huán)節(jié)，直接在目標節(jié)點peer.org1和peer0.org2上安裝鏈碼，因為在這個演示中我們只需要這兩個節(jié)點進行鏈碼調(diào)用和查詢。

# peer0.org1
docker exec cli peer chaincode install -n mycc -v 1 \
  -p github.com/chaincode/sacc
  
# peer0.org2  
docker exec \
  -e CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/users/Admin@org2.example.com/msp \
  -e CORE_PEER_ADDRESS=peer0.org2.example.com:9051 -e CORE_PEER_LOCALMSPID="Org2MSP" \
  -e CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt \
  cli peer chaincode install -n mycc -v 1 -p github.com/chaincode/sacc

STEP 3：在通道m(xù)ychannel上實例化鏈碼并查詢

注意在sacc鏈碼中有Init()代碼。當(dāng)我們實例化鏈碼時，我們需要提供Init()所需的參數(shù)：

docker exec cli peer chaincode instantiate -o orderer.example.com:7050 --tls \
  --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem \
  -C mychannel -n mycc -v 1 -c '{"Args":["name","kc"]}' \
  -P "AND ('Org1MSP.peer','Org2MSP.peer')"

如果現(xiàn)在看看peer節(jié)點的日志，我們可以看到出了新區(qū)塊#3。

在鏈碼實例化之后，我們可以查詢：

docker exec cli peer chaincode query -C mychannel -n mycc -c '{"Args":["get","name"]}'

STEP 4：調(diào)用set()設(shè)置新值并從另一個節(jié)點查詢

出于演示目的，我們在peer0.org1上調(diào)用set()，然后在peer0.org2上調(diào)用get()，以此說明鏈碼是否工作正常。

# peer0.org1
docker exec cli peer chaincode invoke -o orderer.example.com:7050 --tls \
  --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem \
  --peerAddresses peer0.org1.example.com:7051 \
  --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt \
  --peerAddresses peer0.org2.example.com:9051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt \
  -C mychannel -n mycc -c '{"Args":["set","name","Peter"]}'
  
  # peer0.org2
docker exec -e CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/users/Admin@org2.example.com/msp \
  -e CORE_PEER_ADDRESS=peer0.org2.example.com:9051 \
  -e CORE_PEER_LOCALMSPID="Org2MSP" \
  -e CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt \
  cli peer chaincode query -C mychannel -n mycc -c '{"Args":["get","name"]}'

4、Fabric 2.0鏈碼操作演示

類似的，在Fairc 2.0.0中，我們也先以無鏈碼方式啟動First Network，然后再啟動SACC鏈碼以便聚焦鏈碼的生命周期。

下面是演示步驟：

• 無鏈碼方式啟動First Network

• 打包SACC鏈碼

• 在指定peer節(jié)點上安裝SACC鏈碼包

• 機構(gòu)審批鏈碼

• 在mychannel通道上提交鏈碼

• 調(diào)用SACC鏈碼的Init方法

• 調(diào)用SACC鏈碼的set方法并從另一個peer節(jié)點查詢結(jié)果

STEP 1：以無鏈碼方式啟動First Network：

cd fabric-samples/first-network
./byfn.sh up -n

現(xiàn)在First Network已經(jīng)啟動，通道m(xù)ychannel已經(jīng)創(chuàng)建并且所有peer節(jié)點已經(jīng)加入mychannel通道。注意在Fabric 2.0.0中，F(xiàn)irst Network使用Raft作為排序服務(wù)，所有5個排序節(jié)點都在運行。在這個演示中，我們只使用orderer.example.com，不過使用其他排序節(jié)點也是一樣的。

STEP 2：打包SACC鏈碼

首先我們處理依賴問題：

cd fabric-sample/chaincode/sacc
GO111MODULE=on go mod vendor
cd fabric-sample/first-network

然后打包鏈碼：

docker exec cli peer lifecycle chaincode package sacc.tar.gz \
  --path github.com/hyperledger/fabric-samples/chaincode/sacc/ \
  --label sacc_1

在CLI容器內(nèi)可以看到生成了新的文件sacc.tar.gz：

STEP 3：在指定peer節(jié)點上安裝SACC鏈碼包

現(xiàn)在我們在peer0.org1和peer0.org2上安裝SACC練馬報，因為在這個演示中我們只需要使用這兩個節(jié)點進行鏈碼調(diào)用和查詢。

# peer0.org1
docker exec cli peer lifecycle chaincode install sacc.tar.gz

# peer0.org2
docker exec \
  -e CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/users/Admin@org2.example.com/msp \
  -e CORE_PEER_ADDRESS=peer0.org2.example.com:9051 \
  -e CORE_PEER_LOCALMSPID="Org2MSP" \
  -e CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt \
  cli peer lifecycle chaincode install sacc.tar.gz

我們會收到鏈碼包的標識符，在下面的鏈碼審批階段會用到。我們收到的鏈碼標識符為：sacc_1:bf57…6399。

我們可以使用peer lifecycle chaincode queryinstalled命令隨時檢查節(jié)點上的鏈碼安裝情況，如果我們需要找出鏈碼包的標識ID，這個命令會很有用。

# peer0.org1
docker exec cli peer lifecycle chaincode queryinstalled

# peer0.org2
docker exec \
  -e CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/users/Admin@org2.example.com/msp \
  -e CORE_PEER_ADDRESS=peer0.org2.example.com:9051 \
  -e CORE_PEER_LOCALMSPID="Org2MSP" \
  -e CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt \
  cli peer lifecycle chaincode queryinstalled

STEP 4：審批鏈碼

根據(jù)默認策略，需要超過半數(shù)的機構(gòu)審批鏈碼后才能向通道提交鏈碼，具體可參考configtx.yaml中的Application/Policies/LifecycleEndorsement部分。目前的設(shè)置中包含兩個機構(gòu)，因此需要兩個機構(gòu)同時批準鏈碼。

首先是Org1批準鏈碼：

docker exec cli peer lifecycle chaincode approveformyorg \
  --tls \
  --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem \
  --channelID mychannel --name mycc --version 1 \
  --init-required --sequence 1 --waitForEvent --package-id ${PACKAGE_ID}

如果我們現(xiàn)在看下peer節(jié)點的日志，可以看到出了新塊#3。

類似的，我們讓Org2批準鏈碼：

docker exec \
  -e CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/users/Admin@org2.example.com/msp \
  -e CORE_PEER_ADDRESS=peer0.org2.example.com:9051 \
  -e CORE_PEER_LOCALMSPID="Org2MSP" \
  -e CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt \
  cli peer lifecycle chaincode approveformyorg \
  --tls \
  --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem \
  --channelID mychannel --name mycc --version 1 --init-required \
  --sequence 1 --waitForEvent --package-id ${PACKAGE_ID}

不出意外，可以看到出了新塊block#4：

注意我們在approval命令中指定了init相關(guān)的參數(shù)，以便向SACC鏈碼的Init方法傳入所需的參數(shù)。

可以隨時使用如下命令查看鏈碼的提交狀態(tài)：

docker exec cli peer lifecycle chaincode checkcommitreadiness \
  --channelID mychannel --name mycc --version 1 --sequence 1 --output json

兩個機構(gòu)都已經(jīng)批準了鏈碼，現(xiàn)在可以提交了。

STEP 5：向通道m(xù)ychannel提交鏈碼

鏈碼提交可以在一個peer節(jié)點上完成：

docker exec cli peer lifecycle chaincode commit -o orderer.example.com:7050 \
  --tls \
  --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem \
  --peerAddresses peer0.org1.example.com:7051 \
  --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt \
  --peerAddresses peer0.org2.example.com:9051 \
  --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt \
  --channelID mychannel --name mycc --version 1 --sequence 1 --init-required

可以看到出了新塊#5：

注意我們在commit命令中已經(jīng)包含了init所需的參數(shù)。

同樣，我們可以使用querycommited命令來查看鏈碼的提交狀態(tài)：

docker exec cli peer lifecycle chaincode querycommitted --channelID mychannel --name mycc

在鏈碼提交到通道之后，鏈碼的生命周期就完成了，鏈碼已經(jīng)可以訪問?，F(xiàn)在我們回到鏈碼的調(diào)用和查詢，這和之前的版本是一致的。

STEP 6：調(diào)用鏈碼的Init方法

SACC鏈碼的Init方法需要首先調(diào)用。

docker exec cli peer chaincode invoke -o orderer.example.com:7050 \
  --tls \
  --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem \
  --peerAddresses peer0.org1.example.com:7051 \
  --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt \
  --peerAddresses peer0.org2.example.com:9051 \
  --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt \
  -C mychannel -n mycc --isInit -c '{"Args":["name","kc"]}'

現(xiàn)在可以查詢 鏈碼：

docker exec cli peer chaincode query -C mychannel -n mycc -c '{"Args":["get","name"]}'

STEP 7：調(diào)用鏈碼的set()方法并從另一個peer節(jié)點查詢

和之前一樣，我們在peer0.org1上調(diào)用鏈碼的set()方法，在peer0.org2上進行查詢：

# peer0.org1
docker exec cli peer chaincode invoke \
  -o orderer.example.com:7050 \
  --tls \
  --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem \
  --peerAddresses peer0.org1.example.com:7051 \
  --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt \
  --peerAddresses peer0.org2.example.com:9051 \
  --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt \
  -C mychannel -n mycc -c '{"Args":["set","name","Peter"]}'
  
  # peer0.org2
docker exec \
  -e CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/users/Admin@org2.example.com/msp \
  -e CORE_PEER_ADDRESS=peer0.org2.example.com:9051 \
  -e CORE_PEER_LOCALMSPID="Org2MSP" \
  -e CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt \
  cli peer chaincode query -C mychannel -n mycc -c '{"Args":["get","name"]}'

一切正常。

感謝各位的閱讀！關(guān)于“Fabric 2.0中鏈碼操作過程是怎么樣的”這篇文章就分享到這里了，希望以上內(nèi)容可以對大家有一定的幫助，讓大家可以學(xué)到更多知識，如果覺得文章不錯，可以把它分享出去讓更多的人看到吧！