BSN-DDC基礎網路DDC SDK詳細設計（六）：交易查詢、區塊查詢、簽名事件

2022年1月25日，區塊鏈服務網路發展聯盟（簡稱“BSN聯盟”）推出了“BSN-DDC基礎網路”（簡稱DDC網路）。DDC網路的推出，為NFT技術在我國的落地提供基礎設施能力支撐，併為其合規發展保駕護航。

DDC（Distributed Digital Certificate）即分散式數字憑證，其屬性和功能類似於NFT。NFT是現實或數字世界中某個事物在區塊鏈上的數字化權益證明，儘管目前大多被用於數字藝術品版權領域，然而其本質上是一種區塊鏈分散式資料庫技術，並不帶有特定的業務屬性，它的潛在使用場景是非常廣泛的，可應用在數字商品憑證、票證、賬戶管理、智慧財產權等各種領域。

DDC網路不直接向個人使用者提供服務，而是向擁有DDC/NFT業務的平臺方提供極其便捷的網路接入服務，以方便這些平臺以極低的成本提供DDC/NFT的生成和管理服務。

DDC-SDK 是用於開發者與DDC合約互動的 API 工具。為了讓運營方或各平臺方對DDC-SDK整體設計有一個全面詳細的瞭解，同時為專案的開發、測試、驗證、交付等環節提供原始依據以及開發指導，BSN研習社推出BSN-DDC基礎網路DDC SDK詳細設計系列。分別從整體設計，DID功能設計，DDC許可權管理、費用管理，官方合約BSN-DDC-721，官方合約 BSN-DDC-1155，交易查詢、區塊查詢、簽名事件，資料解析，示例等八個方面，全面詳細的介紹DDC-SDK。

本期是系列文章第六期，交易查詢、區塊查詢、簽名事件。

3.2.1  BSN-DDC-交易查詢

3.2.5.1 查詢交易資訊

3.2.5.1.1  功能介紹

運營方或平臺方根據交易雜湊對交易資訊進行查詢。

3.2.5.1.2  API定義

• 方法定義：
  String getTransByHash(String txHash)
• 呼叫者：平臺方、運營方；
• 核心邏輯：

1. 根據交易雜湊查詢的交易資訊（不同框架自定義輸出引數）
2. 檢查簽名事件是否被註冊；

• 輸入引數：

欄位名	欄位	型別	必傳	備註
交易雜湊	txHash	String	是

• 輸出引數：

欄位名	欄位	型別	必傳	備註
交易資訊	txInfo	String	是

3.2.5.2  查詢交易回執

3.2.5.2.1  功能介紹

運營方或平臺方根據交易雜湊對交易回執資訊進行查詢。

3.2.5.2.2  API定義

• 方法定義：
  String getTransReceipt(String txHash)
• 呼叫者：平臺方、運營方；
• 核心邏輯：

1. 根據交易hash查詢交易回執（不同框架自定義輸出引數）
2. 檢查簽名事件是否被註冊；

• 輸入引數：

欄位名	欄位	型別	必傳	備註
交易雜湊	txHash	String	是

• 輸出引數：

欄位名	欄位	型別	必傳	備註
交易回執	txReceipt	String	是

3.2.5.3  查詢交易狀態

3.2.5.3.1  功能介紹

運營方或平臺方根據交易雜湊查詢交易狀態是否成功。

3.2.5.3.2  API定義

• 方法定義：

  Boolean getTransByStatus(String txHash)

• 呼叫者：平臺方、運營方；

• 核心邏輯：

1. 根據交易雜湊查詢的交易是否成功；

2. 檢查簽名事件是否被註冊；

• 輸入引數：

欄位名	欄位	型別	必傳	備註
交易雜湊	txHash	String	是

• 輸出引數：

欄位名	欄位	型別	必傳	備註
交易是否成功	txStatus	Boolean	是

3.2.2  BSN-DDC-區塊查詢

3.2.6.1  獲取區塊資訊

3.2.6.1.1  功能介紹

運營方或平臺方根據區塊高度對區塊資訊進行查詢，並解析區塊資料返回給運營方或平臺方。

3.2.6.1.2  API定義

• 方法定義：
  String getBlockByNumber(BigInteger blockNumber)
• 呼叫者：運營方、平臺方；
• 核心邏輯：

1. 根據區塊高度查詢區塊資訊（不同框架自定義輸出引數）；
2. 檢查簽名事件是否被註冊；

• 輸入引數：

欄位名	欄位	型別	必傳	備註
區塊高度	blockNumber	BigInteger	是

• 輸出引數：

欄位名	欄位	型別	必傳	備註
區塊資訊	blockInfo	String	是

3.2.3  BSN-DDC-簽名事件

3.2.7.1  功能介紹

此事件是通用事件，所有的上鍊待簽名交易報文需呼叫此事件進行簽名，業務呼叫方需要註冊此簽名事件，並在實現的簽名事件中實現簽名邏輯，並將最終簽名後的結果返回給DDC-SDK。

3.2.7.2 事件定義

• 輸入引數：簽名事件類
• 輸出引數：簽名結果

String signEvent(SignEvent event);

3.2.7.2 資料結構

• SignEvent

欄位名	欄位	型別	必傳	備註
簽名者	sender	String	是
待簽名交易	unSignTrans	Object	是

本文資料內容來源於BSN-DDC SDK詳細設計-V1.0，GitHub地址為：

欲瀏覽更多資訊，請您點選登入檢視。