蚂蚁链跨链桥中继(AntChain Bridge Relayer)是蚂蚁链跨链开源项目的重要组件,负责连接区块链、区块链域名服务(BCDNS)和证明转化组件(PTC),完成可信信息的流转与证明,实现区块链互操作。
AntChain Bridge Relayer是从蚂蚁链跨链产品ODATS中开源出来的组件,并按照IEEE 3205对跨链逻辑进行了升级,目前开源版本已经支持协议中通信相关的基本流程,包括统一跨链数据包(Unified Crosschain Packet, UCP)、可认证消息(Authentic Message, AM)、智能合约数据报(Smartcontract Datagram Protocol, SDP)等消息的处理,以及基于BCDNS的实现了区块链身份管理流程和区块链之间的消息寻址功能,目前支持**信息通信研究院基于星火链开发的BCDNS服务。
AntChain Bridge Relayer将功能实现分为两部分,分别为通信和可信,目前AntChain Bridge Relayer已经实现区块链合约之间的通信功能,在2024年将实现基于PTC和BCDNS的可信链路,最终提供灵活可靠的区块链互操作能力。
*在开始之前,请您确保安装了maven和JDK,这里推荐使用openjdk-1.8版本
*确保安装了AntChain Bridge Plugin SDK,详情请见
在项目根目录运行maven命令即可:
mvn package -Dmaven.test.skip=true
在r-bootstrap/target
下面会产生一个压缩包acb-relayer-x.y.z.tar.gz
,将该压缩包解压到运行环境即可。
解压之后可以看到以下文件:
tree .
.
├── README.md
├── bin
│ ├── acb-relayer.service
│ ├── init_tls_certs.sh
│ ├── print.sh
│ ├── start.sh
│ └── stop.sh
├── config
│ ├── application.yml
│ └── db
│ └── ddl.sql
└── lib
└── r-bootstrap-0.1.0.jar
4 directories, 9 files
AntChain Bridge Relayer使用了MySQL和Redis,这里建议使用docker快速安装依赖。
首先通过脚本安装docker,或者在官网下载。
wget -qO- https://get.docker.com/ | bash
然后下载MySQL镜像并启动容器,注意这里指定了时区为+08:00
,请修改为您的时区。
docker run -itd --name mysql-test -p 3306:3306 -e MYSQL_ROOT_PASSWORD='YOUR_PWD' mysql --default-authentication-plugin=mysql_native_password --default_time_zone +08:00
然后下载Redis镜像并启动容器:
docker run -itd --name redis-test -p 6379:6379 redis --requirepass 'YOUR_PWD' --maxmemory 500MB
在开始之前,需要初始化中继的数据库,这里提供一个DDL,或者解压之后在路径config/db/ddl.sql
找到,在MySQL执行即可生成数据库relayer
。
这里初始化中继的TLS证书,会在tls_certs
路径下生成relayer.crt
和relayer.key
。
bin/init_tls_certs.sh
___ __ ______ __ _ ____ _ __
/ | ____ / /_ / ____// /_ ____ _ (_)____ / __ ) _____ (_)____/ /____ _ ___
/ /| | / __ \ / __// / / __ \ / __ `// // __ \ / __ |/ ___// // __ // __ `// _ \
/ ___ | / / / // /_ / /___ / / / // /_/ // // / / / / /_/ // / / // /_/ // /_/ // __/
/_/ |_|/_/ /_/ \__/ \____//_/ /_/ \__,_//_//_/ /_/ /_____//_/ /_/ \__,_/ \__, / \___/
/____/
[ INFO ]_[ 2023-12-25 20:32:17.170 ] : generate relayer.key successfully
[ INFO ]_[ 2023-12-25 20:32:17.170 ] : generate relayer.crt successfully
然后,找到config/application.yml
,配置MySQL和Redis信息到配置文件:
spring:
application:
name: antchain-bridge-relayer
profiles:
active: env
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/relayer?serverTimezone=Asia/Shanghai&rewriteBatchedStatements=true
password: YOUR_PWD
username: root
redis:
host: localhost
port: 6379
password: YOUR_PWD
最后,需要向BCDNS服务申请中继身份证书,用于与BCDNS和其他中继进行交互,这里推荐搭建信通院基于星火链实现的BCDNS服务,目前没有提供测试网服务,需要开发者自行运行该服务。
使用CLI工具(请参考CLI文档)为中继生成私钥、公钥。
___ ______ ____ ____ ______ __ ___ __ __ ______ ____
/ | / ____// __ ) / __ \ / ____// / / |\ \/ // ____// __ \
/ /| | / / / __ | / /_/ // __/ / / / /| | \ // __/ / /_/ /
/ ___ |/ /___ / /_/ / / _, _// /___ / /___ / ___ | / // /___ / _, _/
/_/ |_|\____//_____/ /_/ |_|/_____//_____//_/ |_|/_//_____//_/ |_|
CLI 0.1.0
relayer:> generate-relayer-account
private key path: /path/to/private_key.pem
public key path: /path/to/public_key.pem
然后,生成BID Document,用于向BCDNS申请中继证书,具体申请操作请参考BCDNS操作文档。
relayer:> generate-bid-document --publicKeyPath /path/to/public_key.pem
file is : /path/to/bid_document.json
如果BCDNS返回的是Base64格式的证书,可以使用CLI工具转换成PEM格式,以用于Relayer。
relayer:> convert-cross-chain-cert-to-pem --base64Input AAAIAgAAAAABAAAAMQEAK...wWf/zi60DKnQ7xaCA==
-----BEGIN RELAYER CERTIFICATE-----
AAAIAgAAAAABAAAAMQEAKAAAAGRpZDpiaWQ6ZWY5OVJ6OFRpN3g0aTZ6eUNyUHlG
aXk5dXRzV0JKVVcCAAEAAAADAwA7AAAAAAA1AAAAAAABAAAAAQEAKAAAAGRpZDpi
...
4QlxLUp70uRK43ECAAcAAABFZDI1NTE5AwBAAAAAbA8zkKXCI4Iwp6KBERXOqKln
JT/qn36in7+iU6SsNEz0rsJpmEvVRT6adNVY7zS/ni35JwWf/zi60DKnQ7xaCA==
-----END RELAYER CERTIFICATE-----
在获得PEM格式的中继证书和密钥之后,将其配置到文件中,这里假设将证书和密钥分别放在cc_certs/relayer.crt
和cc_certs/private_key.pem
:
relayer:
network:
node:
sig_algo: Ed25519
crosschain_cert_path: file:cc_certs/relayer.crt
private_key_path: file:cc_certs/private_key.pem
如果仅需要将程序运行起来,或者进行某些测试,可以使用测试用例中提供的证书和密钥,请不要将该证书与密钥用于生产。
通过运行bin/start.sh -h
,可以看到运行方式。
-
可以直接运行
start.sh
启动服务进程。 -
可以通过运行
start.sh -s
作为系统服务启动,支持自动重启等功能。
bin/start.sh -h
start.sh - Start the AntChain Bridge Relayer
Usage:
start.sh <params>
Examples:
1. start in system service mode:
start.sh -s
2. start in application mode:
start.sh
Options:
-s run in system service mode.
-h print help information.
成功运行之后,可以在log/antchain-bridge-relayer
看到日志文件。
AntChain Bridge Relayer提供了一个命令行交互工具,详情请见使用文档。
Relayer可以启动多个节点,以实现水平拓展。
启动第一个节点之后,在第二台机器解压程序安装包,并将配置文件、TLS证书密钥、跨链证书密钥拷贝到对应的路径,启动程序即可。
多节点启动之后,可以使用CLI工具查询当前节点状态:
relayer:> query-curr-active-nodes
[
{
"last_active_time":1703737607000,
"node_ip":"172.16.0.49",
"active":true,
"node_id":"172.16.0.49"
},
{
"last_active_time":1703737607000,
"node_ip":"172.16.0.50",
"active":true,
"node_id":"172.16.0.50"
}
]
节点的ID默认使用机器IP,此外还可以配置为UUID模式,更改配置重启Relayer进程即可:
relayer:
engine:
node_id_mode: UUID
不同的Relayer之间可以互相转发跨链消息,具体流程为:
- 本地Relayer收到域名A发往域名B的跨链消息,但是域名B的路由信息在本地Relayer不存在,则需要先挂起该方向的跨链消息;
- 本地Relayer向BCDNS查询该域名的路由信息,找到网络中对接该链的Relayer;
- 本地Relayer发起“握手”流程,建立于网络中的Relayer的可信连接;
- 两个Relayer之间建立域名A和域名B的可信通道;
- 本地Relayer将挂起的跨链消息发送到网络Relayer,并提交到域名B链上。
在可以被发现之前,本地Relayer需要完成:
-
设置本地网络地址,该地址目前支持http和https,后续考虑支持grpcs等方式,比如
https://localhost:8082
,也可以设置多个,用","隔开即可。relayer:> set-local-endpoints --endpoints https://172.16.0.49:8082
可以通过
get-local-endpoints
查询当前endpoints信息。 -
对本地启动过Anchor服务的区块链,将其域名注册到BCDNS,使得网络中其他Relayer可以发现并向本地Relayer转发跨链消息。
relayer:> register-domain-router --domain domain.web3.net
可以通过下面请求获取到BCDNS的路由信息:
relayer:> query-domain-router --domain domain.web3.net {"destDomain":{"domain":"domain.web3.net","domainSpace":false},"destRelayer":{"netAddressList":["https://localhost:8082"],"relayerCert":{"credentialSubject":"AADVAAAAAAAD...hNDRjY2UifV19","credentialSubjectInstance":{"applicant":{"rawId":"ZGlkOmJpZDplZmJ...1b1FHWDZMVUd3Zw==","type":"BID"},"name":"relay","rawSubjectPublicKey":"r2Ze5VBjX...yWnSkTM4=","subject":"eyJwdWJsaWNLZXkiO...jZSJ9XX0=","subjectInfo":"eyJwd...J9XX0=","subjectPublicKey":{"algorithm":"Ed25519","encoded":"MCowBQYDK2V...qJKDyWnSkTM4=","format":"X.509","pointEncoding":"r2Ze5V...ifV19","expirationDate":1733811853,"id":"did:bid:efGeAv4Jr7V2FSyun77m4xTFmTDfG8nh","issuanceDate":1702275853,"issuer":{"rawId":"ZGlkOmJpZDpl...NTdtRENwQw==","type":"BID"},"proof":{"certHash":"Gaw4gcwXzn2i...K6HaPWBxXM=","hashAlgo":"SM3","rawProof":"kMZ/tvT19Tk...TQ4IVYlXkYjSBw==","sigAlgo":"Ed25519"},"type":"RELAYER_CERTIFICATE","version":"1"},"relayerCertId":"did:bid:efGeAv4Jr7V2FSyun77m4xTFmTDfG8nh"}}
AntChain Bridge 欢迎您以任何形式参与社区建设。
您可以通过以下方式参与社区讨论
- 钉钉
- 邮件
发送邮件到[email protected]
详情参考LICENSE。