BSN-DDC基础网络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.3 数据结构

SignEvent

字段名	字段	类型	必传	备注
签名者	sender	String	是
待签名交易	unSignTrans	Object	是