使用指南
本文將為您介紹如何使用跨鏈服務控制臺,包括注冊區塊鏈、跨鏈授權(包括賬本數據訪問、合約消息推送)的相關操作流程,以及如何進行權限查看、合約消息查看等。
注冊區塊鏈
注冊您的區塊鏈是開始跨鏈連接的第一步。注冊區塊鏈后,跨鏈數據連接服務將訪問您的區塊鏈,并在您的區塊鏈上部署跨鏈合約,用于跨鏈信息傳遞。
目前該服務支持螞蟻區塊鏈和Hyperledger Fabric,如果需要注冊其他類型區塊鏈,請聯系產品團隊。
注冊螞蟻區塊鏈
登錄跨鏈服務控制臺。
單擊 注冊區塊鏈 進入注冊頁面。
區塊鏈類型 請選擇 螞蟻區塊鏈,然后完成相應的注冊步驟。
根據頁面提示,提供螞蟻區塊鏈的基本信息,賬戶信息和證書信息,跨鏈服務將使用這些信息訪問區塊鏈,部署跨鏈系統合約,以及提交跨鏈交易。
注冊 Fabric 區塊鏈
登錄跨鏈服務控制臺。
單擊 注冊區塊鏈 進入注冊頁面。
區塊鏈類型 請選擇 Hyperledger Fabric,然后完成相應的注冊步驟。
按照頁面上的操作提示進行注冊。
下載跨鏈鏈碼包,創建 channel,安裝鏈碼包。
下載頁面上的跨鏈鏈碼包。
在 Hyperledger Fabric 區塊鏈上創建開通跨鏈服務的 channel。
在創建的 channel 中安裝鏈碼包。
創建賬戶或申請證書,獲取配置文件。
在 Hyperledger Fabric 區塊鏈上注冊一個賬戶或者申請證書,供跨鏈服務使用。
如果您是阿里云 Hyperledger Fabric 用戶,可下載 SDK 配置文件,解壓后獲取
connection-profile-standard.yaml
的配置文件。如果您不是阿里云 Hyperledger Fabric 用戶,請聯系螞蟻技術支持人員獲取配置文件。
注冊區塊鏈,提供賬戶或證書,上傳配置文件。
在頁面上創建區塊鏈域名,上傳第二步中獲取的 connection-standard.yaml 的配置文件。
注冊成功后,提供區塊鏈錨定信息,包括跨鏈 channel 名稱,選擇驗證節點,提供第二步中創建的用戶名和密碼。
或者,您也可以直接上傳證書和私鑰。
注冊完成后,可以在控制臺上看到已經注冊的鏈信息。
跨鏈管理
查看跨鏈域名詳情
登錄跨鏈服務控制臺。
單擊已注冊區塊鏈右側的 詳情 按鈕,進入到詳情頁。
在基本信息頁簽下,支持查看跨鏈域名詳情。
您可以在此查看區塊鏈在跨鏈系統中的基本信息、域名證書,以及UDSN證書。
查看跨鏈系統合約
登錄跨鏈服務控制臺。
單擊已注冊區塊鏈右側的 詳情 按鈕,進入到詳情頁。
在合約信息頁簽下,支持查看跨鏈系統在該區塊鏈上已部署的跨鏈合約的相關信息。
螞蟻區塊鏈跨鏈合約信息
Fabric跨鏈合約信息
跨鏈授權-賬本數據訪問
登錄跨鏈服務控制臺。
單擊已注冊區塊鏈右側的 詳情 按鈕,進入到詳情頁。
單擊 跨鏈授權 功能頁簽,進入到授權頁面。
單擊右上角的 新建授權。
在彈窗中,授權已經注冊的另外一條區塊鏈通過跨鏈服務訪問當前區塊鏈的賬本數據。
跨鏈授權-合約消息推送
登錄跨鏈服務控制臺。
單擊已注冊區塊鏈右側的 詳情 按鈕,進入到詳情頁。
單擊 跨鏈授權 功能頁簽,進入到授權頁面。
單擊右上角的 新建授權。
在彈窗中,授權已經注冊的另外一條區塊鏈的指定合約向當前區塊鏈的指定合約發送消息。
上圖的授權示例中,區塊鏈
crosschain1.oracle.chain
允許區塊鏈crosschain2.oracle.chain
的合約sourceContract
發送消息給本區塊鏈上的合約destContract
。重要如果您未進行授權設置,那么通過跨鏈數據連接服務進行的跨鏈賬本數據訪問和消息推送將會失敗。
查看我的權限
如果有其他區塊鏈為您授權,您可以在 我的權限 模塊查看。
業務合約開發
賬本數據訪問開發流程
用戶智能合約使用賬本數據訪問 API 接口,開發流程如下:
在 BaaS 平臺上獲取賬本數據合約名稱。
獲取賬本數據訪問 API 接口定義(ChainDataInterface.sol)。
在用戶合約中引入賬本數據訪問 API 定義。
用戶合約實現回調接口,用于異步接收賬本數據回調使用。
用戶合約構建賬本數據訪問請求(ChainDataCmdHelper.sol)。
用戶合約向賬本數據合約發送請求,具體參考API使用示例。
賬本數據服務返回數據為 JSON 格式,具體格式參考賬本數據結構部分。
合約開發請參考開發指南。
合約消息推送開發流程
用戶智能合約使用合約消息推送服務API接口,開發流程如下:
在 BaaS 平臺上獲取消息合約名稱。
獲取合約消息推送 API 接口定義。
在用戶合約中引入合約消息推送 API 接口。
用戶合約實現接收消息接口,供跨鏈消息收發合約調用。
用戶合約調用跨鏈消息收發合約發送消息接口。
合約開發請參考開發指南。