使用指南

本文将为您介绍如何使用跨链服务控制台。

注册区块链

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

  1. 点击 注册区块链 进入注册页面。
    3

  2. 选择要注册的区块链类型,完成相应的注册步骤。目前该服务支持蚂蚁区块链和 HyperLedger Fabric,如果您需要注册其他类型的区块链,请 提交工单 联系我们。

  • 注册蚂蚁区块链

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

注册

  • 注册 Hyperledger Fabric

如果您注册的是 Hyperledger Fabric,可按照页面上的操作提示进行注册。
5

  1. 下载跨链链码包,创建 channel,安装链码包。
    1. 下载页面上的跨链链码包。
    2. 在 Hyperledger Fabric 区块链上创建开通跨链服务的 channel。
    3. 在创建的 channel 中安装链码包。
  2. 创建账户或申请证书,获取配置文件。

    1. 在 Hyperledger Fabric 区块链上注册一个账户或者申请证书,供跨链服务使用。
    2. 如果您是阿里云 Hyperledger Fabric 用户,可下载 SDK 配置文件,解压后获取 connection-standard.yaml 的配置文件。如果您不是阿里云 Hyperledger Fabric 用户,请联系蚂蚁技术支持人员获取配置文件。
  3. 注册区块链,提供账户或证书,上传配置文件。

    1. 在页面上创建区块链域名,上传第二步中获取的 connection-standard.yaml 的配置文件。
    2. 注册成功后,提供区块链锚定信息,包括跨链 channel 名称,选择验证节点,提供第二步中创建的用户名和密码。
      6
      或者您也可以直接上传证书和私钥。
      7注册完成后,可以在控制台上看到已经注册的链信息

跨链授权

点击已注册区块链 右侧的详情按钮,进入到详情页。跨链授权-1

点击跨链授权功能,进入到授权页面。
8

账本数据访问

授权已经注册的另外一条区块链通过跨链服务访问当前区块链的账本数据。
10

合约消息推送

授权已经注册的另外一条区块链的指定合约向当前区块链的指定合约发送消息。
合约消息推送上图的授权示例中,区块链crosschain1.oracle.chain允许区块链crosschain2.oracle.chain 的合约 sourceContract 发送消息给本区块链上的合约 destContract。

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

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

业务合约开发

账本数据访问开发流程
  1. 用户智能合约使用账本数据访问 API 接口,开发流程如下:
  2. 在 Baas 平台上获取账本数据合约名称。
  3. 获取账本数据访问 API 接口定义( ChainDataInterface.sol )。
  4. 在用户合约中引入账本数据访问 API 定义。
  5. 用户合约实现回调接口,用于异步接收账本数据回调使用。
  6. 用户合约构建账本数据访问请求( ChainDataCmdHelper.sol )。
  7. 用户合约向账本数据合约发送请求,具体参考API使用示例。
  8. 账本数据服务返回数据为json格式,具体格式参考账本数据结构部分。

合约开发请参考开发指南

合约消息推送开发流程

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

  1. 在 Baas 平台上获取消息合约名称。
  2. 获取合约消息推送 API 接口定义。
  3. 在用户合约中引入合约消息推送 API 接口。
  4. 用户合约实现接收消息接口,供跨链消息收发合约调用。
  5. 用户合约调用跨链消息收发合约发送消息接口。

合约开发请参考开发指南