@lumiapassport/ui-kit 1.0.2 → 1.2.0

package/dist/index.d.cts

@@ -1,5 +1,6 @@
 import * as React from 'react';
 import React__default from 'react';
+import { UserOperationV07, UserOperationV06 } from '@lumiapassport/core/bundler';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as viem from 'viem';
 import { Chain, Hash as Hash$1, TransactionReceipt } from 'viem';
@@ -173,6 +174,22 @@ interface AccountSession$1 {
     address: `0x${string}`;
 }
 declare function sendUserOperation(session: AccountSession$1, callTarget: `0x${string}`, amountWei: string, innerData?: `0x${string}`, feeType?: 'economy' | 'standard' | 'fast', entryPointVersion?: 'v0.6' | 'v0.7'): Promise<`0x${string}`>;
+/**
+ * Prepare and sign a UserOperation without sending it to the bundler.
+ * Returns the signed UserOp and its hash for backend verification and submission.
+ *
+ * @param session - Account session with signing credentials
+ * @param callTarget - Target address for the transaction
+ * @param amountWei - Amount in wei to send
+ * @param innerData - Call data for the transaction
+ * @param feeType - Fee tier: 'economy', 'standard', or 'fast'
+ * @param entryPointVersion - EntryPoint version: 'v0.6' or 'v0.7'
+ * @returns Object with signed UserOperation and its hash
+ */
+declare function prepareUserOperation(session: AccountSession$1, callTarget: `0x${string}`, amountWei: string, innerData?: `0x${string}`, feeType?: 'economy' | 'standard' | 'fast', entryPointVersion?: 'v0.6' | 'v0.7'): Promise<{
+    userOp: UserOperationV07 | UserOperationV06;
+    userOpHash: `0x${string}`;
+}>;
 
 type AccountSession = AccountSession$1;
 interface SessionState {
@@ -795,4 +812,4 @@ declare function useLumiaPassportLinkedProfiles(): {
     readonly refresh: () => Promise<void>;
 };
 
-export { type AccountSession$1 as AccountSession, Address, type AddressProps, type Asset, ConnectWalletButton, type ConnectWalletButtonProps, Hash, type HashProps, KeyshareBackup, LUMIA_EXPLORER_URL, LumiaLogo, type LumiaPassportCallbacks, type LumiaPassportConfig, LumiaPassportProvider, type LumiaPassportProviderProps, LumiaRainbowKitProvider, type LumiaRainbowKitProviderProps, LumiaSessionProvider, type LumiaSessionProviderProps, LumiaWagmiProvider, type SendTransactionParams, type SendTransactionResult, type Theme, ThemeToggle, type TokenBalance, type Transaction, TransactionsList, type UpdateProfileRequest, type UseSendTransactionReturn, type UseUserOpStatusOptions, type UseUserOpStatusReturn, type UserOpMempool, type UserOpReceipt, type SendTransactionParams$1 as UserOpSendTransactionParams, type UserOpState, UserOpStatus, type UserOpStatusProps, type UserOperation, type UserProfile, getUserProfile, lumiaBeam, queryClient, sendUserOperation, updateUserProfile, useAssets, useLumiaPassportConfig, useLumiaPassportLinkedProfiles, useLumiaSession, useSendTransaction, useSmartAccountTransactions, useTheme, useTokenBalance, useTokenInfo, useTransactions, useUserOpStatus, wagmiConfig };
+export { type AccountSession$1 as AccountSession, Address, type AddressProps, type Asset, ConnectWalletButton, type ConnectWalletButtonProps, Hash, type HashProps, KeyshareBackup, LUMIA_EXPLORER_URL, LumiaLogo, type LumiaPassportCallbacks, type LumiaPassportConfig, LumiaPassportProvider, type LumiaPassportProviderProps, LumiaRainbowKitProvider, type LumiaRainbowKitProviderProps, LumiaSessionProvider, type LumiaSessionProviderProps, LumiaWagmiProvider, type SendTransactionParams, type SendTransactionResult, type Theme, ThemeToggle, type TokenBalance, type Transaction, TransactionsList, type UpdateProfileRequest, type UseSendTransactionReturn, type UseUserOpStatusOptions, type UseUserOpStatusReturn, type UserOpMempool, type UserOpReceipt, type SendTransactionParams$1 as UserOpSendTransactionParams, type UserOpState, UserOpStatus, type UserOpStatusProps, type UserOperation, type UserProfile, getUserProfile, lumiaBeam, prepareUserOperation, queryClient, sendUserOperation, updateUserProfile, useAssets, useLumiaPassportConfig, useLumiaPassportLinkedProfiles, useLumiaSession, useSendTransaction, useSmartAccountTransactions, useTheme, useTokenBalance, useTokenInfo, useTransactions, useUserOpStatus, wagmiConfig };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import * as React from 'react';
 import React__default from 'react';
+import { UserOperationV07, UserOperationV06 } from '@lumiapassport/core/bundler';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as viem from 'viem';
 import { Chain, Hash as Hash$1, TransactionReceipt } from 'viem';
@@ -173,6 +174,22 @@ interface AccountSession$1 {
     address: `0x${string}`;
 }
 declare function sendUserOperation(session: AccountSession$1, callTarget: `0x${string}`, amountWei: string, innerData?: `0x${string}`, feeType?: 'economy' | 'standard' | 'fast', entryPointVersion?: 'v0.6' | 'v0.7'): Promise<`0x${string}`>;
+/**
+ * Prepare and sign a UserOperation without sending it to the bundler.
+ * Returns the signed UserOp and its hash for backend verification and submission.
+ *
+ * @param session - Account session with signing credentials
+ * @param callTarget - Target address for the transaction
+ * @param amountWei - Amount in wei to send
+ * @param innerData - Call data for the transaction
+ * @param feeType - Fee tier: 'economy', 'standard', or 'fast'
+ * @param entryPointVersion - EntryPoint version: 'v0.6' or 'v0.7'
+ * @returns Object with signed UserOperation and its hash
+ */
+declare function prepareUserOperation(session: AccountSession$1, callTarget: `0x${string}`, amountWei: string, innerData?: `0x${string}`, feeType?: 'economy' | 'standard' | 'fast', entryPointVersion?: 'v0.6' | 'v0.7'): Promise<{
+    userOp: UserOperationV07 | UserOperationV06;
+    userOpHash: `0x${string}`;
+}>;
 
 type AccountSession = AccountSession$1;
 interface SessionState {
@@ -795,4 +812,4 @@ declare function useLumiaPassportLinkedProfiles(): {
     readonly refresh: () => Promise<void>;
 };
 
-export { type AccountSession$1 as AccountSession, Address, type AddressProps, type Asset, ConnectWalletButton, type ConnectWalletButtonProps, Hash, type HashProps, KeyshareBackup, LUMIA_EXPLORER_URL, LumiaLogo, type LumiaPassportCallbacks, type LumiaPassportConfig, LumiaPassportProvider, type LumiaPassportProviderProps, LumiaRainbowKitProvider, type LumiaRainbowKitProviderProps, LumiaSessionProvider, type LumiaSessionProviderProps, LumiaWagmiProvider, type SendTransactionParams, type SendTransactionResult, type Theme, ThemeToggle, type TokenBalance, type Transaction, TransactionsList, type UpdateProfileRequest, type UseSendTransactionReturn, type UseUserOpStatusOptions, type UseUserOpStatusReturn, type UserOpMempool, type UserOpReceipt, type SendTransactionParams$1 as UserOpSendTransactionParams, type UserOpState, UserOpStatus, type UserOpStatusProps, type UserOperation, type UserProfile, getUserProfile, lumiaBeam, queryClient, sendUserOperation, updateUserProfile, useAssets, useLumiaPassportConfig, useLumiaPassportLinkedProfiles, useLumiaSession, useSendTransaction, useSmartAccountTransactions, useTheme, useTokenBalance, useTokenInfo, useTransactions, useUserOpStatus, wagmiConfig };
+export { type AccountSession$1 as AccountSession, Address, type AddressProps, type Asset, ConnectWalletButton, type ConnectWalletButtonProps, Hash, type HashProps, KeyshareBackup, LUMIA_EXPLORER_URL, LumiaLogo, type LumiaPassportCallbacks, type LumiaPassportConfig, LumiaPassportProvider, type LumiaPassportProviderProps, LumiaRainbowKitProvider, type LumiaRainbowKitProviderProps, LumiaSessionProvider, type LumiaSessionProviderProps, LumiaWagmiProvider, type SendTransactionParams, type SendTransactionResult, type Theme, ThemeToggle, type TokenBalance, type Transaction, TransactionsList, type UpdateProfileRequest, type UseSendTransactionReturn, type UseUserOpStatusOptions, type UseUserOpStatusReturn, type UserOpMempool, type UserOpReceipt, type SendTransactionParams$1 as UserOpSendTransactionParams, type UserOpState, UserOpStatus, type UserOpStatusProps, type UserOperation, type UserProfile, getUserProfile, lumiaBeam, prepareUserOperation, queryClient, sendUserOperation, updateUserProfile, useAssets, useLumiaPassportConfig, useLumiaPassportLinkedProfiles, useLumiaSession, useSendTransaction, useSmartAccountTransactions, useTheme, useTokenBalance, useTokenInfo, useTransactions, useUserOpStatus, wagmiConfig };

package/dist/index.js

@@ -1403,7 +1403,7 @@ async function deriveBackupPasswordFromPasskey(userId, credentialId) {
 }
 function getBackupStatus(userId) {
   const storage = typeof window !== "undefined" ? window.localStorage : void 0;
-  const statusData = storage?.getItem(`lumia.backup.status.${userId}`);
+  const statusData = storage?.getItem(`lumia-passport.backup.status.${userId}`);
   if (statusData) {
     try {
       return JSON.parse(statusData);
@@ -1417,14 +1417,14 @@ function updateBackupStatus(userId, method, status) {
   if (!storage) return;
   const current = getBackupStatus(userId);
   current[method] = { ...current[method], ...status };
-  storage.setItem(`lumia.backup.status.${userId}`, JSON.stringify(current));
+  storage.setItem(`lumia-passport.backup.status.${userId}`, JSON.stringify(current));
   if (typeof window !== "undefined") {
-    window.dispatchEvent(new CustomEvent("lumia-backup-status-changed", { detail: { method, status, currentStatus: current } }));
+    window.dispatchEvent(new CustomEvent("lumia-passport-backup-status-changed", { detail: { method, status, currentStatus: current } }));
   }
 }
 function clearBackupStatus(userId) {
   const storage = typeof window !== "undefined" ? window.localStorage : void 0;
-  storage?.removeItem(`lumia.backup.status.${userId}`);
+  storage?.removeItem(`lumia-passport.backup.status.${userId}`);
 }
 async function checkServerBackupAvailability() {
   try {
@@ -2411,7 +2411,7 @@ var init_iframe_manager = __esm({
         const response = await this.sendMessage("SDK_AUTH", {
           projectId: this.projectId
         });
-        if (response.type === "SDK_AUTH_SUCCESS") {
+        if (response.type === "LUMIA_PASSPORT_SDK_AUTH_SUCCESS") {
           this.sessionToken = response.sessionToken;
           this.log("[IframeManager] \u2705 SDK authenticated, session token received");
         } else {
@@ -2427,20 +2427,21 @@ var init_iframe_manager = __esm({
           return;
         }
         const validIframeTypes = [
-          "IFRAME_READY",
-          "SHOW_IFRAME",
-          "HIDE_IFRAME",
-          "SDK_AUTH_SUCCESS",
-          "AUTH_SUCCESS",
-          "DKG_SUCCESS",
-          "SIGNATURE",
-          "ADDRESS",
-          "KEYSHARE_STATUS",
-          "TRUSTED_APPS_LIST",
-          "TRUSTED_APP_REMOVED",
-          "REQUEST_NEW_TOKEN",
-          "RESPONSE",
-          "ERROR"
+          "LUMIA_PASSPORT_IFRAME_READY",
+          "LUMIA_PASSPORT_SHOW_IFRAME",
+          "LUMIA_PASSPORT_HIDE_IFRAME",
+          "LUMIA_PASSPORT_SDK_AUTH_SUCCESS",
+          "LUMIA_PASSPORT_AUTH_SUCCESS",
+          "LUMIA_PASSPORT_DKG_SUCCESS",
+          "LUMIA_PASSPORT_SIGNATURE",
+          "LUMIA_PASSPORT_ADDRESS",
+          "LUMIA_PASSPORT_KEYSHARE_STATUS",
+          "LUMIA_PASSPORT_TRUSTED_APPS_LIST",
+          "LUMIA_PASSPORT_TRUSTED_APP_REMOVED",
+          "LUMIA_PASSPORT_REQUEST_NEW_TOKEN",
+          "LUMIA_PASSPORT_TOKEN_REFRESHED",
+          "LUMIA_PASSPORT_RESPONSE",
+          "LUMIA_PASSPORT_ERROR"
         ];
         if (!validIframeTypes.includes(message.type) && !message.messageId) {
           return;
@@ -2450,24 +2451,24 @@ var init_iframe_manager = __esm({
           this.log("[IframeManager] \u26A0\uFE0F Ignored message from invalid origin:", event.origin, "expected:", iframeOrigin);
           return;
         }
-        if (message.type === "IFRAME_READY") {
-          this.log("[IframeManager] \u{1F4E8} Received IFRAME_READY");
+        if (message.type === "LUMIA_PASSPORT_IFRAME_READY") {
+          this.log("[IframeManager] \u{1F4E8} Received LUMIA_PASSPORT_IFRAME_READY");
           this.isReady = true;
           this.readyResolve();
           return;
         }
-        if (message.type === "SHOW_IFRAME") {
-          this.log("[IframeManager] \u{1F4E8} Received SHOW_IFRAME");
+        if (message.type === "LUMIA_PASSPORT_SHOW_IFRAME") {
+          this.log("[IframeManager] \u{1F4E8} Received LUMIA_PASSPORT_SHOW_IFRAME");
           this.showIframe();
           return;
         }
-        if (message.type === "HIDE_IFRAME") {
-          this.log("[IframeManager] \u{1F4E8} Received HIDE_IFRAME");
+        if (message.type === "LUMIA_PASSPORT_HIDE_IFRAME") {
+          this.log("[IframeManager] \u{1F4E8} Received LUMIA_PASSPORT_HIDE_IFRAME");
           this.hideIframe();
           return;
         }
-        if (message.type === "REQUEST_NEW_TOKEN") {
-          this.log("[IframeManager] \u{1F4E8} Received REQUEST_NEW_TOKEN");
+        if (message.type === "LUMIA_PASSPORT_REQUEST_NEW_TOKEN") {
+          this.log("[IframeManager] \u{1F4E8} Received LUMIA_PASSPORT_REQUEST_NEW_TOKEN");
           this.handleTokenRefreshRequest(message).catch((error) => {
             this.log("[IframeManager] \u274C Token refresh error:", error);
           });
@@ -2477,7 +2478,7 @@ var init_iframe_manager = __esm({
           const pending = this.pendingRequests.get(message.messageId);
           if (pending) {
             this.pendingRequests.delete(message.messageId);
-            if (message.type === "ERROR") {
+            if (message.type === "LUMIA_PASSPORT_ERROR") {
               pending.reject(new Error(message.error || "Unknown error"));
             } else {
               pending.resolve(message.data || message);
@@ -2500,7 +2501,7 @@ var init_iframe_manager = __esm({
               const iframeOrigin = new URL(this.iframeUrl).origin;
               this.iframe.contentWindow.postMessage(
                 {
-                  type: "TOKEN_REFRESHED",
+                  type: "LUMIA_PASSPORT_TOKEN_REFRESHED",
                   messageId: message.messageId,
                   accessToken: newAccessToken,
                   timestamp: Date.now()
@@ -2515,7 +2516,7 @@ var init_iframe_manager = __esm({
               const iframeOrigin = new URL(this.iframeUrl).origin;
               this.iframe.contentWindow.postMessage(
                 {
-                  type: "TOKEN_REFRESHED",
+                  type: "LUMIA_PASSPORT_TOKEN_REFRESHED",
                   messageId: message.messageId,
                   error: "Token refresh failed",
                   timestamp: Date.now()
@@ -2530,7 +2531,7 @@ var init_iframe_manager = __esm({
             const iframeOrigin = new URL(this.iframeUrl).origin;
             this.iframe.contentWindow.postMessage(
               {
-                type: "TOKEN_REFRESHED",
+                type: "LUMIA_PASSPORT_TOKEN_REFRESHED",
                 messageId: message.messageId,
                 error: error instanceof Error ? error.message : "Unknown error",
                 timestamp: Date.now()
@@ -2653,7 +2654,7 @@ var init_iframe_manager = __esm({
           userId,
           projectId: this.projectId
         });
-        if (response.type === "AUTH_SUCCESS") {
+        if (response.type === "LUMIA_PASSPORT_AUTH_SUCCESS") {
           return {
             userId: response.userId,
             address: response.address
@@ -2672,7 +2673,7 @@ var init_iframe_manager = __esm({
           accessToken
           // Pass access token for TSS API authentication
         });
-        if (response.type === "DKG_SUCCESS") {
+        if (response.type === "LUMIA_PASSPORT_DKG_SUCCESS") {
           return response.ownerAddress;
         }
         throw new Error("DKG failed");
@@ -2689,7 +2690,7 @@ var init_iframe_manager = __esm({
           accessToken
           // Pass access token for TSS API authentication
         });
-        if (response.type === "SIGNATURE") {
+        if (response.type === "LUMIA_PASSPORT_SIGNATURE") {
           return response.signature;
         }
         throw new Error("Transaction signing failed");
@@ -2702,7 +2703,7 @@ var init_iframe_manager = __esm({
         const response = await this.sendMessage("GET_ADDRESS", {
           userId
         });
-        if (response.type === "ADDRESS") {
+        if (response.type === "LUMIA_PASSPORT_ADDRESS") {
           return response.address;
         }
         return void 0;
@@ -2715,7 +2716,7 @@ var init_iframe_manager = __esm({
         const response = await this.sendMessage("CHECK_KEYSHARE", {
           userId
         });
-        if (response.type === "KEYSHARE_STATUS") {
+        if (response.type === "LUMIA_PASSPORT_KEYSHARE_STATUS") {
           return {
             hasKeyshare: response.hasKeyshare,
             address: response.address
@@ -2731,7 +2732,7 @@ var init_iframe_manager = __esm({
         const response = await this.sendMessage("GET_TRUSTED_APPS", {
           userId
         });
-        if (response.type === "TRUSTED_APPS_LIST") {
+        if (response.type === "LUMIA_PASSPORT_TRUSTED_APPS_LIST") {
           return response.apps || [];
         }
         return [];
@@ -2746,7 +2747,7 @@ var init_iframe_manager = __esm({
           projectId,
           appOrigin: origin
         });
-        if (response.type === "TRUSTED_APP_REMOVED") {
+        if (response.type === "LUMIA_PASSPORT_TRUSTED_APP_REMOVED") {
           return response.success;
         }
         return false;
@@ -5271,6 +5272,208 @@ async function sendUserOperation(session, callTarget, amountWei, innerData = "0x
   }
   return hash;
 }
+async function prepareUserOperation(session, callTarget, amountWei, innerData = "0x", feeType = "standard", entryPointVersion = "v0.7") {
+  const entryPointAddress = entryPointVersion === "v0.6" ? ENTRYPOINT_V06 : ENTRYPOINT_V07;
+  const amountWeiBigInt = BigInt(amountWei);
+  const isMinimalTest = callTarget === "0x0000000000000000000000000000000000000000" && amountWei === "0" && innerData === "0x";
+  let callData;
+  if (isMinimalTest) {
+    callData = "0x";
+  } else {
+    callData = encodeFunctionData({ abi: executeAbi, functionName: "execute", args: [callTarget, amountWeiBigInt, innerData] });
+  }
+  let isDeployed = false;
+  let deploymentMethod = "unknown";
+  try {
+    const code = await publicClient.getCode({ address: session.smartAccountAddress });
+    if (code && code !== "0x" && code.length > 2) {
+      isDeployed = true;
+      deploymentMethod = "getCode";
+    }
+  } catch {
+  }
+  const nonce = await fetchEntryPointNonce(session.smartAccountAddress, entryPointAddress);
+  const nonceValue = BigInt(nonce);
+  if (!isDeployed && nonceValue !== 0n) throw new Error(`Undeployed account has non-zero nonce: ${nonce}. This will cause CodeHashChanged error.`);
+  const shouldIncludeFactory = !isDeployed;
+  let userOp;
+  if (shouldIncludeFactory) {
+    const compatCreateAbi = [{ type: "function", name: "createAccount", stateMutability: "payable", inputs: [{ name: "owner", type: "address" }, { name: "salt", type: "bytes32" }], outputs: [{ name: "", type: "address" }] }];
+    const saltZero = "0x0000000000000000000000000000000000000000000000000000000000000000";
+    const factoryData = encodeFunctionData({ abi: compatCreateAbi, functionName: "createAccount", args: [session.ownerAddress, saltZero] });
+    userOp = await createUserOperationWithDynamicFees(
+      session.smartAccountAddress,
+      nonce,
+      callData,
+      true,
+      session.factoryAddress,
+      factoryData,
+      feeType
+    );
+  } else {
+    userOp = await createUserOperationWithDynamicFees(
+      session.smartAccountAddress,
+      nonce,
+      callData,
+      false,
+      void 0,
+      void 0,
+      feeType
+    );
+  }
+  const ensureGenerousDefaults = () => {
+    const toHex2 = (v) => `0x${v.toString(16)}`;
+    const minCallGas = 0x493e0n;
+    const minVerificationGas = 0x989680n;
+    const minPreVerificationGas = 0x30d40n;
+    if (BigInt(userOp.callGasLimit || "0x0") < minCallGas) userOp.callGasLimit = toHex2(minCallGas);
+    if (BigInt(userOp.verificationGasLimit || "0x0") < minVerificationGas) userOp.verificationGasLimit = toHex2(minVerificationGas);
+    if (BigInt(userOp.preVerificationGas || "0x0") < minPreVerificationGas) userOp.preVerificationGas = toHex2(minPreVerificationGas);
+  };
+  const enforceCaps = (usePaymaster) => {
+    try {
+      const envCaps = typeof import.meta !== "undefined" && import.meta.env || {};
+      const maxBundlerVerifGas = envCaps.VITE_MAX_VERIFICATION_GAS ? BigInt(envCaps.VITE_MAX_VERIFICATION_GAS) : MAX_BUNDLER_VERIFICATION_GAS;
+      const maxCallGas = envCaps.VITE_MAX_CALL_GAS_LIMIT ? BigInt(envCaps.VITE_MAX_CALL_GAS_LIMIT) : 0x7a120n;
+      const toHex2 = (v) => `0x${v.toString(16)}`;
+      const maxAccountVerifGas = usePaymaster ? maxBundlerVerifGas - PAYMASTER_VERIFICATION_GAS : maxBundlerVerifGas;
+      const verGas = BigInt(userOp.verificationGasLimit || "0x0");
+      if (verGas > maxAccountVerifGas) userOp.verificationGasLimit = toHex2(maxAccountVerifGas);
+      const callGas = BigInt(userOp.callGasLimit || "0x0");
+      if (callGas > maxCallGas) userOp.callGasLimit = toHex2(maxCallGas);
+    } catch {
+    }
+  };
+  let estimated = false;
+  try {
+    const gasEst = await estimateUserOperationGas({ ...userOp, signature: `0x${"00".repeat(65)}` });
+    userOp.callGasLimit = gasEst.callGasLimit;
+    userOp.verificationGasLimit = gasEst.verificationGasLimit;
+    userOp.preVerificationGas = gasEst.preVerificationGas;
+    ensureGenerousDefaults();
+    enforceCaps(session.usePaymaster);
+    estimated = true;
+  } catch {
+    ensureGenerousDefaults();
+    enforceCaps(session.usePaymaster);
+  }
+  try {
+    const toHex2 = (v) => `0x${v.toString(16)}`;
+    const isContractCall = !!userOp.callData && userOp.callData !== "0x";
+    if (isContractCall) {
+      const currentVer = BigInt(userOp.verificationGasLimit || "0x0");
+      const call = BigInt(userOp.callGasLimit || "0x0");
+      const postOp = 150000n;
+      const safety10k = 10000n;
+      let buffer = call + postOp + safety10k;
+      buffer += buffer / 63n;
+      const newVer = currentVer + buffer;
+      userOp.verificationGasLimit = toHex2(newVer);
+      enforceCaps(session.usePaymaster);
+    }
+  } catch {
+  }
+  if (session.usePaymaster && LUMIA_PAYMASTER_ADDRESS) {
+    userOp.paymaster = LUMIA_PAYMASTER_ADDRESS;
+    userOp.paymasterData = "0x";
+    userOp.paymasterVerificationGasLimit = PAYMASTER_VERIFICATION_GAS_LIMIT;
+    userOp.paymasterPostOpGasLimit = PAYMASTER_POSTOP_GAS_LIMIT;
+  }
+  userOp.nonce = nonce;
+  let opHash;
+  if (entryPointVersion === "v0.6") {
+    const userOpV06 = convertUserOpV07ToV06(userOp);
+    opHash = await publicClient.readContract({
+      address: entryPointAddress,
+      abi: [{ type: "function", name: "getUserOpHash", inputs: [{ name: "userOp", type: "tuple", components: [{ name: "sender", type: "address" }, { name: "nonce", type: "uint256" }, { name: "initCode", type: "bytes" }, { name: "callData", type: "bytes" }, { name: "callGasLimit", type: "uint256" }, { name: "verificationGasLimit", type: "uint256" }, { name: "preVerificationGas", type: "uint256" }, { name: "maxFeePerGas", type: "uint256" }, { name: "maxPriorityFeePerGas", type: "uint256" }, { name: "paymasterAndData", type: "bytes" }, { name: "signature", type: "bytes" }] }], outputs: [{ name: "", type: "bytes32" }] }],
+      functionName: "getUserOpHash",
+      args: [{
+        sender: userOpV06.sender,
+        nonce: BigInt(userOpV06.nonce),
+        initCode: userOpV06.initCode,
+        callData: userOpV06.callData,
+        callGasLimit: BigInt(userOpV06.callGasLimit),
+        verificationGasLimit: BigInt(userOpV06.verificationGasLimit),
+        preVerificationGas: BigInt(userOpV06.preVerificationGas),
+        maxFeePerGas: BigInt(userOpV06.maxFeePerGas),
+        maxPriorityFeePerGas: BigInt(userOpV06.maxPriorityFeePerGas),
+        paymasterAndData: userOpV06.paymasterAndData,
+        signature: "0x"
+      }]
+    });
+  } else {
+    const hasFactoryData = !!(userOp.factory && userOp.factoryData);
+    const initCode = hasFactoryData ? (() => {
+      const factoryAddr = userOp.factory.startsWith("0x") ? userOp.factory.slice(2) : userOp.factory;
+      const factoryDataClean = userOp.factoryData.startsWith("0x") ? userOp.factoryData.slice(2) : userOp.factoryData;
+      return `0x${factoryAddr}${factoryDataClean}`;
+    })() : "0x";
+    const accountGasLimits = pack2x128(BigInt(userOp.verificationGasLimit), BigInt(userOp.callGasLimit));
+    const gasFees = pack2x128(BigInt(userOp.maxPriorityFeePerGas), BigInt(userOp.maxFeePerGas));
+    let paymasterAndData = "0x";
+    if (userOp.paymaster && userOp.paymaster !== "0x0000000000000000000000000000000000000000") {
+      const verificationGasLimit = userOp.paymasterVerificationGasLimit || "0x186a0";
+      const postOpGasLimit = userOp.paymasterPostOpGasLimit || "0x186a0";
+      const paymasterDataField = userOp.paymasterData || "0x";
+      const packedPaymasterGasLimits = pack2x128(BigInt(verificationGasLimit), BigInt(postOpGasLimit));
+      const paymasterAddr = userOp.paymaster.startsWith("0x") ? userOp.paymaster.slice(2) : userOp.paymaster;
+      const paymasterDataClean = paymasterDataField === "0x" ? "" : paymasterDataField.startsWith("0x") ? paymasterDataField.slice(2) : paymasterDataField;
+      paymasterAndData = `0x${paymasterAddr}${packedPaymasterGasLimits.slice(2)}${paymasterDataClean}`;
+    }
+    const packedForHash = {
+      sender: session.smartAccountAddress,
+      nonce: BigInt(nonce),
+      initCode,
+      callData,
+      accountGasLimits,
+      preVerificationGas: BigInt(userOp.preVerificationGas),
+      gasFees,
+      paymasterAndData,
+      signature: "0x"
+    };
+    opHash = await publicClient.readContract({
+      address: entryPointAddress,
+      abi: entryPoint07Abi,
+      functionName: "getUserOpHash",
+      args: [packedForHash]
+    });
+  }
+  let signature;
+  if (session.mpcUserId) {
+    const mpcSig = await signDigestWithMpc(session.mpcUserId, opHash, {
+      sender: userOp.sender,
+      nonce: userOp.nonce,
+      callData: userOp.callData,
+      callGasLimit: userOp.callGasLimit,
+      verificationGasLimit: userOp.verificationGasLimit,
+      preVerificationGas: userOp.preVerificationGas,
+      maxFeePerGas: userOp.maxFeePerGas,
+      maxPriorityFeePerGas: userOp.maxPriorityFeePerGas,
+      paymaster: userOp.paymaster,
+      factory: userOp.factory,
+      factoryData: userOp.factoryData
+    });
+    if (!mpcSig) throw new Error("MPC signing failed");
+    signature = mpcSig;
+  } else if (session.ownerPrivateKey) {
+    const account = privateKeyToAccount(session.ownerPrivateKey);
+    const rawSig = await account.sign({ hash: opHash });
+    signature = normalizeSignature(rawSig);
+  } else {
+    throw new Error("No signing method available");
+  }
+  userOp.signature = signature;
+  if (typeof userOp.sender !== "string") {
+    userOp.sender = session.smartAccountAddress;
+  }
+  console.log("[Account] \u2705 Prepared signed UserOp (not sent):", JSON.stringify(userOp, (key, value) => typeof value === "bigint" ? `0x${value.toString(16)}` : value, 2));
+  console.log("[Account] \u{1F511} UserOp Hash:", opHash);
+  if (entryPointVersion === "v0.6") {
+    const userOpV06 = convertUserOpV07ToV06(userOp);
+    return { userOp: userOpV06, userOpHash: opHash };
+  }
+  return { userOp, userOpHash: opHash };
+}
 async function getEntryPointDeposit(address, entryPointVersion = "v0.7") {
   const entryPointAddress = entryPointVersion === "v0.6" ? ENTRYPOINT_V06 : ENTRYPOINT_V07;
   const depositAbi = [{ type: "function", name: "balanceOf", stateMutability: "view", inputs: [{ name: "account", type: "address" }], outputs: [{ name: "", type: "uint256" }] }];
@@ -5967,7 +6170,7 @@ function BackupForm({ userId, onBackupSuccess }) {
       setTimeout(() => {
         if (typeof window !== "undefined") {
           window.dispatchEvent(
-            new CustomEvent("lumia-backup-status-changed", {
+            new CustomEvent("lumia-passport-backup-status-changed", {
               detail: { method, success: true }
             })
           );
@@ -8996,7 +9199,7 @@ function KeyshareBackup({ userId, onClose, onBackupSuccess }) {
       setTimeout(() => {
         if (typeof window !== "undefined") {
           window.dispatchEvent(
-            new CustomEvent("lumia-backup-status-changed", {
+            new CustomEvent("lumia-passport-backup-status-changed", {
               detail: { method, success: true }
             })
           );
@@ -9500,6 +9703,7 @@ export {
   UserOpStatus,
   getUserProfile,
   lumiaBeam,
+  prepareUserOperation,
   queryClient,
   sendUserOperation,
   updateUserProfile,