Skip to content

跨链浏览器体验指南

一、测试网配置流程

我们建议使用 Google Chrome 并安装 MetaMask 钱包扩展程序(推荐使用10.0.1及以上)。以下是 MetaMask 常见问题解答 供参考！

测试网自动配置

MetaMask插件安装完成后，点击浏览器【登陆】按钮，系统会弹出测试网自动配置添加页面，用户点击【Approve】，即可成功添加BitXHub测试网。

Metamask Network

BitXHub测试网络添加成功后，系统会提示您进行网络切换，用户点击【Switch network】，即可成功切换至BitXHub测试网络并进行后续操作。

Metamask Network

测试网RPC手动配置

选择顶部网络功能，然后选择【自定义RPC】进入网络配置页面。

Metamask Network

BitXHub测试网配置信息详情

Chain ID

1356

RPC URL

https://testnet-1.bitxhub.cn:8881

配置如下图所示

Network

二、应用链环境准备

应用链接入中继链之前，需要进行相应的跨链合约部署以及跨链网关配置等操作。

部署跨链合约

可以参考BitXHub文档站链接进行跨链合约部署。（注意：文档中提到的二进制或开源项目，均是要对应 v1.11.0的版本）

获取Pier部署包和修改配置

可以参考BitXHub文档站链接。

注意：

1）文档中提到的二进制或开源项目，均是要对应 v1.11.0的版本；

2）以上pier配置过程，pier.toml中关于应用链的部分需要特别注意，以fabric为例，[appchain]字段下的配置示例如下，

[mode.relay]
addrs = ["testnet-1.bitxhub.cn:60111"]

[appchain]
plugin = "fabric-client-1.4"
config = "fabric"

获取应用链私钥（用于导入MetaMask钱包）

完成以上配置后，在页面上注册应用链之前，还需要将上一步pier配置目录下的key.json转换显示成可以导入MetaMask钱包的公私钥对，具体示例如下：

# 1.进入到pier的配置主目录，即pier.toml所在的目录
# 执行pier show命令
./pier show --path ~/.pier/key.json
# 返回结果示例：
private key: 0x88b434530176d3faf4dbf10ede1c25c4f7af673392152d71a18758a1ba677ddc
public key: 0x041b311209c6feb1587aaf16d7a1bac9f96c1fecb539d4cde416f97ff5048139beeac307d14d0e7196c7e15ad657530dedcc33bbe821276dadf3989bfff470747a
address: 0xE7f5E3c3963c6a588AB3de753817B3F735a6Ab58
# 将返回的private key的字符串导入到MetaMask钱包即可

三、浏览器可视化操作

用户实名绑定

BitXHub测试网络下，新用户首次点击【登陆】，需要完成手机实名绑定，系统会提示【正在为您跳转，请先完成用户注册】，并跳转到注册页面。

注册

注册页面中，用户需要输入手机号进行验证码校验，完成密码设置后，点击【注册】，即可跳转返回跨链浏览器页面。新用户完成注册后，您的地址1h内将收到BitXHub测试网发送的燃料费用于跨链体验。

注册

应用链注册申请

对于新注册的用户，您的地址1h内将收到BitXHub测试网发送的燃料费用于跨链体验。当您的地址中BitXHub测试网燃料费为0时，系统会提示【您的测试网燃料正分发中，请稍后】。

注册

应用链注册

注册

注册字段说明：

  1. 节点ID：系统根据钱包地址自动生成

  2. 应用链名称：自定义应用链的名称

  3. 应用链类型：分为fabric1.4.3、fabric1.4.4 、hyperchain和 其他 四类

  4. 版本号：应用链对应的版本号

  5. 共识算法：应用链采用的共识算法

  6. 验证者信息：请参考验证者信息生成

  7. 验证规则：分为fabric1.4.3、fabric1.4.4 、无验证规则和 其他 四类（用户可选择无验证规则模式进行快速跨链体验），根据对应应用链类型选择合适的验证规则。注意其他类型需要提交自定义的验证规则，并附带源码链接。编写规则请参考验证规则编写

  8. 申请理由：填写申请接入跨链系统的理由

应用链接入BitXHub跨链系统需要获得中继链管理员的准入审批，中继链管理员会在24h内完成应用链注册申请审，审核通过即可接入应用链。

四、网关启动

在完成以上步骤之后，用户启动跨链网关，即完成应用链接入跨链系统的操作。

#以用户目录下的pier为例
pier --repo=~/.pier start

五、跨链体验

目前测试网已经接入Fabric和Hyperchain，两条链都部署了存证服务，用户应用链接入跨链系统后，可通过BitXHub体验跨链存证服务。

两条测试应用链的信息如下：

1. Fabric

应用链DID： did:bitxhub:appchain0xc11bA472f5955B2a3b0e66a91fFc05f68995eFDf:.

存证合约地址： mychannel&data_swapper

2. Hyperchain

应用链DID： did:bitxhub:appchain0xe1E8c72408623Dd1825b704C21ceF7C03ab62aB6

存证合约地址： 0xb8dc305352edef315f6a7844948c864717e93c84

具体调用说明如下：

跨链存证

调用自己应用链上的data_swapper合约向我们内部的测试应用链发起跨链存证交易，调用方法是 set ，其参数有3个，依次是目的链合约的did、要存储的key，要存储的value

跨链获取

调用自己应用链上的data_swapper合约向我们内部的测试应用链发起跨链交易，将获取到的数据存到自己链上，调用方法是 get ，其参数有2个，依次是 目的链合约的did、要获取的key。

本地查询

调用自己应用链上的data_swapper合约查询上一步获取的数据，如果自己链是fabric，则调用方法是 get，如果自己链是hyperchain或其它，则调用方法是 getData，参数均只有1个，即要查询的key

用户如果想验证目的链上是否真正执行了跨链操作，可通过部署两条自己的应用链进行跨链存证的完整体验。