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

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

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

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

鏈碼操作指的是在Hyperledger fabric網絡通道上部署鏈碼的操作，這樣區塊鏈之外的應用可以調用或查詢鏈碼方法。在鏈碼開發完成并測試后，首先需要將Fabric鏈碼安裝到指定的peer節點。在這個階段鏈碼還不能使用，直到鏈碼被提交（Fabric 2.0中的術語）到通道中或在通道上實例化（Fabric 1.4中的術語），這樣鏈碼就可以被授權用戶訪問了。

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

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

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

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

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

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

鏈碼打包這一步是創建一個打包文件（tar格式），其中包含Fabric鏈碼以及一些元數據。雖然不同的機構可以分別進行打包處理，更常見是由一個機構打包然后分發給其他機構以便確保所有的機構使用相同的鏈碼。

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

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

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

在批準機構達到指定數量后，鏈碼就可以提交了。我們現在就進入了最后一個步驟：鏈碼提交。

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

現在鏈碼就可以使用了。

2、First Network和SACC鏈碼簡介

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

First Network是一個雙機構設置，每個機構中包含兩個peer節點。通道mychannel創建后加入所有的4個peer節點。在byfn.sh中完整的實現了First Network的部署，并包含一些可選的參數。在下面的演示中，我們不使用默認的鏈碼（在Fabric 1.4中式chaincode_example02，在Fabric 2.0中式abstore），而是使用SACC鏈碼。

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

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

3、Fabric 1.4.4鏈碼操作演示

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

下面是演示步驟：

• 無鏈碼方式啟動First Network

• 在指定的peer節點上安裝SACC鏈碼

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

• 調用set()設置新值并從另一個peer節點查詢結果

STEP 1：首先啟動First Network：

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

上面的命令會啟動First Network、創建通道mychannel并將所有的peer節點加入該通道。注意在Fabric 1.4.4中，First Network使用solo排序服務實現，只有一個排序節點。另外，我們看到有4個對等節點在運行，以及一個CLI用于鏈碼操作。

現在我們可以開始鏈碼部署操作。

STEP 2：在指定peer節點上安裝鏈碼

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

# 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：在通道mychannel上實例化鏈碼并查詢

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

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')"

如果現在看看peer節點的日志，我們可以看到出了新區塊#3。

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

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

STEP 4：調用set()設置新值并從另一個節點查詢

出于演示目的，我們在peer0.org1上調用set()，然后在peer0.org2上調用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節點上安裝SACC鏈碼包

• 機構審批鏈碼

• 在mychannel通道上提交鏈碼

• 調用SACC鏈碼的Init方法

• 調用SACC鏈碼的set方法并從另一個peer節點查詢結果

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

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

現在First Network已經啟動，通道mychannel已經創建并且所有peer節點已經加入mychannel通道。注意在Fabric 2.0.0中，First Network使用Raft作為排序服務，所有5個排序節點都在運行。在這個演示中，我們只使用orderer.example.com，不過使用其他排序節點也是一樣的。

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容器內可以看到生成了新的文件sacc.tar.gz：

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

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

# 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命令隨時檢查節點上的鏈碼安裝情況，如果我們需要找出鏈碼包的標識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：審批鏈碼

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

首先是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}

如果我們現在看下peer節點的日志，可以看到出了新塊#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相關的參數，以便向SACC鏈碼的Init方法傳入所需的參數。

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

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

兩個機構都已經批準了鏈碼，現在可以提交了。

STEP 5：向通道mychannel提交鏈碼

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

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命令中已經包含了init所需的參數。

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

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

在鏈碼提交到通道之后，鏈碼的生命周期就完成了，鏈碼已經可以訪問。現在我們回到鏈碼的調用和查詢，這和之前的版本是一致的。

STEP 6：調用鏈碼的Init方法

SACC鏈碼的Init方法需要首先調用。

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"]}'

現在可以查詢 鏈碼：

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

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

和之前一樣，我們在peer0.org1上調用鏈碼的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"]}'

一切正常。

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