@getpara/core-sdk 2.18.0 → 2.19.0

package/dist/cjs/constants.js

@@ -46,7 +46,7 @@ __export(constants_exports, {
   TRANSACTION_REVIEW_TIMEOUT_MS: () => TRANSACTION_REVIEW_TIMEOUT_MS
 });
 module.exports = __toCommonJS(constants_exports);
-const PARA_CORE_VERSION = "2.18.0";
+const PARA_CORE_VERSION = "2.19.0";
 const PREFIX = "@CAPSULE/";
 const PARA_PREFIX = "@PARA/";
 const LOCAL_STORAGE_AUTH_INFO = `${PREFIX}authInfo`;

package/dist/cjs/index.js

@@ -92,6 +92,8 @@ __export(src_exports, {
   isPortal: () => import_utils.isPortal,
   isWalletSupported: () => import_wallet.isWalletSupported,
   mpcComputationClient: () => mpcComputationClient,
+  offParaEvent: () => import_utils.offParaEvent,
+  onParaEvent: () => import_utils.onParaEvent,
   paraVersion: () => paraVersion,
   publicKeyFromHex: () => import_utils2.publicKeyFromHex,
   shortenUrl: () => import_utils.shortenUrl,
@@ -102,6 +104,7 @@ module.exports = __toCommonJS(src_exports);
 var import_ParaCore = require("./ParaCore.js");
 var import_user_management_client = require("@getpara/user-management-client");
 var import_types = require("./types/index.js");
+__reExport(src_exports, require("./types/smartAccounts.js"), module.exports);
 __reExport(src_exports, require("./types/coreApi.js"), module.exports);
 __reExport(src_exports, require("./types/events.js"), module.exports);
 __reExport(src_exports, require("./types/config.js"), module.exports);
@@ -189,11 +192,14 @@ var src_default = import_ParaCore.ParaCore;
   isPortal,
   isWalletSupported,
   mpcComputationClient,
+  offParaEvent,
+  onParaEvent,
   paraVersion,
   publicKeyFromHex,
   shortenUrl,
   toAssetInfoArray,
   transmissionUtilsRetrieve,
+  ...require("./types/smartAccounts.js"),
   ...require("./types/coreApi.js"),
   ...require("./types/events.js"),
   ...require("./types/config.js"),

package/dist/cjs/types/index.js

@@ -21,6 +21,7 @@ __reExport(types_exports, require("./wallet.js"), module.exports);
 __reExport(types_exports, require("./methods.js"), module.exports);
 __reExport(types_exports, require("./popup.js"), module.exports);
 __reExport(types_exports, require("./events.js"), module.exports);
+__reExport(types_exports, require("./smartAccounts.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require("./accountLinking.js"),
@@ -29,5 +30,6 @@ __reExport(types_exports, require("./events.js"), module.exports);
   ...require("./wallet.js"),
   ...require("./methods.js"),
   ...require("./popup.js"),
-  ...require("./events.js")
+  ...require("./events.js"),
+  ...require("./smartAccounts.js")
 });

package/dist/cjs/types/smartAccounts.js

@@ -0,0 +1,119 @@
+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 smartAccounts_exports = {};
+__export(smartAccounts_exports, {
+  SMART_ACCOUNT_ERROR_CODES: () => SMART_ACCOUNT_ERROR_CODES,
+  SMART_ACCOUNT_PROVIDERS: () => SMART_ACCOUNT_PROVIDERS,
+  SmartAccountError: () => SmartAccountError,
+  classifyProviderError: () => classifyProviderError,
+  wrapProviderError: () => wrapProviderError
+});
+module.exports = __toCommonJS(smartAccounts_exports);
+const SMART_ACCOUNT_PROVIDERS = [
+  "ALCHEMY",
+  "ZERODEV",
+  "BICONOMY",
+  "GELATO",
+  "PIMLICO",
+  "SAFE",
+  "THIRDWEB",
+  "RHINESTONE",
+  "PORTO",
+  "CDP"
+];
+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,
+  SMART_ACCOUNT_PROVIDERS,
+  SmartAccountError,
+  classifyProviderError,
+  wrapProviderError
+});

package/dist/cjs/utils/events.js

@@ -31,15 +31,43 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var events_exports = {};
 __export(events_exports, {
-  dispatchEvent: () => dispatchEvent
+  dispatchEvent: () => dispatchEvent,
+  offParaEvent: () => offParaEvent,
+  onParaEvent: () => onParaEvent
 });
 module.exports = __toCommonJS(events_exports);
+const listeners = /* @__PURE__ */ new Map();
+function onParaEvent(type, handler) {
+  let set = listeners.get(type);
+  if (!set) {
+    set = /* @__PURE__ */ new Set();
+    listeners.set(type, set);
+  }
+  set.add(handler);
+  return () => set.delete(handler);
+}
+function offParaEvent(type, handler) {
+  var _a;
+  (_a = listeners.get(type)) == null ? void 0 : _a.delete(handler);
+}
 function dispatchEvent(type, data, error) {
-  typeof window !== "undefined" && !!window.dispatchEvent && window.dispatchEvent(
-    new CustomEvent(type, { detail: __spreadValues({ data }, error && { error: new Error(error) }) })
-  );
+  const detail = __spreadValues({ data }, error && { error: new Error(error) });
+  const set = listeners.get(type);
+  if (set) {
+    for (const handler of set) {
+      try {
+        handler({ detail });
+      } catch (e) {
+      }
+    }
+  }
+  if (typeof window !== "undefined" && window.dispatchEvent) {
+    window.dispatchEvent(new CustomEvent(type, { detail }));
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  dispatchEvent
+  dispatchEvent,
+  offParaEvent,
+  onParaEvent
 });

package/dist/esm/constants.js

@@ -1,5 +1,5 @@
 import "./chunk-7B52C2XE.js";
-const PARA_CORE_VERSION = "2.18.0";
+const PARA_CORE_VERSION = "2.19.0";
 const PREFIX = "@CAPSULE/";
 const PARA_PREFIX = "@PARA/";
 const LOCAL_STORAGE_AUTH_INFO = `${PREFIX}authInfo`;

package/dist/esm/index.js

@@ -33,10 +33,20 @@ import {
   PregenIdentifierType,
   AccountLinkError
 } from "./types/index.js";
+export * from "./types/smartAccounts.js";
 export * from "./types/coreApi.js";
 export * from "./types/events.js";
 export * from "./types/config.js";
-import { getPortalDomain, dispatchEvent, entityToWallet, constructUrl, shortenUrl, isPortal } from "./utils/index.js";
+import {
+  getPortalDomain,
+  dispatchEvent,
+  onParaEvent,
+  offParaEvent,
+  entityToWallet,
+  constructUrl,
+  shortenUrl,
+  isPortal
+} from "./utils/index.js";
 import {
   PREFIX,
   PARA_PREFIX,
@@ -142,6 +152,8 @@ export {
   isPortal,
   isWalletSupported,
   mpcComputationClient,
+  offParaEvent,
+  onParaEvent,
   paraVersion,
   publicKeyFromHex,
   shortenUrl,

package/dist/esm/types/index.js

@@ -5,3 +5,4 @@ export * from "./wallet.js";
 export * from "./methods.js";
 export * from "./popup.js";
 export * from "./events.js";
+export * from "./smartAccounts.js";

package/dist/esm/types/smartAccounts.js

@@ -0,0 +1,93 @@
+import "../chunk-7B52C2XE.js";
+const SMART_ACCOUNT_PROVIDERS = [
+  "ALCHEMY",
+  "ZERODEV",
+  "BICONOMY",
+  "GELATO",
+  "PIMLICO",
+  "SAFE",
+  "THIRDWEB",
+  "RHINESTONE",
+  "PORTO",
+  "CDP"
+];
+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,
+  SMART_ACCOUNT_PROVIDERS,
+  SmartAccountError,
+  classifyProviderError,
+  wrapProviderError
+};

package/dist/esm/utils/events.js

@@ -1,11 +1,37 @@
 import {
   __spreadValues
 } from "../chunk-7B52C2XE.js";
+const listeners = /* @__PURE__ */ new Map();
+function onParaEvent(type, handler) {
+  let set = listeners.get(type);
+  if (!set) {
+    set = /* @__PURE__ */ new Set();
+    listeners.set(type, set);
+  }
+  set.add(handler);
+  return () => set.delete(handler);
+}
+function offParaEvent(type, handler) {
+  var _a;
+  (_a = listeners.get(type)) == null ? void 0 : _a.delete(handler);
+}
 function dispatchEvent(type, data, error) {
-  typeof window !== "undefined" && !!window.dispatchEvent && window.dispatchEvent(
-    new CustomEvent(type, { detail: __spreadValues({ data }, error && { error: new Error(error) }) })
-  );
+  const detail = __spreadValues({ data }, error && { error: new Error(error) });
+  const set = listeners.get(type);
+  if (set) {
+    for (const handler of set) {
+      try {
+        handler({ detail });
+      } catch (e) {
+      }
+    }
+  }
+  if (typeof window !== "undefined" && window.dispatchEvent) {
+    window.dispatchEvent(new CustomEvent(type, { detail }));
+  }
 }
 export {
-  dispatchEvent
+  dispatchEvent,
+  offParaEvent,
+  onParaEvent
 };

package/dist/types/index.d.ts

@@ -1,10 +1,11 @@
 import { ParaCore } from './ParaCore.js';
 export { type Auth, type AuthInfo, type PrimaryAuthInfo, type VerifiedAuthInfo, type VerifiedAuth, AuthMethod, type TAuthMethod, AuthMethodStatus, type AuthExtras, type CurrentWalletIds, EmailTheme, type PartnerEntity, type WalletEntity, Network, type TNetwork, WalletType, type TWalletType, WalletScheme, type TWalletScheme, OnRampAsset, type TOnRampAsset, OnRampPurchaseType, OnRampProvider, OnRampPurchaseStatus, type OnRampConfig, type OnRampAssets, type OnRampPurchase, type OnRampAssetInfo, type ProviderAssetInfo, OnRampMethod, type Theme, OAuthMethod, type TOAuthMethod, type TLinkedAccountType, type SupportedAccountLinks, type SupportedWalletTypes, type TPregenIdentifierType, type PregenIds, type LinkedAccount, type LinkedAccounts, type TExternalWallet, type ExternalWalletInfo, type PregenAuth, type Setup2faResponse, type TelegramAuthResponse, type VerifyExternalWalletParams, type AssetMetadata, type AssetMetadataIndexed, type AssetValue, type BalancesConfig, type WalletBalance, type ProfileBalance, type OfframpDepositRequest, type WalletWithMetadata, RecoveryStatus, ThemeMode, NON_ED25519, PREGEN_IDENTIFIER_TYPES, WALLET_TYPES, WALLET_SCHEMES, OAUTH_METHODS, LINKED_ACCOUNT_TYPES, EXTERNAL_WALLET_TYPES, EVM_WALLETS, SOLANA_WALLETS, COSMOS_WALLETS, formatAssetQuantity, formatCurrency, type EstimateTransactionOpts, type EstimateTransactionResult, type BroadcastTransactionOpts, type BroadcastTransactionResult, type PendingTransactionEntity, type SerializedDecodedTx, type SerializedTxData, type GetPendingTransactionResponse, } from '@getpara/user-management-client';
 export { PopupType, PregenIdentifierType, type AuthStateSignup, type AuthStateVerify, type AuthStateLogin, type AuthState, type OAuthResponse, type CoreAuthInfo, type SignatureRes, type FullSignatureRes, type SuccessfulSignatureRes, type DeniedSignatureRes, type DeniedSignatureResWithUrl, type Wallet, type AvailableWallet, type AccountLinkInProgress, AccountLinkError, type InternalInterface, type Verify2faParams, type Verify2faResponse, type StorageType, type TelegramParams, } from './types/index.js';
+export * from './types/smartAccounts.js';
 export * from './types/coreApi.js';
 export * from './types/events.js';
 export * from './types/config.js';
-export { getPortalDomain, dispatchEvent, entityToWallet, constructUrl, shortenUrl, isPortal } from './utils/index.js';
+export { getPortalDomain, dispatchEvent, onParaEvent, offParaEvent, entityToWallet, constructUrl, shortenUrl, isPortal, } from './utils/index.js';
 export { PREFIX as STORAGE_PREFIX, PARA_PREFIX as PARA_STORAGE_PREFIX, LOCAL_STORAGE_CURRENT_WALLET_IDS, LOCAL_STORAGE_WALLETS, } from './constants.js';
 export { distributeNewShare } from './shares/shareDistribution.js';
 export { KeyContainer } from './shares/KeyContainer.js';

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

@@ -5,5 +5,6 @@ export * from './wallet.js';
 export * from './methods.js';
 export * from './popup.js';
 export * from './events.js';
+export * from './smartAccounts.js';
 export type * from './util';
 export type * from './authState';

package/dist/types/types/smartAccounts.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 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];
+/**
+ * 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';
+/**
+ * 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;
+}
+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/utils/events.d.ts

@@ -1,2 +1,15 @@
-import { ParaEvent } from '../types/index.js';
+import { BaseEvent, ParaEvent } from '../types/index.js';
+type ParaEventHandler = (event: {
+    detail: BaseEvent<any>;
+}) => void;
+/**
+ * Subscribe to a ParaEvent. Works on every platform (web, RN, Node).
+ * Returns an unsubscribe function.
+ */
+export declare function onParaEvent(type: ParaEvent, handler: ParaEventHandler): () => void;
+/**
+ * Remove a previously registered handler.
+ */
+export declare function offParaEvent(type: ParaEvent, handler: ParaEventHandler): void;
 export declare function dispatchEvent<T>(type: ParaEvent, data: T, error?: string): void;
+export {};

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@getpara/core-sdk",
-  "version": "2.18.0",
+  "version": "2.19.0",
   "dependencies": {
     "@celo/utils": "^8.0.2",
     "@cosmjs/encoding": "^0.32.4",
     "@ethereumjs/util": "^9.1.0",
-    "@getpara/user-management-client": "2.18.0",
+    "@getpara/user-management-client": "2.19.0",
     "@noble/hashes": "^1.5.0",
     "axios": "^1.8.4",
     "base64url": "^3.0.1",
@@ -30,7 +30,7 @@
     "dist",
     "package.json"
   ],
-  "gitHead": "4481f6f4e108e682d14c74d4433696141c47fc58",
+  "gitHead": "7dc9400777adb653c0cc28e0d9236424eb384467",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "scripts": {