紙貴區塊鏈雲服務平臺(Z-BaaS)操作指南

買賣虛擬貨幣
Z-BaaS(Ziggurat Blockchain as a Service)是紙貴科技釋出的一款區塊鏈雲服務平臺產品,旨在幫助開發者快速構建區塊鏈基礎設施,提供區塊鏈應用開發、部署、測試和監控的整套解決方案。Z-BaaS堅持技術研發與自主創新,支援各類主流的聯盟鏈、公有鏈開發環境,包括Hyperledger Fabric、Z-Ledger、Ethereum等,並面向商業應用場景提供了多種企業級解決方案。Z-BaaS為開發者提供了簡單易用的開發工具,開發者可以在視覺化的操作介面下完成區塊鏈的構建與操作,極大地降低了開發門檻,提高了開發效率。主要功能包括:按需部署:按需選擇區塊鏈配置,一鍵構建區塊鏈網路;區塊瀏覽器:節點、區塊、交易、資產等賬本資訊的視覺化展示;合約IDE:智慧合約一站式管理,包括上傳、編輯、編譯和部署;
API呼叫:提供Restful API介面,視覺化呼叫與除錯;賬戶與通證管理:匿名賬戶的建立與資產管理,自定義通證發行與流轉;日誌查詢:實時監控,區塊鏈各節點日誌資訊檢視。Z-BaaS的產品優勢:1. 開放共贏:秉承開放共贏的設計原則,Z-BaaS支援各類主流的聯盟鏈、公有鏈開發環境,包括Hyperledger Fabric、Z-Ledger、Ethereum等。2. 簡單易用:Z-BaaS以開發者需求為導向,支援區塊鏈產品的免費試用,並提供簡單易用的開發者工具與服務,開發者可以在視覺化的操作介面下完成區塊鏈的構建與操作,極大地降低了開發門檻,提高了開發效率。
3. 自主創新:Z-BaaS堅持技術研發與自主創新,提供基於Hyperledger Fabric 1.x自主研發的Z-Ledger企業級聯盟鏈服務,並持續研究共識演算法、密碼學演算法、跨鏈互動、去中心化儲存等前沿技術,為開發者提供最先進的技術服務。4. 成熟可靠:紙貴區塊鏈雲服務平臺與國內主流的雲端計算廠商攜手合作,採用Kubernetes、Docker等成熟的開源元件,為開發者提供成熟可靠的企業級區塊鏈基礎設施服務。平臺基本操作1. 平臺註冊與登入

新使用者可點選Z-BaaS首頁右上角“註冊”按鈕進入註冊頁面,填寫相關資訊進行使用者註冊。

註冊成功後,註冊郵箱會收到一封驗證郵件,請點選郵件內的啟用連結進行賬戶啟用。

如果您沒有收到啟用郵件,您可以嘗試:

· 檢查註冊郵箱地址,返回重新註冊;
· 檢查郵箱垃圾箱;
· 聯絡我們:admin@chaindaily。

已註冊使用者可點選“登入”按鈕進入登入頁面,填寫郵箱與密碼並登入系統。

登入系統後,會預設進入“我的專案”頁,展示您已經選擇的服務。若您還沒有建立任何服務,可以根據頁面提示按步驟建立服務。

2. 平臺服務瀏覽與使用

點選Z-BaaS首頁導航欄“產品服務”,可檢視平臺中包含的全部區塊鏈雲服務產品,包括Z-Ledger環境構建、Hyperledger Fabric環境構建、Ethereum測試網路接入等。

點選每個產品的“瞭解詳情”按鈕,可進入產品的詳細介紹頁面,介紹產品的優勢、功能、截圖和接入流程等資訊。在產品詳情頁中點選“免費試用”或“立即體驗”的按鈕,即可在平臺中建立服務,建立過程中需填寫相關配置資訊,完成服務的最終建立。

3 合約中心

合約中心裡包含了眾多優秀示例合約,幫助開發者快速上手合約開發。使用者可以將合約中心的示例合約加入“我的合約”,檢視詳細合約資訊並下載和編輯程式碼。

Z-Ledger環境構建

Z-Ledger是紙貴科技基於Hyperledger Fabric 1.0基礎之上自主研發的商用級聯盟鏈底層,及配套工具集。包括區塊鏈底層系統、智慧合約、SDK、瀏覽器、運維平臺等產品,在共識機制、可擴充套件性、資產登記和流轉、許可權管理和隱私保護、跨鏈互動等方面做出許多重要改進,使之更適用於大規模企業級應用。

更多關於Z-Ledger的技術資料可前往 Z-Ledger技術文件 中檢視。

以下為您介紹在Z-BaaS中搭建Z-Ledger環境並完成鏈碼操作的步驟:

1 環境構建

登入系統,在Z-Ledger服務詳情頁點選“免費試用版”,進入服務建立流程,選擇區塊鏈配置。

舉例:區塊鏈名稱為“test”,共識演算法選擇“solo”,型別選擇“高階配置”,點選完成,建立成功,進入我的專案頁。

提示:試用版區塊鏈將在部署後48小時自動釋放。(我的專案頁)

2 專案控制檯

建立成功的Z-Ledger將會在我的專案中以卡片形式顯示,點選卡片上“進入專案”可進入專案控制檯。

專案控制檯頁面左側導航欄展示了控制檯的功能:區塊鏈瀏覽器、鏈碼管理、API呼叫、賬戶、通證、日誌。

· 區塊鏈瀏覽器:展示區塊鏈賬本基本資訊,包括區塊資訊、交易資訊、合約數量等;
· 鏈碼管理:檢視區塊鏈鏈碼資訊,執行鏈碼(智慧合約)的安裝、例項化等操作;
· API呼叫:提供Restful API,支援視覺化呼叫並檢視呼叫結果;
· 賬戶:提供賬戶管理工具,支援賬戶的建立、刪除、檢視資產和資產轉賬等功能;
· 通證:區塊鏈通證資產檢視,支援自定義通證發行;
· 日誌:實時檢視區塊鏈各節點日誌。

3 賬戶與通證

Z-Ledger在Hyperledger Fabric基礎上新增了賬戶和通證的功能。

為了便於使用者操作和理解,Z-Ledger區塊鏈在初始化階段會預設建立1個賬戶並給這個賬戶發行1000億個ZIG Token。
ZIG Token是Z-Ledger的原生Token,賬戶發起交易時需消耗一定比例的ZIG Token作為手續費。

3.1 新增賬戶

進入“賬戶”模組,可以看到當前建立的全部賬戶,包括初始化生成的預設賬戶,記為賬戶1。

點選“新增賬戶”按鈕新增一個賬戶,此時頁面會有2個賬戶,新增的賬戶記為賬戶2。後文將針對賬戶1和賬戶2進行操作。

3.2 發行通證

進入“通證”模組,可以看到當前發行的全部通證資訊,包括初始化生成的原生通證ZIG。
點選“發行通證”,輸入通證名稱、個數、小數點個數,發行賬戶等資訊。
舉例,名稱:AToken;通證個數:100000000;小數點個數:3;賬戶:賬戶1。(以上資料代表實際發行通證數量為100000.000)

通證發行成功後進入“賬戶”模組,選擇賬戶1點選“資產”檢視當前賬戶地址下所有通證名稱及數量。可以發現賬戶1已經擁有ZIG和AToken兩種通證資產。

3.3 賬戶間通證轉賬

在賬戶1的通證資產頁面,點選ZIG通證的“轉賬”,輸入通證個數和轉賬地址。舉例,通證個數:5000.00;轉賬地址:賬戶2。

點選“確定”後稍等一段時間,轉賬交易被確認。同理,可將AToken進行轉賬操作,通證個數:5000.000;轉賬地址:賬戶2。

此時可在賬戶2的資產頁面,檢視其資產數額變化資訊。

目前,賬戶2已擁有ZIG和AToken兩種資產,在後文將繼續介紹賬戶2如何使用者兩種資產。

4 示例鏈碼演示

4.1 鏈碼部署

“鏈碼管理”模組展示了該區塊鏈上已安裝或已部署的鏈碼,使用者可以在該模組中為區塊鏈安裝部署新的鏈碼。

在“鏈碼管理”模組中點選加號執行鏈碼安裝,在“合約中心”中選擇“資產掛單交易/asset”示例合約進行安裝。

“資產掛單交易/asset”示例合約支援註冊新使用者,使用者可以將資產以Token形式定價掛單,其他使用者可以透過指定Token進行資產購買。

安裝成功後,在“鏈碼管理”頁面會顯示該示例鏈碼。點選“部署”執行鏈碼例項化,無需填寫引數,點選提交,等待一段時間後,部署成功。

4.2 鏈碼呼叫

鏈碼部署成功後,進入“API呼叫”頁面,對剛部署成功的示例鏈碼進行API呼叫。

API呼叫介面展示了所提供的多種API,包括獲取鏈資訊、獲取區塊資訊、獲取交易資訊、鏈碼呼叫、賬戶和通證操作等等。鏈碼的呼叫方式包括Invoke和Query,分別對應“Invoke Chaincode”和“Query Chaincode”這兩個API。使用者可點選進入,填寫相關引數,執行呼叫並檢視反饋結果。

需要注意的是:在Zig-Ledger中透過Invoke方式呼叫合約時需要指定賬戶,每次進行Invoke操作時需要從ZIG賬戶中扣除一定額度的手續費,費用以當前已經傳送的交易位元組數來確定。

以下繼續介紹“資產轉移合約”的示例操作步驟:

1) 新增使用者U1、使用者U2
建立U1,在“Invoke Chaincode”API中,填寫鏈碼名稱“asset”,鏈碼版本“1.0”,鏈碼函式“addUser”,引數“U1”“15”,呼叫賬戶“賬戶1”,執行呼叫,獲得如下結果:

返回了交易TxHash,代表交易成功。
同理,繼續建立使用者U2,填寫鏈碼名稱“asset”,鏈碼版本“1.0”,鏈碼函式“addUser”,引數“U2”“20”,呼叫賬戶“賬戶2”,執行呼叫,完成建立。

2)查詢使用者資訊

在“Query Chaincode”API中,填寫鏈碼名稱“asset”,鏈碼版本“1.0”,鏈碼函式“queryUser”,引數“U1”,執行查詢,獲得如下結果:

返回了U1使用者的資訊,說明U1成功建立。

同理,在“Query Chaincode”API中,填寫鏈碼名稱“asset”,鏈碼版本“1.0”,鏈碼函式“queryUser”,引數“U2”,執行查詢,返回U2資訊,U2成功建立。

3)新增資產-BOOK1

現在我們為U1新增1個掛單資產,該資產設定為一本書,名叫BOOK1,型別是BOOK,描述是A guidebook,並定價2.00單位的AToken。

在“Invoke Chaincode”API中,填寫鏈碼名稱“asset”,鏈碼版本“1.0”,鏈碼函式“addAsset”,引數“BOOK1”“BOOK”“A guidebook”“AToken”“200”“U1”(引數200包含了小數點,代表2.00個AToken),呼叫賬戶“賬戶1”,執行呼叫,獲得如下結果:

返回了交易TxHash,代表交易成功。

4)查詢資產-BOOK1

在“Query Chaincode”API中,填寫鏈碼名稱“asset”,鏈碼版本“1.0”,鏈碼函式“readAsset”,引數“BOOK1”,執行查詢,獲得如下結果:

返回了BOOK1資產的資訊,資產成功建立,owner是U1。
同理,也可以使用函式“readAssetByRange”來查詢名稱在A-Z範圍內的所有資產。

5)U2購買資產BOOK1

在“Invoke Chaincode”API中,填寫鏈碼名稱“asset”,鏈碼版本“1.0”,鏈碼函式“buyAsset”,引數“BOOK1”“U2”,呼叫賬戶“賬戶2”,執行呼叫,獲得如下結果:

返回了交易TxHash,代表交易成功。
如果該筆交易順利執行,那麼BOOK1將歸屬於U2,並且U1和U2的AToken數量也將發生變化,那麼接下來讓我們去查詢下這些資訊。

6)查詢資產-BOOK1

在“Query Chaincode”API中,填寫鏈碼名稱“asset”,鏈碼版本“1.0”,鏈碼函式“readAsset”,引數“BOOK1”,執行查詢,獲得如下結果:

可以發現,BOOK1的owner已經變更為U2。

7)查詢賬戶的資產

在“賬戶”模組中查詢賬戶1和賬戶2的資產資訊,發現資產數量發生變化,賬戶2的AToken減少了2個,而賬戶1的AToken增加了2個,驗證之前的交易成功執行。

下表彙總了示例合約的操作流程:

4.3 完成呼叫

呼叫完成後,返回“區塊鏈瀏覽器”,發現此時區塊鏈資訊已經發生變化,區塊和交易數量有所增加。
點選可檢視剛才呼叫所產生的區塊和交易詳情。

4.4 Restful API呼叫

開發者可以透過視覺化的介面完成呼叫,也可以透過Restful API進行呼叫。Zig-Ledger構建服務提供了一系列Restful API用於幫助開發者快速構建區塊鏈應用,開發者在呼叫前需先獲取Token令牌來獲得呼叫許可權。具體介面使用方法詳見 技術文件 - Zig-Ledger Restful API文件。

5 日誌檢視

進入“日誌”模組,檢視區塊鏈網路中節點的執行日誌。在Zig-Ledger的高階配置中,可以透過下拉選單選擇檢視CA節點、Orderer節點或Peer節點的日誌資訊。

6 釋放區塊鏈

當不需要此鏈時,進入“我的專案”,選擇該區塊鏈並點選“立即釋放”。

Hyperledger Fabric環境構建

Hyperledger Fabric是一個面向企業的分散式賬本平臺,具有高度的靈活性、模組化和可擴充套件效能。Zig-BaaS提供Hyperledger Fabric 1.0版本區塊鏈網路的快速構建,併為開發者提供區塊瀏覽器、鏈碼管理、API呼叫、日誌檢視等功能。

以下為您介紹在Zig-BaaS中搭建Hyperledger Fabric環境並完成鏈碼操作的步驟:

1 環境構建

開啟Zig-BaaS首頁,在Hyperledger Fabric服務詳情頁點選“免費試用版”,進入服務建立流程,選擇區塊鏈配置。

舉例:區塊鏈名稱為“test”,共識演算法選擇”solo“,型別選擇“基礎配置”,點選完成,建立成功,進入我的專案頁。
提示:試用版區塊鏈將在部署後48小時自動釋放。

2 專案控制檯
建立成功的Hyperledger Fabric將會在我的專案中以卡片形式顯示,點選卡片上“進入專案”可進入專案控制檯。

專案控制檯頁面左側導航欄展示了控制檯的功能:區塊鏈瀏覽器、鏈碼管理、API呼叫、日誌。

· 區塊鏈瀏覽器:展示區塊鏈賬本基本資訊,包括區塊資訊、交易資訊、合約數量等;
· 鏈碼管理:檢視區塊鏈鏈碼資訊,執行鏈碼(智慧合約)的安裝、例項化等操作;
· API呼叫:提供Restful API,支援視覺化呼叫並檢視呼叫結果;
· 日誌:實時檢視區塊鏈各節點日誌。

3 示例鏈碼演示

3.1 鏈碼部署
“鏈碼管理”模組展示了該區塊鏈上已安裝或已部署的鏈碼,使用者可以在該模組中為區塊鏈安裝部署新的鏈碼。
在“鏈碼管理”中點選加號,在“合約中心”中選擇“資產轉移合約/trans”示例合約進行安裝。

安裝成功後,在“鏈碼管理”頁面會顯示該示例鏈碼。點選“部署”執行鏈碼例項化,部署時需輸入引數:a,10,b,10,點選提交,等待一段時間後,部署成功。

3.2 鏈碼呼叫

鏈碼部署成功後,進入“API呼叫”頁面,對剛部署成功的示例鏈碼進行API呼叫。

API呼叫介面展示了所提供的多種API,包括獲取鏈資訊、獲取區塊資訊、獲取交易資訊、鏈碼呼叫等等。鏈碼的呼叫方式包括Invoke和Query,分別對應“Invoke Chaincode”和“Query Chaincode”這兩個API。使用者可點選進入,填寫相關引數,執行呼叫並檢視反饋結果。

以下繼續介紹“資產轉移合約”的示例操作步驟:

1)查詢實體a、實體b的資產

在“Query Chaincode”API中,填寫鏈碼名稱“trans”,鏈碼版本“1.0”,鏈碼函式“query”,引數“a”,執行查詢,獲得如下結果:

代表a具有10單位的資產。

同理查詢實體b的資產,填寫鏈碼名稱“trans”,鏈碼版本“1.0”,鏈碼函式“query”,引數“b”,執行查詢。查詢得到實體b具有10單位的資產。

a、b的資產數量與部署時填寫的初始化引數相符。

2)從a向b轉移5個單位的資產

在“Invoke Chaincode”API中,填寫鏈碼名稱“trans”,鏈碼版本“1.0”,鏈碼函式“invoke”,引數“a”“b”“5”,執行查詢,獲得如下結果:

返回了交易TxHash,代表交易成功。

3)查詢實體a、實體b的資產

在“Query Chaincode”API中,填寫鏈碼名稱“trans”,鏈碼版本“1.0”,鏈碼函式“query”,引數“a”,執行查詢,獲得如下結果:

代表a具有5單位的資產,因為在上一步,a向b轉移了5單位的資產。
同理查詢實體b的資產,可以發現實體b擁有15單位的資產,資產轉移成功。

下表彙總了示例合約的操作流程:

操作步驟  函式名稱  引數  方法  說明

3.3 完成呼叫

呼叫完成後,返回“區塊鏈瀏覽器”,發現此時區塊鏈資訊已經發生變化,區塊和交易數量有所增加。
點選可檢視剛才呼叫所產生的區塊和交易詳情。

3.4 Restful API呼叫

開發者可以透過視覺化的介面完成呼叫,也可以透過Restful API進行呼叫。Hyperledger Fabric構建服務提供了一系列Restful API用於幫助開發者快速構建區塊鏈應用,開發者在呼叫前需先獲取Token令牌來獲得呼叫許可權。Restful API介面詳見“API呼叫”模組。具體介面使用方法詳見 技術文件 - Hyperledger Fabric Restful API文件。

4 日誌檢視

進入“日誌”模組,檢視區塊鏈網路中節點的執行日誌。在Hyperledger Fabric的基礎配置中,可以透過下拉選單選擇檢視CA節點、Orderer節點或Peer節點的日誌資訊。

5 釋放區塊鏈
當不需要此鏈時,進入“我的專案”,選擇該區塊鏈並點選“立即釋放”。

免責聲明:

  1. 本文版權歸原作者所有,僅代表作者本人觀點,不代表鏈報觀點或立場。
  2. 如發現文章、圖片等侵權行爲,侵權責任將由作者本人承擔。
  3. 鏈報僅提供相關項目信息,不構成任何投資建議

推荐阅读

;