BSN-DDC 基础网络详解（五）：接入 DDC 网络（1）

BSN-DDC 基础网络推出已经一年了，得到了行业应用方和广大开发者的高度认可。一年中 BSN 产品技术团队也在根据市场业务需求不断更新功能服务，我们将通过本系列文章为大家系统化介绍 DDC 网络的功能和使用，为感兴趣的朋友提供学习帮助。

01

支持 DDC 的开放联盟链

BSN 联盟将持续引入众多国内外主流的区块链底层框架，分别打造成以中国城市命名的开放联盟链（节点部署有权限控制，无法使用任何 cryptocurrencies），并使其作为支撑 DDC 网络的区块链底层环境。以下是 DDC 网络上的开放联盟链信息：

更多开放联盟链持续增加中……

上述每个开放联盟链的具体特点和智能合约编写方式均与对应的底层技术基本一致，算力中心方和平台方也可以到相应的底层技术开源社区或官网进行了解和学习。

算力中心方和平台方根据自己的业务要求和技术储备，可自行选择一条或多条 DDC 开放联盟链使用。所有 DDC 开放联盟链上的官方 DDC 合约均定义了相同的方法。

02

DDC 官方门户功能

除前文提到的业务开通功能外，官方门户提供了应用项目管理（仅 DDC 平台方可使用）、链节点管理（仅算力中心方可使用）、链账户管理、官方 DDC 查询、官方 DDC 业务费查询、能量值查询、资金账户交易流水查询等功能。因为 DDC 网络只服务于算力中心方和平台方，因此官方门户也就是算力中心方和平台方使用的作为 DDC 网络直接客户的门户。虽然很多操作可以在门户网站中手工进行，但强烈建议算力中心方和平台方应对门户网站的 OpenAPI 熟悉，尽量使用 OpenAPI 进行相应操作。例如如果算力中心和平台方因为业务需要有成千上万个链账户，生成链账户以及链账户的能量值充值就无法有效地通过人工操作完成。

1．链节点管理（仅算力中心方可使用）

1）节点查询

算力中心方用户登录官方门户系统并开通业务后，可查看自己搭建的节点信息。

点击左侧菜单中“链节点管理”进入节点列表，节点列表初始无数据。点击【查询】时，展示算力中心方用户的所有节点信息，并支持按照开放联盟链、节点状态以及创建时间进行搜索查询。

节点确认入网后，节点列表中展示节点 IP,点击图标可以复制节点 IP。

​

2）节点详情

在节点列表中，点击操作中的【查看详情】按钮，可查看节点的基本信息和审核信息。

2.项目管理（仅 DDC 平台方可使用）

平台方可在官方门户为其开发的基于 DDC 开放联盟链的区块链应用建立项目，在项目中管理应用接入 DDC 网络的安全控制参数：项目 ID 和项目 Key。平台方的应用业务系统与 BSN 联盟提供的 DDC 网络开放联盟链网关通信时，网关将验证这些安全控制参数，并在验证通过后，将应用的交易请求转发到开放联盟链网络中。平台方可基于每个 DDC 开放联盟链创建不限数量的多个项目。项目设置的目的是让平台方可以有效对不同业务进行不同的 DDC 网络接入控制。平台方完全可以选择同一开放联盟链框架下的所有业务只使用同一个项目 ID。同时，平台方也可以通过官方门户 OpenAPI 进行项目的创建和管理（建议）。

1）创建项目

• 登录官方门户，在“项目管理”页面，点击【创建项目】按钮；

​

• 自定义项目名称并选择开放联盟链框架，点击【完成创建】按钮。

​

2）项目 Key

创建项目后默认只启用项目 ID，项目 Key 由平台方自主选择是否需要启用。如果启用，那么访问 DDC 网络的开放联盟链网关时必须要有项目 ID 和项目 Key。

启用

• 登录官方门户，在“项目管理”页面，查询找到待启用项目 Key 的项目；

• 点击【操作】下拉框后再点击【启用项目 Key】；

​

• 弹出确认框后点击【确认】按钮，便完成启用项目 Key。

​

更新

• 登录官方门户，在“项目管理”页面，查询找到待更新项目 Key 的项目；

• 点击【操作】下拉框后再点击【更新项目 Key】；

​

• 弹出确认框后点击【确认】按钮，便完成更新项目 Key。

​

禁用

• 登录官方门户，在“项目管理”页面，查询找到待禁用项目 Key 的项目；

• 点击【操作】下拉框后再点击【禁用项目 Key】；

​

• 弹出确认框后点击【确认】按钮，便完成禁用项目 Key。

3）下载接入参数

接入参数指的是接入开放联盟链网关的参数，平台方下载接入参数后按开放联盟链网关接入说明，便可在业务系统直接对接网关。

• 登录官方门户，在“项目管理”页面进行项目查询；

• 点击【操作】下拉框后再点击【下载接入参数】。

​

4）删除

• 登录官方门户，在“项目管理”页面进行项目查询；

• 点击【操作】下拉框后再点击【删除】；

​

• 弹出确认框后点击【确认】按钮，便完成删除项目。

​

3.管理链账户

算力中心方和平台方可在官方门户自主选择开放联盟链框架，自由创建链账户，并可对每一个链账户进行能量值和官方 DDC 业务费的充值操作，同时还可对任何链账户状态进行冻结和解冻操作。

在任何一个开放联盟链上开设的链账户数量没有限制，因此算力中心方和平台方可以根据自己的业务灵活设置链账户的管理，甚至可以为平台上几十万终端用户每人开设一个链账户，每个终端用户可以控制自己链账户的私钥，或由平台托管私钥（算力中心方和平台方自行实现）。当然，算力中心方和平台方也可以选择所有 DDC/NFT 全部生成到自己控制的唯一一个链账户内，完全根据自己的业务需求和实现方法决定。DDC 网络致力于为算力中心方和平台方提供尽可能大的灵活性。

1）链账户的创建

由于开放联盟链的可公用性，有多种方式可以创建链账户，如：通过官方 DDC SDK 生成、通过链框架技术方提供的工具生成、通过第三方的钱包工具生成等。生成链账户后，算力中心方和平台方需在官方门户或通过官方门户 OpenAPI（强烈推荐）登记注册链账户，注册时需提交和验证业务凭证。只有注册后的链账户才能启用 DDC 网络业务功能。

• 登录官方门户，在“链账户管理”->“链账户”页面，点击【创建】按钮；

​

• 链账户的创建页面，选择 DDC 开放联盟链框架、定义链账户名称、选择该链账户是否使用官方 DDC（选择“否”则涉及不到官方 DDC 类型）、选择官方 DDC 类型为平台方还是终端用户、选择创建方式、输入链账户相关信息、上传平台方的业务凭证；

​

• 点击【创建】按钮，完成链账户的创建。

​

• 如果会生成多个链账户，这里强烈建议算力中心方和平台方使用官方门户 OpenAPI 进行操作。

2）链账户的充值

链账户是链上交易不可或缺的直接载体，每一个链账户都必须由所属平台方完成从门户资金账户到链账户的能量值以及业务费充值（注意：链账户的能量值和业务费是分开充值的），充值时需提交和验证业务凭证。算力中心方和平台方可在官方门户内查询具体的链账户余额并进行手动充值操作，也可以在自己的业务系统内，通过引用官方 DDC SDK 或调用官方门户 OpenAPI 自动查询自己的资金账户余额，以及动态向任何链账户充值（强烈建议，如果涉及多个链账户）。

能量值充值

在 DDC 网络中执行任何合约时，都会从发起交易的链账户中扣减交易处理所需的能量值，所以为保证链账户在相应的链上发起的区块链交易能正常执行，算力中心方和平台方需为链账户进行能量值充值。

• 登录官方门户，在“链账户管理”->“链账户”页面，查询需充值的链账户；

• 点击【操作】下拉框后再点击【能量值充值】按钮；

​

• 在弹出框内，选择（输入）充值金额，点击【确认】按钮完成充值。

​

官方 DDC 业务费充值

调用官方 DDC 合约涉及到业务费，所以为保证链账户在相应的链上正常调用官方 DDC 合约方法，算力中心方和平台方需为链账户进行业务费充值。

• 登录官方门户，在“链账户管理”->“链账户”页面，查询需充值的链账户；

• 点击【操作】下拉框后再点击【官方 DDC 业务费充值】按钮；

​

• 在弹出框内，选择（输入）充值金额，点击【确认】按钮完成充值。

​

3）链账户的冻结和解冻

链账户本身并没有状态，BSN-DDC 体系为了缔造基于中国现行法律完全可控、合法合规的基础网络，在官方 DDC 合约内对链账户增加了状态管理属性；同时在官方门户、门户 OpenAPI 以及 DDC SDK 里增加了对链账户的状态管理，让算力中心方和平台方可以对自己的终端用户的链账户进行冻结和解冻操作。

冻结和解冻仅应用于链账户是否可进行 BSN 官方 DDC 业务处理，并不会影响已发生的交易数据和被冻结链账户内的官方 DDC 业务费、能量值余额等,也不会影响该链账户调用算力中心方和平台方自定义合约。

冻结

• 登录官方门户，在“链账户管理”->“链账户”页面，查询需冻结的链账户；

• 点击【操作】下拉框后再点击【冻结官方 DDC】按钮。

​

解冻

• 登录官方门户，在“链账户管理”->“链账户”页面，查询需解冻的链账户

• 点击【操作】下拉框后再点击【启用】按钮。

​

内容引用于《BSN-DDC 基础网络帮助手册》，手册版本号：2.1.2，修订时间：2023-02