使用指南

更新时间:

本文将为您介绍如何使用跨链服务控制台,包括注册区块链、跨链授权(包括账本数据访问、合约消息推送)的相关操作流程,以及如何进行权限查看、合约消息查看等。

注册区块链

注册您的区块链是开始跨链连接的第一步。注册区块链后,跨链数据连接服务将访问您的区块链,并在您的区块链上部署跨链合约,用于跨链信息传递。

说明

目前该服务支持蚂蚁区块链和Hyperledger Fabric,如果需要注册其他类型区块链,请联系产品团队。

注册蚂蚁区块链

  1. 登录跨链服务控制台

  2. 单击 注册区块链 进入注册页面。

    image.png

  3. 区块链类型 请选择 蚂蚁区块链,然后完成相应的注册步骤。

  4. 根据页面提示,提供蚂蚁区块链的基本信息,账户信息和证书信息,跨链服务将使用这些信息访问区块链,部署跨链系统合约,以及提交跨链交易。

    注册

注册 Fabric 区块链

  1. 登录跨链服务控制台

  2. 单击 注册区块链 进入注册页面。

    image.png

  3. 区块链类型 请选择 Hyperledger Fabric,然后完成相应的注册步骤。

  4. 按照页面上的操作提示进行注册。

    5

    1. 下载跨链链码包,创建 channel,安装链码包。

      1. 下载页面上的跨链链码包。

      2. 在 Hyperledger Fabric 区块链上创建开通跨链服务的 channel。

      3. 在创建的 channel 中安装链码包。

    2. 创建账户或申请证书,获取配置文件。

      1. 在 Hyperledger Fabric 区块链上注册一个账户或者申请证书,供跨链服务使用。

      2. 如果您是阿里云 Hyperledger Fabric 用户,可下载 SDK 配置文件,解压后获取connection-profile-standard.yaml的配置文件。如果您不是阿里云 Hyperledger Fabric 用户,请联系蚂蚁技术支持人员获取配置文件。

    3. 注册区块链,提供账户或证书,上传配置文件。

      1. 在页面上创建区块链域名,上传第二步中获取的 connection-standard.yaml 的配置文件。

      2. 注册成功后,提供区块链锚定信息,包括跨链 channel 名称,选择验证节点,提供第二步中创建的用户名和密码。

        6

        或者,您也可以直接上传证书和私钥。

        7

    注册完成后,可以在控制台上看到已经注册的链信息。

跨链管理

查看跨链域名详情

  1. 登录跨链服务控制台

  2. 单击已注册区块链右侧的 详情 按钮,进入到详情页。

  3. 基本信息页签下,支持查看跨链域名详情。

    您可以在此查看区块链在跨链系统中的基本信息、域名证书,以及UDSN证书。

    image

查看跨链系统合约

  1. 登录跨链服务控制台

  2. 单击已注册区块链右侧的 详情 按钮,进入到详情页。

  3. 合约信息页签下,支持查看跨链系统在该区块链上已部署的跨链合约的相关信息。

    • 蚂蚁区块链跨链合约信息

      image

    • Fabric跨链合约信息

      image

跨链授权-账本数据访问

  1. 登录跨链服务控制台

  2. 单击已注册区块链右侧的 详情 按钮,进入到详情页。

  3. 单击 跨链授权 功能页签,进入到授权页面。

  4. 单击右上角的 新建授权

    image

  5. 在弹窗中,授权已经注册的另外一条区块链通过跨链服务访问当前区块链的账本数据。

    10

跨链授权-合约消息推送

  1. 登录跨链服务控制台

  2. 单击已注册区块链右侧的 详情 按钮,进入到详情页。

  3. 单击 跨链授权 功能页签,进入到授权页面。

  4. 单击右上角的 新建授权

    image

  5. 在弹窗中,授权已经注册的另外一条区块链的指定合约向当前区块链的指定合约发送消息。

    合约消息推送

    上图的授权示例中,区块链crosschain1.oracle.chain允许区块链crosschain2.oracle.chain的合约sourceContract发送消息给本区块链上的合约destContract

    重要

    如果您未进行授权设置,那么通过跨链数据连接服务进行的跨链账本数据访问和消息推送将会失败。

查看我的权限

如果有其他区块链为您授权,您可以在 我的权限 模块查看。

12

业务合约开发

账本数据访问开发流程

用户智能合约使用账本数据访问 API 接口,开发流程如下:

  1. 在 BaaS 平台上获取账本数据合约名称。

  2. 获取账本数据访问 API 接口定义(ChainDataInterface.sol)。

  3. 在用户合约中引入账本数据访问 API 定义。

  4. 用户合约实现回调接口,用于异步接收账本数据回调使用。

  5. 用户合约构建账本数据访问请求(ChainDataCmdHelper.sol)。

  6. 用户合约向账本数据合约发送请求,具体参考API使用示例。

  7. 账本数据服务返回数据为 JSON 格式,具体格式参考账本数据结构部分。

合约开发请参考开发指南

合约消息推送开发流程

用户智能合约使用合约消息推送服务API接口,开发流程如下:

  1. 在 BaaS 平台上获取消息合约名称。

  2. 获取合约消息推送 API 接口定义。

  3. 在用户合约中引入合约消息推送 API 接口。

  4. 用户合约实现接收消息接口,供跨链消息收发合约调用。

  5. 用户合约调用跨链消息收发合约发送消息接口。

合约开发请参考开发指南