@getpara/viem-v2-integration 2.15.0 → 2.17.0

package/dist/cjs/aa/errors.js

@@ -0,0 +1,105 @@
+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",
+  // Chain
+  "CHAIN_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) {
+  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";
+  }
+  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) {
+  var _a;
+  if (error instanceof SmartAccountError) {
+    return error;
+  }
+  const code = classifyProviderError(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:
+0 && (module.exports = {
+  SMART_ACCOUNT_ERROR_CODES,
+  SmartAccountError,
+  classifyProviderError,
+  wrapProviderError
+});

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/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,167 @@
+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 });
+};
+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 __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) {
+  try {
+    if (params.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"] });
+    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/esm/aa/errors.js

@@ -0,0 +1,80 @@
+import "../chunk-6FNC3XMI.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",
+  // Chain
+  "CHAIN_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) {
+  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";
+  }
+  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) {
+  var _a;
+  if (error instanceof SmartAccountError) {
+    return error;
+  }
+  const code = classifyProviderError(error);
+  const message = error instanceof Error ? (_a = error.message) != null ? _a : String(error) : String(error);
+  return new SmartAccountError({ code, message, provider, cause: error });
+}
+export {
+  SMART_ACCOUNT_ERROR_CODES,
+  SmartAccountError,
+  classifyProviderError,
+  wrapProviderError
+};

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

@@ -0,0 +1,24 @@
+import "../chunk-6FNC3XMI.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,106 @@
+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) {
+  try {
+    if (params.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"] });
+    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-6FNC3XMI.js

@@ -0,0 +1,45 @@
+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;
+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 __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,
+  __spreadProps,
+  __async
+};

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-6FNC3XMI.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", "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;
+    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/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

@@ -0,0 +1,179 @@
+import type ParaCore from '@getpara/core-sdk';
+import type { Chain, Hex, LocalAccount, TransactionReceipt, WalletClient } 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;
+    /**
+     * 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.
+ */
+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.
+     */
+    sendTransaction(params: TransactionParams, options?: unknown): Promise<TransactionReceipt>;
+    /**
+     * Send multiple transactions in a batch and wait for confirmation.
+     */
+    sendBatchTransaction(calls: TransactionParams[], options?: unknown): Promise<TransactionReceipt>;
+    /**
+     * The underlying provider-specific client
+     */
+    client: TClient;
+}
+/**
+ * EIP-4337 smart account (user operations via bundler)
+ */
+export interface SmartAccount4337<TClient = any> extends SmartAccountBase<TClient> {
+    /** Discriminant — always `'4337'` for EIP-4337 accounts. */
+    mode: '4337';
+}
+/**
+ * EIP-7702 smart account (EOA delegation)
+ */
+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
+ */
+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,62 @@
+import type ParaCore from '@getpara/core-sdk';
+import type { Chain, Hex, LocalAccount, WalletClient } from 'viem';
+import type { BaseSmartAccountConfig, SmartAccountProvider } from './types.js';
+/**
+ * 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()`
+ * 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;
+/**
+ * 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/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@getpara/viem-v2-integration",
-  "version": "2.15.0",
+  "version": "2.17.0",
   "dependencies": {
-    "@getpara/core-sdk": "2.15.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": "9cecc178e975a44d8ed4b03f46aeb57ddcb7a152",
+  "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"
 }