Comment on page
Interface
The security interface for Hyperlane
ISMs must implement the
IInterchainSecurityModel() interface. This interface consists of two functions.// SPDX-License-Identifier: MIT OR Apache-2.0
pragma solidity >=0.6.11;
interface IInterchainSecurityModule {
/**
* @notice Returns an enum that represents the type of security model
* encoded by this ISM.
* @dev Relayers infer how to fetch and format metadata.
*/
function moduleType() external view returns (uint8);
/**
* @notice Defines a security model responsible for verifying interchain
* messages based on the provided metadata.
* @param _metadata Off-chain metadata provided by a relayer, specific to
* the security model encoded by the module (e.g. validator signatures)
* @param _message Hyperlane encoded interchain message
* @return True if the message was verified
*/
function verify(bytes calldata _metadata, bytes calldata _message)
external
returns (bool);
}
The primary function that ISMs must implement is
verify(). The Mailbox will call IInterchainSecurityModule.verify() before delivering a message to its recipient. If verify() reverts or returns false, the message will not be delivered.The
verify() function takes two parameters.The first,
_metadata, consists of arbitrary bytes provided by Relayers. Typically, these bytes are specific to the ISM. For example, for a Multisig ISM, _metadata must include validator signatures.The second,
_message, consists of the Hyperlane message being verified. ISMs can use this to inspect details about the message being verified. For example, a Multisig ISM could change validator sets based on the origin chain of the message.See the
Message.sol library for more information on the format of the Hyperlane message passed to verify()The secondary function that ISMs must implement is
moduleType(). This is used to signal to Relayerswhat to include in _metadata. ISMs must return one of the supported module types.The following shows a simplified sequence diagram of an interchain message being verified and delivered on the destination chain.
If the recipient does not implement
ISpecifiesInterchainSecurityModule or recipient.interchainSecurityModule() returns address(0), the default ISM configured on the Mailbox will be used to verify the message.This is omitted from the sequence diagram for clarity.
Last modified 2mo ago