Connext testnet Router中文教程

本文用于在Connext contribution program中设置测试网router节点。

本文仅供参考,请以官方文档为准。

最低硬件要求

8GB RAM
30GB Storage
Redis

安装所需环境

更新源

sudo apt update && sudo apt upgrade -y

安装docker和docker compose。

sudo apt-get install ca-certificates curl gnupg lsb-release -y;

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg;

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

网络配置

router不需要为入站访问打开任何端口。

危险

不要把ROUTER_EXTERNAL_PORT暴露给任何你不信任的人!它只能由操作者在受信任的环境中访问。

克隆github仓库

git clone https://github.com/connext/nxtp-router-docker-compose.git
cd nxtp-router-docker-compose/
git checkout amarok

基本配置

环境配置

cp .env.example .env
vim .env

修改以下环境变量:

  • ROUTER_VERSION- 要使用的router版本(例如v0.1.0)。有关最新发布的版本,请参阅release页面。
  • ROUTER_EXTERNAL_PORT- router的对外暴露端口。请记住不要将此端口暴露到公网。
  • GRAFANA_EXTERNAL_PORT- Grafana 仪表板的暴露端口。
  • LOGDNA_KEY- 此密钥由 logdna 容器使用。您可以通过在此处注册来获取此密钥。
LOGDNA_KEY
LOGDNA_KEY

例如

################################################################################

General configuration

ROUTER_VERSION=0.2.0-alpha.16

ROUTER_EXTERNAL_PORT=8000
GRAFANA_EXTERNAL_PORT=3008
WEB3SIGNER_HTTP_LISTEN_PORT=9000

################################################################################

Monitoring configuration

LOGDNA_KEY=你的LOGDNA_KEY
LOGDNA_TAG=

DISCORD_WEBHOOK=

Redis 配置

路由器默认使用 Docker 中的内部 Redis 实例。但是,如果您更喜欢使用您的外部 Redis 实例,您可以在config.json修改hostport,可以在Redis 网站上找到说明。

Web3Signer 配置

设置Web3Signer配置文件以安全地设置私钥。

cp key.example.yaml key.yaml
vim key.yaml

修改privateKey 为你自己的以太坊地址私钥

例如

type: "file-raw"
keyType: "SECP256K1"
privateKey: "c41a12b71d297b7bea5be41f4b752"

router配置

cp config.example.json config.json
vim config.json

至少更改以下值:

  • sequencerUrl- Sequencer 节点的 URL。
  • redis- 要使用的 Redis 实例。
  • server- 内部 HTTP 服务器配置 ( adminToken)。

chains- 添加您想要的链、资产和提供者 URL。使用domain mappings而不是chainIds。获取更多链的chain id,请查看https://raw.githubusercontent.com/connext/chaindata/main/crossChain.json。确保为每个链使用不同的providers!当前测试网资产的示例如下:

{
  ...
  "chains": {
    "1111": {
      "assets": [
        {
          "address": "0xcF4d2994088a8CDE52FB584fE29608b63Ec063B2",
          "name": "TEST"
        }
      ],
      "providers": ["https://rinkeby.infura.io/v3/...", "https://rpc.ankr.com/eth_rinkeby"]
    },
    "2221": {
      "assets": [
        {
          "address": "0xB5AabB55385bfBe31D627E2A717a7B189ddA4F8F",
          "name": "TEST"
        }
      ],
      "providers": ["https://kovan.infura.io/v3/..."]
    }
  }
}

web3SignerUrl -设置为"http://signer:9000"
redis

  • host- 设置为您的外部 Redis 实例的主机名。
  • port- 设置为您的外部 Redis 实例的端口。

有关详细信息,请参阅配置部分。

运行router

运行router docker compose。

docker compose up -d

通过查询/config端点来测试它是否正常工作。登录主机或router容器并运行以下 curl 命令:

curl localhost:8000/config

返回值如下

{"signerAddress":"0x627306090abaB3A6e1400e9345bC60c78a8BEf57"}

这个地址为你privateKey对应的以太坊地址。

升级版本

1.修改 .env 文件中的 NXTP_VERSION ,在这里检查最新的版本。

2.更新config。请参考官方文档的最新config。

3.更新容器

docker compose pull
docker compose up -d

4.更新版本后可能要重新添加流动性。

查看日志

docker logs router

docker logs --follow --tail 100 router

Grafana 仪表板

Router运行了Grafana 仪表板,其端口为配置文件中的GRAFANA_EXTERNAL_PORT。

获取一些测试网的原生资产

获取测试币

可以在这个网页的水龙头中领取测试链的ETH

在以下网页中连接钱包,领取TEST TOKEN

领取测试币
领取测试币

添加流动性

打开

https://testnet.amarok.connextscan.io/router/你router的地址

点击左上角的Manage Router按钮,添加流动性。

添加流动性
添加流动性

添加成功之后,你的router就配置成功了!

Subscribe to Silent ⚛| validator
Receive the latest updates directly to your inbox.
Verification
This entry has been permanently stored onchain and signed by its creator.