Troubleshooting

Having trouble with Hyperlane? Let's help you figure it out!
As you navigate the interchain space and begin sending your first messages between blockchains, you may run into some issues. This section will help you troubleshoot common issues so you can get right back on the Interchain Highway and onwards to your destination!

Message Delivery

For a simple approach to debugging messages, try the Hyperlane Explorer. It can diagnose common issues with message delivery. See Debugging with Explorer for details.
Still need more help? Find our team on the Hyperlane Discord and ask away!

Etherscan says an Error ocurrred

More often than not, it is not actually an error. What happens is that the Mailbox will attempt to make a call to the recipient to query its Interchain security modules. If a recipient does not specify an ISM by implementing the interface, the Mailbox will default to the default ISM that is configured on it. However, to Etherscan, the transaction trace includes a revert which it calls out, however in this case, it is a false-positive. So if you see a process transaction like this one, know that your message has actually been processed.
This is actually fine!
This is also fine!

Off-chain Agents

Missing name field error

An error about a missing name field most likely indicates that you have an environment variable that implies the existence of a chain, but said chain does not exist in the config files. You may have mispelled the ENV name (HYP_BASE_CHAINS_GOERLI_CONNECTION_URL). Or you may have specified a new chain but forgot to load the corresponding config file.