中移链（基于EOS）DDC-SDK实战-如何集成中移链DDC-SDK

本文档是关于中移链 DDC-SDK 实战，即如何集成基于 EOS 的中移链 DDC-SDK 的操作指南，适用于 BSN 开放联盟链--中移链 DDC-SDK 开发者，帮助读者了解如何以平台方的角色集成中移链 DDC-SDK。

前言

2021年10月，中移（动）信息技术有限公司（以下统称“ IT 公司”）与 BSN 开展合作，由 BSN 搭建 BSN-DDC 基础网络，IT 公司区块链团队自主研发基于 EOS 的中移链 DDC，面向存在 DDC 业务需求的各行业客户提供接入服务，使其可便捷管理 DDC 操作，从而灵活升级产品模式，助力客户业务创新。

本文档是关于中移链 DDC-SDK 实战，即如何集成基于 EOS 的中移链 DDC-SDK 的操作指南，适用于 BSN 开放联盟链--中移链 DDC-SDK 开发者，帮助读者了解如何以平台方的角色集成中移链 DDC-SDK。

 

‍

----------

一、中移链（基于EOS）操作说明

1.创建链账户

1.1 进入【链账户管理】模块，点击【创建链账户】按钮；

1.2 在链账户模块中点击创建链账户进入新增页面。页面中输入链账户名称，开放链框架下拉中选择中移链，链账户类型只支持上传公钥模式；

注意：链账户名称是12个字符，只能包括【12345和26个字母】。其中必须以字母开头，并且链账户名称唯一。完成创建后，该链账户只可用于访问所选开放链框架且不可修改。

1.3 用户点击【创建】按钮，进入证书模式页中，输入公钥、测试数据及签名数据。测试通过后，点击【确认创建】完成链账户创建；

注意：此时创建的链账户就是平台方链账户，上传公钥所对应的私钥就是平台方私钥，后续初始化配置需要使用。

 

2.分配资源

2.1 在链账户列表中的操作列点击【分配资源】后，系统打开资源分配窗口。

2.2 资源分配窗口，用户选择资源有效期、输入资源购买容量，系统自动计算出支付金额。点击【确认分配】按钮，弹出确认分配提示并点击【确定】按钮完成链账户资源分配；

注意：资源用于链上交易，分配后不支持退款。链上交易处理过程中，从链账户中扣除资源时，链账户上必须同时有NET、CPU和RAM，三种资源缺一不可。CPU/NET购买后，资源使用有时间限制，RAM购买后无时间限制。用户购买CPU/NET后，若在有效期内，资源使用累加超过购买额度，需重新分配资源，否则过期则会清空资源。

 

3.创建项目

3.1 进入【项目管理】模块，点击【创建项目】按钮。

3.2、在创建项目页面中输入【项目名称】，【开放链框架】下拉中选择【中移链】即可完成创建；

注意：项目创建完成后不允许修改开放链框架。

4.网关接入说明

4.1 密钥算法：中移链（基于EOS）通过ECDSA(secp256k1)算法生成公私钥。

4.2 Chain ID：

    9b4c6015f8b73b2d7ee3ebd92d249a1aba06a614e9990dcf54f7cf2e3d5172e1。

4.3 接入方式：中移链（基于EOS）目前支持 JSON-RPC API 方式接入；     

API文档参考：

     https://developers.eos.io/manuals/eos/latest/nodeos/plugins/chain_api_plugin/api-reference/index    

4.4 密钥模式：在上传公钥模式下，用户自己管理密钥，完全按照API文档发起交易。

4.5 网关地址规则

RPC访问地址：网关地址/api/[项目id]/rpc；其中网关地址：https://opbningxia.bsngate.com:18602；

如果使用项目key接入，需按照网关地址/api/[项目id]/[Protocol]格式拼接请求地址，同时请求报文头header中增加x-api-key:{项目key值}；

项目id：创建项目后生成的项目ID，见下图:

也可以从项目管理->操作->下载接入参数获取。

 

二、引入DDC-SDK依赖包

1.引入bsn-eos-sdk的jar包

1.<dependency>  

2.    <groupId>com.bsn.eos</groupId>  

3.    <artifactId>bsn-eos-sdk</artifactId>  

4.    <version>1.0.20220602</version>  

5.    <scope>system</scope>  

6.    <systemPath>${project.basedir}/lib/bsn-eos-sdk-1.0.20220602.jar</systemPath>  

7.</dependency>  

2.引入EOS官方java-sdk以及相关依赖包

1.<dependencies>  

2.    <dependency>  

3.        <groupId>org.bouncycastle</groupId>  

4.        <artifactId>bcprov-jdk15on</artifactId>  

5.        <version>1.69</version>  

6.    </dependency>  

7.    <dependency>  

8.        <groupId>org.bouncycastle</groupId>  

9.        <artifactId>bcpkix-jdk15on</artifactId>  

10.        <version>1.69</version>  

11.    </dependency>  

12.  

13.    <dependency>  

14.        <groupId>one.block</groupId>  

15.        <artifactId>eosiojava</artifactId>  

16.        <version>1.0.0</version>  

17.        <exclusions>  

18.            <exclusion>  

19.                <groupId>org.slf4j</groupId>  

20.                <artifactId>slf4j-jdk14</artifactId>  

21.            </exclusion>  

22.        </exclusions>  

23.    </dependency>  

24.    <dependency>  

25.        <groupId>one.block</groupId>  

26.        <artifactId>eosio-java-rpc-provider</artifactId>  

27.        <version>1.0.0</version>  

28.    </dependency>  

29.  

30.    <dependency>  

31.        <groupId>com.alibaba</groupId>  

32.        <artifactId>fastjson</artifactId>  

33.        <version>1.2.79</version>  

34.    </dependency>  

35.    <dependency>  

36.        <groupId>com.fasterxml.jackson.core</groupId>  

37.        <artifactId>jackson-databind</artifactId>  

38.        <version>2.13.0</version>  

39.    </dependency>  

40.    <dependency>  

41.        <groupId>com.squareup.okhttp3</groupId>  

42.        <artifactId>okhttp</artifactId>  

43.        <version>3.12.0</version>  

44.    </dependency>  

45.    <dependency>  

46.        <groupId>com.squareup.okhttp3</groupId>  

47.        <artifactId>logging-interceptor</artifactId>  

48.        <version>3.12.0</version>  

49.    </dependency>  

50.    <dependency>  

51.        <groupId>com.squareup.retrofit2</groupId>  

52.        <artifactId>converter-scalars</artifactId>  

53.        <version>2.5.0</version>  

54.    </dependency>  

55.    <dependency>  

56.        <groupId>com.squareup.retrofit2</groupId>  

57.        <artifactId>retrofit</artifactId>  

58.        <version>2.5.0</version>  

59.    </dependency>  

60.    <dependency>  

61.        <groupId>com.squareup.retrofit2</groupId>  

62.        <artifactId>converter-jackson</artifactId>  

63.        <version>2.5.0</version>  

64.    </dependency>  

65.  

66.    <dependency>  

67.        <groupId>org.projectlombok</groupId>  

68.        <artifactId>lombok</artifactId>  

69.        <version>1.18.24</version>  

70.        <scope>compile</scope>  

71.    </dependency>  

72.    <dependency>  

73.        <groupId>io.jafka</groupId>  

74.        <artifactId>jeos</artifactId>  

75.        <version>0.9.15</version>  

76.        <exclusions>  

77.            <exclusion>  

78.                <groupId>org.slf4j</groupId>  

79.                <artifactId>slf4j-reload4j</artifactId>  

80.            </exclusion>  

81.        </exclusions>  

82.    </dependency>  

83.</dependencies>  

   

三、初始化平台方配置

1.初始化参数配置

初始化com.bsn.eos.chain.ChainConfig 类中的三个参数：gatewayUrl、ddcContractAndAccount、pk，完成EOS链访问地址、DDC合约账户名、平台方账户私钥的配置。其中，中移链的gatewayUrl为https://opbningxia.bsngate.com:18602/api/[项目id]/rpc，合约链账户ddcContractAndAccount为reddateddc22，平台方账户私钥pk为创建链账户所使用公钥对应的私钥。

2.初始化代码示例

1.//设置EOS链访问地址  

2.ChainConfig.setGatewayUrl("https://opbningxia.bsngate.com:18602/api/58f79d4af7754e588fc2efd23bf7e7fc/rpc");  

3.//设置部署DDC合约的账户  

4.ChainConfig.setDdcContractAndAccount("reddateddc22");  

5.//设置平台方账户私钥  

6.ChainConfig.setPk("5Jj3bPpWtbJex5DGXCLjE8c5Gr9SudFRogkwXvd1KHGGa7ZWYS1");  

四、实现API调用

1.调用DDC生成

1.1功能介绍：

平台方、终端用户通过调用该方法进行DDC的创建。

1.2 API定义：

1)方法定义：String safeMint(String from, String to, String ddcURI);

2)EOS合约方法：ddc::mint_721(name sender, name to, uint64_t amount, std::string ddc_uri, std::string memo);

3)调用者：平台方、终端用户，需设置调用者私钥；

4)核心逻辑：

①　检查发送方、接收者账户状态是否可用；

②　检查角色是否为平台方或终端用户；

③　检查发送方账户是否有调用权限；

④　检查发送方账户与接受者账户是否属于同平台。

5)输入参数：

字段名	字段	类型	必传	备注
发送方账户	From	String	是
接收者账户	to	String	是
DDC资源标识符	ddcURI	String	是

6)输出参数：

字段名	字段	类型	备注
		String	交易 Hash

1.3调用代码示例：

1.@Test  

2.public void mint721() {  

3.    //设置平台方账户  

4.    String platformAccount = "ddc.platform";  

5.    DDC721Service ddc721Service = new DDC721ServiceImpl();  

6.    String transactionId = ddc721Service.safeMint(platformAccount, platformAccount, "https://bitnodes.io/226");  

7.    System.out.println(transactionId);  

8.}  

2.调用查询DDC数量

2.1功能介绍：

通过调用该方法查询当前账户拥有的DDC数量。

2.2 API定义：

1)方法定义：BigInteger balanceOf(String owner);

2）EOS合约方法：get_table_rows(name contract, name table, name account);

3）调用者：所有人；

4）核心逻辑：检查拥有者账户状态是否可用；

5）输入参数：

字段名	字段	类型	必传	备注
拥有者账户	owner	String	是

6）输出参数：

字段名	字段	类型	备注
DDC的数量	balance	BigInteger

2.3 调用代码示例：

1.@Test  

2.public void balanceOf721() {  

3.    //设置平台方账户  

4.    String platformAccount = "ddc.platform";  

5.    DDC721Service ddc721Service = new DDC721ServiceImpl();  

6.    System.out.println(ddc721Service.balanceOf(platformAccount));  

7.}  

   

五、参考链接

BSN介绍：

https://bsnbase.com/static/tmpFile/bzsc/bsn/1-1.html

中移链（基于EOS）操作说明：

https://bsnbase.com/static/tmpFile/bzsc/openper/7-2-4.html

中移链（基于EOS）网关接入说明：

https://bsnbase.com/static/tmpFile/bzsc/openper/7-3-6.html