@hyperlane-xyz/core 1.3.7 → 1.3.8

package/docs/src/contracts/interfaces/IValidatorAnnounce.sol/interface.IValidatorAnnounce.md

@@ -0,0 +1,78 @@
+# IValidatorAnnounce
+[Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/60f321f452052881dce4e22999022e11fc117456/contracts/interfaces/IValidatorAnnounce.sol)
+
+
+## Functions
+### localDomain
+
+Returns the local domain for validator announcements
+
+
+```solidity
+function localDomain() external view returns (uint32);
+```
+
+### mailbox
+
+Returns the mailbox contract for validator announcements
+
+
+```solidity
+function mailbox() external view returns (address);
+```
+
+### getAnnouncedValidators
+
+Returns a list of validators that have made announcements
+
+
+```solidity
+function getAnnouncedValidators() external view returns (address[] memory);
+```
+
+### getAnnouncedStorageLocations
+
+Returns a list of all announced storage locations for `validators`
+
+
+```solidity
+function getAnnouncedStorageLocations(address[] calldata _validators) external view returns (string[][] memory);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_validators`|`address[]`|The list of validators to get storage locations for|
+
+**Returns**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`<none>`|`string[][]`|A list of announced storage locations|
+
+
+### announce
+
+Announces a validator signature storage location
+
+
+```solidity
+function announce(address _validator, string calldata _storageLocation, bytes calldata _signature)
+    external
+    returns (bool);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_validator`|`address`||
+|`_storageLocation`|`string`|Information encoding the location of signed checkpoints|
+|`_signature`|`bytes`|The signed validator announcement|
+
+**Returns**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`<none>`|`bool`|True upon success|
+
+

package/docs/src/contracts/interfaces/README.md

@@ -0,0 +1,17 @@
+
+
+# Contents
+- [hooks](/contracts/interfaces/hooks)
+- [isms](/contracts/interfaces/isms)
+- [middleware](/contracts/interfaces/middleware)
+- [IGasOracle](IGasOracle.sol/interface.IGasOracle.md)
+- [IHyperlaneConnectionClient](IHyperlaneConnectionClient.sol/interface.IHyperlaneConnectionClient.md)
+- [IInterchainGasPaymaster](IInterchainGasPaymaster.sol/interface.IInterchainGasPaymaster.md)
+- [IInterchainSecurityModule](IInterchainSecurityModule.sol/interface.IInterchainSecurityModule.md)
+- [ISpecifiesInterchainSecurityModule](IInterchainSecurityModule.sol/interface.ISpecifiesInterchainSecurityModule.md)
+- [ILiquidityLayerMessageRecipient](ILiquidityLayerMessageRecipient.sol/interface.ILiquidityLayerMessageRecipient.md)
+- [ILiquidityLayerRouter](ILiquidityLayerRouter.sol/interface.ILiquidityLayerRouter.md)
+- [IMailbox](IMailbox.sol/interface.IMailbox.md)
+- [IMessageRecipient](IMessageRecipient.sol/interface.IMessageRecipient.md)
+- [IRouter](IRouter.sol/interface.IRouter.md)
+- [IValidatorAnnounce](IValidatorAnnounce.sol/interface.IValidatorAnnounce.md)

package/docs/src/contracts/interfaces/hooks/IMessageHook.sol/interface.IMessageHook.md

@@ -0,0 +1,12 @@
+# IMessageHook
+[Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/60f321f452052881dce4e22999022e11fc117456/contracts/interfaces/hooks/IMessageHook.sol)
+
+
+## Functions
+### postDispatch
+
+
+```solidity
+function postDispatch(uint32 _destination, bytes32 _messageId) external payable returns (uint256);
+```
+

package/docs/src/contracts/interfaces/hooks/README.md

@@ -0,0 +1,4 @@
+
+
+# Contents
+- [IMessageHook](IMessageHook.sol/interface.IMessageHook.md)

package/docs/src/contracts/interfaces/isms/IAggregationIsm.sol/interface.IAggregationIsm.md

@@ -0,0 +1,36 @@
+# IAggregationIsm
+[Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/60f321f452052881dce4e22999022e11fc117456/contracts/interfaces/isms/IAggregationIsm.sol)
+
+**Inherits:**
+[IInterchainSecurityModule](/contracts/interfaces/IInterchainSecurityModule.sol/interface.IInterchainSecurityModule.md)
+
+
+## Functions
+### modulesAndThreshold
+
+Returns the set of modules responsible for verifying _message
+and the number of modules that must verify
+
+*Can change based on the content of _message*
+
+
+```solidity
+function modulesAndThreshold(bytes calldata _message)
+    external
+    view
+    returns (address[] memory modules, uint8 threshold);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_message`|`bytes`|Hyperlane formatted interchain message|
+
+**Returns**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`modules`|`address[]`|The array of ISM addresses|
+|`threshold`|`uint8`|The number of modules needed to verify|
+
+

package/docs/src/contracts/interfaces/isms/IMultisigIsm.sol/interface.IMultisigIsm.md

@@ -0,0 +1,36 @@
+# IMultisigIsm
+[Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/60f321f452052881dce4e22999022e11fc117456/contracts/interfaces/isms/IMultisigIsm.sol)
+
+**Inherits:**
+[IInterchainSecurityModule](/contracts/interfaces/IInterchainSecurityModule.sol/interface.IInterchainSecurityModule.md)
+
+
+## Functions
+### validatorsAndThreshold
+
+Returns the set of validators responsible for verifying _message
+and the number of signatures required
+
+*Can change based on the content of _message*
+
+
+```solidity
+function validatorsAndThreshold(bytes calldata _message)
+    external
+    view
+    returns (address[] memory validators, uint8 threshold);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_message`|`bytes`|Hyperlane formatted interchain message|
+
+**Returns**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`validators`|`address[]`|The array of validator addresses|
+|`threshold`|`uint8`|The number of validator signatures needed|
+
+

package/docs/src/contracts/interfaces/isms/IRoutingIsm.sol/interface.IRoutingIsm.md

@@ -0,0 +1,31 @@
+# IRoutingIsm
+[Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/60f321f452052881dce4e22999022e11fc117456/contracts/interfaces/isms/IRoutingIsm.sol)
+
+**Inherits:**
+[IInterchainSecurityModule](/contracts/interfaces/IInterchainSecurityModule.sol/interface.IInterchainSecurityModule.md)
+
+
+## Functions
+### route
+
+Returns the ISM responsible for verifying _message
+
+*Can change based on the content of _message*
+
+
+```solidity
+function route(bytes calldata _message) external view returns (IInterchainSecurityModule);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_message`|`bytes`|Formatted Hyperlane message (see Message.sol).|
+
+**Returns**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`<none>`|`IInterchainSecurityModule`|module The ISM to use to verify _message|
+
+

package/docs/src/contracts/interfaces/isms/README.md

@@ -0,0 +1,6 @@
+
+
+# Contents
+- [IAggregationIsm](IAggregationIsm.sol/interface.IAggregationIsm.md)
+- [IMultisigIsm](IMultisigIsm.sol/interface.IMultisigIsm.md)
+- [IRoutingIsm](IRoutingIsm.sol/interface.IRoutingIsm.md)

package/docs/src/contracts/interfaces/middleware/IInterchainAccountRouter.sol/interface.IInterchainAccountRouter.md

@@ -0,0 +1,64 @@
+# IInterchainAccountRouter
+[Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/60f321f452052881dce4e22999022e11fc117456/contracts/interfaces/middleware/IInterchainAccountRouter.sol)
+
+
+## Functions
+### callRemote
+
+
+```solidity
+function callRemote(uint32 _destination, address _to, uint256 _value, bytes calldata _data)
+    external
+    returns (bytes32);
+```
+
+### callRemote
+
+
+```solidity
+function callRemote(uint32 _destination, CallLib.Call[] calldata calls) external returns (bytes32);
+```
+
+### callRemoteWithOverrides
+
+
+```solidity
+function callRemoteWithOverrides(uint32 _destination, bytes32 _router, bytes32 _ism, CallLib.Call[] calldata calls)
+    external
+    returns (bytes32);
+```
+
+### getLocalInterchainAccount
+
+
+```solidity
+function getLocalInterchainAccount(uint32 _origin, bytes32 _router, bytes32 _owner, address _ism)
+    external
+    view
+    returns (OwnableMulticall);
+```
+
+### getLocalInterchainAccount
+
+
+```solidity
+function getLocalInterchainAccount(uint32 _origin, address _router, address _owner, address _ism)
+    external
+    view
+    returns (OwnableMulticall);
+```
+
+### getRemoteInterchainAccount
+
+
+```solidity
+function getRemoteInterchainAccount(address _router, address _owner, address _ism) external view returns (address);
+```
+
+### getRemoteInterchainAccount
+
+
+```solidity
+function getRemoteInterchainAccount(uint32 _destination, address _owner) external view returns (address);
+```
+

package/docs/src/contracts/interfaces/middleware/IInterchainQueryRouter.sol/interface.IInterchainQueryRouter.md

@@ -0,0 +1,21 @@
+# IInterchainQueryRouter
+[Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/60f321f452052881dce4e22999022e11fc117456/contracts/interfaces/middleware/IInterchainQueryRouter.sol)
+
+
+## Functions
+### query
+
+
+```solidity
+function query(uint32 _destination, address _to, bytes memory _data, bytes memory _callback)
+    external
+    returns (bytes32);
+```
+
+### query
+
+
+```solidity
+function query(uint32 _destination, CallLib.StaticCallWithCallback[] calldata calls) external returns (bytes32);
+```
+

package/docs/src/contracts/interfaces/middleware/README.md

@@ -0,0 +1,5 @@
+
+
+# Contents
+- [IInterchainAccountRouter](IInterchainAccountRouter.sol/interface.IInterchainAccountRouter.md)
+- [IInterchainQueryRouter](IInterchainQueryRouter.sol/interface.IInterchainQueryRouter.md)

package/docs/src/contracts/isms/README.md

@@ -0,0 +1,7 @@
+
+
+# Contents
+- [aggregation](/contracts/isms/aggregation)
+- [multisig](/contracts/isms/multisig)
+- [native](/contracts/isms/native)
+- [routing](/contracts/isms/routing)

package/docs/src/contracts/isms/aggregation/AbstractAggregationIsm.sol/abstract.AbstractAggregationIsm.md

@@ -0,0 +1,60 @@
+# AbstractAggregationIsm
+[Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/60f321f452052881dce4e22999022e11fc117456/contracts/isms/aggregation/AbstractAggregationIsm.sol)
+
+**Inherits:**
+[IAggregationIsm](/contracts/interfaces/isms/IAggregationIsm.sol/interface.IAggregationIsm.md)
+
+Manages per-domain m-of-n ISM sets that are used to verify
+interchain messages.
+
+
+## State Variables
+### moduleType
+
+```solidity
+uint8 public constant moduleType = uint8(IInterchainSecurityModule.Types.AGGREGATION);
+```
+
+
+## Functions
+### modulesAndThreshold
+
+Returns the set of ISMs responsible for verifying _message
+and the number of ISMs that must verify
+
+*Can change based on the content of _message*
+
+
+```solidity
+function modulesAndThreshold(bytes calldata _message) public view virtual returns (address[] memory, uint8);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_message`|`bytes`|Hyperlane formatted interchain message|
+
+**Returns**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`<none>`|`address[]`|modules The array of ISM addresses|
+|`<none>`|`uint8`|threshold The number of ISMs needed to verify|
+
+
+### verify
+
+Requires that m-of-n ISMs verify the provided interchain message.
+
+
+```solidity
+function verify(bytes calldata _metadata, bytes calldata _message) public returns (bool);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_metadata`|`bytes`|ABI encoded module metadata (see AggregationIsmMetadata.sol)|
+|`_message`|`bytes`|Formatted Hyperlane message (see Message.sol).|
+
+

package/docs/src/contracts/isms/aggregation/README.md

@@ -0,0 +1,6 @@
+
+
+# Contents
+- [AbstractAggregationIsm](AbstractAggregationIsm.sol/abstract.AbstractAggregationIsm.md)
+- [StaticAggregationIsm](StaticAggregationIsm.sol/contract.StaticAggregationIsm.md)
+- [StaticAggregationIsmFactory](StaticAggregationIsmFactory.sol/contract.StaticAggregationIsmFactory.md)

package/docs/src/contracts/isms/aggregation/StaticAggregationIsm.sol/contract.StaticAggregationIsm.md

@@ -0,0 +1,30 @@
+# StaticAggregationIsm
+[Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/60f321f452052881dce4e22999022e11fc117456/contracts/isms/aggregation/StaticAggregationIsm.sol)
+
+**Inherits:**
+[AbstractAggregationIsm](/contracts/isms/aggregation/AbstractAggregationIsm.sol/abstract.AbstractAggregationIsm.md)
+
+Manages per-domain m-of-n ISM sets that are used to verify
+interchain messages.
+
+
+## Functions
+### modulesAndThreshold
+
+Returns the set of ISMs responsible for verifying _message
+and the number of ISMs that must verify
+
+*Can change based on the content of _message*
+
+
+```solidity
+function modulesAndThreshold(bytes calldata) public view virtual override returns (address[] memory, uint8);
+```
+**Returns**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`<none>`|`address[]`|modules The array of ISM addresses|
+|`<none>`|`uint8`|threshold The number of ISMs needed to verify|
+
+

package/docs/src/contracts/isms/aggregation/StaticAggregationIsmFactory.sol/contract.StaticAggregationIsmFactory.md

@@ -0,0 +1,15 @@
+# StaticAggregationIsmFactory
+[Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/60f321f452052881dce4e22999022e11fc117456/contracts/isms/aggregation/StaticAggregationIsmFactory.sol)
+
+**Inherits:**
+[StaticMOfNAddressSetFactory](/contracts/libs/StaticMOfNAddressSetFactory.sol/abstract.StaticMOfNAddressSetFactory.md)
+
+
+## Functions
+### _deployImplementation
+
+
+```solidity
+function _deployImplementation() internal virtual override returns (address);
+```
+

package/docs/src/contracts/isms/multisig/AbstractMerkleRootMultisigIsm.sol/abstract.AbstractMerkleRootMultisigIsm.md

@@ -0,0 +1,78 @@
+# AbstractMerkleRootMultisigIsm
+[Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/60f321f452052881dce4e22999022e11fc117456/contracts/isms/multisig/AbstractMerkleRootMultisigIsm.sol)
+
+**Inherits:**
+[AbstractMultisigIsm](/contracts/isms/multisig/AbstractMultisigIsm.sol/abstract.AbstractMultisigIsm.md)
+
+This ISM allows using a newer signed checkpoint (say #33) to prove existence of an older message (#22) in the validators' MerkleTree.
+This guarantees censorship resistance as validators cannot hide a message
+by refusing to sign its checkpoint but later signing a checkpoint for a newer message.
+If validators decide to censor a message, they are left with only one option — to not produce checkpoints at all.
+Otherwise, the very next signed checkpoint (#33) can be used by any relayer to prove the previous message inclusion using this ISM.
+This is censorship resistance is missing in the sibling implementation `AbstractMessageIdMultisigIsm`,
+since it can only verify messages having the corresponding checkpoints.
+
+*Provides the default implementation of verifying signatures over a checkpoint and the message inclusion in that checkpoint.
+This abstract contract can be overridden for customizing the `validatorsAndThreshold()` (static or dynamic).*
+
+*May be adapted in future to support batch message verification against a single root.*
+
+
+## State Variables
+### moduleType
+
+```solidity
+uint8 public constant moduleType = uint8(IInterchainSecurityModule.Types.MERKLE_ROOT_MULTISIG);
+```
+
+
+## Functions
+### digest
+
+Returns the digest to be used for signature verification.
+
+
+```solidity
+function digest(bytes calldata _metadata, bytes calldata _message) internal pure override returns (bytes32);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_metadata`|`bytes`|ABI encoded module metadata|
+|`_message`|`bytes`|Formatted Hyperlane message (see Message.sol).|
+
+**Returns**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`<none>`|`bytes32`|digest The digest to be signed by validators|
+
+
+### signatureAt
+
+Returns the signature at a given index from the metadata.
+
+
+```solidity
+function signatureAt(bytes calldata _metadata, uint256 _index)
+    internal
+    pure
+    virtual
+    override
+    returns (bytes memory signature);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_metadata`|`bytes`|ABI encoded module metadata|
+|`_index`|`uint256`|The index of the signature to return|
+
+**Returns**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`signature`|`bytes`|Packed encoding of signature (65 bytes)|
+
+

package/docs/src/contracts/isms/multisig/AbstractMessageIdMultisigIsm.sol/abstract.AbstractMessageIdMultisigIsm.md

@@ -0,0 +1,69 @@
+# AbstractMessageIdMultisigIsm
+[Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/60f321f452052881dce4e22999022e11fc117456/contracts/isms/multisig/AbstractMessageIdMultisigIsm.sol)
+
+**Inherits:**
+[AbstractMultisigIsm](/contracts/isms/multisig/AbstractMultisigIsm.sol/abstract.AbstractMultisigIsm.md)
+
+This ISM minimizes gas/performance overhead of the checkpoints verification by compromising on the censorship resistance.
+For censorship resistance consider using `AbstractMerkleRootMultisigIsm`.
+If the validators (`validatorsAndThreshold`) skip messages by not sign checkpoints for them,
+the relayers will not be able to aggregate a quorum of signatures sufficient to deliver these messages via this ISM.
+Integrations are free to choose the trade-off between the censorship resistance and the gas/processing overhead.
+
+*Provides the default implementation of verifying signatures over a checkpoint related to a specific message ID.
+This abstract contract can be customized to change the `validatorsAndThreshold()` (static or dynamic).*
+
+
+## State Variables
+### moduleType
+
+```solidity
+uint8 public constant moduleType = uint8(IInterchainSecurityModule.Types.MESSAGE_ID_MULTISIG);
+```
+
+
+## Functions
+### digest
+
+Returns the digest to be used for signature verification.
+
+
+```solidity
+function digest(bytes calldata _metadata, bytes calldata _message) internal pure override returns (bytes32);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_metadata`|`bytes`|ABI encoded module metadata|
+|`_message`|`bytes`|Formatted Hyperlane message (see Message.sol).|
+
+**Returns**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`<none>`|`bytes32`|digest The digest to be signed by validators|
+
+
+### signatureAt
+
+Returns the signature at a given index from the metadata.
+
+
+```solidity
+function signatureAt(bytes calldata _metadata, uint256 _index) internal pure virtual override returns (bytes memory);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_metadata`|`bytes`|ABI encoded module metadata|
+|`_index`|`uint256`|The index of the signature to return|
+
+**Returns**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`<none>`|`bytes`|signature Packed encoding of signature (65 bytes)|
+
+