1. 应用链跨链合约部署¶
当前步骤是要在应用链上部署跨链合约broker_direct、事务合约transaction和数据合约broker_data。
我们提供了针对不同应用链的跨链合约和事务合约，下面以Ethereum和Fabric为例进行介绍，其它类型的应用链部署跨链合约的步骤基本上是一致的。
Ethereum部署跨链合约¶
跨链合约broker_direct、事务合约transaction和数据合约broker_data可以在pier-client-ethereum项目的example目录下获取。
部署broker合约需要有构造参数，具体参数含义可以参考broker合约的说明。
transaction合约由broker调用，用以维护直连模式下注册服务与跨链交易的事务状态，部署时仅需传入broker合约地址
在Ethereum上部署合约的工具有很多，您可以使用Remix进行合约的编译和部署，也可以使用运维工具进行部署：
Step1：部署broker_data合约
在部署broker合约之前需要部署broker_data合约，broker_data合约构造参数如下：
-_ADMINS: 管理员的地址，一般使用部署合约的账户地址；
_ADMINTHRESHOLD：投票通过的最少应用链管理员数量，如果创建合约的账户只有1个，填入1。
Step2： 部署Broker合约
broker合约构造参数如下：
""^ethappchain^["0x20f7fac801c5fc3f7e20cfbadaa1cdb33d818fa3"]^1^0xFB2dedaDC34eE08De344BbB2344f4513b7be433F
-
_BITXHUBID：中继链的链id，因为直连模式没有中继链，所以这里置为空； -
_APPCHAINID：应用链在中继链上的链id，应与pier向中继链注册的链id一致； -
_ADMINS：管理员的地址，一般使用部署合约的账户地址； -
_ADMINTHRESHOLD：投票通过的最少应用链管理员数量，如果创建合约的账户只有1个，填入1，默认不变； -
_DATAADDR：broker_data合约地址，需要拷贝2.1步骤输出的地址。
Step3： broker_data合约审计broker合约
broker_data合约调用参数如下：
addr：broker合约地址status：合约审计状态，1代表通过，2代表不通过
Step4： 部署transaction合约
transaction合约构造参数如下
_BROKERADDR：为broker合约地址。
Step1：获取goduck工具（若已获取可跳过）
git clone https://github.com/meshplus/goduck.git
cd goduck && make install
# 初始化goduck配置
goduck init
Step2：部署broker_data合约
goduck ether contract deploy \
--address http://localhost:8545 \
--key-path account.key \
--psd-path password \
--code-path transaction.sol \
["0x20f7fac801c5fc3f7e20cfbadaa1cdb33d818fa3"]^1
# 0x20f7fac801c5fc3f7e20cfbadaa1cdb33d818fa3是管理员的地址，一般使用部署合约的账户地址
# 1是投票通过的最少应用链管理员数量，如果创建合约的账户只有1个，填入1
Step3：部署broker合约
# address指定以太坊地址
# key-path指定以太坊账户地址的私钥，goduck使用该账户进行合约部署，所以需要保证该账户有足够的gas费进行合约部署
# psd-path指定以太坊账户地址私钥的密码
# code-path指定broker.sol合约路径（在pier-client-ethereum/example目录下）
# 合约的构造参数通过"^"进行分割
# 注意!!!由于goduck采用远程编译的方式进行，需要确保以太坊所在服务器有对应的solitidy编译环境
goduck ether contract deploy \
--address http://localhost:8545 \
--key-path account.key \
--psd-path password \
--code-path broker.sol \
""^ethappchain^["0x20f7fac801c5fc3f7e20cfbadaa1cdb33d818fa3"]^1^0xFB2dedaDC34eE08De344BbB2344f4513b7be433F
# ""原本是中继链的链id，因为直连模式没有中继链，所以这里填空
# ethappchain是应用链在中继链上的链id
# ["0x20f7fac801c5fc3f7e20cfbadaa1cdb33d818fa3"]是管理员的地址，一般使用部署合约的账户地址
# 1是投票通过的最少应用链管理员数量，如果创建合约的账户只有1个，填入1
# 0xFB2dedaDC34eE08De344BbB2344f4513b7be433F是broker_data合约地址
Step4：部署transaction合约
goduck ether contract deploy \
--address http://localhost:8545 \
--key-path account.key \
--psd-path password \
--code-path transaction.sol \
"0x857133c5C69e6Ce66F7AD46F200B9B3573e77582"
# 0x857133c5C69e6Ce66F7AD46F200B9B3573e77582为broker合约地址
Step5：broker_data合约审计broker合约
```shell
# abi-path指定abi文件
# "0xFB2dedaDC34eE08De344BbB2344f4513b7be433F"为broker_data合约地址
# "0x857133c5C69e6Ce66F7AD46F200B9B3573e77582"^"1"是传入audit方法的参数，第一个参数为业务合约地址
goduck ether contract invoke \
--address http://localhost:8545 \
--key-path account.key \
--psd-path password \
--abi-path broker_data.abi \
"0xFB2dedaDC34eE08De344BbB2344f4513b7be433F" audit "0x857133c5C69e6Ce66F7AD46F200B9B3573e77582"^"1"
```
说明：部署broker合约后，需要 记住broker合约的地址 ，后续业务合约可能需要引用broker合约的地址，才能正确完成跨链调用。
Fabric部署跨链合约¶
broker合约以及transacrion合约可以在pier-client-fabric项目的example目录下获取。
Fabric部署合约可以使用fabric-cli，也可以使用运维工具：
Step1: 安装部署合约的工具fabric-cli
go get github.com/securekey/fabric-examples/fabric-cli/cmd/fabric-cli(go1.16版本以下)
# ps：由于fabric-cli这个项目后续没有再维护导致go1.16及以上通过go install获取会产生编译问题
# 可以通过该链接下载编译好的二进制https://github.com/meshplus/pier-client-fabric/releases/tag/v2.0.0
Step2: 部署broker合约
# --gopath 为pier-client-fabric/exmaple目录下的contracts目录
# 安装和示例化broker合约，其中${CONFIG_YAML}为fabric配置文件的路径
fabric-cli chaincode install --gopath ./contracts --ccp broker --ccid broker --config "${CONFIG_YAML}" --orgid org2 --user Admin --cid mychannel
fabric-cli chaincode instantiate --ccp broker --ccid broker \
--config "${CONFIG_YAML}" --orgid org2 --user Admin --cid mychannel
# 初始化合约参数(直连模式下不需要中继链的chainId,只需应用链id即可)
fabric-cli chaincode invoke --cid mychannel --ccid=broker \
--args='{"Func":"initialize", "Args":["", "fabappchain","1"]}' \
--user Admin --orgid org2 --payload --config "${CONFIG_YAML}"
Step3: 部署transaction合约
# --gopath 为pier-client-fabric/exmaple目录下的contracts目录
# 安装和示例化broker合约，其中${CONFIG_YAML}为fabric配置文件的路径
fabric-cli chaincode install --gopath ./contracts --ccp transaction --ccid transaction --config "${CONFIG_YAML}" --orgid org2 --user Admin --cid mychannel
fabric-cli chaincode instantiate --ccp transaction --ccid broker \
--config "${CONFIG_YAML}" --orgid org2 --user Admin --cid mychannel
fabric-cli chaincode invoke --cid mychannel --ccid=broker \
--args='{"Func":"initialize", "Args":[]}' \
--user Admin --orgid org2 --payload --config "${CONFIG_YAML}"
Step1: 获取goduck工具（若已获取可跳过）
git clone https://github.com/meshplus/goduck.git
cd goduck && make install
# 初始化goduck配置
goduck init
Step2: 部署broker合约
# config-path指定fabric配置文件路径
# gopath指定fabric合约路径，pier-client-fabric/exmaple目录下的contracts目录
# ccp指定fabric chaincode路径
# ccid指定fabric chaincode id
# version指定fabric chaincode版本
# 注意！！！config.yaml如果使用的变量，需要指定具体的证书路径
goduck fabric deploy \
--config-path config.yaml \
--gopath contracts
--ccp broker \
--ccid broker \
--version 1
# 初始化直连broker合约不需要提供BitXHub的chainId，只需对应应用链的ID
goduck fabric contract invoke --config-path config.yaml broker initialize "",fabappchain,1
Step3: 部署transaction合约