A built-in IBC relayer in Ignite CLI lets you connect blockchains that run on your local computer to blockchains that run on remote computers. The Ignite CLI relayer uses the TypeScript relayer.
configure command configures a connection between two blockchains:
ignite relayer configure
You are prompted for the required RPC endpoints and optional faucet endpoints. Accounts used by the relayer are created on both blockchains and faucets are used, if available, to automatically fetch tokens.
If the relayer fails to receive tokens from a faucet, you must manually send tokens to addresses.
By default, a connection for token transfers is set up for the
--advanced flag lets you configure port and version for the custom IBC module.
By default, relayer configuration is stored in
Remove existing relayers
If you previously used the Ignite CLI relayer, follow these steps to remove existing relayer and Ignite CLI configurations:
Stop your blockchain or blockchains.
Delete previous configuration files:
rm -rf ~/.ignite/relayer
Restart your blockchains.
Relayer configure example
All values can be passed with flags.
ignite relayer configure --advanced --source-rpc "http://0.0.0.0:26657" --source-faucet "http://0.0.0.0:4500" --source-port "blog" --source-version "blog-1" --target-rpc "http://0.0.0.0:26659" --target-faucet "http://0.0.0.0:4501" --target-port "blog" --target-version "blog-1"
Connect blockchains and watch for IBC packets
ignite relayer connect command connects configured blockchains and watches for IBC packets to relay.
Tip: You can observe the relayer packets on the terminal window where you connected your relayer.