@lumiapassport/ui-kit 1.1.0 → 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

@@ -5272,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" }] }];
@@ -9501,6 +9703,7 @@ export {
   UserOpStatus,
   getUserProfile,
   lumiaBeam,
+  prepareUserOperation,
   queryClient,
   sendUserOperation,
   updateUserProfile,