Comment on page

AMB Implementations

Introduction
AMB (Arbitrary Messaging Bridge) implementations are the individual messaging bridges used to move messages defined in various State Registry contracts. 
Core Concepts
All AMB implementations must implement IAmbImplementation , which defines a set of important characteristics to be able to dispatch messages via that particular bridge. Individual AMB Implementations all have different ways of receiving payloads, but other methods are standardized. 
dispatchPayload
This function allows the state registry to send a message via the implementation. This function is overridden in individual implementations and can only be called by State Registries the PROTOCOL_ADMIN has given appropriate permissions to.
function dispatchPayload(
        address srcSender_,
        uint64 dstChainId_,
        bytes memory message_,
        bytes memory extraData_
) external payable;
name
description
srcSender_
address of the caller, used for gas refunds
dstChainId_
uint64 of the EVM chain id to send the message to
message_
bytes message to pass to the given chain
extraData_
bytes AMB override specific to the bridge
retryPayload
This function specifies a method to allow for the permissionless calling of the AMB's retry mechanism if payloads aren't successfully delivered. 
function retryPayload(
    bytes memory data_
) external payable
name
description
data_
bytes encoded data of the appropriate data types to hash in the message to retry, specific on the AMB implementation
estimateFees
This function returns an estimate of gas fees in native tokens to send the message.
function estimateFees(
    uint64 dstChainId_,
    bytes memory message_,
    bytes memory extraData_
) external view returns (uint256 fees);
name
description
dstChainId_
uint64 of the EVM chain ID to send the message
message_
bytes message to pass to the given chain
extraData_
bytes AMB override specific to the bridge

name	description
`srcSender_`	address of the caller, used for gas refunds
`dstChainId_`	uint64 of the EVM chain id to send the message to
`message_`	bytes message to pass to the given chain
`extraData_`	bytes AMB override specific to the bridge

name	description
`data_`	bytes encoded data of the appropriate data types to hash in the message to retry, specific on the AMB implementation

name	description
`dstChainId_`	uint64 of the EVM chain ID to send the message
`message_`	bytes message to pass to the given chain
`extraData_`	bytes AMB override specific to the bridge

Last modified 19d ago