基本跨链操作¶
以一个基本的以太坊和fabric之间的跨链为例，其中bitxhub和pier均以二进制方式启动。
在进行跨链操作前，需要先安装好goduck并完成初始化
1 启动应用链¶
1.1 启动以太坊¶
1.1.1启动以太坊镜像¶
我们提供了以太坊镜像，使用如下goduck命令可以一键启动：
$ goduck ether start
exec: /bin/bash ethereum.sh docker 8545 8546 30303 1.2.0
start a new ethereum-node container
e6688e08332e3ccb808b5e027b14c611ca914e34540ef120fc576586010a104b
start ethereum private chain with data directory in $goduck_repo/ethereum/datadir.
1.1.2 部署以太坊智能合约¶
在以太坊镜像中部署broker和transfer智能合约，示例如下
#部署broker_data合约
goduck ether contract deploy --code-path $HOME/goduck/scripts/example/broker_data.sol "["0x20f7fac801c5fc3f7e20cfbadaa1cdb33d818fa3"]^1"
======= #HOME/goduck/scripts/example/broker_data.sol:BrokerData =======
Deployed contract address is 0x857133c5C69e6Ce66F7AD46F200B9B3573e77582
Contract JSON ABI
[{"inputs":[{"internalType":"string","name":"_bitxhubID","type":"string"},{"internalType":"string","name":"_appchainID","type":"string"},{"internalType":"address[]","name":"_validators","type":"address[]"},{"internalType":"uint64","name":"_valThreshold","type":"uint64"},{"internalType":"address[]","name":"_admins","type":"address[]"},{"internalType":"uint64","name":"_adminThreshold","type":"uint64"}],"stateMutability":"nonpayable","type":"constructor"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint64","name":"index","type":"uint64"},{"indexed":false,"internalType":"string","name":"dstFullID","type":"string"},{"indexed":false,"internalType":"string","name":"srcFullID","type":"string"},{"indexed":false,"internalType":"string","name":"func","type":"string"},{"indexed":false,"internalType":"bytes[]","name":"args","type":"bytes[]"},{"indexed":false,"internalType":"bytes32","name":"hash","type":"bytes32"}],"name":"throwInterchainEvent","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint64","name":"index","type":"uint64"},{"indexed":false,"internalType":"string","name":"dstFullID","type":"string"},{"indexed":false,"internalType":"string","name":"srcFullID","type":"string"},{"indexed":false,"internalType":"uint64","name":"typ","type":"uint64"},{"indexed":false,"internalType":"bool","name":"status","type":"bool"},{"indexed":false,"internalType":"bytes[]","name":"result","type":"bytes[]"},{"indexed":false,"internalType":"bytes32","name":"hash","type":"bytes32"}],"name":"throwReceiptEvent","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bool","name":"","type":"bool"}],"name":"throwReceiptStatus","type":"event"},{"inputs":[{"internalType":"address","name":"addr","type":"address"},{"internalType":"int64","name":"status","type":"int64"}],"name":"audit","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"destFullServiceID","type":"string"},{"internalType":"string","name":"funcCall","type":"string"},{"internalType":"bytes[]","name":"args","type":"bytes[]"},{"internalType":"string","name":"funcCb","type":"string"},{"internalType":"bytes[]","name":"argsCb","type":"bytes[]"},{"internalType":"string","name":"funcRb","type":"string"},{"internalType":"bytes[]","name":"argsRb","type":"bytes[]"},{"internalType":"bool","name":"isEncrypt","type":"bool"}],"name":"emitInterchainEvent","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"chainID","type":"string"}],"name":"getAppchainInfo","outputs":[{"internalType":"string","name":"","type":"string"},{"internalType":"bytes","name":"","type":"bytes"},{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getCallbackMeta","outputs":[{"internalType":"string[]","name":"","type":"string[]"},{"internalType":"uint64[]","name":"","type":"uint64[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getChainID","outputs":[{"internalType":"string","name":"","type":"string"},{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"id","type":"string"}],"name":"getDirectTransactionMeta","outputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"uint64","name":"","type":"uint64"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getDstRollbackMeta","outputs":[{"internalType":"string[]","name":"","type":"string[]"},{"internalType":"uint64[]","name":"","type":"uint64[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getInnerMeta","outputs":[{"internalType":"string[]","name":"","type":"string[]"},{"internalType":"uint64[]","name":"","type":"uint64[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getLocalServiceList","outputs":[{"internalType":"string[]","name":"","type":"string[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"addr","type":"address"}],"name":"getLocalWhiteList","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"outServicePair","type":"string"},{"internalType":"uint64","name":"idx","type":"uint64"}],"name":"getOutMessage","outputs":[{"internalType":"string","name":"","type":"string"},{"internalType":"bytes[]","name":"","type":"bytes[]"},{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getOuterMeta","outputs":[{"internalType":"string[]","name":"","type":"string[]"},{"internalType":"uint64[]","name":"","type":"uint64[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"remoteAddr","type":"string"}],"name":"getRSWhiteList","outputs":[{"internalType":"address[]","name":"","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"inServicePair","type":"string"},{"internalType":"uint64","name":"idx","type":"uint64"}],"name":"getReceiptMessage","outputs":[{"internalType":"bytes[]","name":"","type":"bytes[]"},{"internalType":"uint64","name":"","type":"uint64"},{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getRemoteServiceList","outputs":[{"internalType":"string[]","name":"","type":"string[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"srcFullID","type":"string"},{"internalType":"string","name":"destAddr","type":"string"},{"internalType":"uint64","name":"index","type":"uint64"},{"internalType":"uint64","name":"typ","type":"uint64"},{"internalType":"string","name":"callFunc","type":"string"},{"internalType":"bytes[]","name":"args","type":"bytes[]"},{"internalType":"uint64","name":"txStatus","type":"uint64"},{"internalType":"bytes[]","name":"signatures","type":"bytes[]"},{"internalType":"bool","name":"isEncrypt","type":"bool"}],"name":"invokeInterchain","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"string","name":"srcAddr","type":"string"},{"internalType":"string","name":"dstFullID","type":"string"},{"internalType":"uint64","name":"index","type":"uint64"},{"internalType":"uint64","name":"typ","type":"uint64"},{"internalType":"bytes[]","name":"result","type":"bytes[]"},{"internalType":"uint64","name":"txStatus","type":"uint64"},{"internalType":"bytes[]","name":"signatures","type":"bytes[]"}],"name":"invokeReceipt","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"register","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"chainID","type":"string"},{"internalType":"string","name":"broker","type":"string"},{"internalType":"address","name":"ruleAddr","type":"address"},{"internalType":"bytes","name":"trustRoot","type":"bytes"}],"name":"registerAppchain","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"registerDirectTransaction","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"chainID","type":"string"},{"internalType":"string","name":"serviceID","type":"string"},{"internalType":"address[]","name":"whiteList","type":"address[]"}],"name":"registerRemoteService","outputs":[],"stateMutability":"nonpayable","type":"function"}]
#记录broker_data合约地址，后续部署broker合约、transfer合约以及调用合约时需要使用
#部署broker合约
goduck ether contract deploy --code-path $HOME/goduck/scripts/example/broker.sol "1356^ethappchain1^["0xc7F999b83Af6DF9e67d0a37Ee7e900bF38b3D013","0x79a1215469FaB6f9c63c1816b45183AD3624bE34","0x97c8B516D19edBf575D72a172Af7F418BE498C37","0xc0Ff2e0b3189132D815b8eb325bE17285AC898f8"]^1^["0x20f7fac801c5fc3f7e20cfbadaa1cdb33d818fa3"]^1^0x857133c5C69e6Ce66F7AD46F200B9B3573e77582"
======= #HOME/goduck/scripts/example/broker.sol:Broker =======
Deployed contract address is 0x30c5D3aeb4681af4D13384DBc2a717C51cb1cc11
Contract JSON ABI
[{"inputs":[{"internalType":"string","name":"_bitxhubID","type":"string"},{"internalType":"string","name":"_appchainID","type":"string"},{"internalType":"address[]","name":"_validators","type":"address[]"},{"internalType":"uint64","name":"_valThreshold","type":"uint64"},{"internalType":"address[]","name":"_admins","type":"address[]"},{"internalType":"uint64","name":"_adminThreshold","type":"uint64"},{"internalType":"address","name":"_dataAddr","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint64","name":"index","type":"uint64"},{"indexed":false,"internalType":"string","name":"dstFullID","type":"string"},{"indexed":false,"internalType":"string","name":"srcFullID","type":"string"},{"indexed":false,"internalType":"string","name":"func","type":"string"},{"indexed":false,"internalType":"bytes[]","name":"args","type":"bytes[]"},{"indexed":false,"internalType":"bytes32","name":"hash","type":"bytes32"},{"indexed":false,"internalType":"string[]","name":"group","type":"string[]"}],"name":"throwInterchainEvent","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint64","name":"index","type":"uint64"},{"indexed":false,"internalType":"string","name":"dstFullID","type":"string"},{"indexed":false,"internalType":"string","name":"srcFullID","type":"string"},{"indexed":false,"internalType":"uint64","name":"typ","type":"uint64"},{"indexed":false,"internalType":"bytes[][]","name":"results","type":"bytes[][]"},{"indexed":false,"internalType":"bytes32","name":"hash","type":"bytes32"},{"indexed":false,"internalType":"bool[]","name":"multiStatus","type":"bool[]"}],"name":"throwReceiptEvent","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bool","name":"","type":"bool"}],"name":"throwReceiptStatus","type":"event"},{"inputs":[],"name":"adminThreshold","outputs":[{"internalType":"uint64","name":"","type":"uint64"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"admins","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"addr","type":"address"},{"internalType":"int64","name":"status","type":"int64"}],"name":"audit","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"destFullServiceID","type":"string"},{"internalType":"string","name":"funcCall","type":"string"},{"internalType":"bytes[]","name":"args","type":"bytes[]"},{"internalType":"string","name":"funcCb","type":"string"},{"internalType":"bytes[]","name":"argsCb","type":"bytes[]"},{"internalType":"string","name":"funcRb","type":"string"},{"internalType":"bytes[]","name":"argsRb","type":"bytes[]"},{"internalType":"bool","name":"isEncrypt","type":"bool"},{"internalType":"string[]","name":"group","type":"string[]"}],"name":"emitInterchainEvent","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"getCallbackMeta","outputs":[{"internalType":"string[]","name":"","type":"string[]"},{"internalType":"uint64[]","name":"","type":"uint64[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getChainID","outputs":[{"internalType":"string","name":"","type":"string"},{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getDstRollbackMeta","outputs":[{"internalType":"string[]","name":"","type":"string[]"},{"internalType":"uint64[]","name":"","type":"uint64[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getInnerMeta","outputs":[{"internalType":"string[]","name":"","type":"string[]"},{"internalType":"uint64[]","name":"","type":"uint64[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getLocalServiceList","outputs":[{"internalType":"string[]","name":"","type":"string[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"addr","type":"address"}],"name":"getLocalWhiteList","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"outServicePair","type":"string"},{"internalType":"uint64","name":"idx","type":"uint64"}],"name":"getOutMessage","outputs":[{"internalType":"string","name":"","type":"string"},{"internalType":"bytes[]","name":"","type":"bytes[]"},{"internalType":"bool","name":"","type":"bool"},{"internalType":"string[]","name":"","type":"string[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getOuterMeta","outputs":[{"internalType":"string[]","name":"","type":"string[]"},{"internalType":"uint64[]","name":"","type":"uint64[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"inServicePair","type":"string"},{"internalType":"uint64","name":"idx","type":"uint64"}],"name":"getReceiptMessage","outputs":[{"internalType":"bytes[][]","name":"","type":"bytes[][]"},{"internalType":"uint64","name":"","type":"uint64"},{"internalType":"bool","name":"","type":"bool"},{"internalType":"bool[]","name":"","type":"bool[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"srcFullID","type":"string"},{"internalType":"string","name":"destAddr","type":"string"},{"internalType":"uint64","name":"index","type":"uint64"},{"internalType":"uint64","name":"typ","type":"uint64"},{"internalType":"string","name":"callFunc","type":"string"},{"internalType":"bytes[]","name":"args","type":"bytes[]"},{"internalType":"uint64","name":"txStatus","type":"uint64"},{"internalType":"bytes[]","name":"signatures","type":"bytes[]"},{"internalType":"bool","name":"isEncrypt","type":"bool"}],"name":"invokeInterchain","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"string[]","name":"srcFullID","type":"string[]"},{"internalType":"string[]","name":"destAddr","type":"string[]"},{"internalType":"uint64[]","name":"index","type":"uint64[]"},{"internalType":"uint64[]","name":"typ","type":"uint64[]"},{"internalType":"string[]","name":"callFunc","type":"string[]"},{"internalType":"bytes[][]","name":"args","type":"bytes[][]"},{"internalType":"uint64[]","name":"txStatus","type":"uint64[]"},{"internalType":"bytes[][]","name":"signatures","type":"bytes[][]"},{"internalType":"bool[]","name":"isEncrypt","type":"bool[]"}],"name":"invokeInterchains","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"string","name":"srcFullID","type":"string"},{"internalType":"string","name":"destAddr","type":"string"},{"internalType":"uint64","name":"index","type":"uint64"},{"internalType":"uint64","name":"typ","type":"uint64"},{"internalType":"string","name":"callFunc","type":"string"},{"internalType":"bytes[][]","name":"args","type":"bytes[][]"},{"internalType":"uint64","name":"txStatus","type":"uint64"},{"internalType":"bytes[]","name":"signatures","type":"bytes[]"},{"internalType":"bool","name":"isEncrypt","type":"bool"}],"name":"invokeMultiInterchain","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"string","name":"srcAddr","type":"string"},{"internalType":"string","name":"dstFullID","type":"string"},{"internalType":"uint64","name":"index","type":"uint64"},{"internalType":"uint64","name":"typ","type":"uint64"},{"internalType":"bytes[][]","name":"results","type":"bytes[][]"},{"internalType":"bool[]","name":"multiStatus","type":"bool[]"},{"internalType":"uint64","name":"txStatus","type":"uint64"},{"internalType":"bytes[]","name":"signatures","type":"bytes[]"}],"name":"invokeMultiReceipt","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"string","name":"srcAddr","type":"string"},{"internalType":"string","name":"dstFullID","type":"string"},{"internalType":"uint64","name":"index","type":"uint64"},{"internalType":"uint64","name":"typ","type":"uint64"},{"internalType":"bytes[][]","name":"results","type":"bytes[][]"},{"internalType":"uint64","name":"txStatus","type":"uint64"},{"internalType":"bytes[]","name":"signatures","type":"bytes[]"}],"name":"invokeReceipt","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"bool","name":"ordered","type":"bool"}],"name":"register","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"_admins","type":"address[]"},{"internalType":"uint64","name":"_adminThreshold","type":"uint64"}],"name":"setAdmins","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"_validators","type":"address[]"},{"internalType":"uint64","name":"_valThreshold","type":"uint64"}],"name":"setValidators","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"valThreshold","outputs":[{"internalType":"uint64","name":"","type":"uint64"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"validators","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"}]
#部署transfer合约
goduck ether contract deploy --code-path $HOME/goduck/scripts/example/transfer.sol "0x30c5D3aeb4681af4D13384DBc2a717C51cb1cc11^true"
======= #HOME/goduck/scripts/example/transfer.sol:Transfer =======
Deployed contract address is 0xe95C4c9D9DFeAdC8aD80F87de3F36476DcDdE9F4
Contract JSON ABI
[{"inputs":[{"internalType":"address","name":"_brokerAddr","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[{"internalType":"bytes","name":"b","type":"bytes"}],"name":"bytesToUint64","outputs":[{"internalType":"uint64","name":"","type":"uint64"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"string","name":"id","type":"string"}],"name":"getBalance","outputs":[{"internalType":"uint64","name":"","type":"uint64"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes[]","name":"args","type":"bytes[]"},{"internalType":"bool","name":"isRollback","type":"bool"}],"name":"interchainCharge","outputs":[{"internalType":"bytes[]","name":"","type":"bytes[]"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes[]","name":"args","type":"bytes[]"}],"name":"interchainRollback","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"register","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"id","type":"string"},{"internalType":"uint64","name":"amount","type":"uint64"}],"name":"setBalance","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"destChainServiceID","type":"string"},{"internalType":"string","name":"sender","type":"string"},{"internalType":"string","name":"receiver","type":"string"},{"internalType":"uint64","name":"amount","type":"uint64"}],"name":"transfer","outputs":[],"stateMutability":"nonpayable","type":"function"}]
#记录transfer合约地址，后续调用合约函数时需要使用
1.1.3 合约审计¶
目前broker合约部署完成后需要在broker_data中对其进行审核，示例如下
#审计broker合约
goduck ether contract invoke --key-path $HOME/goduck/scripts/docker/quick_start/account.key --abi-path $HOME/goduck/scripts/example/broker_data.abi --address http://localhost:8545 0x857133c5C69e6Ce66F7AD46F200B9B3573e77582 audit "0x30c5D3aeb4681af4D13384DBc2a717C51cb1cc11^1"
======= invoke function audit =======
invoke contract success, tx hash is: 0x25d67f98d36a60e908f1d8e60c76adc413a379187c83b4ba5cea7f67f81c6b14
此外，transfer部署完成后需要在broker合约中对其进行审核，示例如下
#审核transfer合约
goduck ether contract invoke --key-path $HOME/goduck/scripts/docker/quick_start/account.key --abi-path $HOME/goduck/scripts/example/broker.abi --address http://localhost:8545 0x30c5D3aeb4681af4D13384DBc2a717C51cb1cc11 audit "0xe95C4c9D9DFeAdC8aD80F87de3F36476DcDdE9F4^1"
======= invoke function audit =======
invoke contract success, tx hash is: 0x985961e3dd23cc47d964d6840af00ba2c2aaa8b4f9ba039bd36c92e6bc6e2c36
1.2 启动fabric¶
1.2.1 启动fabric应用链¶
$ goduck fabric start
# 启动成功后最后的日志打印如下：
...
========= All GOOD, BYFN execution completed ===========
_____ _ _ ____
| ____| | \ | | | _ \
| _| | \| | | | | |
| |___ | |\ | | |_| |
|_____| |_| \_| |____/
⚠️ 启动过程中可能需要科学上网。如果出现报错或fabric-samples下载失败，建议删除fabric-samples文件，重新执行fabric启动命令。
1.2.2 部署跨链合约¶
我们会提供已经准备好的fabric跨链合约contract文件，但部署时需要注明需要跨链的bitxhub版本，因为不同版本的bitxhub对应的跨链合约可能有查别。
执行以下命令可以直接下载相应版本合约并部署：
goduck fabric contract chaincode --bxh-version v2.8.0
# 部署成功后会依次打印出几个步骤的日志，日志中有部分报错不影响，只要没有红色报错，且能大致打印出以下日志即可：
install default interchain chaincode
===> Install chaincode
===> 1. Deploying broker, transfer and data_swapper chaincode
Installing chaincode broker on org[org2] peers:
-- grpcs://localhost:9051
-- grpcs://localhost:10051
...successfuly installed chaincode broker.v0 on peer localhost:10051.
...successfuly installed chaincode broker.v0 on peer localhost:9051.
...successfuly instantiated chaincode broker on channel mychannel.
Installing chaincode transfer on org[org2] peers:
-- grpcs://localhost:9051
-- grpcs://localhost:10051
...successfuly installed chaincode transfer.v0 on peer localhost:10051.
...successfuly installed chaincode transfer.v0 on peer localhost:9051.
...successfuly instantiated chaincode transfer on channel mychannel.
Installing chaincode data_swapper on org[org2] peers:
-- grpcs://localhost:9051
-- grpcs://localhost:10051
...successfuly installed chaincode data_swapper.v0 on peer localhost:10051.
...successfuly installed chaincode data_swapper.v0 on peer localhost:9051.
...successfuly instantiated chaincode data_swapper on channel mychannel.
===> 2. Set Alice 10000 amout in transfer chaincode
****************************************************************************************************
***** | Response[0]:
***** | | Payload:
***** | Response[1]:
***** | | Payload:
****************************************************************************************************
===> 3. Set (key: path, value: /Users/xxx/.goduck) in data_swapper chaincode
****************************************************************************************************
***** | Response[0]:
***** | | Payload:
***** | Response[1]:
***** | | Payload:
****************************************************************************************************
===> 4. Register transfer and data_swapper chaincode to broker chaincode
****************************************************************************************************
***** | Response[0]:
***** | | Payload: mychannel&transfer
***** | Response[1]:
***** | | Payload: mychannel&transfer
****************************************************************************************************
****************************************************************************************************
***** | Response[0]:
***** | | Payload: mychannel&data_swapper
***** | Response[1]:
***** | | Payload: mychannel&data_swapper
****************************************************************************************************
===> 6. Audit transfer and data_swapper chaincode
****************************************************************************************************
***** | Response[0]:
***** | | Payload: set status of chaincode mychannel&transfer to 1
***** | Response[1]:
***** | | Payload: set status of chaincode mychannel&transfer to 1
****************************************************************************************************
****************************************************************************************************
***** | Response[0]:
***** | | Payload: set status of chaincode mychannel&data_swapper to 1
***** | Response[1]:
***** | | Payload: set status of chaincode mychannel&data_swapper to 1
****************************************************************************************************
2 启动bitxhub¶
goduck bitxhub start
======> Start bitxhub cluster
Start bitxhub node1
Start bitxhub node2
Start bitxhub node3
Start bitxhub node4
You can use the "goduck status list" command to check the status of the startup BitXHub node.
3 启动pier¶
3.1 启动连接以太坊的pier¶
3.1.1 启动pier¶
goduck pier start
======> Generate configuration files for pier_ethereum
【1】generate configuration files
【2】copy pier plugin and appchain config
======> Rewrite config for pier_ethereum
【1】rewrite pier.toml
【2】rewrite appchain config
【3】rewrite api
======> Start pier of ethereum in binary...
You can use the "goduck status list" command to check the status of the startup pier.
3.1.2 注册应用链以及服务¶
第一步：确保账户有钱
注册应用链之前，首先需要保证应用链管理员有注册应用链的权限，即账户有钱，可以由中继链管理员给应用链管理员转账。
这一部分不属于goduck功能，可以使用bitxhub命令行实现，示例如下：
#查看网关id
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub key show --path $HOME/.goduck/pier/.pier_ethereum/key.json
private key: d8aec60d5b0876485939b2ebce3274439d0bd6a271c9314ed8db55ffbe7493fd
public key: 04e843e60dda3b1c5a989199d55719eff84988c8577bd54f5c9d6e51572fcbc14af754a924c941ce2a37caf96bdc9ceb23f5ad6e547945205ffbe3f6d4dd5b8d9a
address: 0xCb4B1B4b6849151D92C84123ADC8da8c64F987ea
#记录下网关账户地址以便后续使用
#中继链转账
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub client transfer --key $HOME/.goduck/bitxhub/.bitxhub/node1/key.json --to 0xCb4B1B4b6849151D92C84123ADC8da8c64F987ea --amount 100000000000000000
{"tx_hash":"0xB86a421169Fa30AC19Dad443E34E91Cd4bcBF80D21DF35CA4c5d5239AC57fA0B"}
#余额查询
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub client account --address 0xCb4B1B4b6849151D92C84123ADC8da8c64F987ea
{
"type": "normal",
"balance": 100000000000000000,
"contract_count": 0,
"code_hash": "0x0000000000000000000000000000000000000000000000000000000000000000"
}
第二步：提交注册提案 确保账户有钱后，即可进行应用链注册操作，示例如下：
#将编译后的2.8.0版本pier二进制文件拷贝到pier生成目录 并切换到对应位置
cp $HOME/.goduck/bin/pier_darwin_v2.8.0/pier $HOME/.goduck/pier/.pier_ethereum/
cd $HOME/.goduck/pier/.pier_ethereum/
#网关执行应用链注册操作
pier --repo ./ appchain register --appchain-id "ethappchain1" --name "eth1" --type "ETH" --trustroot $HOME/.goduck/pier/.pier_ethereum/ethereum/ether.validators --broker 0x857133c5C69e6Ce66F7AD46F200B9B3573e77582 --desc "desc" --master-rule "0x00000000000000000000000000000000000000a2" --rule-url "http://github.com" --admin 0xCb4B1B4b6849151D92C84123ADC8da8c64F987ea --reason "reason"
#应用链注册成功，等待投票提案通过
Register appchain successfully, wait for proposal 0xCb4B1B4b6849151D92C84123ADC8da8c64F987ea-0 to finish.
注册提案提交后需要进行投票，投票部分不属于goduck的功能，可以使用bitxhub命令行实现，示例如下：
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub --repo $HOME/.goduck/bitxhub/.bitxhub/node1 client governance vote --id 0xCb4B1B4b6849151D92C84123ADC8da8c64F987ea-0 --info approve --reason reason
vote successfully!
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub --repo $HOME/.goduck/bitxhub/.bitxhub/node2 client governance vote --id 0xCb4B1B4b6849151D92C84123ADC8da8c64F987ea-0 --info approve --reason reason
vote successfully!
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub --repo $HOME/.goduck/bitxhub/.bitxhub/node3 client governance vote --id 0xCb4B1B4b6849151D92C84123ADC8da8c64F987ea-0 --info approve --reason reason
vote successfully!
完成投票提案后查看应用链状态
#根据应用链名称查询状态
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub --repo $HOME/.goduck/bitxhub/.bitxhub/node1 client governance appchain info --name "eth1"
Id Name Type Broker Status Desc Version
-- ---- ---- ------ ------ ---- -------
ethappchain1 eth1 ETH 0x857133c5C69e6Ce66F7AD46F200B9B3573e77582 available desc 0
#根据应用链Id查询状态
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub --repo $HOME/.goduck/bitxhub/.bitxhub/node1 client governance appchain status --id "ethappchain1"
appchain ethappchain1 is available
#网关向中继链注册服务
pier --repo ./ appchain service register --appchain-id "ethappchain1" --service-id "0xe95C4c9D9DFeAdC8aD80F87de3F36476DcDdE9F4" --name "ethService" --intro "" --type CallContract --permit "" --details "test"--reason "reason" --ordered "1"
Register appchain service for ethappchain1:0xe95C4c9D9DFeAdC8aD80F87de3F36476DcDdE9F4 successfully, wait for proposal 0xCb4B1B4b6849151D92C84123ADC8da8c64F987ea-1 to finish.
第五步：服务提案投票通过 投票过程同第三步，示例如下
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub --repo $HOME/.goduck/bitxhub/.bitxhub/node1 client governance vote --id 0xCb4B1B4b6849151D92C84123ADC8da8c64F987ea-1 --info approve --reason reason
vote successfully!
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub --repo $HOME/.goduck/bitxhub/.bitxhub/node2 client governance vote --id 0xCb4B1B4b6849151D92C84123ADC8da8c64F987ea-1 --info approve --reason reason
vote successfully!
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub --repo $HOME/.goduck/bitxhub/.bitxhub/node3 client governance vote --id 0xCb4B1B4b6849151D92C84123ADC8da8c64F987ea-1 --info approve --reason reason
vote successfully!
完成投票提案后查看服务状态
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub --repo $HOME/.goduck/bitxhub/.bitxhub/node1 client governance service status --id "ethappchain1:0xe95C4c9D9DFeAdC8aD80F87de3F36476DcDdE9F4"
service ethappchain1:0xe95C4c9D9DFeAdC8aD80F87de3F36476DcDdE9F4 is available, Available is true
3.1.3 启动pier¶
成功注册应用链后pier启动即将准备完成。 在启动pier之前将pier连接的broker地址更新为部署的合约地址
cd $HOME/.goduck/pier/.pier_ethereum/ethereum
# 修改ethereum.toml文件为
[ether]
addr = "ws://127.0.0.1:8546"
name = "ether"
contract_address = "0x30c5D3aeb4681af4D13384DBc2a717C51cb1cc11"
key_path = "account.key"
password = "password"
min_confirm = 0
我们可以在对应路径下启动pier
# 注意需要指定pier的启动目录，默认是$HOME/.goduck/pier/.pier_ethereum
cd $HOME/.goduck/pier/.pier_ethereum
pier --repo ./ start
# pier网关执行结果如下
2023-02-06T15:02:08.419+0800 [DEBUG] plugin.sh: 2023-02-06T15:02:08.419+0800 [INFO] client: Consumer started
INFO[2023-02-06T15:02:08.419] appchain adapter start module=appchain_adapter
INFO[2023-02-06T15:02:08.420] BxhAdapter started module=bxh_adapter
INFO[2023-02-06T15:02:08.446] get appchain all services module=exchanger serviveIdList="[1356:ethappchain1:0xe95C4c9D9DFeAdC8aD80F87de3F36476DcDdE9F4]"
INFO[2023-02-06T15:02:08.473] get bitxhub all services destServiceList="[1356:ethappchain1:0xe95C4c9D9DFeAdC8aD80F87de3F36476DcDdE9F4]" module=exchanger
INFO[2023-02-06T15:02:08.500] Start To Recover IBTPs! module=exchanger
INFO[2023-02-06T15:02:08.500] start init pool interchain="&{1356:ethappchain1:0xe95C4c9D9DFeAdC8aD80F87de3F36476DcDdE9F4 map[] map[] map[] map[]}" module=exchanger serviceID="1356:ethappchain1:0xe95C4c9D9DFeAdC8aD80F87de3F36476DcDdE9F4" srcChainId=fabappchain
INFO[2023-02-06T15:02:08.501] End To Recover IBTPs! module=exchanger
INFO[2023-02-06T15:02:08.501] Exchanger started module=exchanger
INFO[2023-02-06T15:02:08.501] listenIBTPFromDestAdaptToServicePairCh bitxhub:1356 Start! module=exchanger
INFO[2023-02-06T15:02:08.501] listenIBTPFromSrcAdaptToServicePairCh appchain:ethappchain1 Start! module=exchanger
3.2 启动连接fabric的pier¶
3.2.1 启动pier¶
#复制出一份新的pier配置文件
cp $HOME/.goduck/pier_config/v2.8.0/pier_modify_config.toml $HOME/.goduck/pier_config/v2.8.0/pier_modify_config1.toml
#修改网关端口配置
vim $HOME/.goduck/pier_config/v2.8.0/pier_modify_config1.toml
httpPort = 44564
pprofPort = 44560
apiPort = 8081
goduck pier start --version v2.8.0 --appchain fabric --configPath $HOME/.goduck/pier_config/v2.8.0/pier_modify_config1.toml
======> Generate configuration files for pier_fabric
【1】generate configuration files
【2】copy pier plugin and appchain config
======> Rewrite config for pier_fabric
【1】rewrite pier.toml
【2】rewrite appchain config
【3】rewrite api
======> Start pier of fabric in binary...
You can use the "goduck status list" command to check the status of the startup pier.
3.2.2 注册应用链以及服务¶
第一步：确保账户有钱
注册应用链之前，首先需要保证应用链管理员有注册应用链的权限，即账户有钱，可以由中继链管理员给应用链管理员转账。
这一部分不属于goduck功能，可以使用bitxhub命令行实现，示例如下：
#查看网关id
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub key show --path $HOME/.goduck/pier/.pier_fabric/key.json
private key: 8e750da155fc552edc6ac452cdb0935129b4530742747f296ef590e72a87a6f7
public key: 041917c8f6f580aec999fcaf79772c3160874be46ebfbe9346226e77d19f8563d2409b213c8ebd2c17096adb7a5f8529417cc7f0fe53b82a055396f971ad54bc25
address: 0x509DB883eA1D037C05313F8Ba5244575C40CE9e0
#中继链转账
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub client transfer --key $HOME/.goduck/bitxhub/.bitxhub/node1/key.json --to 0x509DB883eA1D037C05313F8Ba5244575C40CE9e0 --amount 100000000000000000
{"tx_hash":"0xa80A372D7eAEF1985d6ef5c9F4D93dbfedf92136aDa5568202B02Fd6200ac6B0"}
#余额查询
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub client account --address 0x509DB883eA1D037C05313F8Ba5244575C40CE9e0
{
"type": "normal",
"balance": 100000000000000000,
"contract_count": 0,
"code_hash": "0x0000000000000000000000000000000000000000000000000000000000000000"
}
第二步：提交注册提案
#将编译后的2.8.0版本pier二进制文件拷贝到pier生成目录 并切换到对应位置
cp $HOME/.goduck/bin/pier_darwin_v2.8.0/pier $HOME/.goduck/pier/.pier_fabric/
cd $HOME/.goduck/pier/.pier_fabric/
#网关执行应用链注册操作
pier --repo ./ appchain register --appchain-id "appchain1" --name "fabric1" --type "Fabric V1.4.3" --trustroot $HOME/.goduck/pier/.pier_fabric/fabric/fabric.validators --broker-cid mychanncel --broker-ccid broker --broker-v 1 --desc "desc" --master-rule "0x00000000000000000000000000000000000000a2" --rule-url "http://github.com" --admin 0x509DB883eA1D037C05313F8Ba5244575C40CE9e0 --reason "reason"
#应用链注册成功，等待投票提案通过
Register appchain successfully, wait for proposal 0x509DB883eA1D037C05313F8Ba5244575C40CE9e0-0 to finish.
第三步：提案投票通过
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub --repo $HOME/.goduck/bitxhub/.bitxhub/node1 client governance vote --id 0x509DB883eA1D037C05313F8Ba5244575C40CE9e0-0 --info approve --reason reason
vote successfully!
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub --repo $HOME/.goduck/bitxhub/.bitxhub/node2 client governance vote --id 0x509DB883eA1D037C05313F8Ba5244575C40CE9e0-0 --info approve --reason reason
vote successfully!
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub --repo $HOME/.goduck/bitxhub/.bitxhub/node3 client governance vote --id 0x509DB883eA1D037C05313F8Ba5244575C40CE9e0-0 --info approve --reason reason
vote successfully!
完成投票提案后查看应用链状态
#根据应用链名称查询状态
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub --repo $HOME/.goduck/bitxhub/.bitxhub/node1 client governance appchain info --name "fabric1"
Id Name Type Broker Status Desc Version
-- ---- ---- ------ ------ ---- -------
fabricappchain1 fabric1 Fabric V1.4.3 {"channel_id":"mychanncel","chaincode_id":"broker","broker_version":"1"} available desc 0
#根据应用链Id查询状态
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub --repo $HOME/.goduck/bitxhub/.bitxhub/node1 client governance appchain status --id "appchain1"
appchain appchain1 is available
第四步：提交注册服务提案 完成应用链注册后，即可对应用链服务进行注册操作，示例如下
#网关向中继链注册服务
pier --repo ./ appchain service register --appchain-id "appchain1" --service-id "mychannel&transfer" --name "fabServer1" --intro "" --type CallContract --permit "" --details "test"--reason "reason" --ordered "1"
Register appchain service for fabricappchain1:mychannel&transfer successfully, wait for proposal 0x509DB883eA1D037C05313F8Ba5244575C40CE9e0-1 to finish.
第五步：服务提案投票通过 投票过程同第三步，示例如下
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub --repo $HOME/.goduck/bitxhub/.bitxhub/node1 client governance vote --id 0x509DB883eA1D037C05313F8Ba5244575C40CE9e0-1 --info approve --reason reason
vote successfully!
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub --repo $HOME/.goduck/bitxhub/.bitxhub/node2 client governance vote --id 0x509DB883eA1D037C05313F8Ba5244575C40CE9e0-1 --info approve --reason reason
vote successfully!
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub --repo $HOME/.goduck/bitxhub/.bitxhub/node3 client governance vote --id 0x509DB883eA1D037C05313F8Ba5244575C40CE9e0-1 --info approve --reason reason
vote successfully!
完成投票提案后查看服务状态
$HOME/.goduck/bin/bitxhub_darwin_v2.8.0/bitxhub --repo $HOME/.goduck/bitxhub/.bitxhub/node1 client governance service status --id "appchain1:mychannel&transfer"
service appchain1:mychannel&transfer is available, Available is true
3.2.3 启动pier¶
成功注册应用链后pier启动即准备完成。
我们可以在对应路径下启动pier
# 注意需要指定pier的启动目录，默认是$HOME/.goduck/pier/.pier_fabric
cd $HOME/.goduck/pier/.pier_fabric
pier --repo ./ start
# pier网关执行结果如下
2023-02-06T15:23:01.384+0800 [DEBUG] plugin.sh: 2023-02-06T15:23:01.384+0800 [INFO ] client: Fabric consumer started
INFO[2023-02-06T15:23:01.384] appchain adapter start module=appchain_adapter
INFO[2023-02-06T15:23:01.385] BxhAdapter started module=bxh_adapter
INFO[2023-02-06T15:23:01.416] get appchain all services module=exchanger serviveIdList="[1356:appchain1:mychannel&data_swapper 1356:appchain1:mychannel&transfer]"
INFO[2023-02-06T15:23:01.492] get bitxhub all services destServiceList="[1356:appchain1:mychannel&transfer]" module=exchanger
INFO[2023-02-06T15:23:01.522] Start To Recover IBTPs! module=exchanger
INFO[2023-02-06T15:23:01.522] start init pool interchain="&{1356:appchain1:mychannel&transfer map[] map[] map[] map[]}" module=exchanger serviceID="1356:appchain1:mychannel&transfer" srcChainId=fabappchain
INFO[2023-02-06T15:23:01.523] End To Recover IBTPs! module=exchanger
INFO[2023-02-06T15:23:01.523] Exchanger started module=exchanger
INFO[2023-02-06T15:23:01.523] listenIBTPFromSrcAdaptToServicePairCh appchain:appchain1 Start! module=exchanger
INFO[2023-02-06T15:23:01.523] listenIBTPFromDestAdaptToServicePairCh bitxhub:1356 Start! module=exchanger
4 跨链交易¶
#以太坊上Alice余额设置为10000
goduck ether contract invoke --key-path $HOME/goduck/scripts/docker/quick_start/account.key --address http://localhost:8545 --abi-path $HOME/goduck/scripts/example/transfer.abi 0xe95C4c9D9DFeAdC8aD80F87de3F36476DcDdE9F4 setBalance Alice^10000
======= invoke function setBalance =======
invoke contract success, tx hash is: 0x14bc0f20b75e128240336dcad1816168714807af33267594c3f16d5c2146af99
# 查询以太坊上Alice账户余额
goduck ether contract invoke --key-path $HOME/goduck/scripts/docker/quick_start/account.key --address http://localhost:8545 --abi-path $HOME/goduck/scripts/example/transfer.abi 0xe95C4c9D9DFeAdC8aD80F87de3F36476DcDdE9F4 getBalance Alice
======= invoke function getBalance =======
call result: 10000
# 查询fabric上Alice账户余额
goduck fabric contract invoke transfer getBalance Alice
[fabric] invoke function "getBalance", receipt is 10000
# 以太坊向Fabric转账
goduck ether contract invoke --key-path $HOME/goduck/scripts/docker/quick_start/account.key --address http://localhost:8545 --abi-path $HOME/goduck/scripts/example/transfer.abi 0xe95C4c9D9DFeAdC8aD80F87de3F36476DcDdE9F4 transfer "1356:appchain1:mychannel&transfer"^Alice^Alice^1000
======= invoke function transfer =======
invoke contract success, tx hash is: 0x0c1fb6d186d7827e1dc0545ff20e440c2c27357823ea1878aba653de1aed1248
# 查询以太坊上Alice账户余额
goduck ether contract invoke --key-path $HOME/goduck/scripts/docker/quick_start/account.key --address http://localhost:8545 --abi-path $HOME/goduck/scripts/example/transfer.abi 0xe95C4c9D9DFeAdC8aD80F87de3F36476DcDdE9F4 getBalance Alice
======= invoke function getBalance =======
call result: 9000
# 查询fabric上Alice账户余额
goduck fabric contract invoke transfer getBalance Alice
[fabric] invoke function "getBalance", receipt is 11000