Send your first interchain message

This tutorial demonstrates how to send an interchain message to a pre-deployed TestRecipient contract.

Sending a message is a simple matter of calling Mailbox.dispatch. Make sure you have an account with funds on the origin chain.

origin:

• alfajores
• bsctestnet
• chiado
• fuji
• plumetestnet
• scrollsepolia
• sepolia
• solanadevnet
• solanatestnet
• eclipsetestnet

destination:

• alfajores
• bsctestnet
• chiado
• fuji
• plumetestnet
• scrollsepolia
• sepolia
• solanadevnet
• solanatestnet
• eclipsetestnet

body:

Hyperlane CLI

Install the CLI:

npm install -g @hyperlane-xyz/cli

Send the message:

hyperlane send message --origin alfajores --destination bsctestnet --body "Hello, world""

Cast

Install cast:

curl -L https://foundry.paradigm.xyz | bash

Send the message:

cast send 0xEf9F292fcEBC3848bF4bB92a96a04F9ECBb78E59 "dispatch(uint32,bytes32,bytes)" 97 0x0000000000000000000000006489d13AcAd3B8dce4c5B31f375DE4f9451E7b38 $(cast --from-utf8 "Hello, world") --rpc-url https://alfajores-forno.celo-testnet.org --value 0.01ether

Explorer

1. Navigate to the alfajores.celoscan.io dispatch interface
2. Click on the Connect to Web3 button to connect your Wallet. Make sure you are on alfajores.
3. Fill in value: 0.01, destination: 97, recipient: 0x0000000000000000000000006489d13AcAd3B8dce4c5B31f375DE4f9451E7b38, and message the hex representation of "Hello, world". For example if you have cast installed, cast --from-utf8 "Hello, world" returns 0x48656c6c6f2c20776f726c64.
4. Click the Write button to submit the transaction!

tip

You can watch the progress of your message on explorer.hyperlane.xyz by searching for the transaction hash of your Mailbox.dispatch call.

Check the result

The TestRecipient has the following handle implementation:

Solidity

function handle(
    uint32 _origin,
    bytes32 _sender,
    bytes calldata _data
) external payable virtual override {
    emit ReceivedMessage(_origin, _sender, msg.value, string(_data));
    lastSender = _sender;
    lastData = _data;
}

CosmWasm

🚧 Coming soon! 🚧

Check the logs to see your message delivery!

Testnet TestRecipient Addresses

Chain	Domain	Address	Explorer
Alfajores	44787	0x6489d13AcAd3B8dce4c5B31f375DE4f9451E7b38	alfajores.celoscan.io
BSC Testnet	97	0xfbcD1c00a3d809f36cC1A15918694B17B32c0b6c	testnet.bscscan.com
Fuji	43113	0x44a7e1d76fD8AfA244AdE7278336E3D5C658D398	testnet.snowtrace.io
Plume Testnet	161221135	0xe0B988062A0C6492177d64823Ab95a9c256c2a5F	plume-testnet.explorer.caldera.xyz
Scroll Sepolia	534351	0xa3AB7E6cE24E6293bD5320A53329Ef2f4DE73fCA	sepolia.scrollscan.dev
Sepolia	11155111	0xeDc1A3EDf87187085A3ABb7A9a65E1e7aE370C07	sepolia.etherscan.io

Testnet Mailbox Addresses

Chain	Domain	Address	Explorer
Alfajores	44787	0xEf9F292fcEBC3848bF4bB92a96a04F9ECBb78E59	alfajores.celoscan.io
BSC Testnet	97	0xF9F6F5646F478d5ab4e20B0F910C92F1CCC9Cc6D	testnet.bscscan.com
Fuji	43113	0x5b6CFf85442B851A8e6eaBd2A4E4507B5135B3B0	testnet.snowtrace.io
Plume Testnet	161221135	0x33dB966328Ea213b0f76eF96CA368AB37779F065	plume-testnet.explorer.caldera.xyz
Scroll Sepolia	534351	0x3C5154a193D6e2955650f9305c8d80c18C814A68	sepolia.scrollscan.dev
Sepolia	11155111	0xfFAEF09B3cd11D9b20d1a19bECca54EEC2884766	sepolia.etherscan.io