feat: support CCTP v2 fast transfers (#6709)

Author: yorhodes

.changeset/light-years-reply.md

@@ -0,0 +1,5 @@
+---
+"@hyperlane-xyz/core": minor
+---
+
+Implement support for CCTP v2 fast transfers

solidity/contracts/interfaces/cctp/IMessageHandlerV2.sol

@@ -0,0 +1,57 @@
+/*
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+pragma solidity >=0.8.0;
+
+/**
+ * @title IMessageHandlerV2
+ * @notice Handles messages on the destination domain, forwarded from
+ * an IReceiverV2.
+ */
+interface IMessageHandlerV2 {
+    /**
+     * @notice Handles an incoming finalized message from an IReceiverV2
+     * @dev Finalized messages have finality threshold values greater than or equal to 2000
+     * @param sourceDomain The source domain of the message
+     * @param sender The sender of the message
+     * @param finalityThresholdExecuted the finality threshold at which the message was attested to
+     * @param messageBody The raw bytes of the message body
+     * @return success True, if successful; false, if not.
+     */
+    function handleReceiveFinalizedMessage(
+        uint32 sourceDomain,
+        bytes32 sender,
+        uint32 finalityThresholdExecuted,
+        bytes calldata messageBody
+    ) external returns (bool);
+
+    /**
+     * @notice Handles an incoming unfinalized message from an IReceiverV2
+     * @dev Unfinalized messages have finality threshold values less than 2000
+     * @param sourceDomain The source domain of the message
+     * @param sender The sender of the message
+     * @param finalityThresholdExecuted The finality threshold at which the message was attested to
+     * @param messageBody The raw bytes of the message body
+     * @return success True, if successful; false, if not.
+     */
+    function handleReceiveUnfinalizedMessage(
+        uint32 sourceDomain,
+        bytes32 sender,
+        uint32 finalityThresholdExecuted,
+        bytes calldata messageBody
+    ) external returns (bool);
+}

solidity/contracts/interfaces/cctp/IMessageTransmitterV2.sol

@@ -0,0 +1,64 @@
+/*
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+pragma solidity >=0.8.0;
+
+import {IMessageTransmitter} from "./IMessageTransmitter.sol";
+import {IReceiver} from "./IMessageTransmitter.sol";
+
+/**
+ * @title IReceiverV2
+ * @notice Receives messages on the destination chain and forwards them to contracts implementing
+ * IMessageHandlerV2.
+ */
+interface IReceiverV2 is IReceiver {}
+
+/**
+ * @title IRelayerV2
+ * @notice Sends messages from the source domain to the destination domain
+ */
+interface IRelayerV2 {
+    /**
+     * @notice Sends an outgoing message from the source domain.
+     * @dev Emits a `MessageSent` event with message information.
+     * WARNING: if the `destinationCaller` does not represent a valid address as bytes32, then it will not be possible
+     * to broadcast the message on the destination domain. If set to bytes32(0), anyone will be able to broadcast it.
+     * This is an advanced feature, and using bytes32(0) should be preferred for use cases where a specific destination caller is not required.
+     * @param destinationDomain Domain of destination chain
+     * @param recipient Address of message recipient on destination domain as bytes32
+     * @param destinationCaller Allowed caller on destination domain (see above WARNING).
+     * @param minFinalityThreshold Minimum finality threshold at which the message must be attested to.
+     * @param messageBody Content of the message, as raw bytes
+     */
+    function sendMessage(
+        uint32 destinationDomain,
+        bytes32 recipient,
+        bytes32 destinationCaller,
+        uint32 minFinalityThreshold,
+        bytes calldata messageBody
+    ) external;
+}
+
+/**
+ * @title IMessageTransmitterV2
+ * @notice Interface for V2 message transmitters, which both relay and receive messages.
+ */
+interface IMessageTransmitterV2 is
+    IRelayerV2,
+    IReceiverV2,
+    IMessageTransmitter
+{}

solidity/contracts/interfaces/cctp/ITokenMessenger.sol

@@ -2,6 +2,10 @@
 pragma solidity ^0.8.0;
 
 interface ITokenMessenger {
+    function messageBodyVersion() external returns (uint32);
+}
+
+interface ITokenMessengerV1 is ITokenMessenger {
     event DepositForBurn(
         uint64 indexed nonce,
         address indexed burnToken,
@@ -19,6 +23,4 @@ interface ITokenMessenger {
         bytes32 mintRecipient,
         address burnToken
     ) external returns (uint64 _nonce);
-
-    function messageBodyVersion() external returns (uint32);
 }

solidity/contracts/interfaces/cctp/ITokenMessengerV2.sol

@@ -1,7 +1,9 @@
 // SPDX-License-Identifier: MIT
 pragma solidity ^0.8.0;
 
-interface ITokenMessengerV2 {
+import {ITokenMessenger} from "./ITokenMessenger.sol";
+
+interface ITokenMessengerV2 is ITokenMessenger {
     event DepositForBurn(
         address indexed burnToken,
         uint256 amount,
@@ -24,6 +26,4 @@ interface ITokenMessengerV2 {
         uint256 maxFee,
         uint32 minFinalityThreshold
     ) external;
-
-    function messageBodyVersion() external returns (uint32);
 }

solidity/contracts/libs/CctpMessage.sol renamed to solidity/contracts/libs/CctpMessageV1.sol

@@ -40,7 +40,7 @@ import {TypedMemView} from "./TypedMemView.sol";
  * messageBody           dynamic    bytes      116
  *
  **/
-library CctpMessage {
+library CctpMessageV1 {
     using TypedMemView for bytes;
     using TypedMemView for bytes29;
 
@@ -182,7 +182,7 @@ library CctpMessage {
  * amount                32         uint256    68
  * messageSender         32         bytes32    100
  **/
-library BurnMessage {
+library BurnMessageV1 {
     using TypedMemView for bytes;
     using TypedMemView for bytes29;