Skip to main content
Version: Testnet

Relayer

Relayer is used to facilitate token transfers between Dymension and the RollApp. In this section will start by initializing the rollapp which is a prerequisitive for running the relayer following by setting up and running the relayer.

In case you have already initialized the rollapp, you can skip the initialization step and proceed to setup IBC connection.

Requirements​

note

This guide assumes you've already setup your environment and initialized your rollapp.

Hardware Requirements​

  • A Linux or macOS operating system
  • At least 4GB of RAM
  • At least 10GB of free disk space
  • At least 1 CPU core
  • At least 10 Mbps bandwidth

Setup IBC Connection​

Before running the relayer, you need to setup the IBC connection between the Dymension hub and the RollApp.

Important

The relayer must run on the same machine as the sequencer for the IBC connection creation phase. After connection creation phase it may take a few minutes until transfers are enabled in the portal assuming sequencer RPC endpoints are functional.

roller relayer setup

Run Relayer​

note

Sequencers are eligible to send gas-free IBC transactions to their RollApp. The whitelisted relayers can be registered on the hub using dymd tx sequencer update-whitelisted-relayers using the hub sequencer key.

Starts the relayer in the foreground:

roller relayer start
note

The first IBC transfer from the RollApp can take approximately ~1 hour, after which operators are expected to run the eIBC client.