4.2.2. PoA类使用¶
4.2.2.1. 共识状态查看¶
4.2.2.1.1. 共识状态查询¶
1. 通用共识状态查询
./bin/xchain-cli consensus status
2. PoA存储字段查询
// 若不装载Chained-BFT组件,--type后需填写poa
./bin/xchain-cli consensus invoke --type xpoa --method getValidates --fee ${1000_IF_NEED}
重要
变更之后,并不会立即生效,必须在3个块高度之后生效(高度为H的高度,H+3之后才会生效,此处实际使用快照读取)。
4.2.2.2. 创世块配置介绍¶
PoA类共识的创世块示例在上述 /data/genesis/xpoa.json
中,下面简要介绍:
1 2 3 4 5 6 7 8 9 10 11 | "genesis_consensus":{
"name": "xpoa", // 共识名称
"config": {
"period":3000, // 【重要】每个块生产固定时间,单位为毫秒,示例所示为3s一个块
"block_num":40, // 【重要】每个候选人在一轮轮数中需要出块的数目
"init_proposer": {
"address" : ["TeyyPLpp9L7QAcxHangtcHTu7HUZ6iydY", "SmJG3rH2ZzYQ9ojxhbRCPwFiE9y6pD1Co"] // 【重要】数组中记录了全部初始候选人节点的address
}
// , "bft_config":{} 可选项,即配置chained-bft组件。
}
}
|
4.2.2.3. PoA候选人变更流程整体介绍¶
PoA整体候选人变更流程详细介绍请见 PoA流程 。
Xpoa类命令行操作,仅限变更目前的validators集合address地址,一步即可完成。候选人集合中的节点发起操作变更,发送成功之后,将在三个块之后生效,候选人集合被改变。
4.2.2.3.1. 修改候选人流程¶
ACL账户准备
修改候选人需要通过合约ACL实现,我们建议将ACL设定为当前全部候选人集合的均值权限。例如初始状态下有节点1和节点2为候选人集合节点,那么ACL账户为节点1和节点2的组合账户,每人的权限均分分配为0.5,阈值权限为0.6,需两人全部签名。用户可根据业务场景需求自设定ACL账户。
ACL多签流程如下:
./bin/xchain-cli account new --desc account.des --fee 1000
./bin/xchain-cli transfer --to XC1111111111111111@xuper --amount 1000000000
具体account.des示例如下:
// account.des
{
"module_name": "xkernel",
"method_name": "NewAccount",
"contract_name": "$acl",
"args" : {
"account_name": "1111111111111111",
"acl": "{\"pm\": {\"rule\": 1,\"acceptValue\": 0.6},\"aksWeight\": {\"TeyyPLpp9L7QAcxHangtcHTu7HUZ6iydY\": 0.5, \"SmJG3rH2ZzYQ9ojxhbRCPwFiE9y6pD1Co\": 0.5}}"}
}
重要
注意应有文件data/acl/addrs。
// addr
XC1111111111111111@xuper/TeyyPLpp9L7QAcxHangtcHTu7HUZ6iydY
XC1111111111111111@xuper/SmJG3rH2ZzYQ9ojxhbRCPwFiE9y6pD1Co
更改候选人集合的命令行如下,增删改全部仅使用一个方法editValidates。该方法走多签流程。
1 2 3 4 5 6 7 8 9 | ./bin/xchain-cli consensus invoke --type xpoa --method editValidates --isMulti --account ${ACL_ACCOUNT} --fee ${1000_IF_NEED} --desc ${EDIT_FILE} -H:${PORT}
// 后续会生成一个tx.out在当前目录。
// 注意需要在建立/data/acl/addrs,标明ACL账户信息。
./bin/xchain-cli multisig sign --tx=./tx.out --output=./key1.sign
./bin/xchain-cli multisig sign --tx=./tx.out --keys ${acl keys地址} --output=./key2.sign
./bin/xchain-cli multisig send --tx ./tx.out ./key1.sign,./key2.sign ./key1.sign,./key2.sign -H:${PORT}
// 成功后会生成txid
|
具体edit_file示例如下。
1 2 3 4 | // edit_file
{
"validates":"TeyyPLpp9L7QAcxHangtcHTu7HUZ6iydY;SmJG3rH2ZzYQ9ojxhbRCPwFiE9y6pD1Co;iYjtLcW6SVCiousAb5DFKWtWroahhEj4u"
}
|