Running IBC Relayer

An IBC relayer is a software component that facilitates communication between two distinct blockchain networks that support the Inter-Blockchain Communication (IBC) protocol.

It is required for built-in oracle, Minitswap, and other cross-chain services to function with your rollup.

While setting up a relayer is traditionally one of the most complex tasks in the Cosmos ecosystem, Weave simplifies this process significantly, reducing the typical 10+ step IBC Relayer setup to just a few simple steps.

Weave only supports IBC relayer setup between Initia L1 and Interwoven Rollups. Setting up relayers between other arbitrary networks is not supported.

Currently, Weave only supports the Hermes relayer. For detailed information about Hermes, please refer to the Hermes documentation.

Setting up

weave relayer init

This command will guide you through 2 major parts of the relayer setup:

• Setting up networks and channels to relay messages between
• Setting up the account responsible for relaying messages

For the former, Weave will present you with three options:

1. Configure channels between Initia L1 and a whitelisted Rollup (those available in Initia Registry
2. Configure using artifacts from weave rollup launch (recommended for users who have just launched their rollup)
3. Configure manually

As for the latter, Weave will ask whether you want to use OPinit Challenger bot account for the relayer. This is recommended as it is exempted from gas fees on the rollup and able to stop other relayers from relaying when it detects a malicious message coming from it.

Relayer requires funds to relay messages between Initia L1 and your rollup (if it’s not in the fee whitelist). If Weave detects that your account does not have enough funds, Weave will ask you to fund via Gas Station.

For advanced configuration options, you can refer to the Hermes Configuration Guide and customize the relayer’s configuration file located at ~/.hermes/config.toml.

Running Relayer

Start

weave relayer start

Available Flags

--detach, -d · boolean · default: "false"

Whether to run the node in the background.

--update-client · string · default: "true"

Whether to update the IBC clients on the rollup before starting the relayer.

Valid values are true and false.

Stop

weave relayer stop

Restart

weave relayer restart

View logs

weave relayer log

Available Flags

-n · number · default: "100"

The number of lines to display from the end of the logs.

Help

To see all the available commands:

weave relayer --help