Support starknet_getMessagesStatus

Sources/Starknet/Data/MessageStatus.swift

@@ -0,0 +1,17 @@
+public struct MessageStatus: Decodable, Equatable {
+    public let transactionHash: Felt
+    public let finalityStatus: StarknetTransactionStatus
+    public let failureReason: String?
+
+    enum CodingKeys: String, CodingKey {
+        case transactionHash = "transaction_hash"
+        case finalityStatus = "finality_status"
+        case failureReason = "failure_reason"
+    }
+
+    // public static func == (lhs: MessageStatus, rhs: MessageStatus) -> Bool {
+    //     lhs.transactionHash == rhs.transactionHash &&
+    //         lhs.finalityStatus == rhs.finalityStatus &&
+    //         lhs.failureReason == rhs.failureReason
+    // }
+}

Sources/Starknet/Network/StarknetRequest.swift

@@ -195,6 +195,18 @@ public enum RequestBuilder {
         return StarknetRequest(method: .getTransactionStatus, params: .getTransactionStatus(params))
     }
 
+    /// Get L1 handler transaction data for all L1 → L2 messages sent by the given L1 transaction.
+    ///
+    /// - Parameters:
+    ///  - l1TransactionHash: The hash of the L1 transaction
+    ///
+    /// - Returns: The status of the messages
+    public static func getMessagesStatus(l1TransactionHash: NumAsHex) -> StarknetRequest<[MessageStatus]> {
+        let params = GetMessagesStatusPayload(l1TransactionHash: l1TransactionHash)
+
+        return StarknetRequest(method: .getMessagesStatus, params: .getMessagesStatus(params))
+    }
+
     /// Get the currently configured Starknet chain id
     ///
     /// - Returns: The Starknet chain id

Sources/Starknet/Providers/StarknetProvider/JsonRpcMethod.swift

@@ -16,6 +16,7 @@ enum JsonRpcMethod: String, Encodable {
     case getTransactionByBlockIdAndIndex = "starknet_getTransactionByBlockIdAndIndex"
     case getTransactionReceipt = "starknet_getTransactionReceipt"
     case getTransactionStatus = "starknet_getTransactionStatus"
+    case getMessagesStatus = "starknet_getMessagesStatus"
     case getChainId = "starknet_chainId"
     case simulateTransactions = "starknet_simulateTransactions"
     case estimateMessageFee = "starknet_estimateMessageFee"

Sources/Starknet/Providers/StarknetProvider/JsonRpcParams.swift

@@ -155,6 +155,14 @@ struct GetTransactionStatusPayload: Encodable {
     }
 }
 
+struct GetMessagesStatusPayload: Encodable {
+    let l1TransactionHash: NumAsHex
+
+    enum CodingKeys: String, CodingKey {
+        case l1TransactionHash = "l1_transaction_hash"
+    }
+}
+
 struct SimulateTransactionsParams: Encodable {
     let transactions: [any StarknetExecutableTransaction]
     let blockId: StarknetBlockId
@@ -193,6 +201,7 @@ enum JsonRpcParams {
     case getTransactionByBlockIdAndIndex(GetTransactionByBlockIdAndIndex)
     case getTransactionReceipt(GetTransactionReceiptPayload)
     case getTransactionStatus(GetTransactionStatusPayload)
+    case getMessagesStatus(GetMessagesStatusPayload)
     case simulateTransactions(SimulateTransactionsParams)
 }
 
@@ -229,6 +238,8 @@ extension JsonRpcParams: Encodable {
             try params.encode(to: encoder)
         case let .getTransactionStatus(params):
             try params.encode(to: encoder)
+        case let .getMessagesStatus(params):
+            try params.encode(to: encoder)
         case let .simulateTransactions(params):
             try params.encode(to: encoder)
         }