华企号 互联网综合 BSN-DDC基础网络DDC SDK详细设计(六):交易查询、区块查询、签名事件

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地址为:

作者: 华企网通李铁牛程序员

我是程序员李铁牛,热爱互联网软件开发和设计,专注于大数据、数据分析、数据库、php、java、python、scala、k8s、docker等知识总结。15889726201 我的座右铭:"业精于勤荒于嬉,行成于思毁于随"
上一篇
下一篇

发表回复

联系我们

联系我们

028-84868647

在线咨询: QQ交谈

邮箱: tech@68v8.com

工作时间:周一至周五,9:00-17:30,节假日休息

关注微信
微信扫一扫关注我们

微信扫一扫关注我们

关注微博
返回顶部