feat: implement wallet_getCallsStatus request handler

Author: ultraviolet10

apps/iframe/src/requests/modules/boop-batcher/helpers.ts

@@ -0,0 +1,33 @@
+import type { Hex, Log, WalletGetCallsStatusReturnType } from "viem"
+import type { UserOperationReceipt } from "viem/account-abstraction"
+
+/**
+ * Converts an array of user operation receipts into the {@link WalletGetCallsStatusReturnType} format.
+ * If no receipts are provided, returns a `"PENDING"` status.
+ *
+ * @param receipts - Array of UserOperationReceipt objects or null.
+ * @returns WalletGetCallsStatusReturnType with formatted receipt data.
+ */
+export function convertUserOpReceiptToCallStatus(
+    receipts: UserOperationReceipt[] | null,
+): WalletGetCallsStatusReturnType {
+    if (!receipts || receipts.length === 0) {
+        return { status: "PENDING" }
+    }
+
+    return {
+        status: "CONFIRMED",
+        receipts: receipts.map(({ receipt, logs, success }) => ({
+            logs: logs.map((log: Log<bigint, number, false>) => ({
+                address: log.address as Hex,
+                data: log.data as Hex,
+                topics: log.topics as Hex[],
+            })),
+            status: (success ? "0x1" : "0x0") as Hex,
+            blockHash: receipt.blockHash as Hex,
+            blockNumber: `0x${receipt.blockNumber.toString(16)}` as Hex,
+            gasUsed: `0x${receipt.gasUsed.toString(16)}` as Hex,
+            transactionHash: receipt.transactionHash as Hex,
+        })),
+    } satisfies WalletGetCallsStatusReturnType
+}

apps/iframe/src/requests/permissionless.ts

@@ -42,6 +42,7 @@ import { getUser } from "#src/state/user"
 import { getWalletClient } from "#src/state/walletClient"
 import type { AppURL } from "#src/utils/appURL"
 import { checkIfRequestRequiresConfirmation } from "#src/utils/checkIfRequestRequiresConfirmation"
+import { convertUserOpReceiptToCallStatus } from "./modules/boop-batcher/helpers"
 import { sendResponse } from "./sendResponse"
 import { appForSourceID, checkAuthenticated } from "./utils"
 
@@ -290,6 +291,26 @@ export async function dispatchHandlers(request: ProviderMsgsFromApp[Msgs.Request
             return capabilities satisfies GetCapabilitiesReturnType
         }
 
+        case "wallet_getCallsStatus": {
+            // TODO if the batch was atomic, this handler MUST return only a single receipt
+            try {
+                const [hash] = request.payload.params as Hash[]
+                if (!hash) {
+                    throw new Error("Transaction hash is missing.")
+                }
+                const smartAccountClient = (await getSmartAccountClient()) as ExtendedSmartAccountClient
+
+                const userOpReceipt = await smartAccountClient.getUserOperationReceipt({
+                    hash: hash,
+                })
+
+                return convertUserOpReceiptToCallStatus(userOpReceipt ? [userOpReceipt] : null)
+            } catch (error) {
+                console.error(error)
+                throw error
+            }
+        }
+
         case HappyMethodNames.REQUEST_SESSION_KEY: {
             const user = getUser()
             const targetContractAddress = request.payload.params[0] as Address

support/wallet-common/lib/interfaces/permissions.ts

@@ -67,6 +67,7 @@ const safeList = new Set([
     "web3_clientVersion",
     "web3_sha3",
     "wallet_getCapabilities",
+    "wallet_getCallsStatus",
 ])
 
 /**