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. 检查签名事件是否被注册；

• 输入参数：

• 输出参数：

3.2.5.2  查询交易回执

3.2.5.2.1  功能介绍

运营方或平台方根据交易哈希对交易回执信息进行查询。

3.2.5.2.2  API 定义

• 方法定义：

  String getTransReceipt(String txHash)

• 调用者：平台方、运营方；

• 核心逻辑：

1. 根据交易 hash 查询交易回执（不同框架自定义输出参数）

2. 检查签名事件是否被注册；

• 输入参数：

• 输出参数：

3.2.5.3  查询交易状态

3.2.5.3.1  功能介绍

运营方或平台方根据交易哈希查询交易状态是否成功。

3.2.5.3.2  API 定义

• 方法定义：

  Boolean getTransByStatus(String txHash)

• 调用者：平台方、运营方；

• 核心逻辑：

1. 根据交易哈希查询的交易是否成功；

2. 检查签名事件是否被注册；

• 输入参数：

• 输出参数：

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. 检查签名事件是否被注册；

• 输入参数：

• 输出参数：

3.2.3  BSN-DDC-签名事件

3.2.7.1  功能介绍

此事件是通用事件，所有的上链待签名交易报文需调用此事件进行签名，业务调用方需要注册此签名事件，并在实现的签名事件中实现签名逻辑，并将最终签名后的结果返回给 DDC-SDK。

3.2.7.2 事件定义

• 输入参数：签名事件类

• 输出参数：签名结果

String signEvent(SignEvent event);

3.2.7.2 数据结构

• SignEvent

本文资料内容来源于 BSN-DDC SDK 详细设计-V1.0，GitHub 地址为：

https://github.com/BSN-DDC/did-sdk

欲浏览更多信息，请您点击登录查看。