6. 使用平行链与群组

6.1. 创建平行链

现在超级链中创建平行链的方式是：发起一个系统智能合约，发到xuper链。

当前xchain.yaml有两个配置项：

  1. Kernel:
  2.     # minNewChainAmount 设置创建平行链时最少要转多少utxo（门槛）到同链名的address
  3.     minNewChainAmount: “100”
  4.     # newChainWhiteList 有权创建平行链的address白名单
  5.     newChainWhiteList:
  6.         - dpzuVdosQrF2kmzumhVeFQZa1aYcdgFpN: true

创建平行链的json文件（模版），如下：

  1. {
  2.     "Module": "kernel",
  3.     "Method": "CreateBlockChain",
  4.     "Args": {
  5.         "name": "HelloChain",
  6.         "data": "{\"version\": \"1\", \"consensus\": {\"miner\":\"dpzuVdosQrF2kmzumhVeFQZa1aYcdgFpN\", \"type\":\"single\"},\"predistribution\":[{\"address\": \"dpzuVdosQrF2kmzumhVeFQZa1aYcdgFpN\",\"quota\": \"1000000000000000\"}],\"maxblocksize\": \"128\",\"period\": \"3000\",\"award\": \"1000000\"}"
  7.     }
  8. }

使用如下指令即可创建平行链（需要在主链操作，转了100个主链的token到平行链同名的address，作为创建链的代价）：

  1. ./xchain-cli transfer --to HelloChain --amount 100 --desc createChain.json

6.2. 获取group_chain合约

超级链提供了默认的群组合约（group_chain）的实现，路径为 core/contractsdk/cpp/example/group_chain.cc 。在 core/contractsdk/cpp 目录下执行 sh build.sh 即可编译生成 group_chain.wasm ，即可使用 group_chain.wasm 实现群组合约的部署。

6.3. 创建群组

如果希望创建的平行链只在自己希望的小范围使用，那么可以参考此节配置群组功能

当前超级链中创建群组的方式是：在xuper链上部署GroupChain智能合约，将节点白名单加到GroupChain合约中。

在创世块中配置群组合约配置：

  1. {
  2.     "group_chain_contract": {
  3.         "module_name": "wasm",
  4.         "contract_name": "group_chain",
  5.         "method_name": "list",
  6.         "args":{}
  7.     }
  8. }

如果需要确保HelloChain具备群组属性，且白名单为<ip1,addr1>,<ip2,addr2>，其他节点不能获取这条平行链的信息，可以按如下操作。 此处： ip1,ip2是指从xchain-cli netURL preview 获取的形如”/ip4/127.0.0.1/tcp/47101/p2p/QmVxeNubpg1ZQjQT8W5yZC9fD7ZB1ViArwvyGUB53sqf8e”的IP地址； add1,add2 是指节点的公钥地址：data/keys/addresss

step1: 在xuper链部署GroupChain合约

  1. # 需要使用合约账号，部署编译好的合约文件
  2. ./xchain-cli wasm deploy --account XC1111111111111111@xuper --cname group_chain ./group_chain.wasm --fee xxx

step2: 调用GroupChain合约的AddNode方法将<ip1,add1>,<ip2,add2>加入白名单

  1. ./xchain-cli wasm invoke group_chain --method addNode -a '{"bcname":"HelloChain", "ip":"ip1", "address":"addr1"}'
  2. ./xchain-cli wasm invoke group_chain --method addNode -a '{"bcname":"HelloChain", "ip":"ip2", "address":"addr2"}'

step3: 调用GroupChain合约的AddChain确保HelloChain具备群组特性

  1. ./xchain-cli wasm invoke group_chain --method addChain -a '{"bcname":"HelloChain"}'

至此即完成了群组的设置，只有<ip1,add1>,<ip2,add2>两个节点可以获取平行链HelloChain的内容了。