@hyperlane-xyz/core 1.4.1 → 1.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (143) hide show
  1. package/docs/book.css +13 -0
  2. package/docs/book.toml +12 -0
  3. package/docs/solidity.min.js +74 -0
  4. package/docs/src/README.md +15 -0
  5. package/docs/src/SUMMARY.md +139 -0
  6. package/docs/src/contracts/GasRouter.sol/abstract.GasRouter.md +124 -0
  7. package/docs/src/contracts/HyperlaneConnectionClient.sol/abstract.HyperlaneConnectionClient.md +191 -0
  8. package/docs/src/contracts/Mailbox.sol/contract.Mailbox.md +251 -0
  9. package/docs/src/contracts/OwnableMulticall.sol/contract.OwnableMulticall.md +41 -0
  10. package/docs/src/contracts/PausableReentrancyGuard.sol/abstract.PausableReentrancyGuardUpgradeable.md +100 -0
  11. package/docs/src/contracts/README.md +19 -0
  12. package/docs/src/contracts/Router.sol/abstract.Router.md +255 -0
  13. package/docs/src/contracts/ValidatorAnnounce.sol/contract.ValidatorAnnounce.md +117 -0
  14. package/docs/src/contracts/hooks/ERC5164/ERC5164MessageHook.sol/contract.ERC5164MessageHook.md +64 -0
  15. package/docs/src/contracts/hooks/ERC5164/README.md +5 -0
  16. package/docs/src/contracts/hooks/ERC5164/interfaces/IMessageDispatcher.sol/interface.IMessageDispatcher.md +25 -0
  17. package/docs/src/contracts/hooks/ERC5164/interfaces/README.md +4 -0
  18. package/docs/src/contracts/hooks/OptimismMessageHook.sol/contract.OptimismMessageHook.md +71 -0
  19. package/docs/src/contracts/hooks/README.md +5 -0
  20. package/docs/src/contracts/igps/InterchainGasPaymaster.sol/contract.InterchainGasPaymaster.md +231 -0
  21. package/docs/src/contracts/igps/OverheadIgp.sol/contract.OverheadIgp.md +161 -0
  22. package/docs/src/contracts/igps/README.md +6 -0
  23. package/docs/src/contracts/igps/gas-oracles/README.md +4 -0
  24. package/docs/src/contracts/igps/gas-oracles/StorageGasOracle.sol/contract.StorageGasOracle.md +114 -0
  25. package/docs/src/contracts/interfaces/IGasOracle.sol/interface.IGasOracle.md +25 -0
  26. package/docs/src/contracts/interfaces/IHyperlaneConnectionClient.sol/interface.IHyperlaneConnectionClient.md +43 -0
  27. package/docs/src/contracts/interfaces/IInterchainGasPaymaster.sol/interface.IInterchainGasPaymaster.md +33 -0
  28. package/docs/src/contracts/interfaces/IInterchainSecurityModule.sol/interface.IInterchainSecurityModule.md +55 -0
  29. package/docs/src/contracts/interfaces/IInterchainSecurityModule.sol/interface.ISpecifiesInterchainSecurityModule.md +12 -0
  30. package/docs/src/contracts/interfaces/ILiquidityLayerMessageRecipient.sol/interface.ILiquidityLayerMessageRecipient.md +13 -0
  31. package/docs/src/contracts/interfaces/ILiquidityLayerRouter.sol/interface.ILiquidityLayerRouter.md +19 -0
  32. package/docs/src/contracts/interfaces/IMailbox.sol/interface.IMailbox.md +103 -0
  33. package/docs/src/contracts/interfaces/IMessageRecipient.sol/interface.IMessageRecipient.md +12 -0
  34. package/docs/src/contracts/interfaces/IRouter.sol/interface.IRouter.md +33 -0
  35. package/docs/src/contracts/interfaces/IValidatorAnnounce.sol/interface.IValidatorAnnounce.md +78 -0
  36. package/docs/src/contracts/interfaces/README.md +17 -0
  37. package/docs/src/contracts/interfaces/hooks/IMessageHook.sol/interface.IMessageHook.md +12 -0
  38. package/docs/src/contracts/interfaces/hooks/README.md +4 -0
  39. package/docs/src/contracts/interfaces/isms/IAggregationIsm.sol/interface.IAggregationIsm.md +36 -0
  40. package/docs/src/contracts/interfaces/isms/IMultisigIsm.sol/interface.IMultisigIsm.md +36 -0
  41. package/docs/src/contracts/interfaces/isms/IRoutingIsm.sol/interface.IRoutingIsm.md +31 -0
  42. package/docs/src/contracts/interfaces/isms/README.md +6 -0
  43. package/docs/src/contracts/interfaces/middleware/IInterchainAccountRouter.sol/interface.IInterchainAccountRouter.md +64 -0
  44. package/docs/src/contracts/interfaces/middleware/IInterchainQueryRouter.sol/interface.IInterchainQueryRouter.md +21 -0
  45. package/docs/src/contracts/interfaces/middleware/README.md +5 -0
  46. package/docs/src/contracts/isms/README.md +7 -0
  47. package/docs/src/contracts/isms/aggregation/AbstractAggregationIsm.sol/abstract.AbstractAggregationIsm.md +60 -0
  48. package/docs/src/contracts/isms/aggregation/README.md +6 -0
  49. package/docs/src/contracts/isms/aggregation/StaticAggregationIsm.sol/contract.StaticAggregationIsm.md +30 -0
  50. package/docs/src/contracts/isms/aggregation/StaticAggregationIsmFactory.sol/contract.StaticAggregationIsmFactory.md +15 -0
  51. package/docs/src/contracts/isms/hook/AbstractHookISM.sol/abstract.AbstractHookISM.md +44 -0
  52. package/docs/src/contracts/isms/hook/CrossChainEnabled.sol/abstract.CrossChainEnabled.md +74 -0
  53. package/docs/src/contracts/isms/hook/ERC5164ISM.sol/contract.ERC5164ISM.md +57 -0
  54. package/docs/src/contracts/isms/hook/README.md +7 -0
  55. package/docs/src/contracts/isms/hook/optimism/CrossChainEnabledOptimism.sol/abstract.CrossChainEnabledOptimism.md +53 -0
  56. package/docs/src/contracts/isms/hook/optimism/LibOptimism.sol/library.LibOptimism.md +39 -0
  57. package/docs/src/contracts/isms/hook/optimism/OptimismISM.sol/contract.OptimismISM.md +66 -0
  58. package/docs/src/contracts/isms/hook/optimism/README.md +6 -0
  59. package/docs/src/contracts/isms/multisig/AbstractMerkleRootMultisigIsm.sol/abstract.AbstractMerkleRootMultisigIsm.md +78 -0
  60. package/docs/src/contracts/isms/multisig/AbstractMessageIdMultisigIsm.sol/abstract.AbstractMessageIdMultisigIsm.md +69 -0
  61. package/docs/src/contracts/isms/multisig/AbstractMultisigIsm.sol/abstract.AbstractMultisigIsm.md +102 -0
  62. package/docs/src/contracts/isms/multisig/LegacyMultisigIsm.sol/contract.LegacyMultisigIsm.md +355 -0
  63. package/docs/src/contracts/isms/multisig/README.md +12 -0
  64. package/docs/src/contracts/isms/multisig/StaticMultisigIsm.sol/abstract.AbstractMetaProxyMultisigIsm.md +36 -0
  65. package/docs/src/contracts/isms/multisig/StaticMultisigIsm.sol/contract.StaticMerkleRootMultisigIsm.md +11 -0
  66. package/docs/src/contracts/isms/multisig/StaticMultisigIsm.sol/contract.StaticMerkleRootMultisigIsmFactory.md +15 -0
  67. package/docs/src/contracts/isms/multisig/StaticMultisigIsm.sol/contract.StaticMessageIdMultisigIsm.md +10 -0
  68. package/docs/src/contracts/isms/multisig/StaticMultisigIsm.sol/contract.StaticMessageIdMultisigIsmFactory.md +15 -0
  69. package/docs/src/contracts/isms/routing/AbstractRoutingIsm.sol/abstract.AbstractRoutingIsm.md +55 -0
  70. package/docs/src/contracts/isms/routing/DomainRoutingIsm.sol/contract.DomainRoutingIsm.md +112 -0
  71. package/docs/src/contracts/isms/routing/DomainRoutingIsmFactory.sol/contract.DomainRoutingIsmFactory.md +47 -0
  72. package/docs/src/contracts/isms/routing/InterchainAccountIsm.sol/contract.InterchainAccountIsm.md +44 -0
  73. package/docs/src/contracts/isms/routing/README.md +7 -0
  74. package/docs/src/contracts/libs/Call.sol/library.CallLib.md +124 -0
  75. package/docs/src/contracts/libs/CheckpointLib.sol/library.CheckpointLib.md +61 -0
  76. package/docs/src/contracts/libs/EnumerableMapExtended.sol/library.EnumerableMapExtended.md +63 -0
  77. package/docs/src/contracts/libs/LegacyCheckpointLib.sol/library.LegacyCheckpointLib.md +55 -0
  78. package/docs/src/contracts/libs/Merkle.sol/library.MerkleLib.md +354 -0
  79. package/docs/src/contracts/libs/Message.sol/library.Message.md +304 -0
  80. package/docs/src/contracts/libs/MetaProxy.sol/library.MetaProxy.md +36 -0
  81. package/docs/src/contracts/libs/MinimalProxy.sol/library.MinimalProxy.md +34 -0
  82. package/docs/src/contracts/libs/README.md +16 -0
  83. package/docs/src/contracts/libs/StaticMOfNAddressSetFactory.sol/abstract.StaticMOfNAddressSetFactory.md +123 -0
  84. package/docs/src/contracts/libs/TypeCasts.sol/library.TypeCasts.md +19 -0
  85. package/docs/src/contracts/libs/ValidatorAnnouncements.sol/library.ValidatorAnnouncements.md +31 -0
  86. package/docs/src/contracts/libs/isms/AggregationIsmMetadata.sol/library.AggregationIsmMetadata.md +97 -0
  87. package/docs/src/contracts/libs/isms/LegacyMultisigIsmMetadata.sol/library.LegacyMultisigIsmMetadata.md +296 -0
  88. package/docs/src/contracts/libs/isms/MerkleRootMultisigIsmMetadata.sol/library.MerkleRootMultisigIsmMetadata.md +177 -0
  89. package/docs/src/contracts/libs/isms/MessageIdMultisigIsmMetadata.sol/library.MessageIdMultisigIsmMetadata.md +109 -0
  90. package/docs/src/contracts/libs/isms/README.md +7 -0
  91. package/docs/src/contracts/libs/middleware/InterchainAccountMessage.sol/library.InterchainAccountMessage.md +134 -0
  92. package/docs/src/contracts/libs/middleware/InterchainQueryMessage.sol/library.InterchainQueryMessage.md +203 -0
  93. package/docs/src/contracts/libs/middleware/README.md +5 -0
  94. package/docs/src/contracts/middleware/InterchainAccountRouter.sol/contract.InterchainAccountRouter.md +542 -0
  95. package/docs/src/contracts/middleware/InterchainQueryRouter.sol/contract.InterchainQueryRouter.md +119 -0
  96. package/docs/src/contracts/middleware/README.md +6 -0
  97. package/docs/src/contracts/middleware/liquidity-layer/LiquidityLayerRouter.sol/contract.LiquidityLayerRouter.md +81 -0
  98. package/docs/src/contracts/middleware/liquidity-layer/README.md +6 -0
  99. package/docs/src/contracts/middleware/liquidity-layer/adapters/CircleBridgeAdapter.sol/contract.CircleBridgeAdapter.md +197 -0
  100. package/docs/src/contracts/middleware/liquidity-layer/adapters/PortalAdapter.sol/contract.PortalAdapter.md +189 -0
  101. package/docs/src/contracts/middleware/liquidity-layer/adapters/README.md +5 -0
  102. package/docs/src/contracts/middleware/liquidity-layer/interfaces/ILiquidityLayerAdapter.sol/interface.ILiquidityLayerAdapter.md +23 -0
  103. package/docs/src/contracts/middleware/liquidity-layer/interfaces/README.md +6 -0
  104. package/docs/src/contracts/middleware/liquidity-layer/interfaces/circle/ICircleMessageTransmitter.sol/interface.ICircleMessageTransmitter.md +54 -0
  105. package/docs/src/contracts/middleware/liquidity-layer/interfaces/circle/ITokenMessenger.sol/interface.ITokenMessenger.md +92 -0
  106. package/docs/src/contracts/middleware/liquidity-layer/interfaces/circle/README.md +5 -0
  107. package/docs/src/contracts/middleware/liquidity-layer/interfaces/portal/IPortalTokenBridge.sol/interface.IPortalTokenBridge.md +131 -0
  108. package/docs/src/contracts/middleware/liquidity-layer/interfaces/portal/README.md +4 -0
  109. package/docs/src/contracts/mock/MockCircleMessageTransmitter.sol/contract.MockCircleMessageTransmitter.md +58 -0
  110. package/docs/src/contracts/mock/MockCircleTokenMessenger.sol/contract.MockCircleTokenMessenger.md +44 -0
  111. package/docs/src/contracts/mock/MockERC5164.sol/contract.MockMessageDispatcher.md +15 -0
  112. package/docs/src/contracts/mock/MockERC5164.sol/contract.MockMessageExecutor.md +11 -0
  113. package/docs/src/contracts/mock/MockHyperlaneEnvironment.sol/contract.MockHyperlaneEnvironment.md +69 -0
  114. package/docs/src/contracts/mock/MockMailbox.sol/contract.MockMailbox.md +137 -0
  115. package/docs/src/contracts/mock/MockPortalBridge.sol/contract.MockPortalBridge.md +82 -0
  116. package/docs/src/contracts/mock/MockToken.sol/contract.MockToken.md +22 -0
  117. package/docs/src/contracts/mock/README.md +11 -0
  118. package/docs/src/contracts/test/LightTestRecipient.sol/contract.LightTestRecipient.md +15 -0
  119. package/docs/src/contracts/test/README.md +20 -0
  120. package/docs/src/contracts/test/TestGasRouter.sol/contract.TestGasRouter.md +27 -0
  121. package/docs/src/contracts/test/TestHyperlaneConnectionClient.sol/contract.TestHyperlaneConnectionClient.md +29 -0
  122. package/docs/src/contracts/test/TestInterchainGasPaymaster.sol/contract.TestInterchainGasPaymaster.md +30 -0
  123. package/docs/src/contracts/test/TestLegacyMultisigIsm.sol/contract.TestLegacyMultisigIsm.md +15 -0
  124. package/docs/src/contracts/test/TestLiquidityLayerMessageRecipient.sol/contract.TestLiquidityLayerMessageRecipient.md +23 -0
  125. package/docs/src/contracts/test/TestMailbox.sol/contract.TestMailbox.md +29 -0
  126. package/docs/src/contracts/test/TestMerkle.sol/contract.TestMerkle.md +50 -0
  127. package/docs/src/contracts/test/TestMessage.sol/contract.TestMessage.md +68 -0
  128. package/docs/src/contracts/test/TestMultisigIsm.sol/contract.TestMultisigIsm.md +51 -0
  129. package/docs/src/contracts/test/TestQuery.sol/contract.TestQuery.md +45 -0
  130. package/docs/src/contracts/test/TestQuerySender.sol/contract.TestQuerySender.md +128 -0
  131. package/docs/src/contracts/test/TestRecipient.sol/contract.TestRecipient.md +78 -0
  132. package/docs/src/contracts/test/TestRouter.sol/contract.TestRouter.md +63 -0
  133. package/docs/src/contracts/test/TestSendReceiver.sol/contract.TestSendReceiver.md +49 -0
  134. package/docs/src/contracts/test/TestTokenRecipient.sol/contract.TestTokenRecipient.md +80 -0
  135. package/docs/src/contracts/test/bad-recipient/BadRecipient1.sol/contract.BadRecipient1.md +15 -0
  136. package/docs/src/contracts/test/bad-recipient/BadRecipient2.sol/contract.BadRecipient2.md +12 -0
  137. package/docs/src/contracts/test/bad-recipient/BadRecipient3.sol/contract.BadRecipient3.md +15 -0
  138. package/docs/src/contracts/test/bad-recipient/BadRecipient5.sol/contract.BadRecipient5.md +15 -0
  139. package/docs/src/contracts/test/bad-recipient/BadRecipient6.sol/contract.BadRecipient6.md +15 -0
  140. package/docs/src/contracts/test/bad-recipient/README.md +8 -0
  141. package/docs/src/contracts/upgrade/README.md +4 -0
  142. package/docs/src/contracts/upgrade/Versioned.sol/contract.Versioned.md +14 -0
  143. package/package.json +3 -3
@@ -0,0 +1,30 @@
1
+ # TestInterchainGasPaymaster
2
+ [Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/a5209dbd9b0f5eb34e0bc9df2ba157dda2b454d3/contracts/test/TestInterchainGasPaymaster.sol)
3
+
4
+ **Inherits:**
5
+ [InterchainGasPaymaster](/contracts/igps/InterchainGasPaymaster.sol/contract.InterchainGasPaymaster.md)
6
+
7
+
8
+ ## State Variables
9
+ ### gasPrice
10
+
11
+ ```solidity
12
+ uint256 public constant gasPrice = 10;
13
+ ```
14
+
15
+
16
+ ## Functions
17
+ ### constructor
18
+
19
+
20
+ ```solidity
21
+ constructor(address _beneficiary);
22
+ ```
23
+
24
+ ### quoteGasPayment
25
+
26
+
27
+ ```solidity
28
+ function quoteGasPayment(uint32, uint256 gasAmount) public pure override returns (uint256);
29
+ ```
30
+
@@ -0,0 +1,15 @@
1
+ # TestLegacyMultisigIsm
2
+ [Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/a5209dbd9b0f5eb34e0bc9df2ba157dda2b454d3/contracts/test/TestLegacyMultisigIsm.sol)
3
+
4
+ **Inherits:**
5
+ [LegacyMultisigIsm](/contracts/isms/multisig/LegacyMultisigIsm.sol/contract.LegacyMultisigIsm.md)
6
+
7
+
8
+ ## Functions
9
+ ### getDomainHash
10
+
11
+
12
+ ```solidity
13
+ function getDomainHash(uint32 _origin, bytes32 _originMailbox) external pure returns (bytes32);
14
+ ```
15
+
@@ -0,0 +1,23 @@
1
+ # TestLiquidityLayerMessageRecipient
2
+ [Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/a5209dbd9b0f5eb34e0bc9df2ba157dda2b454d3/contracts/test/TestLiquidityLayerMessageRecipient.sol)
3
+
4
+ **Inherits:**
5
+ [ILiquidityLayerMessageRecipient](/contracts/interfaces/ILiquidityLayerMessageRecipient.sol/interface.ILiquidityLayerMessageRecipient.md)
6
+
7
+
8
+ ## Functions
9
+ ### handleWithTokens
10
+
11
+
12
+ ```solidity
13
+ function handleWithTokens(uint32 _origin, bytes32 _sender, bytes calldata _message, address _token, uint256 _amount)
14
+ external;
15
+ ```
16
+
17
+ ## Events
18
+ ### HandledWithTokens
19
+
20
+ ```solidity
21
+ event HandledWithTokens(uint32 origin, bytes32 sender, bytes message, address token, uint256 amount);
22
+ ```
23
+
@@ -0,0 +1,29 @@
1
+ # TestMailbox
2
+ [Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/a5209dbd9b0f5eb34e0bc9df2ba157dda2b454d3/contracts/test/TestMailbox.sol)
3
+
4
+ **Inherits:**
5
+ [Mailbox](/contracts/Mailbox.sol/contract.Mailbox.md)
6
+
7
+
8
+ ## Functions
9
+ ### constructor
10
+
11
+
12
+ ```solidity
13
+ constructor(uint32 _localDomain) Mailbox(_localDomain);
14
+ ```
15
+
16
+ ### proof
17
+
18
+
19
+ ```solidity
20
+ function proof() external view returns (bytes32[32] memory);
21
+ ```
22
+
23
+ ### testHandle
24
+
25
+
26
+ ```solidity
27
+ function testHandle(uint32 _origin, bytes32 _sender, bytes32 _recipient, bytes calldata _body) external;
28
+ ```
29
+
@@ -0,0 +1,50 @@
1
+ # TestMerkle
2
+ [Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/a5209dbd9b0f5eb34e0bc9df2ba157dda2b454d3/contracts/test/TestMerkle.sol)
3
+
4
+
5
+ ## State Variables
6
+ ### tree
7
+
8
+ ```solidity
9
+ MerkleLib.Tree public tree;
10
+ ```
11
+
12
+
13
+ ## Functions
14
+ ### constructor
15
+
16
+
17
+ ```solidity
18
+ constructor();
19
+ ```
20
+
21
+ ### insert
22
+
23
+
24
+ ```solidity
25
+ function insert(bytes32 _node) external;
26
+ ```
27
+
28
+ ### branchRoot
29
+
30
+
31
+ ```solidity
32
+ function branchRoot(bytes32 _leaf, bytes32[32] calldata _proof, uint256 _index) external pure returns (bytes32 _node);
33
+ ```
34
+
35
+ ### count
36
+
37
+ Returns the number of inserted leaves in the tree
38
+
39
+
40
+ ```solidity
41
+ function count() public view returns (uint256);
42
+ ```
43
+
44
+ ### root
45
+
46
+
47
+ ```solidity
48
+ function root() public view returns (bytes32);
49
+ ```
50
+
@@ -0,0 +1,68 @@
1
+ # TestMessage
2
+ [Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/a5209dbd9b0f5eb34e0bc9df2ba157dda2b454d3/contracts/test/TestMessage.sol)
3
+
4
+
5
+ ## Functions
6
+ ### version
7
+
8
+
9
+ ```solidity
10
+ function version(bytes calldata _message) external pure returns (uint32 _version);
11
+ ```
12
+
13
+ ### nonce
14
+
15
+
16
+ ```solidity
17
+ function nonce(bytes calldata _message) external pure returns (uint256 _nonce);
18
+ ```
19
+
20
+ ### body
21
+
22
+
23
+ ```solidity
24
+ function body(bytes calldata _message) external pure returns (bytes calldata _body);
25
+ ```
26
+
27
+ ### origin
28
+
29
+
30
+ ```solidity
31
+ function origin(bytes calldata _message) external pure returns (uint32 _origin);
32
+ ```
33
+
34
+ ### sender
35
+
36
+
37
+ ```solidity
38
+ function sender(bytes calldata _message) external pure returns (bytes32 _sender);
39
+ ```
40
+
41
+ ### destination
42
+
43
+
44
+ ```solidity
45
+ function destination(bytes calldata _message) external pure returns (uint32 _destination);
46
+ ```
47
+
48
+ ### recipient
49
+
50
+
51
+ ```solidity
52
+ function recipient(bytes calldata _message) external pure returns (bytes32 _recipient);
53
+ ```
54
+
55
+ ### recipientAddress
56
+
57
+
58
+ ```solidity
59
+ function recipientAddress(bytes calldata _message) external pure returns (address _recipient);
60
+ ```
61
+
62
+ ### id
63
+
64
+
65
+ ```solidity
66
+ function id(bytes calldata _message) external pure returns (bytes32);
67
+ ```
68
+
@@ -0,0 +1,51 @@
1
+ # TestMultisigIsm
2
+ [Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/a5209dbd9b0f5eb34e0bc9df2ba157dda2b454d3/contracts/test/TestMultisigIsm.sol)
3
+
4
+ **Inherits:**
5
+ [IMultisigIsm](/contracts/interfaces/isms/IMultisigIsm.sol/interface.IMultisigIsm.md)
6
+
7
+
8
+ ## State Variables
9
+ ### moduleType
10
+
11
+ ```solidity
12
+ uint8 public constant moduleType = uint8(IInterchainSecurityModule.Types.MERKLE_ROOT_MULTISIG);
13
+ ```
14
+
15
+
16
+ ### accept
17
+
18
+ ```solidity
19
+ bool public accept;
20
+ ```
21
+
22
+
23
+ ## Functions
24
+ ### constructor
25
+
26
+
27
+ ```solidity
28
+ constructor();
29
+ ```
30
+
31
+ ### validatorsAndThreshold
32
+
33
+
34
+ ```solidity
35
+ function validatorsAndThreshold(bytes calldata) external pure returns (address[] memory, uint8);
36
+ ```
37
+
38
+ ### setAccept
39
+
40
+
41
+ ```solidity
42
+ function setAccept(bool _val) external;
43
+ ```
44
+
45
+ ### verify
46
+
47
+
48
+ ```solidity
49
+ function verify(bytes calldata, bytes calldata) external view returns (bool);
50
+ ```
51
+
@@ -0,0 +1,45 @@
1
+ # TestQuery
2
+ [Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/a5209dbd9b0f5eb34e0bc9df2ba157dda2b454d3/contracts/test/TestQuery.sol)
3
+
4
+
5
+ ## State Variables
6
+ ### router
7
+
8
+ ```solidity
9
+ InterchainQueryRouter public router;
10
+ ```
11
+
12
+
13
+ ## Functions
14
+ ### constructor
15
+
16
+
17
+ ```solidity
18
+ constructor(address _router);
19
+ ```
20
+
21
+ ### queryRouterOwner
22
+
23
+ *Fetches owner of InterchainQueryRouter on provided domain and passes along with provided secret to `this.receiveRouterOwner`*
24
+
25
+
26
+ ```solidity
27
+ function queryRouterOwner(uint32 domain, uint256 secret) external;
28
+ ```
29
+
30
+ ### receiveRouterOwner
31
+
32
+ *`msg.sender` must be restricted to `this.router` to prevent any local account from spoofing query data.*
33
+
34
+
35
+ ```solidity
36
+ function receiveRouterOwner(uint256 secret, address owner) external;
37
+ ```
38
+
39
+ ## Events
40
+ ### Owner
41
+
42
+ ```solidity
43
+ event Owner(uint256, address);
44
+ ```
45
+
@@ -0,0 +1,128 @@
1
+ # TestQuerySender
2
+ [Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/a5209dbd9b0f5eb34e0bc9df2ba157dda2b454d3/contracts/test/TestQuerySender.sol)
3
+
4
+
5
+ ## State Variables
6
+ ### queryRouter
7
+
8
+ ```solidity
9
+ IInterchainQueryRouter queryRouter;
10
+ ```
11
+
12
+
13
+ ### interchainGasPaymaster
14
+
15
+ ```solidity
16
+ IInterchainGasPaymaster interchainGasPaymaster;
17
+ ```
18
+
19
+
20
+ ### lastAddressResult
21
+
22
+ ```solidity
23
+ address public lastAddressResult;
24
+ ```
25
+
26
+
27
+ ### lastUint256Result
28
+
29
+ ```solidity
30
+ uint256 public lastUint256Result;
31
+ ```
32
+
33
+
34
+ ### lastBytes32Result
35
+
36
+ ```solidity
37
+ bytes32 public lastBytes32Result;
38
+ ```
39
+
40
+
41
+ ## Functions
42
+ ### initialize
43
+
44
+
45
+ ```solidity
46
+ function initialize(address _queryRouterAddress, address _interchainGasPaymaster) external;
47
+ ```
48
+
49
+ ### queryAddress
50
+
51
+
52
+ ```solidity
53
+ function queryAddress(uint32 _destinationDomain, address _target, bytes calldata _targetData, uint256 _gasAmount)
54
+ external
55
+ payable;
56
+ ```
57
+
58
+ ### handleQueryAddressResult
59
+
60
+
61
+ ```solidity
62
+ function handleQueryAddressResult(address _result) external;
63
+ ```
64
+
65
+ ### queryUint256
66
+
67
+
68
+ ```solidity
69
+ function queryUint256(uint32 _destinationDomain, address _target, bytes calldata _targetData, uint256 _gasAmount)
70
+ external
71
+ payable;
72
+ ```
73
+
74
+ ### handleQueryUint256Result
75
+
76
+
77
+ ```solidity
78
+ function handleQueryUint256Result(uint256 _result) external;
79
+ ```
80
+
81
+ ### queryBytes32
82
+
83
+
84
+ ```solidity
85
+ function queryBytes32(uint32 _destinationDomain, address _target, bytes calldata _targetData, uint256 _gasAmount)
86
+ external
87
+ payable;
88
+ ```
89
+
90
+ ### handleQueryBytes32Result
91
+
92
+
93
+ ```solidity
94
+ function handleQueryBytes32Result(bytes32 _result) external;
95
+ ```
96
+
97
+ ### queryAndPayFor
98
+
99
+
100
+ ```solidity
101
+ function queryAndPayFor(
102
+ uint32 _destinationDomain,
103
+ address _target,
104
+ bytes calldata _targetData,
105
+ bytes4 _callbackSelector,
106
+ uint256 _gasAmount
107
+ ) internal;
108
+ ```
109
+
110
+ ## Events
111
+ ### ReceivedAddressResult
112
+
113
+ ```solidity
114
+ event ReceivedAddressResult(address result);
115
+ ```
116
+
117
+ ### ReceivedUint256Result
118
+
119
+ ```solidity
120
+ event ReceivedUint256Result(uint256 result);
121
+ ```
122
+
123
+ ### ReceivedBytes32Result
124
+
125
+ ```solidity
126
+ event ReceivedBytes32Result(bytes32 result);
127
+ ```
128
+
@@ -0,0 +1,78 @@
1
+ # TestRecipient
2
+ [Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/a5209dbd9b0f5eb34e0bc9df2ba157dda2b454d3/contracts/test/TestRecipient.sol)
3
+
4
+ **Inherits:**
5
+ Ownable, [IMessageRecipient](/contracts/interfaces/IMessageRecipient.sol/interface.IMessageRecipient.md), [ISpecifiesInterchainSecurityModule](/contracts/interfaces/IInterchainSecurityModule.sol/interface.ISpecifiesInterchainSecurityModule.md)
6
+
7
+
8
+ ## State Variables
9
+ ### interchainSecurityModule
10
+
11
+ ```solidity
12
+ IInterchainSecurityModule public interchainSecurityModule;
13
+ ```
14
+
15
+
16
+ ### lastSender
17
+
18
+ ```solidity
19
+ bytes32 public lastSender;
20
+ ```
21
+
22
+
23
+ ### lastData
24
+
25
+ ```solidity
26
+ bytes public lastData;
27
+ ```
28
+
29
+
30
+ ### lastCaller
31
+
32
+ ```solidity
33
+ address public lastCaller;
34
+ ```
35
+
36
+
37
+ ### lastCallMessage
38
+
39
+ ```solidity
40
+ string public lastCallMessage;
41
+ ```
42
+
43
+
44
+ ## Functions
45
+ ### handle
46
+
47
+
48
+ ```solidity
49
+ function handle(uint32 _origin, bytes32 _sender, bytes calldata _data) external virtual override;
50
+ ```
51
+
52
+ ### fooBar
53
+
54
+
55
+ ```solidity
56
+ function fooBar(uint256 amount, string calldata message) external;
57
+ ```
58
+
59
+ ### setInterchainSecurityModule
60
+
61
+
62
+ ```solidity
63
+ function setInterchainSecurityModule(address _ism) external onlyOwner;
64
+ ```
65
+
66
+ ## Events
67
+ ### ReceivedMessage
68
+
69
+ ```solidity
70
+ event ReceivedMessage(uint32 indexed origin, bytes32 indexed sender, string message);
71
+ ```
72
+
73
+ ### ReceivedCall
74
+
75
+ ```solidity
76
+ event ReceivedCall(address indexed caller, uint256 amount, string message);
77
+ ```
78
+
@@ -0,0 +1,63 @@
1
+ # TestRouter
2
+ [Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/a5209dbd9b0f5eb34e0bc9df2ba157dda2b454d3/contracts/test/TestRouter.sol)
3
+
4
+ **Inherits:**
5
+ [Router](/contracts/Router.sol/abstract.Router.md)
6
+
7
+
8
+ ## Functions
9
+ ### initialize
10
+
11
+
12
+ ```solidity
13
+ function initialize(address _mailbox, address _interchainGasPaymaster) external initializer;
14
+ ```
15
+
16
+ ### _handle
17
+
18
+
19
+ ```solidity
20
+ function _handle(uint32, bytes32, bytes calldata) internal pure override;
21
+ ```
22
+
23
+ ### isRemoteRouter
24
+
25
+
26
+ ```solidity
27
+ function isRemoteRouter(uint32 _domain, bytes32 _potentialRemoteRouter) external view returns (bool);
28
+ ```
29
+
30
+ ### mustHaveRemoteRouter
31
+
32
+
33
+ ```solidity
34
+ function mustHaveRemoteRouter(uint32 _domain) external view returns (bytes32);
35
+ ```
36
+
37
+ ### dispatch
38
+
39
+
40
+ ```solidity
41
+ function dispatch(uint32 _destination, bytes memory _msg) external;
42
+ ```
43
+
44
+ ### dispatchWithGas
45
+
46
+
47
+ ```solidity
48
+ function dispatchWithGas(
49
+ uint32 _destinationDomain,
50
+ bytes memory _messageBody,
51
+ uint256 _gasAmount,
52
+ uint256 _gasPayment,
53
+ address _gasPaymentRefundAddress
54
+ ) external payable;
55
+ ```
56
+
57
+ ## Events
58
+ ### InitializeOverload
59
+
60
+ ```solidity
61
+ event InitializeOverload();
62
+ ```
63
+
@@ -0,0 +1,49 @@
1
+ # TestSendReceiver
2
+ [Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/a5209dbd9b0f5eb34e0bc9df2ba157dda2b454d3/contracts/test/TestSendReceiver.sol)
3
+
4
+ **Inherits:**
5
+ [IMessageRecipient](/contracts/interfaces/IMessageRecipient.sol/interface.IMessageRecipient.md)
6
+
7
+
8
+ ## State Variables
9
+ ### HANDLE_GAS_AMOUNT
10
+
11
+ ```solidity
12
+ uint256 public constant HANDLE_GAS_AMOUNT = 50_000;
13
+ ```
14
+
15
+
16
+ ## Functions
17
+ ### dispatchToSelf
18
+
19
+
20
+ ```solidity
21
+ function dispatchToSelf(
22
+ IMailbox _mailbox,
23
+ IInterchainGasPaymaster _paymaster,
24
+ uint32 _destinationDomain,
25
+ bytes calldata _messageBody
26
+ ) external payable;
27
+ ```
28
+
29
+ ### handle
30
+
31
+
32
+ ```solidity
33
+ function handle(uint32, bytes32, bytes calldata) external override;
34
+ ```
35
+
36
+ ### previousBlockHash
37
+
38
+
39
+ ```solidity
40
+ function previousBlockHash() internal view returns (bytes32);
41
+ ```
42
+
43
+ ## Events
44
+ ### Handled
45
+
46
+ ```solidity
47
+ event Handled(bytes32 blockHash);
48
+ ```
49
+
@@ -0,0 +1,80 @@
1
+ # TestTokenRecipient
2
+ [Git Source](https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/a5209dbd9b0f5eb34e0bc9df2ba157dda2b454d3/contracts/test/TestTokenRecipient.sol)
3
+
4
+ **Inherits:**
5
+ [ILiquidityLayerMessageRecipient](/contracts/interfaces/ILiquidityLayerMessageRecipient.sol/interface.ILiquidityLayerMessageRecipient.md)
6
+
7
+
8
+ ## State Variables
9
+ ### lastSender
10
+
11
+ ```solidity
12
+ bytes32 public lastSender;
13
+ ```
14
+
15
+
16
+ ### lastData
17
+
18
+ ```solidity
19
+ bytes public lastData;
20
+ ```
21
+
22
+
23
+ ### lastToken
24
+
25
+ ```solidity
26
+ address public lastToken;
27
+ ```
28
+
29
+
30
+ ### lastAmount
31
+
32
+ ```solidity
33
+ uint256 public lastAmount;
34
+ ```
35
+
36
+
37
+ ### lastCaller
38
+
39
+ ```solidity
40
+ address public lastCaller;
41
+ ```
42
+
43
+
44
+ ### lastCallMessage
45
+
46
+ ```solidity
47
+ string public lastCallMessage;
48
+ ```
49
+
50
+
51
+ ## Functions
52
+ ### handleWithTokens
53
+
54
+
55
+ ```solidity
56
+ function handleWithTokens(uint32 _origin, bytes32 _sender, bytes calldata _data, address _token, uint256 _amount)
57
+ external
58
+ override;
59
+ ```
60
+
61
+ ### fooBar
62
+
63
+
64
+ ```solidity
65
+ function fooBar(uint256 amount, string calldata message) external;
66
+ ```
67
+
68
+ ## Events
69
+ ### ReceivedMessage
70
+
71
+ ```solidity
72
+ event ReceivedMessage(uint32 indexed origin, bytes32 indexed sender, string message, address token, uint256 amount);
73
+ ```
74
+
75
+ ### ReceivedCall
76
+
77
+ ```solidity
78
+ event ReceivedCall(address indexed caller, uint256 amount, string message);
79
+ ```
80
+