@getpara/viem-v2-integration 2.14.0 → 2.16.0

package/dist/cjs/aa/errors.js

@@ -0,0 +1,101 @@
+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))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var errors_exports = {};
+__export(errors_exports, {
+  SMART_ACCOUNT_ERROR_CODES: () => SMART_ACCOUNT_ERROR_CODES,
+  SmartAccountError: () => SmartAccountError,
+  classifyProviderError: () => classifyProviderError,
+  wrapProviderError: () => wrapProviderError
+});
+module.exports = __toCommonJS(errors_exports);
+const SMART_ACCOUNT_ERROR_CODES = [
+  "MISSING_CHAIN",
+  "MISSING_ACCOUNT_ADDRESS",
+  "MISSING_API_KEY",
+  "INVALID_CONFIG",
+  // Authorization (7702)
+  "AUTHORIZATION_FAILED",
+  "DELEGATION_CONFLICT",
+  "AUTHORIZATION_NONCE_MISMATCH",
+  // Transaction Submission
+  "BUNDLER_REJECTED",
+  "GAS_ESTIMATION_FAILED",
+  "SPONSORSHIP_DENIED",
+  // Transaction Receipt
+  "RECEIPT_TIMEOUT",
+  "TRANSACTION_REVERTED",
+  "RECEIPT_MISSING",
+  // Provider
+  "PROVIDER_UNREACHABLE",
+  "PROVIDER_RATE_LIMITED",
+  "PROVIDER_ERROR"
+];
+class SmartAccountError extends Error {
+  constructor(params) {
+    super(params.message);
+    this.name = "SmartAccountError";
+    this.code = params.code;
+    this.provider = params.provider;
+    if (params.cause !== void 0) {
+      this.cause = params.cause;
+    }
+  }
+}
+function classifyProviderError(error) {
+  const msg = error instanceof Error ? error.message.toLowerCase() : String(error).toLowerCase();
+  if (msg.includes("rate limit") || msg.includes("429")) {
+    return "PROVIDER_RATE_LIMITED";
+  }
+  if (msg.includes("gas") && (msg.includes("estimate") || msg.includes("estimation"))) {
+    return "GAS_ESTIMATION_FAILED";
+  }
+  if (msg.includes("paymaster") || msg.includes("sponsor")) {
+    return "SPONSORSHIP_DENIED";
+  }
+  if (msg.includes("useroperation") && (msg.includes("reverted") || msg.includes("rejected") || msg.includes("failed"))) {
+    return "BUNDLER_REJECTED";
+  }
+  if (msg.includes("nonce") && msg.includes("authorization")) {
+    return "AUTHORIZATION_NONCE_MISMATCH";
+  }
+  if (msg.includes("nonce") || msg.includes("aa25") || msg.includes("aa10")) {
+    return "BUNDLER_REJECTED";
+  }
+  if (msg.includes("authorization") || msg.includes("delegation")) {
+    return "AUTHORIZATION_FAILED";
+  }
+  if (msg.includes("econnrefused") || msg.includes("fetch failed") || msg.includes("network") || msg.includes("timeout")) {
+    return "PROVIDER_UNREACHABLE";
+  }
+  return "PROVIDER_ERROR";
+}
+function wrapProviderError(error, provider) {
+  if (error instanceof SmartAccountError) {
+    return error;
+  }
+  const code = classifyProviderError(error);
+  const message = error instanceof Error ? error.message : String(error);
+  return new SmartAccountError({ code, message, provider, cause: error });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SMART_ACCOUNT_ERROR_CODES,
+  SmartAccountError,
+  classifyProviderError,
+  wrapProviderError
+});

package/dist/cjs/aa/types.js

@@ -0,0 +1,48 @@
+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))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+__export(types_exports, {
+  SMART_ACCOUNT_PROVIDERS: () => SMART_ACCOUNT_PROVIDERS,
+  isSmartAccount4337: () => isSmartAccount4337,
+  isSmartAccount7702: () => isSmartAccount7702
+});
+module.exports = __toCommonJS(types_exports);
+const SMART_ACCOUNT_PROVIDERS = [
+  "ALCHEMY",
+  "ZERODEV",
+  "BICONOMY",
+  "GELATO",
+  "PIMLICO",
+  "SAFE",
+  "THIRDWEB",
+  "RHINESTONE",
+  "PORTO",
+  "CDP"
+];
+function isSmartAccount7702(account) {
+  return account.mode === "7702";
+}
+function isSmartAccount4337(account) {
+  return account.mode === "4337";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SMART_ACCOUNT_PROVIDERS,
+  isSmartAccount4337,
+  isSmartAccount7702
+});

package/dist/cjs/aa/utils.js

@@ -0,0 +1,39 @@
+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))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var utils_exports = {};
+__export(utils_exports, {
+  resolveWalletIdentifier: () => resolveWalletIdentifier
+});
+module.exports = __toCommonJS(utils_exports);
+function resolveWalletIdentifier(para, params) {
+  var _a;
+  try {
+    if (params.address) {
+      const wallet = para.findWalletByAddress(params.address, { type: ["EVM"] });
+      return wallet.address;
+    }
+    const validId = para.findWalletId(params.walletId, { type: ["EVM"] });
+    return (_a = para.wallets[validId]) == null ? void 0 : _a.address;
+  } catch (e) {
+    return null;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  resolveWalletIdentifier
+});

package/dist/cjs/index.js

@@ -2,6 +2,10 @@ 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))
@@ -13,9 +17,18 @@ 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 = {
-  ...require("./viemWalletClient.js")
+  resolveWalletIdentifier,
+  ...require("./viemWalletClient.js"),
+  ...require("./aa/types.js"),
+  ...require("./aa/errors.js")
 });

package/dist/esm/aa/errors.js

@@ -0,0 +1,76 @@
+import "../chunk-HJO26HIQ.js";
+const SMART_ACCOUNT_ERROR_CODES = [
+  "MISSING_CHAIN",
+  "MISSING_ACCOUNT_ADDRESS",
+  "MISSING_API_KEY",
+  "INVALID_CONFIG",
+  // Authorization (7702)
+  "AUTHORIZATION_FAILED",
+  "DELEGATION_CONFLICT",
+  "AUTHORIZATION_NONCE_MISMATCH",
+  // Transaction Submission
+  "BUNDLER_REJECTED",
+  "GAS_ESTIMATION_FAILED",
+  "SPONSORSHIP_DENIED",
+  // Transaction Receipt
+  "RECEIPT_TIMEOUT",
+  "TRANSACTION_REVERTED",
+  "RECEIPT_MISSING",
+  // Provider
+  "PROVIDER_UNREACHABLE",
+  "PROVIDER_RATE_LIMITED",
+  "PROVIDER_ERROR"
+];
+class SmartAccountError extends Error {
+  constructor(params) {
+    super(params.message);
+    this.name = "SmartAccountError";
+    this.code = params.code;
+    this.provider = params.provider;
+    if (params.cause !== void 0) {
+      this.cause = params.cause;
+    }
+  }
+}
+function classifyProviderError(error) {
+  const msg = error instanceof Error ? error.message.toLowerCase() : String(error).toLowerCase();
+  if (msg.includes("rate limit") || msg.includes("429")) {
+    return "PROVIDER_RATE_LIMITED";
+  }
+  if (msg.includes("gas") && (msg.includes("estimate") || msg.includes("estimation"))) {
+    return "GAS_ESTIMATION_FAILED";
+  }
+  if (msg.includes("paymaster") || msg.includes("sponsor")) {
+    return "SPONSORSHIP_DENIED";
+  }
+  if (msg.includes("useroperation") && (msg.includes("reverted") || msg.includes("rejected") || msg.includes("failed"))) {
+    return "BUNDLER_REJECTED";
+  }
+  if (msg.includes("nonce") && msg.includes("authorization")) {
+    return "AUTHORIZATION_NONCE_MISMATCH";
+  }
+  if (msg.includes("nonce") || msg.includes("aa25") || msg.includes("aa10")) {
+    return "BUNDLER_REJECTED";
+  }
+  if (msg.includes("authorization") || msg.includes("delegation")) {
+    return "AUTHORIZATION_FAILED";
+  }
+  if (msg.includes("econnrefused") || msg.includes("fetch failed") || msg.includes("network") || msg.includes("timeout")) {
+    return "PROVIDER_UNREACHABLE";
+  }
+  return "PROVIDER_ERROR";
+}
+function wrapProviderError(error, provider) {
+  if (error instanceof SmartAccountError) {
+    return error;
+  }
+  const code = classifyProviderError(error);
+  const message = error instanceof Error ? error.message : String(error);
+  return new SmartAccountError({ code, message, provider, cause: error });
+}
+export {
+  SMART_ACCOUNT_ERROR_CODES,
+  SmartAccountError,
+  classifyProviderError,
+  wrapProviderError
+};

package/dist/esm/aa/types.js

@@ -0,0 +1,24 @@
+import "../chunk-HJO26HIQ.js";
+const SMART_ACCOUNT_PROVIDERS = [
+  "ALCHEMY",
+  "ZERODEV",
+  "BICONOMY",
+  "GELATO",
+  "PIMLICO",
+  "SAFE",
+  "THIRDWEB",
+  "RHINESTONE",
+  "PORTO",
+  "CDP"
+];
+function isSmartAccount7702(account) {
+  return account.mode === "7702";
+}
+function isSmartAccount4337(account) {
+  return account.mode === "4337";
+}
+export {
+  SMART_ACCOUNT_PROVIDERS,
+  isSmartAccount4337,
+  isSmartAccount7702
+};

package/dist/esm/aa/utils.js

@@ -0,0 +1,17 @@
+import "../chunk-HJO26HIQ.js";
+function resolveWalletIdentifier(para, params) {
+  var _a;
+  try {
+    if (params.address) {
+      const wallet = para.findWalletByAddress(params.address, { type: ["EVM"] });
+      return wallet.address;
+    }
+    const validId = para.findWalletId(params.walletId, { type: ["EVM"] });
+    return (_a = para.wallets[validId]) == null ? void 0 : _a.address;
+  } catch (e) {
+    return null;
+  }
+}
+export {
+  resolveWalletIdentifier
+};

package/dist/esm/chunk-HJO26HIQ.js

@@ -0,0 +1,41 @@
+var __defProp = Object.defineProperty;
+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 __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());
+  });
+};
+
+export {
+  __spreadValues,
+  __async
+};

package/dist/esm/index.js

@@ -1 +1,8 @@
+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,39 +1,7 @@
-var __defProp = Object.defineProperty;
-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 __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());
-  });
-};
+import {
+  __async,
+  __spreadValues
+} from "./chunk-HJO26HIQ.js";
 import {
   createWalletClient,
   hashMessage,

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

@@ -0,0 +1,22 @@
+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 type SmartAccountErrorCode = (typeof SMART_ACCOUNT_ERROR_CODES)[number];
+export declare class SmartAccountError extends Error {
+    readonly code: SmartAccountErrorCode;
+    readonly provider: SmartAccountProvider;
+    constructor(params: {
+        code: SmartAccountErrorCode;
+        message: string;
+        provider: SmartAccountProvider;
+        cause?: unknown;
+    });
+}
+/**
+ * Classifies an unknown provider error into a SmartAccountErrorCode.
+ * Inspects the error message for common patterns across AA providers.
+ */
+export declare function classifyProviderError(error: unknown): SmartAccountErrorCode;
+/**
+ * Wraps an unknown error thrown by a provider SDK into a SmartAccountError.
+ */
+export declare function wrapProviderError(error: unknown, provider: SmartAccountProvider): SmartAccountError;

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

@@ -0,0 +1,203 @@
+import type ParaCore from '@getpara/core-sdk';
+import type { Chain, Hex, LocalAccount, TransactionReceipt } from 'viem';
+/**
+ * Base configuration shared by all smart account implementations.
+ */
+export interface BaseSmartAccountConfig {
+    /** Optional wallet address to use. If none is provided, the first EVM wallet will be used. */
+    address?: Hex;
+    /** Optional wallet ID to use. Alternative to `address` for selecting a specific wallet. */
+    walletId?: string;
+}
+/**
+ * Configuration for smart accounts that require chain configuration.
+ */
+export interface ChainBasedSmartAccountConfig extends BaseSmartAccountConfig {
+    /** Target blockchain chain */
+    chain: Chain;
+    /** RPC URL for the chain. If not provided, defaults to the chain's built-in public RPC. */
+    rpcUrl?: string;
+}
+/**
+ * Configuration for smart accounts with API key authentication.
+ */
+export interface ApiKeySmartAccountConfig extends ChainBasedSmartAccountConfig {
+    /** API key for the service */
+    apiKey: string;
+}
+/**
+ * Configuration for smart accounts with paymaster support.
+ */
+export interface PaymasterSmartAccountConfig extends ChainBasedSmartAccountConfig {
+    /** Optional bundler RPC URL */
+    bundlerUrl?: string;
+    /** Optional paymaster RPC URL for gas sponsorship */
+    paymasterUrl?: string;
+}
+/**
+ * Adds `para: ParaCore` to a config type to produce the full action params.
+ */
+export type CreateSmartAccountParams<T extends BaseSmartAccountConfig> = T & {
+    /** Para SDK instance */
+    para: ParaCore;
+};
+/**
+ * Smart account mode — the two execution models supported by AA providers.
+ * - '4337': EIP-4337 UserOperations via bundler
+ * - '7702': EIP-7702 EOA delegation (type 4 transactions)
+ */
+export type SmartAccountMode = '4337' | '7702';
+/**
+ * Maps a mode literal to the corresponding SmartAccount type.
+ * When mode is the full union or undefined, returns the union.
+ */
+export type SmartAccountForMode<TMode extends SmartAccountMode | undefined, TClient = any> = TMode extends '7702' ? SmartAccount7702<TClient> : TMode extends '4337' ? SmartAccount4337<TClient> : SmartAccount<TClient>;
+/**
+ * Mixin for params that support choosing between 4337 and 7702 execution modes.
+ */
+export interface SmartAccountModeParam {
+    /**
+     * Account mode: EIP-4337 (bundler) or EIP-7702 (EOA delegation)
+     * @default '4337'
+     */
+    mode?: SmartAccountMode;
+}
+/**
+ * All supported AA provider names.
+ */
+export declare const SMART_ACCOUNT_PROVIDERS: readonly ["ALCHEMY", "ZERODEV", "BICONOMY", "GELATO", "PIMLICO", "SAFE", "THIRDWEB", "RHINESTONE", "PORTO", "CDP"];
+export type SmartAccountProvider = (typeof SMART_ACCOUNT_PROVIDERS)[number];
+/**
+ * Transaction parameters
+ */
+export interface TransactionParams {
+    /** Recipient address */
+    to: Hex;
+    /** Amount in wei. Use viem's `parseEther('0.1')` to convert from ETH. */
+    value?: bigint;
+    /** Encoded contract call data. Use viem's `encodeFunctionData()` to encode. */
+    data?: Hex;
+}
+/**
+ * Re-export viem's TransactionReceipt as the standard return type.
+ * All providers return a full on-chain receipt with logs, gasUsed, etc.
+ */
+export type { TransactionReceipt } from 'viem';
+/**
+ * Base smart account interface with shared functionality
+ * This contains methods available on ALL account types
+ */
+interface SmartAccountBase<TClient = any> {
+    /**
+     * The smart account address — where transactions originate from on-chain.
+     * - EIP-4337: Counterfactual smart account address (different from signer EOA)
+     * - EIP-7702: EOA address (same as signer.address)
+     */
+    smartAccountAddress: Hex;
+    /**
+     * The Para viem LocalAccount that signs operations for this smart account.
+     * Provides signMessage, signTypedData, signTransaction, and signAuthorization.
+     * For 4337, signer.address differs from `smartAccountAddress` (signer EOA vs smart account).
+     * For 7702, signer.address equals `smartAccountAddress`.
+     */
+    signer: LocalAccount;
+    /**
+     * Chain this account is configured for.
+     */
+    chain: Chain;
+    /**
+     * Provider name
+     */
+    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. */
+    mode: '4337';
+}
+/**
+ * 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. */
+    mode: '7702';
+    /**
+     * The smart contract address the EOA delegates execution to.
+     * Each provider uses a different delegation contract.
+     * Undefined if the provider handles delegation internally.
+     */
+    delegationAddress?: Hex;
+}
+/**
+ * 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>;
+/**
+ * Type guard to check if account supports EIP-7702
+ */
+export declare function isSmartAccount7702<TClient = any>(account: SmartAccount<TClient>): account is SmartAccount7702<TClient>;
+/**
+ * Type guard to check if account supports EIP-4337
+ */
+export declare function isSmartAccount4337<TClient = any>(account: SmartAccount<TClient>): account is SmartAccount4337<TClient>;

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

@@ -0,0 +1,14 @@
+import type ParaCore from '@getpara/core-sdk';
+import type { Hex } from 'viem';
+/**
+ * Resolves an EVM wallet address from params. Returns `null` if no matching wallet exists.
+ *
+ * Priority:
+ * 1. Explicit `address` — validated as an EVM wallet via `findWalletByAddress()`
+ * 2. `walletId` — validated via `findWalletId()` and resolved to address
+ * 3. Neither — picks the first available EVM wallet via `findWalletId()`
+ */
+export declare function resolveWalletIdentifier(para: ParaCore, params: {
+    address?: Hex;
+    walletId?: string;
+}): Hex | null;

package/dist/types/index.d.ts

@@ -1 +1,4 @@
 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.14.0",
+  "version": "2.16.0",
   "dependencies": {
-    "@getpara/core-sdk": "2.14.0"
+    "@getpara/core-sdk": "2.16.0"
   },
   "devDependencies": {
     "typescript": "^5.8.3",
@@ -19,7 +19,7 @@
     "dist",
     "package.json"
   ],
-  "gitHead": "8ac7cfbe3b106a42e53f6e5439f484ab11b0e1f3",
+  "gitHead": "fbe96a062b308d04105213378c12c38ee973c798",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "peerDependencies": {