Messaging API

Send and receive interchain messages using Hyperlane

Hyperlane provides an on-chain API for sending and receiving interchain messages.

Cant wait to get started? Follow the Messaging quickstart to send your first interchain message in less than five minutes. Otherwise, read on—

Interface

To Send interchain messages, reference the Mailbox.dispatch() API.

To Receive interchain messages, implement the IMessageRecipient interface.

Testing

See the Unit testing documentation to see how to test your integration with the Hyperlane messaging API using the MockMailbox contracts.

Interchain gas

Delivering an interchain message requires submitting a transaction on the destination chain. Optionally, you can pay for the gas for this transaction on the origin chain, and let Hyperlane Relayers deliver your message for you.

Learn more about Automatically pay for interchain gas.