這篇文章主要介紹Hyperledger Fabric中Chaincode的Invoke功能怎么用,文中介紹的非常詳細,具有一定的參考價值,感興趣的小伙伴們一定要看完!
創(chuàng)新互聯(lián)公司是一家專業(yè)提供正寧企業(yè)網(wǎng)站建設(shè),專注與做網(wǎng)站、成都網(wǎng)站制作、H5技術(shù)、小程序制作等業(yè)務(wù)。10年已為正寧眾多企業(yè)、政府機構(gòu)等服務(wù)。創(chuàng)新互聯(lián)專業(yè)網(wǎng)站設(shè)計公司優(yōu)惠進行中。
Chaincode的Invoke 功能, 主要包括create, update, delete功能。
完整的實例代碼如下:
'use strict'; /* * Chaincode Invoke */ var Fabric_Client = require('fabric-client'); var path = require('path'); var util = require('util'); var os = require('os'); // var fabric_client = new Fabric_Client(); // setup the fabric network var channel = fabric_client.newChannel('mychannel'); var peer = fabric_client.newPeer('grpc://localhost:7051'); channel.addPeer(peer); var order = fabric_client.newOrderer('grpc://localhost:7050') channel.addOrderer(order); // var member_user = null; var store_path = path.join(__dirname, 'hfc-key-store'); console.log('Store path:'+store_path); var tx_id = null; // create the key value store as defined in the fabric-client/config/default.json 'key-value-store' setting Fabric_Client.newDefaultKeyValueStore({ path: store_path }).then((state_store) => { // assign the store to the fabric client fabric_client.setStateStore(state_store); var crypto_suite = Fabric_Client.newCryptoSuite(); // use the same location for the state store (where the users' certificate are kept) // and the crypto store (where the users' keys are kept) var crypto_store = Fabric_Client.newCryptoKeyStore({path: store_path}); crypto_suite.setCryptoKeyStore(crypto_store); fabric_client.setCryptoSuite(crypto_suite); // get the enrolled user from persistence, this user will sign all requests return fabric_client.getUserContext('user1', true); }).then((user_from_store) => { if (user_from_store && user_from_store.isEnrolled()) { console.log('Successfully loaded user1 from persistence'); member_user = user_from_store; } else { throw new Error('Failed to get user1.... run registerUser.js'); } // get a transaction id object based on the current user assigned to fabric client tx_id = fabric_client.newTransactionID(); console.log("Assigning transaction_id: ", tx_id._transaction_id); // createCar chaincode function - requires 5 args, ex: args: ['CAR12', 'Honda', 'Accord', 'Black', 'Tom'], // changeCarOwner chaincode function - requires 2 args , ex: args: ['CAR10', 'Dave'], // must send the proposal to endorsing peers var request = { //targets: let default to the peer assigned to the client chaincodeId: 'fabcar', fcn: '', args: [''], chainId: 'mychannel', txId: tx_id }; // send the transaction proposal to the peers return channel.sendTransactionProposal(request); }).then((results) => { var proposalResponses = results[0]; var proposal = results[1]; let isProposalGood = false; if (proposalResponses && proposalResponses[0].response && proposalResponses[0].response.status === 200) { isProposalGood = true; console.log('Transaction proposal was good'); } else { console.error('Transaction proposal was bad'); } if (isProposalGood) { console.log(util.format( 'Successfully sent Proposal and received ProposalResponse: Status - %s, message - "%s"', proposalResponses[0].response.status, proposalResponses[0].response.message)); // build up the request for the orderer to have the transaction committed var request = { proposalResponses: proposalResponses, proposal: proposal }; // set the transaction listener and set a timeout of 30 sec // if the transaction did not get committed within the timeout period, // report a TIMEOUT status var transaction_id_string = tx_id.getTransactionID(); //Get the transaction ID string to be used by the event processing var promises = []; var sendPromise = channel.sendTransaction(request); promises.push(sendPromise); //we want the send transaction first, so that we know where to check status // get an eventhub once the fabric client has a user assigned. The user // is required bacause the event registration must be signed let event_hub = fabric_client.newEventHub(); event_hub.setPeerAddr('grpc://localhost:7053'); // using resolve the promise so that result status may be processed // under the then clause rather than having the catch clause process // the status let txPromise = new Promise((resolve, reject) => { let handle = setTimeout(() => { event_hub.disconnect(); resolve({event_status : 'TIMEOUT'}); //we could use reject(new Error('Trnasaction did not complete within 30 seconds')); }, 3000); event_hub.connect(); event_hub.registerTxEvent(transaction_id_string, (tx, code) => { // this is the callback for transaction event status // first some clean up of event listener clearTimeout(handle); event_hub.unregisterTxEvent(transaction_id_string); event_hub.disconnect(); // now let the application know what happened var return_status = {event_status : code, tx_id : transaction_id_string}; if (code !== 'VALID') { console.error('The transaction was invalid, code = ' + code); resolve(return_status); // we could use reject(new Error('Problem with the tranaction, event status ::'+code)); } else { console.log('The transaction has been committed on peer ' + event_hub._ep._endpoint.addr); resolve(return_status); } }, (err) => { //this is the callback if something goes wrong with the event registration or processing reject(new Error('There was a problem with the eventhub ::'+err)); }); }); promises.push(txPromise); return Promise.all(promises); } else { console.error('Failed to send Proposal or receive valid response. Response null or status is not 200. exiting...'); throw new Error('Failed to send Proposal or receive valid response. Response null or status is not 200. exiting...'); } }).then((results) => { console.log('Send transaction promise and event listener promise have completed'); // check the results in the order the promises were added to the promise all list if (results && results[0] && results[0].status === 'SUCCESS') { console.log('Successfully sent transaction to the orderer.'); } else { console.error('Failed to order the transaction. Error code: ' + results[0].status); } if(results && results[1] && results[1].event_status === 'VALID') { console.log('Successfully committed the change to the ledger by the peer'); } else { console.log('Transaction failed to be committed to the ledger due to ::'+results[1].event_status); } }).catch((err) => { console.error('Failed to invoke successfully :: ' + err); });
這段代碼主要功能有兩個, 一個是提交交易, 一個是獲取交易結(jié)果。 關(guān)于Hyperledger Fabric 的交易流程的介紹在這里, 主要包括6個步驟。
其實, 對于客戶端來說, 交易過程需要干兩件事:
1 向背書節(jié)點發(fā)送交易提案
2 獲取背書節(jié)點對交易提案的反饋, 并組裝交易, 向orderer節(jié)點發(fā)送交易
而對于交易結(jié)果的獲取, Hyperledger Fabric 是通過事件機制實現(xiàn)的。
通過fabric_client生成一個EventHub對象, 然后通過event_hub對象注冊事件獲取, 詳細介紹見 Hyperledger Fabric SDK for node.js Class: EventHub 。
從文檔可以看出, EventHub可以注冊的事件有:
registerBlockEvent(onEvent, onError) 區(qū)塊事件
registerChaincodeEvent(ccid, eventname, onEvent, onError) 鏈碼事件
registerTxEvent(txid, onEvent, onError) 交易事件
首先看交易過程。交易包括發(fā)送提案和發(fā)送交易兩個過程。交易過程主要封裝請求鏈碼的參數(shù), 發(fā)送請求到背書節(jié)點, 代碼如下:
// get a transaction id object based on the current user assigned to fabric client tx_id = fabric_client.newTransactionID(); console.log("Assigning transaction_id: ", tx_id._transaction_id); // createCar chaincode function - requires 5 args, ex: args: ['CAR12', 'Honda', 'Accord', 'Black', 'Tom'], // changeCarOwner chaincode function - requires 2 args , ex: args: ['CAR10', 'Dave'], // must send the proposal to endorsing peers var request = { //targets: let default to the peer assigned to the client chaincodeId: 'fabcar', fcn: 'createCar', args: ['CAR100', 'Honda', 'Accord', 'Black', 'Jarvis'], chainId: 'mychannel', txId: tx_id }; // send the transaction proposal to the peers return channel.sendTransactionProposal(request);
首先, 獲取一個和當前用戶關(guān)聯(lián)的transaction id 對象, 該對象的定義在這里 。該方法 可以傳入一個參數(shù) boolean,默認為false, 如果為true, 則根據(jù)admin 用戶的證書生成tansaction id 對象。
接下來構(gòu)造sendTransactionProposal參數(shù), 也就是提案的請求對象, 參數(shù)對象的定義在這里 。 這里需要注意的是chaincodeId, chainId, txId 是必須, 用來指定已經(jīng)安裝(intall)并且實例化(initantiate)的chaincode。 fcn 對應(yīng)鏈碼中定義的業(yè)務(wù)邏輯, 默認為invoke, args是fcn對應(yīng)的參數(shù), 所有的args格式都是一樣的, 是一個string 數(shù)組。
參數(shù)構(gòu)造完成, 就可以向背書節(jié)點發(fā)送交易提案了。執(zhí)行成功的話, 返回提案結(jié)果對象, 實際上是https://fabric-sdk-node.github.io/global.html#ProposalResponseObject 對象。
接下來, 提交交易到orderer節(jié)點。
var proposalResponses = results[0]; var proposal = results[1]; let isProposalGood = false; if (proposalResponses && proposalResponses[0].response && proposalResponses[0].response.status === 200) { isProposalGood = true; console.log('Transaction proposal was good'); } else { console.error('Transaction proposal was bad'); } if (isProposalGood) { console.log(util.format( 'Successfully sent Proposal and received ProposalResponse: Status - %s, message - "%s"', proposalResponses[0].response.status, proposalResponses[0].response.message)); // build up the request for the orderer to have the transaction committed var request = { proposalResponses: proposalResponses, proposal: proposal }; // set the transaction listener and set a timeout of 30 sec // if the transaction did not get committed within the timeout period, // report a TIMEOUT status var transaction_id_string = tx_id.getTransactionID(); //Get the transaction ID string to be used by the event processing var promises = []; var sendPromise = channel.sendTransaction(request);
首先判斷提案交易是不是成功
if (proposalResponses && proposalResponses[0].response && proposalResponses[0].response.status === 200) {
如果成功, 構(gòu)建交易參數(shù), 并提交交易。參數(shù)的定義見: Hyperledger Fabric SDK for node.js Global 。包括提案執(zhí)行的結(jié)果。
獲取交易結(jié)果是通過事件機制實現(xiàn)的, 需要用到交易的tansaction id .在代碼中是通過EventHub對象實現(xiàn)的。
具體步驟包括:
1 創(chuàng)建 EventHub對象
let event_hub = fabric_client.newEventHub(); event_hub.setPeerAddr('grpc://localhost:7053');
2 獲取一個事件源的連接
event_hub.connect();
3 注冊并監(jiān)聽事件
Fabric提供的事件對象有:registerBlockEvent, registerTxEvent 和 registerChaincodeEvent . 這里只關(guān)注registerTxEvent事件。
event_hub.registerTxEvent(transaction_id_string, (tx, code) => { //......
詳細文檔查看 Hyperledger Fabric SDK for node.js Class: EventHub 。第一個參數(shù)為 上文提到的transaction id 字符串, 第二個參數(shù)是一個回調(diào)函數(shù), 有兩個參數(shù), 第一個是一個Transaction對象, 第二個是一個字符串, 表示交易是否valid狀態(tài)的字符串。
4 斷開連接
event_hub.disconnect();
以上是“Hyperledger Fabric中Chaincode的Invoke功能怎么用”這篇文章的所有內(nèi)容,感謝各位的閱讀!希望分享的內(nèi)容對大家有幫助,更多相關(guān)知識,歡迎關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道!