BSN-DDC基础网络推出已经一年了,得到了行业应用方和广大开发者的高度认可。一年中BSN产品技术团队也在根据市场业务需求不断更新功能服务,我们将通过本系列文章为大家系统化介绍DDC网络的功能和使用,为感兴趣的朋友提供学习帮助。
01
城市算力中心接入DDC网络
(仅对算力中心方)
1.搭建算力中心开发者门户和管理系统
算力中心完成协议签订后可以开始搭建算力中心开发者门户和管理系统,算力中心通过部署该门户系统将向算力中心开发者用户提供BSN-DDC网络接入和BSN官方DDC应用业务能力。算力中心拥有独立业务用户体系,使用“算力值”对自身用户进行各种业务的交易和结算。算力中心的用户在使用BSN官方DDC应用时将不会感知到BSN-DDC网络应用业务处理中的“能量值”和“业务费”,只需要消耗通过向算力中心方购买的“算力值”即可完成BSN官方DDC应用的业务处理。在本次版本中,算力中心只支持用户链账户“私钥托管”模式存储在算力中心本地资源中,后续我们将提供支持用户私钥自己保管的“公钥上传”模式的算力中心版本。
2.申请外部节点接入网络
在本地安装的算力中心管理系统中可以向BSN-DDC网络运营人员发起外部节点接入网络申请,等待BSN-DDC网络运营人员审批后可以获得BSN联盟签发的节点证书,只有配置了该证书的外部节点才能获得接入BSN-DDC网络的权限。证书的失效期限与算力中心方业务签约到期时间一致。
3.部署节点并完成节点入网
算力中心方使用BSN联盟提供的DDC网络的各个开放联盟链的外部节点部署包和相关说明文档可以进行快速的节点搭建和部署,从而获取直接接入BSN-DDC基础网络的能力。本次版本支持中移链、文昌链和泰安链的外部节点接入网络,后续将推出更多开放联盟链框架的外部节点接入网络。
4.算力中心部署指南
1. 注册成为城市算力中心方 |
1.1 BSN-DDC官网用户注册 |
首先需要前往BSN-DDC官方门户https://ddc.bsnbase.com,完成用户注册。 |
|
1.2 签订协议 |
官方商务或客服人员会尽快与您进行联系沟通,完成城市算力中心协议签订。 |
||
2. 搭建城市算力中心管理系统 |
通过下载链接获取城市算力中心管理系统部署包和部署手册,按照部署手册说明完成系统部署,期间官方技术支持人员将会对您遇到的问题进行解答和帮助。 |
部署手册 |
|
3. 搭建外部节点 |
3.1-1 申请外部节点入网-中移链 |
通过管理系统中的链节点管理->节点入网来申请外部节点入网,填写节点入网信息流程如下:1. 选取“中移链”链框架并点击“在线生成”,会生成三个文件node_cer.csr(证书签名请求)、node_private.pem(节点私钥)、node_public.pem(节点公钥),这些文件在部署节点的过程中都会使用,请妥善保管;2. 节点名称可根据需要任意填写,仅为方便识别,没有任何其它意义;3. 用记事本打开node_cer.csr文件,复制文件内容并填写到“CSR文件内容”中;4. 用记事本打开node_public.pem文件,复制文件内容并填写到“节点公钥”中;5. 如果有需要说明的信息,可以填在备注栏中,完成后点击确定即可创建申请。申请创建后会有官方工作人员进行审核,同时会新增一条记录在链节点管理模块中,您也可以登录官方门户,在链节点管理中查看您的节点信息。 |
|
3.1-2 申请外部节点入网-文昌链 |
通过管理系统中的链节点管理->节点入网来申请外部节点入网,填写节点入网信息流程如下:1. 选取“文昌链”链框架并点击“在线生成”,会生成四个文件node_cer.csr(证书签名请求)、node_private.pem(节点私钥)、node_public.pem(节点公钥)、node_key.json,这些文件在部署节点的过程中都会使用,请妥善保管;2. 节点名称可根据需要任意填写;3. 用记事本打开node_cer.csr文件,复制文件内容并填写到“CSR文件内容”中;4. 用记事本打开node_public.pem文件,复制文件内容并填写到“节点公钥”中;5. 如果有需要说明的信息,可以填在备注栏中,完成后点击确定即可创建申请。申请创建后会有官方工作人员进行审核,同时会新增一条记录在链节点管理模块中,您也可以登录官方门户,在链节点管理中查看您的节点信息。 |
||
3.1-3 申请外部节点入网-泰安链 |
通过管理系统中的链节点管理->节点入网来申请外部节点入网,填写节点入网信息流程如下:1. 选取“泰安链”链框架并点击“在线生成”,会生成六个文件node.csr(证书签名请求)、node.key、node.nodeid、node.pubkey(节点公钥)、sdk.key、sdk.publickey,这些文件在部署节点的过程中都会使用,请妥善保管;2. 节点名称可根据需要任意填写;3. 用记事本打开node.csr文件,复制文件内容并填写到“CSR文件内容”中;4. 用记事本打开node.pubkey文件,复制文件内容并填写到“节点公钥”中;5. 如果有需要说明的信息,可以填在备注栏中,完成后点击确定即可创建申请。申请创建后会有官方工作人员进行审核,同时会新增一条记录在链节点管理模块中,您也可以登录官方门户,在链节点管理中查看您的节点信息。 |
||
3.2 关注节点状态 |
可以通过链节点列表获取您的节点当前状态,状态说明如下:1. 待审核 - 已成功提交申请,等待工作人员进行审核2. 审核拒绝 - 提交的申请审核没有通过 3. 入网中 - 提交的申请审核通过后进行入网 4. 入网失败 - 节点入网时没有成功入网 5. 待确认入网 - 后台生成证书后,待算力中心运营人员进行确认操作 6. 已确认入网 -算力中心运营人员完成确认操作 7. 入网完成 -节点入网成功并完成入网流程 8.退网中 -运营人员提交退网请求 9.退网完成 -节点退网成功 |
||
3.3 获取节点证书 |
当您的节点通过审核后,BSN会为您发放节点证书,您可以在节点详情中下载节点证书(若没有相应字段和链接是因为证书尚未发出,请耐心等待;若节点通过审核后长时间未在详情页面中出现证书下载链接,请与客服或技术支持人员联系)。 |
||
3.4 部署节点并完成入网 |
您可以通过部署说明来进行节点搭建,请注意每条链的节点搭建步骤不尽相同,请使用正确的部署说明。我们的技术支持人员会随时为您解答部署过程中出现的问题。 |
中移链:部署说明 文昌链:部署说明 泰安链:部署说明 |
|
3.5 确认节点入网 |
在链节点管理中确认节点状态已更新为“入网完成”。 |
||
4. 业务配置 |
在算力中心运营管理系统中进行门户参数、服务参数配置,具体请参考算力中心运营管理系统用户操作说明。 |
算力中心运营管理系使用说明 |
02
平台方系统接入DDC网络
(仅对DDC平台方)
官方门户给平台方提供了官方DDC数据的查询统计及管理的功能,而DDC网络的链上交易处理功能,平台方可通过以下两种方式接入。
1.直接调用DDC网络网关
DDC网络的各个开放联盟链上智能合约的方法通过DDC网关开放给平台方,所以平台方可参考相应开放联盟链的网关接入说明调用DDC网关执行DDC智能合约(包括自行部署的合约)。为了避免出现开放联盟链的网络拥堵、执行效率低的情况,我们在DDC网关侧对每个平台方做了100笔/秒的交易限流控制(平台方的所有DDC网络项目共享使用该限流控制),以保证链上各应用方的交易处理处于相对平滑的状态。平台方可根据网关的限流策略,在其业务系统中根据实际业务需求自行实现与网关交易请求的削峰平谷机制。
需要强调的是,100笔交易/秒的控制是DDC网络网关的控制。每条DDC开放联盟链还有链本身的交易处理瓶颈。一般情况下,每条DDC开放联盟链的TPS数约在1500-3000范围内,如果交易量过大,开放联盟链的处理方式与公链一致,会进行交易排队。平台方应充分了解这些限制,并在自己的业务系统内做相应技术处理。另外,算力中心方如果自用,可以选择直接调用本地部署的DDC开放联盟链节点,避免DDC网络的网关TPS限制,所以建议平台方在业务量达到一定程度后转为算力中心方。
2.使用DDC SDK调用
每一条开放联盟链都有官方DDC SDK,平台方可以在业务系统中,通过官方DDC SDK直接调用部署在DDC网络中的官方DDC合约方法。详情参考官方DDC SDK说明。平台方可以在官方DDC SDK的基础上定制开发,以实现在业务系统调用其自定义的DDC/NFT合约。
内容引用于《BSN-DDC基础网络帮助手册》,手册版本号:2.1.2,修订时间:2023-02
-END-