Skip to content

clockworkgr/ibc-relay-tab

Repository files navigation

IBC Relay Tab

This project implements a web-based IBC relayer.

Requirements:

  • a funded Keplr Wallet

If you want to run this locally:

  • NodeJS v20
  • pnpm

First clone the repo.

Then:

cd ibc-relay-tab
pnpm install
pnpm dev

Open your browser at the provided URL (usually localhost:5173), pick 2 chains to relay between and click CONNECT to set up the light clients.

Click RELAY to start relaying packets (you will still have to manually approve signing in Keplr). Click STOP to stop relaying.

By default, this webapp only relays packets for ibc.applications.transfer where the sender or receiver is you as discovered through Keplr.

If you want to add additional filtering functionality (more exclusive or inclusive or for other IBC apps) you will have to write your own packet filter as defined in confio/ts-relayer#275.

The current address-based filter implementation can be found here for guidance: https://github.com/clockworkgr/ibc-relay-tab/blob/main/src/filters.ts

and used like so: https://github.com/clockworkgr/ibc-relay-tab/blob/main/src/components/RelayTab.vue#L196