2. 跨链网关部署¶

跨链网关Pier能够支持跨链消息格式转换、跨链消息的路由、跨链操作的调用等核心功能，不仅保证不同格式的跨链消息能够安全可信的到达目标应用链，而且保证了跨链交易异常情况下来源链的安全。跨链网关为区块链互联形成网络提供了便捷的接入方式，旨在降低跨链互联的使用成本。在之前的文档中介绍了中继模式的pier安装步骤，下面介绍直连模式下pier的安装步骤。请注意，pier直连不依赖于中继链节点，所以本文档不赘述bitxhub的部署了。

安装包获取¶

源码安装¶

跨链网关启动的话需要应用链插件，所以从源码安装的话，还需要编译相应的应用链插件的二进制。

# 编译跨链网关本身
cd $HOME
git clone https://github.com/meshplus/pier.git
cd pier && git checkout release-2.8
make prepare && make install

# 编译Fabric
cd $HOME
git clone https://github.com/meshplus/pier-client-fabric.git
cd pier-client-fabric && git checkout release-2.8
make fabric1.4

# 编译以太坊私链插件
cd $HOME
git clone https://github.com/meshplus/pier-client-ethereum.git
cd pier-client-ethereum && git checkout release-2.8
make eth

# 插件执行make的编译之后，都会在项目目录的之下的build目录生成相应的二进制文件

编译跨链网关步骤会在 $GOPATH/bin 下生成 pier 二进制，运行下面的命令查看是否安装成功：

# $GOPATH/bin需要在PATH目录下
pier version

如果正常安装会打印出类似下面的说明

Pier version: dev-release-2.8-a568b03
App build date: 2023-01-30T09:28:13
System version: darwin/amd64
Golang version: go1.18.2

二进制安装¶

没有现有编译环境的用户，也可以在GitHub开源仓库下载编译好的二进制。

Pier二进制安装：根据需要的版本进行下载即可。
网关插件安装：pier-client-fabric 和 pier-client-ethereum 的应用链插件的二进制。

注意：网关与网关插件对应大版本号一致即可。如pier v2.0.x对应pier-client-ethereum v2.0.x。

修改配置文件¶

修改pier配置¶

在进行应用链注册、验证规则部署等步骤之前，需要初始化跨链网关的配置目录

# 以用户目录下的pier为例
pier --repo=~/pier1 init

该命令会生成跨链网关的一些基础配置文件模板，使用 tree 命令可查看目录信息：

tree -L 1 ~/.pier1

├── api
├── certs
├── key.json
├── network.toml
├── node.csr
├── node.priv
└── pier.toml

1 directory, 6 files

导入插件二进制（hyperchain的插件二进制和配置文件示例需要内部授权）

mkdir -p ~/.pier1/plugins
cp fabric-client-1.4 ~/.pier1/plugins

pier.toml 文件描述链跨链网关启动的必要配置，具体的配置项和说明如下：

配置项	说明
[port]	http、grpc服务端口
[log]	日志输出相关设置
[bitxhub]	连接的bitxhub的IP地址、验证人地址
[appchain]	对接的应用链的基础配置信息

主要需要修改的部分是端口信息、中继链的信息、应用链的信息

修改端口信息

[port]
# 如果不冲突的话，可以不用修改
http  = 44544
pprof = 44555

修改pier配置文件下的api文件信息

# 修改为上一步配置的http的端口号
http://localhost:<http port>/v1/

修改跨链网关信息

[mode]
type = "direct" # relay or direct
...
...
[mode.direct]
    gas_limit = 100000000

修改应用链信息

[appchain]
# 所连接的应用链的配置文件夹在跨链网关配置文件夹下的相对路径
config = "fabric"
# 应用链ID
id = "fabappchain"
# 所连接的应用链对应的Plugin文件在跨链网关配置文件夹下的相对路径
plugin = "fabric-client-1.4"

network.toml 文件描述链跨链网关启动的必要的网络配置，具体的配置项和说明如下：

配置项	说明
[host]	p2p网络地址
[pid]	p2p网络的ID

修改跨链网关网络信息

[[piers]]
hosts = ["/ip4/127.0.0.1/tcp/4321/p2p/"]
pid = "QmZBXPKmBSs45PuzbPpuZV6QzZpAQmqZa8AzJ6HNQX9wJh"

[[piers]]
hosts = ["/ip4/127.0.0.1/tcp/4322/p2p/"]
pid = "QmbmD1kzdsxRiawxu7bRrteDgW1ituXupR8GH6E2EUAHY4"

注意：上面peers字段需要配置两方的pier的p2p地址，其中pid可以使用pier p2p id命令来获取，这也是直连模式区别于中继模式的关键配置。

网关pier适配以太坊插件的配置仿照上述步骤即可。

修改fabric插件配置¶

Fabric插件配置的模板在pier-client-fabric项目中，并且已经在GitHub上进行开源，所以直接在GitHub上下载代码即可

# 转到pier-client-fabric项目路径下
git clone https://github.com/meshplus/pier-client-fabric.git
cd pier-client-fabric && git checkout release-2.8
cp ./config $HOME/.pier1/fabric

配置目录结构

├── crypto-config/
├── config.yaml
├── fabric.toml
└── fabric.validators

主要修改Fabric网络配置，验证证书，跨链合约设置：

Fabric证书配置

启动Fabric网络时，会生成所有节点（包括Order、peer等）的证书信息，并保存在 crypto-config文件夹中，Fabric插件和Fabric交互时需要用到这些证书。

# 复制你所部署的Fabric所产生的crypto-config文件夹
cp -r /path/to/crypto-config $HOME/.pier1/fabric/

# 复制Fabric上验证人证书
cp $HOME/.pier1/fabric/crypto-config/peerOrganizations/org2.example.com/peers/peer1.org2.example.com/msp/signcerts/peer1.org2.example.com-cert.pem $HOME/.pier1/fabric/fabric.validators

修改Plugin配置文件 config.yaml

config.yaml文件记录的Fabric网络配置（如果你是按照你自己的网络拓扑部署的Fabric，用你的网络拓扑配置文件替换这个样例文件），需要使用绝对路径，把所有的路径都修改为 crypto-config文件夹所在的绝对路径，$USER指代当前用户名

path: {CONFIG_PATH}/fabric/crypto-config => path: /home/$USER/.pier/fabric/crypto-config

替换为你部署的Fabric网络的拓扑设置文件即可，同时需要修改所有的Fabric 的IP地址，如：

url: grpcs://localhost:7050 => url: grpcs://10.1.16.48:7050

修改Plugin配置文件 fabric.toml

配置项和说明：

配置项	说明
addr	Fabric 区块链所在的服务器地址和端口
event_filter	跨链合约中抛出的跨链事件的名称
username	Fabric用户名称
ccid	所部署的跨链合约名称
channel_id	部署的跨链合约所在的channel
org	部署的跨链合约所在的org

示例配置

addr = "localhost:7053" // 若Fabric部署在服务器上，该为服务器地址
event_filter = "interchain-event-name"
username = "Admin"
ccid = "broker" // 若部署跨链broker合约名字不是broker需要修改
channel_id = "mychannel"
org = "org2"

修改Plugin配置文件fabric.validators

fabric.validators 是Fabric验证人的证书，配置示例：

修改ethereum插件配置¶

ethereum插件配置的模板在pier-client-ethereum项目中，并且已经在GitHub上进行开源，所以直接在GitHub上下载代码即可

# 转到pier-client-ethereum项目路径下
git clone https://github.com/meshplus/pier-client-ethereum.git
cd pier-client-ethereum && git checkout release-2.8
cp ./config $HOME/.pier2/ether

配置目录结构

├── account.key
├── ether.validators
├── ethereum.toml
├── password
├── pier.toml // 仅作参考，无需配置
└── validating.wasm

注意： 插件目录下的pier.toml仅作参考，系统使用的配置文件是位于pier的配置文件目录下的pier.toml。

主要修改账户信息、abi，跨链合约设置。

以太坊账户配置

启动以太坊网络时，在指定的datadir目录下，将keystore的账户信息拷贝到account.key中。

cp <eth_datadir>/keystore/<account> $HOME/.pier2/ether/config/account.key

**修改Plugin配置文件ethereum.toml **

配置项和说明：

配置项	说明
addr	ethereum 区块链所在的服务器地址和端口
name	以太坊链名称
contract_address	部署的broker合约地址
key_path	账户信息文件路径
password	账户密码文件路径
min_confirm	最低确认区块数
timeout_height	中继模式超时回滚的区块数
timeout_period	直连模式超时回滚的时间

示例配置

[ether]
addr = "ws://localhost:8546"
name = "ether"
contract_address = "0x09f0a8c66bc8bC6e29bF0A425CDD7aa133F40571"
key_path = "account.key"
password = "password"
min_confirm = 0
timeout_height = 100
timeout_period = 60

启动程序¶

准备工作：

两条应用链上A和B都部署broker合约，此外与中继模式不同的是直连模式需要在两条应用链上额外部署transaction合约
启动跨链网关

#以用户目录下的pier1为例
pier --repo=~/pier1 start

#以用户目录下的pier2为例
pier --repo=~/pier2 start

观察日志信息没有报错信息，pier启动成功

说明：
1. 因为跨链合约和验证规则的部署涉及到不同应用链的细节，且需依赖应用链的安装部署，具体操作请见快速开始手册或使用文档，这里不再赘述。
2. 本文是以一方的跨链网关为例进行部署，而另一方的跨链网关的部署与之基本一样，这里不再赘述。

直连模式下，两边的跨链网关对应

完成上述布置后，跨链网关直连模式下部署就已经完成，两边的应用链可以进行跨链操作