> For the complete documentation index, see [llms.txt](https://tantalum666.gitbook.io/namada-docs-chinese/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tantalum666.gitbook.io/namada-docs-chinese/yun-ying-zhi-nan-operators-guide/ibc-zhong-ji-qi-ibc-relayers.md). # IBC 中继器 (IBC Relayers) 本文档介绍了如何为 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 分支](https://github.com/heliaxdev/hermes/tree/1.6.0-namada)。在数据包中继之前，用户需要执行以下步骤来配置并启动 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="/config.toml" touch $HERMES_CONFIG ``` 如果您不指定文件路径，则默认读取 `~/.hermes/config.toml`。
您可以在下面找到配置文件的示例。基本上，您只需更改配置文件中的链 ID、RPC 地址和密钥名称即可。如果您没有节点，请手动设置节点或通过我们的[脚本](#shi-yong-hermes-jiao-ben-she-zhi-ben-di-namada-shi-li-set-up-local-namada-instances-using-the-hermes)设置。 例子： ``` [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` 中保存的配置文件路径将在后面有用。 {% hint style="info" %} 解析 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` 相同。 {% endhint %} ### 在实例之间创建 IBC 客户端/连接/通道 (Create IBC client/connection/channel between instances) Hermes CLI 有创建它们的命令。在创建之前，应在指定的 rpc 地址上运行每个实例的节点。如果您没有节点，请手动设置节点或通过我们的[脚本](#shi-yong-hermes-jiao-ben-she-zhi-ben-di-namada-shi-li-set-up-local-namada-instances-using-the-hermes)设置。 ### 导出环境变量 (Export environment variables) 中继用户将需要保存某些环境变量。它们是： ``` export CHAIN_A_ID="" export CHAIN_B_ID="" export HERMES_CONFIG="" ``` *** ## 安装 Hermes (Install Hermes) 在进行任何 IBC 操作之前，必须下载 Heliax 的分支 Hermes 二进制文件或从源代码中构建。
### 从二进制文件安装 (From binaries) 可以通过选择适当的架构，从我们的[发布页面](https://github.com/heliaxdev/hermes/releases)下载最新的二进制发布版本。 例如： ``` 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 ``` {% hint style="info" %} 对于某些系统，`/usr/local/bin` 是受保护的目录。在这种情况下，您可能需要使用 `sudo` 运行上述命令。即 ``` sudo tar -xvzf /tmp/hermes.tar.gz -C /usr/local/bin ``` 这对于下面的命令 `cp ./target/release/hermes /usr/local/bin/` 也是如此（请参见注释）。 {% endhint %} ### 从源代码安装 (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/ ``` {% hint style="info" %} 现在建议将 hermes 添加到 $PATH 中，以便在没有任何前缀的情况下调用它。对于 ubuntu 用户，可以通过执行以下操作来实现： ``` cp ./target/release/hermes /usr/local/bin/ ``` {% endhint %} *** ## 设置中继器 (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 ``` {% hint style="info" %} 此步骤仅适用于 namada 链。对于基于 cosmos 的链，建议将密钥直接添加到 hermes 中。 ``` ./hermes --config $HERMES_CONFIG keys add --chain "" --key-file "" --overwrite ``` {% endhint %} ### 创建中继器账户 (Create the relayer account) 在每条链上，必须有一个`relayer`账户。在 namada 链上，可以通过运行以下命令来实现： ``` namadaw key gen --alias relayer ``` 这将为中继器账户生成一个密钥。密钥将存储在节点的[基础目录](/namada-docs-chinese/yun-ying-zhi-nan-operators-guide/yun-xing-wan-zheng-jie-dian-runningafull-node/ji-ben-mu-lu-base-directory.md)中的 `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 ``` {% hint style="info" %} 请注意，上述 `CHAIN_IDs` 将取决于您自己的设置，因此请自行检查！ {% endhint %} 当创建完成时，您可以看到通道 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 ``` 您可以在[官方文档](https://hermes.informal.systems/)中查看更多有关 Hermes 的详细信息。 在同步完成后，您可以按照[上述说明](#chuang-jian-ibc-tong-dao-create-ibc-channel)创建通道并启动 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) 现在可以在[两条链之间转移资产了](/namada-docs-chinese/yong-hu-zhi-nan-user-guide/ibc-zhuan-zhang-ibc-transfers.md)。 *** ## 使用 hermes 脚本设置本地 Namada 实例 (Set up local Namada instances using the hermes script) 脚本 `setup-namada` 将设置两个实例，每个实例有一个验证节点，为 Hermes 复制必要的文件，并在每个账本上为 Hermes 创建一个账户。它还会在 `hermes` 目录中创建一个 Hermes 的配置文件 `config_for_namada.toml`。 首先，您需要导出一些环境变量： ``` export NAMADA_DIR="" 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 ``` 在这种情况下，用户不必等待同步。如果每个实例上的中继器账户有足够的余额，用户可以按照上述[说明](#chuang-jian-zhong-ji-qi-zhang-hu-create-the-relayer-account)立即创建通道并启动 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 ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://tantalum666.gitbook.io/namada-docs-chinese/yun-ying-zhi-nan-operators-guide/ibc-zhong-ji-qi-ibc-relayers.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.