6. 使用平行链与群组¶
6.1. 创建平行链¶
现在 XuperChain 中创建平行链的方式是:发起一个系统智能合约,发到xuper链。
当前xchain.yaml有两个配置项:
1 2 3 4 5 6 | Kernel:
# minNewChainAmount 设置创建平行链时最少要转多少utxo(门槛)到同链名的address
minNewChainAmount: “100”
# newChainWhiteList 有权创建平行链的address白名单
newChainWhiteList:
- dpzuVdosQrF2kmzumhVeFQZa1aYcdgFpN: true
|
创建平行链的json文件(模版),如下:
1 2 3 4 5 6 7 8 | {
"Module": "kernel",
"Method": "CreateBlockChain",
"Args": {
"name": "HelloChain",
"data": "{\"version\": \"1\", \"consensus\": {\"miner\":\"dpzuVdosQrF2kmzumhVeFQZa1aYcdgFpN\", \"type\":\"single\"},\"predistribution\":[{\"address\": \"dpzuVdosQrF2kmzumhVeFQZa1aYcdgFpN\",\"quota\": \"1000000000000000\"}],\"maxblocksize\": \"128\",\"period\": \"3000\",\"award\": \"1000000\"}"
}
}
|
使用如下指令即可创建平行链(需要在主链操作,转了100个主链的token到平行链同名的address,作为创建链的代价):
1 | ./xchain-cli transfer --to HelloChain --amount 100 --desc createChain.json
|
6.2. 获取group_chain合约¶
XuperChain 提供了默认的群组合约(group_chain)的实现,路径为 core/contractsdk/cpp/example/group_chain.cc 。在 core/contractsdk/cpp 目录下执行 sh build.sh 即可编译生成 group_chain.wasm ,即可使用 group_chain.wasm 实现群组合约的部署。
6.3. 创建群组¶
如果希望创建的平行链只在自己希望的小范围使用,那么可以参考此节配置群组功能
当前 XuperChain 中创建群组的方式是:在xuper链上部署GroupChain智能合约,将节点白名单加到GroupChain合约中。
在创世块中配置群组合约配置:
1 2 3 4 5 6 7 8 | {
"group_chain_contract": {
"module_name": "wasm",
"contract_name": "group_chain",
"method_name": "list",
"args":{}
}
}
|
如果需要确保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 2 | ./xchain-cli wasm invoke group_chain --method addNode -a '{"bcname":"HelloChain", "ip":"ip1", "address":"addr1"}'
./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的内容了。