@hyperlane-xyz/core 1.4.0 → 1.4.2

package/docs/src/contracts/isms/multisig/LegacyMultisigIsm.sol/contract.LegacyMultisigIsm.md

@@ -0,0 +1,355 @@
+# LegacyMultisigIsm
+[Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/a5209dbd9b0f5eb34e0bc9df2ba157dda2b454d3/contracts/isms/multisig/LegacyMultisigIsm.sol)
+
+**Inherits:**
+[IMultisigIsm](/contracts/interfaces/isms/IMultisigIsm.sol/interface.IMultisigIsm.md), Ownable
+
+Manages an ownable set of validators that ECDSA sign checkpoints to
+reach a quorum.
+
+
+## State Variables
+### moduleType
+
+```solidity
+uint8 public constant moduleType = uint8(IInterchainSecurityModule.Types.LEGACY_MULTISIG);
+```
+
+
+### threshold
+The validator threshold for each remote domain.
+
+
+```solidity
+mapping(uint32 => uint8) public threshold;
+```
+
+
+### validatorSet
+The validator set for each remote domain.
+
+
+```solidity
+mapping(uint32 => EnumerableSet.AddressSet) private validatorSet;
+```
+
+
+### commitment
+A succinct commitment to the validator set and threshold for each remote
+domain.
+
+
+```solidity
+mapping(uint32 => bytes32) public commitment;
+```
+
+
+## Functions
+### constructor
+
+
+```solidity
+constructor() Ownable;
+```
+
+### enrollValidators
+
+Enrolls multiple validators into a validator set.
+
+*Reverts if `_validator` is already in the validator set.*
+
+*_validators[i] are the validators to enroll for _domains[i].*
+
+
+```solidity
+function enrollValidators(uint32[] calldata _domains, address[][] calldata _validators) external onlyOwner;
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_domains`|`uint32[]`|The remote domains of the validator sets.|
+|`_validators`|`address[][]`|The validators to add to the validator sets.|
+
+
+### enrollValidator
+
+Enrolls a validator into a validator set.
+
+*Reverts if `_validator` is already in the validator set.*
+
+
+```solidity
+function enrollValidator(uint32 _domain, address _validator) external onlyOwner;
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_domain`|`uint32`|The remote domain of the validator set.|
+|`_validator`|`address`|The validator to add to the validator set.|
+
+
+### unenrollValidator
+
+Unenrolls a validator from a validator set.
+
+*Reverts if `_validator` is not in the validator set.*
+
+
+```solidity
+function unenrollValidator(uint32 _domain, address _validator) external onlyOwner;
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_domain`|`uint32`|The remote domain of the validator set.|
+|`_validator`|`address`|The validator to remove from the validator set.|
+
+
+### setThresholds
+
+Sets the quorum threshold for multiple domains.
+
+
+```solidity
+function setThresholds(uint32[] calldata _domains, uint8[] calldata _thresholds) external onlyOwner;
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_domains`|`uint32[]`|The remote domains of the validator sets.|
+|`_thresholds`|`uint8[]`|The new quorum thresholds.|
+
+
+### isEnrolled
+
+Returns whether an address is enrolled in a validator set.
+
+
+```solidity
+function isEnrolled(uint32 _domain, address _address) external view returns (bool);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_domain`|`uint32`|The remote domain of the validator set.|
+|`_address`|`address`|The address to test for set membership.|
+
+**Returns**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`<none>`|`bool`|True if the address is enrolled, false otherwise.|
+
+
+### setThreshold
+
+Sets the quorum threshold.
+
+
+```solidity
+function setThreshold(uint32 _domain, uint8 _threshold) public onlyOwner;
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_domain`|`uint32`|The remote domain of the validator set.|
+|`_threshold`|`uint8`|The new quorum threshold.|
+
+
+### verify
+
+Verifies that a quorum of the origin domain's validators signed
+a checkpoint, and verifies the merkle proof of `_message` against that
+checkpoint.
+
+
+```solidity
+function verify(bytes calldata _metadata, bytes calldata _message) external view returns (bool);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_metadata`|`bytes`|ABI encoded module metadata (see LegacyMultisigIsmMetadata.sol)|
+|`_message`|`bytes`|Formatted Hyperlane message (see Message.sol).|
+
+
+### validators
+
+Gets the current validator set
+
+
+```solidity
+function validators(uint32 _domain) public view returns (address[] memory);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_domain`|`uint32`|The remote domain of the validator set.|
+
+**Returns**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`<none>`|`address[]`|The addresses of the validator set.|
+
+
+### 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, uint8);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_message`|`bytes`|Hyperlane formatted interchain message|
+
+**Returns**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`<none>`|`address[]`|validators The array of validator addresses|
+|`<none>`|`uint8`|threshold The number of validator signatures needed|
+
+
+### validatorCount
+
+Returns the number of validators enrolled in the validator set.
+
+
+```solidity
+function validatorCount(uint32 _domain) public view returns (uint256);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_domain`|`uint32`|The remote domain of the validator set.|
+
+**Returns**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`<none>`|`uint256`|The number of validators enrolled in the validator set.|
+
+
+### _enrollValidator
+
+Enrolls a validator into a validator set.
+
+*Reverts if `_validator` is already in the validator set.*
+
+
+```solidity
+function _enrollValidator(uint32 _domain, address _validator) internal;
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_domain`|`uint32`|The remote domain of the validator set.|
+|`_validator`|`address`|The validator to add to the validator set.|
+
+
+### _updateCommitment
+
+Updates the commitment to the validator set for `_domain`.
+
+
+```solidity
+function _updateCommitment(uint32 _domain) internal returns (bytes32);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_domain`|`uint32`|The remote domain of the validator set.|
+
+**Returns**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`<none>`|`bytes32`|The commitment to the validator set for `_domain`.|
+
+
+### _verifyMerkleProof
+
+Verifies the merkle proof of `_message` against the provided
+checkpoint.
+
+
+```solidity
+function _verifyMerkleProof(bytes calldata _metadata, bytes calldata _message) internal pure returns (bool);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_metadata`|`bytes`|ABI encoded module metadata (see LegacyMultisigIsmMetadata.sol)|
+|`_message`|`bytes`|Formatted Hyperlane message (see Message.sol).|
+
+
+### _verifyValidatorSignatures
+
+Verifies that a quorum of the origin domain's validators signed
+the provided checkpoint.
+
+
+```solidity
+function _verifyValidatorSignatures(bytes calldata _metadata, bytes calldata _message) internal view returns (bool);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_metadata`|`bytes`|ABI encoded module metadata (see LegacyMultisigIsmMetadata.sol)|
+|`_message`|`bytes`|Formatted Hyperlane message (see Message.sol).|
+
+
+## Events
+### ValidatorEnrolled
+Emitted when a validator is enrolled in a validator set.
+
+
+```solidity
+event ValidatorEnrolled(uint32 indexed domain, address indexed validator, uint256 validatorCount);
+```
+
+### ValidatorUnenrolled
+Emitted when a validator is unenrolled from a validator set.
+
+
+```solidity
+event ValidatorUnenrolled(uint32 indexed domain, address indexed validator, uint256 validatorCount);
+```
+
+### ThresholdSet
+Emitted when the quorum threshold is set.
+
+
+```solidity
+event ThresholdSet(uint32 indexed domain, uint8 threshold);
+```
+
+### CommitmentUpdated
+Emitted when the validator set or threshold changes.
+
+
+```solidity
+event CommitmentUpdated(uint32 domain, bytes32 commitment);
+```
+

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

@@ -0,0 +1,12 @@
+
+
+# Contents
+- [AbstractMerkleRootMultisigIsm](AbstractMerkleRootMultisigIsm.sol/abstract.AbstractMerkleRootMultisigIsm.md)
+- [AbstractMessageIdMultisigIsm](AbstractMessageIdMultisigIsm.sol/abstract.AbstractMessageIdMultisigIsm.md)
+- [AbstractMultisigIsm](AbstractMultisigIsm.sol/abstract.AbstractMultisigIsm.md)
+- [LegacyMultisigIsm](LegacyMultisigIsm.sol/contract.LegacyMultisigIsm.md)
+- [AbstractMetaProxyMultisigIsm](StaticMultisigIsm.sol/abstract.AbstractMetaProxyMultisigIsm.md)
+- [StaticMerkleRootMultisigIsm](StaticMultisigIsm.sol/contract.StaticMerkleRootMultisigIsm.md)
+- [StaticMessageIdMultisigIsm](StaticMultisigIsm.sol/contract.StaticMessageIdMultisigIsm.md)
+- [StaticMerkleRootMultisigIsmFactory](StaticMultisigIsm.sol/contract.StaticMerkleRootMultisigIsmFactory.md)
+- [StaticMessageIdMultisigIsmFactory](StaticMultisigIsm.sol/contract.StaticMessageIdMultisigIsmFactory.md)

package/docs/src/contracts/isms/multisig/StaticMultisigIsm.sol/abstract.AbstractMetaProxyMultisigIsm.md

@@ -0,0 +1,36 @@
+# AbstractMetaProxyMultisigIsm
+[Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/a5209dbd9b0f5eb34e0bc9df2ba157dda2b454d3/contracts/isms/multisig/StaticMultisigIsm.sol)
+
+**Inherits:**
+[AbstractMultisigIsm](/contracts/isms/multisig/AbstractMultisigIsm.sol/abstract.AbstractMultisigIsm.md)
+
+Manages per-domain m-of-n Validator set that is used
+to verify interchain messages.
+
+
+## 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) public pure override returns (address[] memory, uint8);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`<none>`|`bytes`||
+
+**Returns**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`<none>`|`address[]`|validators The array of validator addresses|
+|`<none>`|`uint8`|threshold The number of validator signatures needed|
+
+

package/docs/src/contracts/isms/multisig/StaticMultisigIsm.sol/contract.StaticMerkleRootMultisigIsm.md

@@ -0,0 +1,11 @@
+# StaticMerkleRootMultisigIsm
+[Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/a5209dbd9b0f5eb34e0bc9df2ba157dda2b454d3/contracts/isms/multisig/StaticMultisigIsm.sol)
+
+**Inherits:**
+[AbstractMerkleRootMultisigIsm](/contracts/isms/multisig/AbstractMerkleRootMultisigIsm.sol/abstract.AbstractMerkleRootMultisigIsm.md), [AbstractMetaProxyMultisigIsm](/contracts/isms/multisig/StaticMultisigIsm.sol/abstract.AbstractMetaProxyMultisigIsm.md)
+
+Manages per-domain m-of-n validator set that is used
+to verify interchain messages using a merkle root signature quorum
+and merkle proof of inclusion.
+
+

package/docs/src/contracts/isms/multisig/StaticMultisigIsm.sol/contract.StaticMerkleRootMultisigIsmFactory.md

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

package/docs/src/contracts/isms/multisig/StaticMultisigIsm.sol/contract.StaticMessageIdMultisigIsm.md

@@ -0,0 +1,10 @@
+# StaticMessageIdMultisigIsm
+[Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/a5209dbd9b0f5eb34e0bc9df2ba157dda2b454d3/contracts/isms/multisig/StaticMultisigIsm.sol)
+
+**Inherits:**
+[AbstractMessageIdMultisigIsm](/contracts/isms/multisig/AbstractMessageIdMultisigIsm.sol/abstract.AbstractMessageIdMultisigIsm.md), [AbstractMetaProxyMultisigIsm](/contracts/isms/multisig/StaticMultisigIsm.sol/abstract.AbstractMetaProxyMultisigIsm.md)
+
+Manages per-domain m-of-n validator set that is used
+to verify interchain messages using a message ID signature quorum.
+
+

package/docs/src/contracts/isms/multisig/StaticMultisigIsm.sol/contract.StaticMessageIdMultisigIsmFactory.md

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

package/docs/src/contracts/isms/routing/AbstractRoutingIsm.sol/abstract.AbstractRoutingIsm.md

@@ -0,0 +1,55 @@
+# AbstractRoutingIsm
+[Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/a5209dbd9b0f5eb34e0bc9df2ba157dda2b454d3/contracts/isms/routing/AbstractRoutingIsm.sol)
+
+**Inherits:**
+[IRoutingIsm](/contracts/interfaces/isms/IRoutingIsm.sol/interface.IRoutingIsm.md)
+
+
+## State Variables
+### moduleType
+
+```solidity
+uint8 public constant moduleType = uint8(IInterchainSecurityModule.Types.ROUTING);
+```
+
+
+## Functions
+### route
+
+Returns the ISM responsible for verifying _message
+
+*Can change based on the content of _message*
+
+
+```solidity
+function route(bytes calldata _message) public view virtual 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|
+
+
+### verify
+
+Routes _metadata and _message to the correct ISM
+
+
+```solidity
+function verify(bytes calldata _metadata, bytes calldata _message) public returns (bool);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_metadata`|`bytes`|ABI encoded module metadata|
+|`_message`|`bytes`|Formatted Hyperlane message (see Message.sol).|
+
+

package/docs/src/contracts/isms/routing/DomainRoutingIsm.sol/contract.DomainRoutingIsm.md

@@ -0,0 +1,112 @@
+# DomainRoutingIsm
+[Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/a5209dbd9b0f5eb34e0bc9df2ba157dda2b454d3/contracts/isms/routing/DomainRoutingIsm.sol)
+
+**Inherits:**
+[AbstractRoutingIsm](/contracts/isms/routing/AbstractRoutingIsm.sol/abstract.AbstractRoutingIsm.md), OwnableUpgradeable
+
+
+## State Variables
+### modules
+
+```solidity
+mapping(uint32 => IInterchainSecurityModule) public modules;
+```
+
+
+## Functions
+### initialize
+
+
+```solidity
+function initialize(address _owner) public initializer;
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_owner`|`address`|The owner of the contract.|
+
+
+### initialize
+
+Sets the ISMs to be used for the specified origin domains
+
+
+```solidity
+function initialize(address _owner, uint32[] calldata _domains, IInterchainSecurityModule[] calldata _modules)
+    public
+    initializer;
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_owner`|`address`|The owner of the contract.|
+|`_domains`|`uint32[]`|The origin domains|
+|`_modules`|`IInterchainSecurityModule[]`|The ISMs to use to verify messages|
+
+
+### set
+
+Sets the ISM to be used for the specified origin domain
+
+
+```solidity
+function set(uint32 _domain, IInterchainSecurityModule _module) external onlyOwner;
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_domain`|`uint32`|The origin domain|
+|`_module`|`IInterchainSecurityModule`|The ISM to use to verify messages|
+
+
+### route
+
+Returns the ISM responsible for verifying _message
+
+*Can change based on the content of _message*
+
+
+```solidity
+function route(bytes calldata _message) public view virtual override 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|
+
+
+### _set
+
+Sets the ISM to be used for the specified origin domain
+
+
+```solidity
+function _set(uint32 _domain, IInterchainSecurityModule _module) internal;
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_domain`|`uint32`|The origin domain|
+|`_module`|`IInterchainSecurityModule`|The ISM to use to verify messages|
+
+
+## Events
+### ModuleSet
+Emitted when a module is set for a domain
+
+
+```solidity
+event ModuleSet(uint32 indexed domain, IInterchainSecurityModule module);
+```
+

package/docs/src/contracts/isms/routing/DomainRoutingIsmFactory.sol/contract.DomainRoutingIsmFactory.md

@@ -0,0 +1,47 @@
+# DomainRoutingIsmFactory
+[Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/a5209dbd9b0f5eb34e0bc9df2ba157dda2b454d3/contracts/isms/routing/DomainRoutingIsmFactory.sol)
+
+
+## State Variables
+### _implementation
+
+```solidity
+address private immutable _implementation;
+```
+
+
+## Functions
+### constructor
+
+
+```solidity
+constructor();
+```
+
+### deploy
+
+Deploys and initializes a DomainRoutingIsm using a minimal proxy
+
+
+```solidity
+function deploy(uint32[] calldata _domains, IInterchainSecurityModule[] calldata _modules)
+    external
+    returns (DomainRoutingIsm);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`_domains`|`uint32[]`|The origin domains|
+|`_modules`|`IInterchainSecurityModule[]`|The ISMs to use to verify messages|
+
+
+## Events
+### ModuleDeployed
+Emitted when a routing module is deployed
+
+
+```solidity
+event ModuleDeployed(DomainRoutingIsm module);
+```
+