@getpara/viem-v2-integration 2.16.0 → 2.17.0

package/dist/cjs/aa/errors.js

@@ -32,6 +32,8 @@ const SMART_ACCOUNT_ERROR_CODES = [
   "AUTHORIZATION_FAILED",
   "DELEGATION_CONFLICT",
   "AUTHORIZATION_NONCE_MISMATCH",
+  // Chain
+  "CHAIN_MISMATCH",
   // Transaction Submission
   "BUNDLER_REJECTED",
   "GAS_ESTIMATION_FAILED",
@@ -57,7 +59,8 @@ class SmartAccountError extends Error {
   }
 }
 function classifyProviderError(error) {
-  const msg = error instanceof Error ? error.message.toLowerCase() : String(error).toLowerCase();
+  var _a;
+  const msg = (error instanceof Error ? (_a = error.message) != null ? _a : String(error) : String(error)).toLowerCase();
   if (msg.includes("rate limit") || msg.includes("429")) {
     return "PROVIDER_RATE_LIMITED";
   }
@@ -85,11 +88,12 @@ function classifyProviderError(error) {
   return "PROVIDER_ERROR";
 }
 function wrapProviderError(error, provider) {
+  var _a;
   if (error instanceof SmartAccountError) {
     return error;
   }
   const code = classifyProviderError(error);
-  const message = error instanceof Error ? error.message : String(error);
+  const message = error instanceof Error ? (_a = error.message) != null ? _a : String(error) : String(error);
   return new SmartAccountError({ code, message, provider, cause: error });
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/cjs/aa/index.js

@@ -0,0 +1,25 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var aa_exports = {};
+module.exports = __toCommonJS(aa_exports);
+__reExport(aa_exports, require("./types.js"), module.exports);
+__reExport(aa_exports, require("./errors.js"), module.exports);
+__reExport(aa_exports, require("./utils.js"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./types.js"),
+  ...require("./errors.js"),
+  ...require("./utils.js")
+});

package/dist/cjs/aa/utils.js

@@ -1,7 +1,24 @@
 var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -15,25 +32,136 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
 var utils_exports = {};
 __export(utils_exports, {
+  assertAccountAddress: () => assertAccountAddress,
+  ensureExternalWalletChain: () => ensureExternalWalletChain,
+  isExternalWallet: () => isExternalWallet,
+  rejectExternalWallet7702: () => rejectExternalWallet7702,
+  resolveExternalSigner: () => resolveExternalSigner,
+  resolveSigner: () => resolveSigner,
   resolveWalletIdentifier: () => resolveWalletIdentifier
 });
 module.exports = __toCommonJS(utils_exports);
+var import_viemWalletClient = require("../viemWalletClient.js");
+var import_errors = require("./errors.js");
+function isExternalWallet(signer) {
+  return !!signer && typeof signer === "object" && "transport" in signer && "account" in signer;
+}
+function resolveExternalSigner(signer) {
+  if (!isExternalWallet(signer)) {
+    return signer;
+  }
+  const account = signer.account;
+  if (!(account == null ? void 0 : account.address)) {
+    throw new Error(
+      "[resolveExternalSigner] WalletClient must have an account set. Call `await walletClient.requestAddresses()` first, then pass the account."
+    );
+  }
+  return {
+    address: account.address,
+    publicKey: "0x",
+    source: "custom",
+    type: "local",
+    sign: (_0) => __async(this, [_0], function* ({ hash }) {
+      return signer.signMessage({ account: account.address, message: { raw: hash } });
+    }),
+    signMessage: (_0) => __async(this, [_0], function* ({ message }) {
+      return signer.signMessage({ account: account.address, message });
+    }),
+    signTransaction: (tx) => __async(this, null, function* () {
+      return signer.signTransaction(__spreadProps(__spreadValues({}, tx), { account }));
+    }),
+    signTypedData: (typedData) => __async(this, null, function* () {
+      return signer.signTypedData(__spreadProps(__spreadValues({}, typedData), { account: account.address }));
+    }),
+    signAuthorization: () => __async(this, null, function* () {
+      throw new Error(
+        "EIP-7702 account delegation (signAuthorization) is not supported with external wallets. External wallets add an EIP-191 prefix to all signatures, which is incompatible with the raw ecrecover required by EIP-7702. Use an embedded Para wallet for 7702 mode, or use 4337 mode which works with any wallet."
+      );
+    })
+  };
+}
+function ensureExternalWalletChain(signer, chain, provider) {
+  return __async(this, null, function* () {
+    if (!isExternalWallet(signer)) return;
+    const currentChainId = yield signer.getChainId();
+    if (currentChainId !== chain.id) {
+      throw new import_errors.SmartAccountError({
+        code: "CHAIN_MISMATCH",
+        message: `External wallet is on chain ${currentChainId} but smart account targets chain ${chain.id} (${chain.name}). Switch your wallet to the correct network before sending transactions.`,
+        provider
+      });
+    }
+  });
+}
 function resolveWalletIdentifier(para, params) {
-  var _a;
   try {
     if (params.address) {
-      const wallet = para.findWalletByAddress(params.address, { type: ["EVM"] });
-      return wallet.address;
+      const wallet2 = para.findWalletByAddress(params.address, { type: ["EVM"] });
+      if (wallet2.isExternal) return null;
+      return wallet2.address;
     }
     const validId = para.findWalletId(params.walletId, { type: ["EVM"] });
-    return (_a = para.wallets[validId]) == null ? void 0 : _a.address;
+    const wallet = para.wallets[validId];
+    if (!wallet || wallet.isExternal) return null;
+    return wallet.address;
   } catch (e) {
     return null;
   }
 }
+function resolveSigner(para, params) {
+  if (params.signer) {
+    return resolveExternalSigner(params.signer);
+  }
+  const walletAddress = resolveWalletIdentifier(para, params);
+  if (!walletAddress) return null;
+  return (0, import_viemWalletClient.createParaAccount)(para, walletAddress);
+}
+function rejectExternalWallet7702(signer, provider) {
+  if (!signer || !isExternalWallet(signer)) return;
+  throw new import_errors.SmartAccountError({
+    code: "INVALID_CONFIG",
+    message: "EIP-7702 mode is not supported with external wallets. External wallets add an EIP-191 prefix to all signatures, which is incompatible with the raw ecrecover required by EIP-7702 authorization. Use an embedded Para wallet for 7702 mode, or use 4337 mode which works with any wallet.",
+    provider
+  });
+}
+function assertAccountAddress(address, clientLabel, provider) {
+  if (!address) {
+    throw new import_errors.SmartAccountError({
+      code: "MISSING_ACCOUNT_ADDRESS",
+      message: `${clientLabel} did not return a smart account address. Verify your configuration.`,
+      provider
+    });
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  assertAccountAddress,
+  ensureExternalWalletChain,
+  isExternalWallet,
+  rejectExternalWallet7702,
+  resolveExternalSigner,
+  resolveSigner,
   resolveWalletIdentifier
 });

package/dist/cjs/index.js

@@ -2,10 +2,6 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
     for (let key of __getOwnPropNames(from))
@@ -17,18 +13,9 @@ var __copyProps = (to, from, except, desc) => {
 var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var src_exports = {};
-__export(src_exports, {
-  resolveWalletIdentifier: () => import_utils.resolveWalletIdentifier
-});
 module.exports = __toCommonJS(src_exports);
 __reExport(src_exports, require("./viemWalletClient.js"), module.exports);
-__reExport(src_exports, require("./aa/types.js"), module.exports);
-__reExport(src_exports, require("./aa/errors.js"), module.exports);
-var import_utils = require("./aa/utils.js");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  resolveWalletIdentifier,
-  ...require("./viemWalletClient.js"),
-  ...require("./aa/types.js"),
-  ...require("./aa/errors.js")
+  ...require("./viemWalletClient.js")
 });

package/dist/esm/aa/errors.js

@@ -1,4 +1,4 @@
-import "../chunk-HJO26HIQ.js";
+import "../chunk-6FNC3XMI.js";
 const SMART_ACCOUNT_ERROR_CODES = [
   "MISSING_CHAIN",
   "MISSING_ACCOUNT_ADDRESS",
@@ -8,6 +8,8 @@ const SMART_ACCOUNT_ERROR_CODES = [
   "AUTHORIZATION_FAILED",
   "DELEGATION_CONFLICT",
   "AUTHORIZATION_NONCE_MISMATCH",
+  // Chain
+  "CHAIN_MISMATCH",
   // Transaction Submission
   "BUNDLER_REJECTED",
   "GAS_ESTIMATION_FAILED",
@@ -33,7 +35,8 @@ class SmartAccountError extends Error {
   }
 }
 function classifyProviderError(error) {
-  const msg = error instanceof Error ? error.message.toLowerCase() : String(error).toLowerCase();
+  var _a;
+  const msg = (error instanceof Error ? (_a = error.message) != null ? _a : String(error) : String(error)).toLowerCase();
   if (msg.includes("rate limit") || msg.includes("429")) {
     return "PROVIDER_RATE_LIMITED";
   }
@@ -61,11 +64,12 @@ function classifyProviderError(error) {
   return "PROVIDER_ERROR";
 }
 function wrapProviderError(error, provider) {
+  var _a;
   if (error instanceof SmartAccountError) {
     return error;
   }
   const code = classifyProviderError(error);
-  const message = error instanceof Error ? error.message : String(error);
+  const message = error instanceof Error ? (_a = error.message) != null ? _a : String(error) : String(error);
   return new SmartAccountError({ code, message, provider, cause: error });
 }
 export {

package/dist/esm/aa/index.js

@@ -0,0 +1,3 @@
+export * from "./types.js";
+export * from "./errors.js";
+export * from "./utils.js";

package/dist/esm/aa/types.js

@@ -1,4 +1,4 @@
-import "../chunk-HJO26HIQ.js";
+import "../chunk-6FNC3XMI.js";
 const SMART_ACCOUNT_PROVIDERS = [
   "ALCHEMY",
   "ZERODEV",

package/dist/esm/aa/utils.js

@@ -1,17 +1,106 @@
-import "../chunk-HJO26HIQ.js";
+import {
+  __async,
+  __spreadProps,
+  __spreadValues
+} from "../chunk-6FNC3XMI.js";
+import { createParaAccount } from "../viemWalletClient.js";
+import { SmartAccountError } from "./errors.js";
+function isExternalWallet(signer) {
+  return !!signer && typeof signer === "object" && "transport" in signer && "account" in signer;
+}
+function resolveExternalSigner(signer) {
+  if (!isExternalWallet(signer)) {
+    return signer;
+  }
+  const account = signer.account;
+  if (!(account == null ? void 0 : account.address)) {
+    throw new Error(
+      "[resolveExternalSigner] WalletClient must have an account set. Call `await walletClient.requestAddresses()` first, then pass the account."
+    );
+  }
+  return {
+    address: account.address,
+    publicKey: "0x",
+    source: "custom",
+    type: "local",
+    sign: (_0) => __async(this, [_0], function* ({ hash }) {
+      return signer.signMessage({ account: account.address, message: { raw: hash } });
+    }),
+    signMessage: (_0) => __async(this, [_0], function* ({ message }) {
+      return signer.signMessage({ account: account.address, message });
+    }),
+    signTransaction: (tx) => __async(this, null, function* () {
+      return signer.signTransaction(__spreadProps(__spreadValues({}, tx), { account }));
+    }),
+    signTypedData: (typedData) => __async(this, null, function* () {
+      return signer.signTypedData(__spreadProps(__spreadValues({}, typedData), { account: account.address }));
+    }),
+    signAuthorization: () => __async(this, null, function* () {
+      throw new Error(
+        "EIP-7702 account delegation (signAuthorization) is not supported with external wallets. External wallets add an EIP-191 prefix to all signatures, which is incompatible with the raw ecrecover required by EIP-7702. Use an embedded Para wallet for 7702 mode, or use 4337 mode which works with any wallet."
+      );
+    })
+  };
+}
+function ensureExternalWalletChain(signer, chain, provider) {
+  return __async(this, null, function* () {
+    if (!isExternalWallet(signer)) return;
+    const currentChainId = yield signer.getChainId();
+    if (currentChainId !== chain.id) {
+      throw new SmartAccountError({
+        code: "CHAIN_MISMATCH",
+        message: `External wallet is on chain ${currentChainId} but smart account targets chain ${chain.id} (${chain.name}). Switch your wallet to the correct network before sending transactions.`,
+        provider
+      });
+    }
+  });
+}
 function resolveWalletIdentifier(para, params) {
-  var _a;
   try {
     if (params.address) {
-      const wallet = para.findWalletByAddress(params.address, { type: ["EVM"] });
-      return wallet.address;
+      const wallet2 = para.findWalletByAddress(params.address, { type: ["EVM"] });
+      if (wallet2.isExternal) return null;
+      return wallet2.address;
     }
     const validId = para.findWalletId(params.walletId, { type: ["EVM"] });
-    return (_a = para.wallets[validId]) == null ? void 0 : _a.address;
+    const wallet = para.wallets[validId];
+    if (!wallet || wallet.isExternal) return null;
+    return wallet.address;
   } catch (e) {
     return null;
   }
 }
+function resolveSigner(para, params) {
+  if (params.signer) {
+    return resolveExternalSigner(params.signer);
+  }
+  const walletAddress = resolveWalletIdentifier(para, params);
+  if (!walletAddress) return null;
+  return createParaAccount(para, walletAddress);
+}
+function rejectExternalWallet7702(signer, provider) {
+  if (!signer || !isExternalWallet(signer)) return;
+  throw new SmartAccountError({
+    code: "INVALID_CONFIG",
+    message: "EIP-7702 mode is not supported with external wallets. External wallets add an EIP-191 prefix to all signatures, which is incompatible with the raw ecrecover required by EIP-7702 authorization. Use an embedded Para wallet for 7702 mode, or use 4337 mode which works with any wallet.",
+    provider
+  });
+}
+function assertAccountAddress(address, clientLabel, provider) {
+  if (!address) {
+    throw new SmartAccountError({
+      code: "MISSING_ACCOUNT_ADDRESS",
+      message: `${clientLabel} did not return a smart account address. Verify your configuration.`,
+      provider
+    });
+  }
+}
 export {
+  assertAccountAddress,
+  ensureExternalWalletChain,
+  isExternalWallet,
+  rejectExternalWallet7702,
+  resolveExternalSigner,
+  resolveSigner,
   resolveWalletIdentifier
 };

package/dist/esm/{chunk-HJO26HIQ.js → chunk-6FNC3XMI.js}

@@ -1,4 +1,6 @@
 var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
 var __getOwnPropSymbols = Object.getOwnPropertySymbols;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __propIsEnum = Object.prototype.propertyIsEnumerable;
@@ -14,6 +16,7 @@ var __spreadValues = (a, b) => {
     }
   return a;
 };
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
 var __async = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
     var fulfilled = (value) => {
@@ -37,5 +40,6 @@ var __async = (__this, __arguments, generator) => {
 
 export {
   __spreadValues,
+  __spreadProps,
   __async
 };

package/dist/esm/index.js

@@ -1,8 +1 @@
-import "./chunk-HJO26HIQ.js";
 export * from "./viemWalletClient.js";
-export * from "./aa/types.js";
-export * from "./aa/errors.js";
-import { resolveWalletIdentifier } from "./aa/utils.js";
-export {
-  resolveWalletIdentifier
-};

package/dist/esm/viemWalletClient.js

@@ -1,7 +1,7 @@
 import {
   __async,
   __spreadValues
-} from "./chunk-HJO26HIQ.js";
+} from "./chunk-6FNC3XMI.js";
 import {
   createWalletClient,
   hashMessage,

package/dist/types/aa/errors.d.ts

@@ -1,5 +1,5 @@
 import type { SmartAccountProvider } from './types.js';
-export declare const SMART_ACCOUNT_ERROR_CODES: readonly ["MISSING_CHAIN", "MISSING_ACCOUNT_ADDRESS", "MISSING_API_KEY", "INVALID_CONFIG", "AUTHORIZATION_FAILED", "DELEGATION_CONFLICT", "AUTHORIZATION_NONCE_MISMATCH", "BUNDLER_REJECTED", "GAS_ESTIMATION_FAILED", "SPONSORSHIP_DENIED", "RECEIPT_TIMEOUT", "TRANSACTION_REVERTED", "RECEIPT_MISSING", "PROVIDER_UNREACHABLE", "PROVIDER_RATE_LIMITED", "PROVIDER_ERROR"];
+export declare const SMART_ACCOUNT_ERROR_CODES: readonly ["MISSING_CHAIN", "MISSING_ACCOUNT_ADDRESS", "MISSING_API_KEY", "INVALID_CONFIG", "AUTHORIZATION_FAILED", "DELEGATION_CONFLICT", "AUTHORIZATION_NONCE_MISMATCH", "CHAIN_MISMATCH", "BUNDLER_REJECTED", "GAS_ESTIMATION_FAILED", "SPONSORSHIP_DENIED", "RECEIPT_TIMEOUT", "TRANSACTION_REVERTED", "RECEIPT_MISSING", "PROVIDER_UNREACHABLE", "PROVIDER_RATE_LIMITED", "PROVIDER_ERROR"];
 export type SmartAccountErrorCode = (typeof SMART_ACCOUNT_ERROR_CODES)[number];
 export declare class SmartAccountError extends Error {
     readonly code: SmartAccountErrorCode;

package/dist/types/aa/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './errors.js';
+export * from './utils.js';

package/dist/types/aa/types.d.ts

@@ -1,5 +1,5 @@
 import type ParaCore from '@getpara/core-sdk';
-import type { Chain, Hex, LocalAccount, TransactionReceipt } from 'viem';
+import type { Chain, Hex, LocalAccount, TransactionReceipt, WalletClient } from 'viem';
 /**
  * Base configuration shared by all smart account implementations.
  */
@@ -8,6 +8,29 @@ export interface BaseSmartAccountConfig {
     address?: Hex;
     /** Optional wallet ID to use. Alternative to `address` for selecting a specific wallet. */
     walletId?: string;
+    /**
+     * External signer — use when signing with a non-Para embedded wallet (e.g. MetaMask, Coinbase Wallet).
+     *
+     * When provided, Para's embedded MPC signing is bypassed entirely. The signer's address is used
+     * as the smart account owner instead of a Para wallet. `para.signMessage` is never called.
+     *
+     * Accepts either a viem `LocalAccount` or a connected `WalletClient` (e.g. from `createWalletClient`
+     * with `custom(window.ethereum)`). If a `WalletClient` is passed, its account must be set.
+     *
+     * @example
+     * ```ts
+     * // MetaMask via viem
+     * const metamask = createWalletClient({ transport: custom(window.ethereum), chain });
+     * await metamask.requestAddresses(); // prompt MetaMask connection
+     * const [address] = await metamask.getAddresses();
+     *
+     * useAlchemySmartAccount({ apiKey, chain, signer: metamask });
+     * // or from an external wallet connector:
+     * const { walletClient } = useExternalWallet();
+     * useAlchemySmartAccount({ apiKey, chain, signer: walletClient });
+     * ```
+     */
+    signer?: LocalAccount | WalletClient;
 }
 /**
  * Configuration for smart accounts that require chain configuration.
@@ -111,43 +134,19 @@ interface SmartAccountBase<TClient = any> {
     provider: SmartAccountProvider;
     /**
      * Send a single transaction and wait for confirmation.
-     *
-     * @param params - Transaction parameters
-     * @param options - Provider-specific options (paymaster config, gas settings, etc.)
-     * @returns viem TransactionReceipt — full on-chain receipt with logs, gasUsed, status, etc.
      */
     sendTransaction(params: TransactionParams, options?: unknown): Promise<TransactionReceipt>;
     /**
      * Send multiple transactions in a batch and wait for confirmation.
-     *
-     * @param calls - Array of transaction calls
-     * @param options - Provider-specific options (paymaster config, gas settings, etc.)
-     * @returns viem TransactionReceipt — full on-chain receipt with logs, gasUsed, status, etc.
      */
     sendBatchTransaction(calls: TransactionParams[], options?: unknown): Promise<TransactionReceipt>;
     /**
      * The underlying provider-specific client
-     * Use this to access provider-specific features beyond the unified interface
-     *
-     * @example
-     * ```typescript
-     * // Access provider-specific features
-     * const nativeClient = smartAccount.client;
-     * await nativeClient.simulateUserOperation({ ... });
-     * ```
      */
     client: TClient;
 }
 /**
  * EIP-4337 smart account (user operations via bundler)
- *
- * Providers: Alchemy, ZeroDev, Biconomy, Pimlico, Safe, Thirdweb, Rhinestone, CDP
- *
- * @example
- * ```typescript
- * const account: SmartAccount4337 = createPimlicoSmartAccount(client);
- * await account.sendTransaction({ to, value, data });
- * ```
  */
 export interface SmartAccount4337<TClient = any> extends SmartAccountBase<TClient> {
     /** Discriminant — always `'4337'` for EIP-4337 accounts. */
@@ -155,15 +154,6 @@ export interface SmartAccount4337<TClient = any> extends SmartAccountBase<TClien
 }
 /**
  * EIP-7702 smart account (EOA delegation)
- *
- * Providers: Alchemy, ZeroDev, Biconomy, Pimlico, Gelato, Porto, Thirdweb
- *
- * @example
- * ```typescript
- * const account: SmartAccount7702 = createPortoSmartAccount(provider);
- * // smartAccountAddress === signer.address for 7702
- * // delegationAddress is the contract the EOA delegates to
- * ```
  */
 export interface SmartAccount7702<TClient = any> extends SmartAccountBase<TClient> {
     /** Discriminant — always `'7702'` for EIP-7702 accounts. */
@@ -177,20 +167,6 @@ export interface SmartAccount7702<TClient = any> extends SmartAccountBase<TClien
 }
 /**
  * Unified smart account type - discriminated union
- *
- * Use TypeScript's control flow analysis to narrow types based on the `mode` field:
- *
- * @example
- * ```typescript
- * function handleAccount(account: SmartAccount) {
- *   if (account.mode === '7702') {
- *     // TypeScript knows this is SmartAccount7702
- *     console.log('Delegation:', account.delegationAddress);
- *   }
- *   // Both modes share sendTransaction, signer, chain
- *   await account.sendTransaction({ to, value, data });
- * }
- * ```
  */
 export type SmartAccount<TClient = any> = SmartAccount4337<TClient> | SmartAccount7702<TClient>;
 /**

package/dist/types/aa/utils.d.ts

@@ -1,7 +1,29 @@
 import type ParaCore from '@getpara/core-sdk';
-import type { Hex } from 'viem';
+import type { Chain, Hex, LocalAccount, WalletClient } from 'viem';
+import type { BaseSmartAccountConfig, SmartAccountProvider } from './types.js';
 /**
- * Resolves an EVM wallet address from params. Returns `null` if no matching wallet exists.
+ * Returns true if the signer is a WalletClient (external browser wallet).
+ * Used to detect external wallets before mode-specific checks.
+ */
+export declare function isExternalWallet(signer: unknown): signer is WalletClient;
+/**
+ * Normalizes a `signer` param (LocalAccount | WalletClient) to a LocalAccount.
+ *
+ * - If it's already a `LocalAccount` (`type === 'local'`), returns it as-is.
+ * - If it's a `WalletClient`, wraps its signing methods into a LocalAccount shape.
+ *   The WalletClient must have an `account` set.
+ */
+export declare function resolveExternalSigner(signer: LocalAccount | WalletClient): LocalAccount;
+/**
+ * Verifies an external wallet (WalletClient) is on the target chain.
+ * Throws a `SmartAccountError` with code `CHAIN_MISMATCH` if the wallet is on a different chain.
+ * No-op if the signer is not a WalletClient.
+ */
+export declare function ensureExternalWalletChain(signer: unknown, chain: Chain, provider: SmartAccountProvider): Promise<void>;
+/**
+ * Resolves an EVM **embedded** wallet address from params. Returns `null` if no matching
+ * wallet exists or if the matched wallet is external (external wallets lack MPC share
+ * data and cannot be used with `createParaAccount`).
  *
  * Priority:
  * 1. Explicit `address` — validated as an EVM wallet via `findWalletByAddress()`
@@ -12,3 +34,29 @@ export declare function resolveWalletIdentifier(para: ParaCore, params: {
     address?: Hex;
     walletId?: string;
 }): Hex | null;
+/**
+ * Resolves a viem LocalAccount signer from the action params.
+ *
+ * - If `params.signer` is a `LocalAccount`, returns it directly.
+ * - If `params.signer` is a `WalletClient`, wraps it via `resolveExternalSigner`.
+ * - If no signer is provided, resolves an embedded Para wallet via `resolveWalletIdentifier`
+ *   and creates a `LocalAccount` via `createParaAccount`.
+ *
+ * Returns `null` when no embedded wallet is found (callers should return `null` to the user).
+ */
+export declare function resolveSigner(para: ParaCore, params: BaseSmartAccountConfig): LocalAccount | null;
+/**
+ * Throws a `SmartAccountError` if an external wallet signer is used with EIP-7702 mode.
+ * 7702 requires raw `signAuthorization` which external wallets cannot provide.
+ *
+ * Call at the top of dual-mode action functions when `mode === '7702'`.
+ * No-op if signer is undefined or a LocalAccount.
+ */
+export declare function rejectExternalWallet7702(signer: LocalAccount | WalletClient | undefined, provider: SmartAccountProvider): void;
+/**
+ * Asserts that a smart account address was resolved.
+ * Throws a `SmartAccountError` with code `MISSING_ACCOUNT_ADDRESS` if the address is falsy.
+ *
+ * Use after creating the provider-specific client to ensure it produced an account.
+ */
+export declare function assertAccountAddress(address: Hex | undefined, clientLabel: string, provider: SmartAccountProvider): asserts address is Hex;

package/dist/types/index.d.ts

@@ -1,4 +1 @@
 export * from './viemWalletClient.js';
-export * from './aa/types.js';
-export * from './aa/errors.js';
-export { resolveWalletIdentifier } from './aa/utils.js';

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@getpara/viem-v2-integration",
-  "version": "2.16.0",
+  "version": "2.17.0",
   "dependencies": {
-    "@getpara/core-sdk": "2.16.0"
+    "@getpara/core-sdk": "2.17.0"
   },
   "devDependencies": {
     "typescript": "^5.8.3",
@@ -13,17 +13,22 @@
       "types": "./dist/types/index.d.ts",
       "import": "./dist/esm/index.js",
       "require": "./dist/cjs/index.js"
+    },
+    "./aa": {
+      "types": "./dist/types/aa/index.d.ts",
+      "import": "./dist/esm/aa/index.js",
+      "require": "./dist/cjs/aa/index.js"
     }
   },
   "files": [
     "dist",
     "package.json"
   ],
-  "gitHead": "fbe96a062b308d04105213378c12c38ee973c798",
+  "gitHead": "3ed1f835b97ae720f1ac747611296e3b86f61138",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "peerDependencies": {
-    "viem": "2.x"
+    "viem": "^2.39.0"
   },
   "scripts": {
     "build": "rm -rf dist && node ./scripts/build.mjs && yarn build:types",
@@ -34,5 +39,12 @@
   },
   "sideEffects": false,
   "types": "dist/types/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "aa": [
+        "dist/types/aa/index.d.ts"
+      ]
+    }
+  },
   "typings": "dist/types/index.d.ts"
 }