IBC 中继器 (IBC Relayers)

在 Namada 上进行中继 (Relaying on Namada)

本文档介绍了如何为 Namada 上的跨链通信（IBC）协议操作中继器。本文档涵盖了通过 IBC 创建连接以及为测试目的设置 Namada 本地实例的能力。

本文档涵盖了与 Namada 一起使用 IBC 的基本步骤：

  • 设置 Hermes（Setup Hermes）

  • 安装 Hermes（Install Hermes）

  • 设置中继器（Setting up the relayer）

  • 启动中继器（Start the relayer）

  • 设置本地 Namada 实例（Set up local Namada instances）

以下内容适用于希望在两个 Namada 链之间中继 IBC 消息传输的人员。当然，也可以在任何两个 IBC 兼容链（如 Cosmos 链）之间执行此操作。在这种情况下，为了进行任何包传输，目标链和源链上都需要运行一个节点。下面，我们首先讨论如何通过 Hermes 在两个预先存在的链之间启用此连接，其次，为此目的设置两个 Namada 本地实例或加入两个预先存在的 Namada 实例。

设置 Hermes (Setup Hermes)

Hermes 是一个 IBC 中继器，用于在链（实例）之间中继 IBC 数据包。Namada 使用支持 Namada 实例的 Hermes 分支。在数据包中继之前，用户需要执行以下步骤来配置并启动 Hermes。

  1. 创建 Hermes 配置文件 (Make Hermes config file)

  2. 在实例之间创建 IBC 客户端/连接/通道 (Create IBC client/connection/channel between instances)

  3. 运行 Hermes (Run Hermes)

创建 Hermes 配置文件 (Make Hermes config file)

解决这个问题的一个重要部分是创建一个 config.toml 文件，描述将设置哪些连接，中继器将负责这些连接。

export HERMES_CONFIG="<choose path for hermes config>/config.toml"
touch $HERMES_CONFIG

如果您不指定文件路径，则默认读取 ~/.hermes/config.toml。

您可以在下面找到配置文件的示例。基本上，您只需更改配置文件中的链 ID、RPC 地址和密钥名称即可。如果您没有节点，请手动设置节点或通过我们的脚本设置。

例子：

[global]
log_level = 'info'
 
[mode]
 
[mode.clients]
enabled = true
refresh = true
misbehaviour = true
 
[mode.connections]
enabled = false
 
[mode.channels]
enabled = false
 
[mode.packets]
enabled = true
clear_interval = 10
clear_on_start = false
tx_confirmation = true
 
[telemetry]
enabled = false
host = '127.0.0.1'
port = 3001
 
[[chains]]
id = 'namada-test.0a4c6786dbda39f786'  # set your chain ID
type = 'namada'
rpc_addr = 'http://127.0.0.1:27657'  # set the IP and the port of the chain
grpc_addr = 'http://127.0.0.1:9090'  # not used for now
event_source = { mode = 'push', url = 'ws://127.0.0.1:27657/websocket', batch_delay = '500ms' }  # set the IP and the port of the chain
account_prefix = ''  # not used
key_name = 'relayer'  # The key is an account name you made
store_prefix = 'ibc'
gas_price = { price = 0.001, denom = 'nam' }  # not used for now
 
[[chains]]
id = 'namada-test.647287156defa8728c'
type = 'namada'
rpc_addr = 'http://127.0.0.1:28657'
grpc_addr = 'http://127.0.0.1:9090'
event_source = { mode = 'push', url = 'ws://127.0.0.1:28657/websocket', batch_delay = '500ms' }
account_prefix = ''
key_name = 'relayer'
store_prefix = 'ibc'
gas_price = { price = 0.001, denom = 'nam' }

将在变量 $HERMES_CONFIG 中保存的配置文件路径将在后面有用。

解析 toml (Interpreting the toml)

每个链配置都在 [[chains]] 对象下指定。这些是您想要密切关注的难题部分：

  • chains.id 是链的名称

  • chains.rpc_address 指定通道通过的端口，并将成为与账本交互时 Namada 的 ledger_address 的参数（稍后将更清晰）

  • 请确保将 IP 地址更改为运行此节点的本地机器的 IP 地址！

  • chains.key_name 指定签名交易的签名者的密钥。应在启动中继器之前生成密钥。

  • event_source 指定链的 websocket 的 URL。为了使 Hermes 正常工作，它必须与 rpc_address 相同。

在实例之间创建 IBC 客户端/连接/通道 (Create IBC client/connection/channel between instances)

Hermes CLI 有创建它们的命令。在创建之前，应在指定的 rpc 地址上运行每个实例的节点。如果您没有节点，请手动设置节点或通过我们的脚本设置。

导出环境变量 (Export environment variables)

中继用户将需要保存某些环境变量。它们是：

export CHAIN_A_ID="<replace-with-chain-a-id>"
export CHAIN_B_ID="<replace-with-chain-b-id>"
export HERMES_CONFIG="<replace-with-hermes-config-path>"

安装 Hermes (Install Hermes)

在进行任何 IBC 操作之前，必须下载 Heliax 的分支 Hermes 二进制文件或从源代码中构建。

从二进制文件安装 (From binaries)

可以通过选择适当的架构，从我们的发布页面下载最新的二进制发布版本。

例如：

export TAG="v1.6.0-namada-beta3"
export ARCH="x86_64-unknown-linux-gnu" # or "aarch64-apple-darwin"
curl -Lo /tmp/hermes.tar.gz https://github.com/heliaxdev/hermes/releases/download/${TAG}/hermes-${TAG}-${ARCH}.tar.gz
tar -xvzf /tmp/hermes.tar.gz -C /usr/local/bin

对于某些系统，/usr/local/bin 是受保护的目录。在这种情况下，您可能需要使用 sudo 运行上述命令。即

sudo tar -xvzf /tmp/hermes.tar.gz -C /usr/local/bin

这对于下面的命令 cp ./target/release/hermes /usr/local/bin/ 也是如此（请参见注释）。

从源代码安装 (From source)

export TAG="v1.6.0-namada-beta3"
 
git clone https://github.com/heliaxdev/hermes.git
git checkout $TAG
cd hermes
cargo build --release --bin hermes
export HERMES=$(pwd) # if needed

检查二进制文件：

./target/release/hermes --version #or sudo cp ./target/release/hermes /usr/local/bin/

现在建议将 hermes 添加到 $PATH 中，以便在没有任何前缀的情况下调用它。对于 ubuntu 用户，可以通过执行以下操作来实现：

cp ./target/release/hermes /usr/local/bin/

设置中继器 (Setting up the relayer)

创建 namada_wallet 目录和链目录，以保存每个中继器的 wallet.toml。

为了使中继器正常工作，它需要有一个钱包目录来存储中继器的密钥。可以通过运行以下命令来实现：

# in the Hermes folder
mkdir namada_wallet
mkdir -p ~/.hermes/namada_wallet/$CHAIN_A_ID
mkdir -p ~/.hermes/namada_wallet/$CHAIN_B_ID

此步骤仅适用于 namada 链。对于基于 cosmos 的链，建议将密钥直接添加到 hermes 中。

./hermes --config $HERMES_CONFIG keys add --chain "<name-of-chain>" --key-file "<path-to-key>" --overwrite

创建中继器账户 (Create the relayer account)

在每条链上，必须有一个relayer账户。在 namada 链上，可以通过运行以下命令来实现：

namadaw key gen --alias relayer

这将为中继器账户生成一个密钥。密钥将存储在节点的基础目录中的 chain-id 文件夹内的 wallet.toml 中。例如，如果 chain-id 是 namada-test.0a4c6786dbda39f786，则 wallet.toml 将位于 $HOME/.local/share/namada/namada-test.0a4c6786dbda39f786/wallet.toml（在未正确设置 base-dir 的 ubuntu 机器上）。

现在重要的是将此钱包文件复制到上面创建的 namada_wallet 目录中，每个链都需要这样做。继续这个例子，可以通过运行以下命令复制第一个钱包：

cp $HOME/.local/share/namada/$CHAIN_A_ID/wallet.toml ~/.hermes/namada_wallet/$CHAIN_A_ID/wallet.toml
# Make sure this is done for both wallets on each chain!

现在可以设置客户端了。

创建 IBC 通道 (Create IBC channel)

下面的 "create channel" 命令不仅创建了 IBC 通道，还创建了必要的 IBC 客户端连接。

hermes --config $HERMES_CONFIG \
  create channel \
  --a-chain $CHAIN_A_ID \
  --b-chain $CHAIN_B_ID \
  --a-port transfer \
  --b-port transfer \
  --new-client-connection --yes

请注意，上述 CHAIN_IDs 将取决于您自己的设置，因此请自行检查！

当创建完成时，您可以看到通道 ID。例如，以下文本显示在 Chain A namada-test.0a4c6786dbda39f786 上已创建了 ID 为 7 的通道，并且在 Chain B namada-test.647287156defa8728c 上已创建了 ID 为 12 的通道。您将需要通道 ID 来通过 IBC 进行转移。这意味着您必须为从 Chain A 到 Chain B 的转移指定 channel-7 作为通道 ID（前缀 channel- 总是必需的）。同样，您必须为从 Chain B 到 Chain A 的转移指定 channel-12 作为通道 ID。

SUCCESS Channel {
    ordering: Unordered,
    a_side: ChannelSide {
        chain: BaseChainHandle {
            chain_id: ChainId {
                id: "namada-test.0a4c6786dbda39f786",
                version: 0,
            },
            runtime_sender: Sender { .. },
        },
        client_id: ClientId(
            "07-tendermint-0",
        ),
        connection_id: ConnectionId(
            "connection-3",
        ),
        port_id: PortId(
            "transfer",
        ),
        channel_id: Some(
            ChannelId(
                "channel-7",
            ),
        ),
        version: None,
    },
    b_side: ChannelSide {
        chain: BaseChainHandle {
            chain_id: ChainId {
                id: "namada-test.647287156defa8728c",
                version: 0,
            },
            runtime_sender: Sender { .. },
        },
        client_id: ClientId(
            "07-tendermint-1",
        ),
        connection_id: ConnectionId(
            "connection-2",
        ),
        port_id: PortId(
            "transfer",
        ),
        channel_id: Some(
            ChannelId(
                "channel-12",
            ),
        ),
        version: None,
    },
    connection_delay: 0ns,
}

启动中继器 (Start the relayer)

一旦运行 Hermes，它将通过节点监视实例并根据监视到的事件中继数据包。

hermes --config $HERMES_CONFIG start

您可以在官方文档中查看更多有关 Hermes 的详细信息。

在同步完成后，您可以按照上述说明创建通道并启动 Hermes。

# create a channel
hermes --config $HERMES_CONFIG \
  create channel \
  --a-chain $CHAIN_A_ID \
  --b-chain $CHAIN_B_ID \
  --a-port transfer \
  --b-port transfer \
  --new-client-connection --yes

通过 IBC 转移资产 (Transferring assets over IBC)

现在可以在两条链之间转移资产了。

使用 hermes 脚本设置本地 Namada 实例 (Set up local Namada instances using the hermes script)

脚本 setup-namada 将设置两个实例，每个实例有一个验证节点，为 Hermes 复制必要的文件，并在每个账本上为 Hermes 创建一个账户。它还会在 hermes 目录中创建一个 Hermes 的配置文件 config_for_namada.toml。

首先，您需要导出一些环境变量：

export NAMADA_DIR="<path-to-namada-source-directory>"
export TAG="v1.6.0-namada-beta3"
git clone https://github.com/heliaxdev/hermes.git
git checkout $TAG # The branch is the same as our Hermes
cd hermes
./scripts/setup-namada $NAMADA_DIR $CHAIN_ID_A $CHAIN_ID_B

在这种情况下，用户不必等待同步。如果每个实例上的中继器账户有足够的余额，用户可以按照上述说明立即创建通道并启动 Hermes。用户可以在配置文件 config_for_namada.toml 中找到这些实例的链 ID。可以运行 grep "id" ${HERMES_CONFIG}。

# create a channel
hermes --config $HERMES_CONFIG \
  create channel \
  --a-chain $CHAIN_A_ID \
  --b-chain $CHAIN_B_ID \
  --a-port transfer \
  --b-port transfer \
  --new-client-connection --yes
 
# Run Hermes
hermes --config $HERMES_CONFIG start

每个节点的数据和配置文件都位于 hermes/data/namada-*/.namada。

为了关闭由脚本设置的任何账本，可以运行：

killall namadan
Previous设置本地网络 (Setting up a local network)Next故障排除 (Troubleshooting)

Last updated