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
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:
- Configure channels between Initia L1 and a whitelisted Rollup (those available in Initia Registry
- Configure using artifacts from
weave rollup launch(recommended for users who have just launched their rollup) - 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
Available Flags
Whether to run the node in the background.
Whether to update the IBC clients on the rollup before starting the relayer.
Valid values are true and false.
Available Flags
Whether to run the node in the background.
Whether to update the IBC clients on the rollup before starting the relayer.
Valid values are true and false.
Help
To see all the available commands:
Was this page helpful?