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。

本期是系列文章第五期,官网合约BSN-DDC-1155。

3.2.1 BSN-DDC-1155
3.2.4.1 平安生成
3.2.4.1.1 性能介绍
平台方或终端用户能够通过调用该办法进行DDC的平安生成。
3.2.4.1.2 API定义
办法定义:String safeMint(String sender,String to,BigInteger amount,String ddcURI,byte[] data);

合约办法:safeMint(address to,uint256 amount, string memory ddcURI, bytes memory data);

调用者:平台方、终端用户;

外围逻辑:

查看sender为标筹备address格局;

查看接收者账户地址信息是否为空;

查看接收者账户地址格局是否正确;

查看须要生成的DDC数量是否大于0;

查看DDCURI信息是否为空;

查看签名事件是否被注册;

输出参数:

字段名字段类型必传备注
调用者senderString调用者地址
接收者账户toString
DDC数量amountBigInteger
DDCURIddcURIString
附加数据databyte[]

输入参数:

字段名字段类型必传备注
String交易哈希

3.2.4.2 批量平安生成
3.2.4.2.1 性能介绍
平台方或终端用户能够通过调用该办法进行DDC的批量平安生成。
3.2.4.2.2 API定义
办法定义:String safeMintBatch(String sender,String to,Multimap<BigInteger,String> ddcInfo,byte[] data);

合约办法:safeMintBatch(address to,uint256[] amounts, string[] ddcURIs, bytes memory data);

调用者:平台方、终端用户;

外围逻辑:

查看sender为标筹备address格局;

查看接收者账户地址信息是否为空;

查看接收者账户地址格局是否正确;

查看生成的DDC数量汇合大小是否大于0;

查看生成的DDC数量汇合中每个DDC数量是否大于0;

查看生成的DDCURI汇合大小是否大于0;

查看生成的DDCURI汇合中每个DDCURI是否为空;

查看生成的DDC数量汇合与DDCURI汇合的大小是否相等;

查看签名事件是否被注册;

输出参数:

字段名字段类型必传备注
调用者senderString调用者地址
接收者账户toString
DDC信息共计ddcInfoMultimap<BigInteger,String>
附加数据databyte[]

输入参数:

字段名字段类型必传备注
String交易哈希

3.2.4.3 账户受权
3.2.4.3.1 性能介绍
DDC拥有者能够通过调用该办法进行账户受权,发起者须要是DDC的拥有者。
3.2.4.3.2 API定义
办法定义:

String setApprovalForAll(String sender,String operator, Boolean approved);

合约办法:

setApprovalForAll(address operator, bool approved);

调用者:DDC拥有者;

外围逻辑:

查看sender为标筹备address格局;

查看受权者账户地址信息是否为空;

查看受权者账户地址格局是否正确;

查看签名事件是否被注册;

输出参数:

字段名字段类型必传备注
调用者senderString调用者地址
受权者账户operatorString
受权标识approvedBoolean

输入参数:

字段名字段类型必传备注
String交易哈希

3.2.4.4 账户受权查问
3.2.4.4.1 性能介绍
经营方、平台方或终端用户能够通过调用该办法进行账户受权查问。
3.2.4.4.2 API定义
办法定义:

Boolean isApprovedForAll(String owner,String operator);

合约办法:

isApprovedForAll(address owner,address operator) returns (bool);

调用者:经营方、平台方或终端用户;

外围逻辑:

查看拥有者账户地址信息是否为空;

查看拥有者账户地址格局是否正确;

查看受权者账户地址信息是否为空;

查看受权者账户地址格局是否正确;

查看签名事件是否被注册;

输出参数:

字段名字段类型必传备注
拥有者账户ownerString
受权者账户operatorBoolean

输入参数:

字段名字段类型必传备注
Boolean

3.2.4.5 平安转移
3.2.4.5.1 性能介绍
DDC拥有者或DDC受权者能够通过调用该办法进行DDC的转移。
3.2.4.5.2 API定义
办法定义:

String safeTransferFrom(String sender,String from,String to,BigInteger ddcId,BigInteger amount,byte[] data);

合约办法:

safeTransferFrom(address from,address to,uint256 ddcId,uint256 amount,bytes memory data);

调用者:DDC拥有者、DDC受权者;

外围逻辑:

查看sender为标筹备address格局;

查看拥有者账户地址信息是否为空;

查看拥有者账户地址格局是否正确;

查看接收者账户地址信息是否为空;

查看接收者账户地址格局是否正确;

查看DDCID数值是否大于0;

查看DDC转移所对应的数量是否大于0;

查看签名事件是否被注册;

输出参数:

字段名字段类型必传备注
调用者senderString调用者地址
拥有者账户fromString
接收者账户toString
DDCIDddcIdBigInteger
数量amountBigIntegerDDCID所对应的数量
附加数据databyte[]

输入参数:

字段名字段类型必传备注
String交易哈希

3.2.4.6 批量平安转移
3.2.4.6.1 性能介绍
DDC拥有者或DDC受权者能够通过调用该办法进行DDC的批量转移。
3.2.4.6.2 API定义
办法定义:

String safeBatchTransferFrom(String sender,String from,String to,Map<BigInteger,BigInteger> ddcs, byte[] data);

合约办法:

safeBatchTransferFrom(address from, address to,uint256[] ddcIds,uint256[] amounts,bytes memory data);

调用者:DDC拥有者、DDC受权者;

外围逻辑:

查看sender为标筹备address格局;

查看拥有者账户地址信息是否为空;

查看拥有者账户地址格局是否正确;

查看接收者账户地址信息是否为空;

查看接收者账户地址格局是否正确;

查看转移的ddcs汇合大小是否大于0;

查看转移的ddcs汇合中每个DDCID是否大于0;

查看转移的ddcs汇合中每个DDC数量是否大于0;

查看签名事件是否被注册;

输出参数:

字段名字段类型必传备注
调用者senderString调用者地址
拥有者账户fromString
接收者账户toString
拥有者DDCID汇合ddcsMap<BigInteger,BigInteger>
附加数据databyte[]

输入参数:

字段名字段类型必传备注
String交易哈希

3.2.4.7 销毁
3.2.4.7.1 性能介绍
DDC拥有者或DDC受权者能够通过调用该办法进行DDC的销毁。
3.2.4.7.2 API定义
办法定义:

String burn(String sender,String owner,BigInteger ddcId);

合约办法:burn(address owner,uint256 ddcId);

调用者:DDC拥有者、DDC受权者;

外围逻辑:

查看sender为标筹备address格局;

查看拥有者账户地址信息是否为空;

查看拥有者账户地址格局是否正确;

查看须要销毁的DDCID汇合长度是否大于0;

查看签名事件是否被注册;

输出参数:

字段名字段类型必传备注
调用者senderString调用者地址
拥有者账户ownerString
DDCIDddcIdBigInteger

输入参数:

字段名字段类型必传备注
String交易哈希

3.2.4.8 批量销毁
3.2.4.8.1 性能介绍
DDC拥用者或DDC受权者能够通过调用该办法进行DDC的批量销毁。
3.2.4.8.2 API定义
办法定义:

String burnBatch(String sender,String owner,List<BigInteger> ddcIds);

合约办法:

burnBatch(address owner,uint256[] ddcIds);

调用者:DDC拥用者、DDC受权者;

外围逻辑:

查看sender为标筹备address格局;

查看拥有者账户地址信息是否为空;

查看拥有者账户地址格局是否正确;

查看须要销毁的DDCID汇合大小是否大于0;

查看须要销毁的DDCID汇合中每个DDCID数值是否大于0;

查看签名事件是否被注册;

输出参数:

字段名字段类型必传备注
调用者senderString调用者地址
拥有者账户ownerString
DDCID汇合ddcIdsList<BigInteger>

输入参数:

字段名字段类型必传备注
String交易哈希

3.2.4.9 查问数量
3.2.4.9.1 性能介绍
经营方、平台方以及终端用户能够通过调用该办法进行查问以后账户领有的DDC的数量。
3.2.4.9.2 API定义
办法定义:

BigInteger balanceOf(String owner,BigInteger ddcId);

合约办法:

balanceOf(address owner, uint256 ddcId) returns (uint256);

调用者:经营方、平台方以及终端用户;

外围逻辑:

查看拥有者账户地址信息是否为空;

查看拥有者账户地址格局是否正确;

查看DDCID汇合长度是否大于0;

查看签名事件是否被注册;

输出参数:

字段名字段类型必传备注
拥有者账户ownerString
DDCIDddcIdBigInteger

输入参数:

字段名字段类型必传备注
数量BigInteger拥有者账户所对应的DDCID所拥用的数量

3.2.4.10 批量查问数量
3.2.4.10.1 性能介绍
经营方、平台方以及终端用户能够通过调用该办法进行批量查问账户领有的DDC的数量。
3.2.4.10.2 API定义
办法定义:

List<BigInteger> balanceOfBatch(Multimap<String,BigInteger>ddcs);

合约办法:

balanceOfBatch(address[] memory owners,uint256[] memory ddcIds) returns (uint256[] memory);

调用者:经营方、平台方以及终端用户;

外围逻辑:

查看ddcs汇合大小是否大于0;

查看ddcs汇合中拥有者账户地址信息是否为空;

查看ddcs汇合中拥有者账户地址格局是否正确;

查看ddcs汇合中每个DDCID数值是否大于0;

查看签名事件是否被注册;

输出参数:

字段名字段类型必传备注
拥有者DDCID汇合ddcsMultimap<String,BigInteger>

输入参数:

字段名字段类型必传备注
数量汇合List<BigInteger>拥有者账户所对应的每个DDCID所拥用的数量

3.2.4.11 获取DDCURI
3.2.4.11.1 性能介绍
经营方、平台方以及终端用户能够通过调用该办法进行查问以后DDC的资源标识符。
3.2.4.11.2 API定义
办法定义:String ddcURI(BigInteger ddcId);

合约办法:ddcURI(uint256 ddcId) returns (string memory);

调用者:经营方、平台方以及终端用户;

外围逻辑:

查看DDCID数值是否大于0;

查看签名事件是否被注册;

输出参数:

字段名字段类型必传备注
DDCIDddcIdBigInteger

输入参数:

字段名字段类型必传备注
DDCURIString

3.2.4.12 URI设置
3.2.4.12.1 性能介绍
DDC拥有者或DDC受权者通过调用该办法对DDC的资源标识符进行设置。
3.2.4.12.2 API定义
办法定义:String setURI(String sender,String owner,BigInteger ddcId,String ddcURI);

合约办法:setURI(address owner,uint256 ddcId,string memory ddcURI);

调用者:DDC拥有者、DDC受权者;

外围逻辑:

查看sender为标筹备address格局;

查看owner地址格局是否正确;

查看ddcId数值是否大于0;

查看ddcURI是否为空字符串;

查看签名事件是否被注册;

输出参数:

字段名字段类型必传备注
调用者senderString调用者地址
DDC拥有者ownerString
DDC惟一标识ddcIdBigInteger
DDC资源标识符ddcURIString

输入参数:

字段名字段类型必传备注
String交易哈希

本文材料内容来源于BSN-DDC SDK具体设计-V1.0,GitHub地址为:

https://github.com/BSN-DDC/di...

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