跳转至

4. 注册应用链

需要注意的是：

  • 在v1.6.0及以上的版本，注册应用链需要中继链BitXHub节点管理员进行投票，投票通过之后才能接入。这一步Ethereum和Fabric（包括其它类型应用链）的流程一样，只是注册信息有所不同；
  • 在v1.18.0及以上的版本内置了一些验证，使用这些验证规则不需要进行额外的部署。

以下操作均是Pier命令行发起。

注册应用链

#在进行应用链注册之前首先需要向目标地址进行转账，保障该地址可以进行应用链注册
#获得admin的id
pier --repo ~/bitxhub-v2.0.0/.pier/ id
#向目标地址转账
bitxhub client transfer --key $HOME/bitxhub/scripts/build/node1/key.json --to 0xFbB01EcDFFc6033e2aa205987696C3fd72f436B2 --amount 100000000000000000
  1. Pier命令行发起应用链注册
# 以用户目录下的pier为例
#注意：命令中的broker地址需要更改为remix编译部署的broker地址，以及admin需要修改为
#之前转账的地址
pier --repo $CONFIG_PATH/.pier appchain register --appchain-id "ethappchain" --name "ethereum" \
--type "ETH" --trustroot "ethereum/ether.validators" --broker \
 0x857133c5C69e6Ce66F7AD46F200B9B3573e77582  --desc "desc" --master-rule \
 "0x00000000000000000000000000000000000000a2" --rule-url "http://github.com" \
 --admin 0xcb33b10104cd217aAB4b302e9BbeEd1957EDaA31 --reason "reason"
# 0x00000000000000000000000000000000000000a2 HappyRuleAddr
# 发起注册后会打印出提案id
Register appchain successfully, wait for proposal 0xDa5cF4F0adb9B75bc6FEADeb7ddbf0769399a2ed-0 to finish.

！！！需要注意的是v1.18.0以上版本的网关注册时会将提供的验证规则地址注册为主验证规则，同时也支持配置多个应用链管理员。

2.中继链节点依次投票

# 进入bitxhub节点的安装目录，用上一步得到的提案id进行投票
bitxhub --repo $CONFIG_PATH/bitxhub/scripts/build/node1 client governance vote --id 0xcb33b10104cd217aAB4b302e9BbeEd1957EDaA31-0 --info approve --reason approve
# 投票完后会打印：vote successfully!
# 如果是多个bitxhub节点组成的集群，依次指定各节点的安装目录进行投票

当BitXHub集群超过半数的管理员投票通过后，应用链注册成功（如果BitXHub是solo模式，则只需要一票同意即可），可以通过如下命令查询提案状态：

bitxhub --repo  $HOME/bitxhub/scripts/build/node1 client governance appchain info --name "ethereum"

#在进行应用链注册之前首先需要向目标地址进行转账，保障该地址可以进行应用链注册
#获得admin的id
pier --repo ~/bitxhub-v2.0.0/.pier/ id
#向目标地址转账
bitxhub client transfer --key $HOME/bitxhub/scripts/build/node1/key.json --to 0xFbB01EcDFFc6033e2aa205987696C3fd72f436B2 --amount 100000000000000000
  1. Pier命令行发起应用链注册
# 以用户目录下的pier为例
#注意：admin需要修改为之前转账的地址
pier --repo $CONFIG_PATH/.pier appchain register --appchain-id "fabappchain" \
--name "fabric" --type "Fabric V1.4.3" --trustroot fabric/fabric.validators --broker-cid mychanncel \
--broker-ccid broker --broker-v 1 --desc "desc" --master-rule "0x00000000000000000000000000000000000000a2" \
--rule-url "http://github.com" --admin 0x321E49c58eC76a5cA02F3E801f303D1E8E0379d0 --reason "reason" 

# 0x00000000000000000000000000000000000000a2 HappyRuleAddr
# 发起注册后会打印出提案id
Register appchain successfully, wait for proposal 0xDa5cF4F0adb9B75bc6FEADeb7ddbf0769399a2ed-0 to finish.

！！！需要注意的是v1.18.0以上版本的网关注册时会将提供的验证规则地址注册为主验证规则，同时也支持配置多个应用链管理员。

2.中继链节点依次投票

# 进入bitxhub节点的安装目录，用上一步得到的提案id进行投票
bitxhub --repo $CONFIG_PATH/bitxhub/scripts/build/node1 client governance vote --id 0xcb33b10104cd217aAB4b302e9BbeEd1957EDaA31-0 --info approve --reason approve
# 投票完后会打印：vote successfully!
# 如果是多个bitxhub节点组成的集群，依次指定各节点的安装目录进行投票

当BitXHub集群超过半数的管理员投票通过后，应用链注册成功（如果BitXHub是solo模式，则只需要一票同意即可），可以通过如下命令查询提案状态：

bitxhub --repo  $HOME/bitxhub/scripts/build/node1 client governance appchain info --name "fabric"

注册验证规则（可选）

应用链除了在注册应用链时，绑定主验证规则，在可用状态下也可以注册其他验证规则，即可以在应用链注册成功且中继链投票通过后进行规则部署。之前已经准备好了验证规则文件，接下来在Pier端发起部署验证规则的命令。

# 以用户目录下的pier为例
$ pier --repo $CONFIG_PATH/.pier rule deploy --path=$CONFIG_PATH/.pier/ether/validating.wasm
# 部署验证规则后会打印：Deploy rule successfully: 0xed97cBf32C16551604f0017f9aA776bF96809b87

$ pier --repo $CONFIG_PATH/.pier rule register --appchain-id ethappchain --rule \
0xed97cBf32C16551604f0017f9aA776bF96809b87 --rule-url "http://github.com"
# 注册成功后会打印: Register rule to bitxhub for appchain ethappchain successfully.

# 以用户目录下的pier为例
$ pier --repo $CONFIG_PATH/.pier rule deploy --path=$CONFIG_PATH/.pier/fabric/validating.wasm
# 部署验证规则后会打印：Deploy rule successfully: 0xed97cBf32C16551604f0017f9aA776bF96809b87

$ pier --repo $CONFIG_PATH/.pier rule register --appchain-id fabappchain --rule \
0xed97cBf32C16551604f0017f9aA776bF96809b87 --rule-url "http://github.com"
# 注册成功后会打印: Register rule to bitxhub for appchain ethappchain successfully.
回到页面顶部