@kheopskit/core 5.0.1 → 5.1.0

package/dist/{chunk-7QSGAJ4A.mjs → chunk-3Y5N4N3Q.mjs}

@@ -1,6 +1,10 @@
-var __defProp = Object.defineProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+import {
+  POLKADOT_EXTENSIONS
+} from "./chunk-BWUUHUDK.mjs";
+import {
+  isWalletConnectWallet,
+  parseWalletId
+} from "./chunk-WOPCW2OX.mjs";
 
 // src/utils/storage.ts
 var noopStorage = {
@@ -133,78 +137,131 @@ var cookieStorage = (initialCookies) => {
   };
 };
 
-// src/utils/isWalletPlatform.ts
-var isWalletPlatform = (platform) => typeof platform === "string" && ["polkadot", "ethereum", "solana"].includes(platform);
-
-// src/utils/WalletId.ts
-var WALLET_CONNECT_WALLET_ID = "walletconnect";
-var getWalletId = (platform, identifier) => {
-  if (!isWalletPlatform(platform)) throw new Error("Invalid platform");
-  if (!identifier) throw new Error("Invalid name");
-  return `${platform}:${identifier}`;
+// src/utils/hydrateState.ts
+var lookupWalletIcon = (platform, identifier) => {
+  if (platform === "polkadot") {
+    return POLKADOT_EXTENSIONS[identifier]?.icon ?? "";
+  }
+  return "";
 };
-var parseWalletId = (walletId) => {
-  if (!walletId) throw new Error("Invalid walletId");
-  const [platform, identifier] = walletId.split(":");
-  if (!isWalletPlatform(platform)) throw new Error("Invalid platform");
-  if (!identifier) throw new Error("Invalid address");
-  return { platform, identifier };
+var PendingWalletError = class extends Error {
+  constructor(walletId) {
+    super(
+      `Wallet ${walletId} is still loading. Wait for isHydrating to be false before calling connect/disconnect.`
+    );
+    this.name = "PendingWalletError";
+  }
 };
-var isValidWalletId = (walletId) => {
-  if (typeof walletId !== "string" || !walletId) return false;
-  if (walletId === WALLET_CONNECT_WALLET_ID) return true;
-  const [platform, identifier] = walletId.split(":");
-  return isWalletPlatform(platform) && !!identifier;
+var hydrateWallet = (cached) => {
+  const throwPending = () => {
+    throw new PendingWalletError(cached.id);
+  };
+  if (cached.type === "walletconnect") {
+    return {
+      id: cached.id,
+      type: "walletconnect",
+      platforms: [],
+      name: cached.name,
+      icon: "",
+      isConnected: cached.isConnected,
+      connect: throwPending,
+      disconnect: throwPending
+    };
+  }
+  const { platform, identifier } = parseWalletId(cached.id);
+  return {
+    id: cached.id,
+    platform: cached.platform,
+    type: cached.type,
+    name: cached.name,
+    icon: lookupWalletIcon(platform, identifier),
+    isConnected: cached.isConnected,
+    connect: throwPending,
+    disconnect: throwPending
+  };
 };
+var hydrateAccount = (cached) => ({
+  id: cached.id,
+  platform: cached.platform,
+  address: cached.address,
+  name: cached.name,
+  walletId: cached.walletId,
+  walletName: cached.walletName,
+  // Spread (not direct keys) so the extra platform fields don't trip the
+  // excess-property check against BaseWalletAccount; they're read back via the
+  // platform-specific account types once narrowed by `platform`.
+  ...cached.platform === "ethereum" && { chainId: cached.chainId },
+  ...cached.platform === "polkadot" && {
+    type: cached.polkadotAccountType
+  }
+});
+var serializeWallet = (wallet) => ({
+  id: wallet.id,
+  // The WalletConnect connector has no platform.
+  platform: isWalletConnectWallet(wallet) ? void 0 : wallet.platform,
+  type: wallet.type,
+  name: wallet.name,
+  // Note: icon is NOT stored to save cookie space
+  isConnected: wallet.isConnected
+});
+var serializeAccount = (account) => ({
+  id: account.id,
+  platform: account.platform,
+  address: account.address,
+  name: account.name,
+  chainId: account.platform === "ethereum" ? account.chainId : void 0,
+  polkadotAccountType: account.platform === "polkadot" ? account.type : void 0,
+  walletId: account.walletId,
+  walletName: account.walletName
+});
 
-// src/utils/getCachedObservable.ts
-var CACHE_SYMBOL = /* @__PURE__ */ Symbol.for("kheopskit.observableCache");
-var getCache = () => {
-  const g = globalThis;
-  let cache = g[CACHE_SYMBOL];
-  if (!cache) {
-    cache = /* @__PURE__ */ new Map();
-    g[CACHE_SYMBOL] = cache;
+// src/utils/iconCache.ts
+var ICON_CACHE_KEY = "kheopskit-icons";
+var memoryCache = null;
+var loadCache = () => {
+  if (memoryCache !== null) return memoryCache;
+  try {
+    const stored = safeLocalStorage.getItem(ICON_CACHE_KEY);
+    memoryCache = stored ? JSON.parse(stored) : {};
+  } catch {
+    memoryCache = {};
   }
-  return cache;
+  return memoryCache;
 };
-var getCachedObservable$ = (key, create) => {
-  const cache = getCache();
-  if (!cache.has(key)) cache.set(key, create());
-  return cache.get(key);
+var saveCache = (cache) => {
+  try {
+    safeLocalStorage.setItem(ICON_CACHE_KEY, JSON.stringify(cache));
+    memoryCache = cache;
+  } catch {
+  }
 };
-var clearCachedObservable = (key) => {
-  getCache().delete(key);
+var getCachedIcon = (walletId) => {
+  const cache = loadCache();
+  return cache[walletId] || void 0;
 };
-var clearCachedObservablesByPrefix = (prefix) => {
-  const cache = getCache();
-  for (const key of cache.keys()) {
-    if (key.startsWith(prefix)) cache.delete(key);
+var setCachedIcons = (icons) => {
+  const cache = loadCache();
+  let changed = false;
+  for (const [walletId, icon] of Object.entries(icons)) {
+    if (icon && cache[walletId] !== icon) {
+      cache[walletId] = icon;
+      changed = true;
+    }
+  }
+  if (changed) {
+    saveCache(cache);
   }
-};
-var clearAllCachedObservables = () => {
-  getCache().clear();
 };
 
-// src/api/types.ts
-var isWalletConnectWallet = (wallet) => wallet.type === "walletconnect";
-var isInjectedWallet = (wallet) => wallet.type === "injected";
-
 export {
-  __publicField,
   getSafeLocalStorage,
   safeLocalStorage,
   cookieStorage,
-  isWalletPlatform,
-  WALLET_CONNECT_WALLET_ID,
-  getWalletId,
-  parseWalletId,
-  isValidWalletId,
-  getCachedObservable$,
-  clearCachedObservable,
-  clearCachedObservablesByPrefix,
-  clearAllCachedObservables,
-  isWalletConnectWallet,
-  isInjectedWallet
+  hydrateWallet,
+  hydrateAccount,
+  serializeWallet,
+  serializeAccount,
+  getCachedIcon,
+  setCachedIcons
 };
-//# sourceMappingURL=chunk-7QSGAJ4A.mjs.map
+//# sourceMappingURL=chunk-3Y5N4N3Q.mjs.map

package/dist/chunk-3Y5N4N3Q.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/storage.ts","../src/utils/hydrateState.ts","../src/utils/iconCache.ts"],"sourcesContent":["export type Storage = {\n\tgetItem: (key: string) => string | null;\n\tsetItem: (key: string, value: string) => void;\n\tremoveItem: (key: string) => void;\n};\n\n/**\n * Extended storage interface with cross-tab sync support.\n */\nexport type SyncableStorage = Storage & {\n\t/**\n\t * Subscribe to storage changes from other tabs.\n\t * Returns an unsubscribe function.\n\t */\n\tsubscribe?: (\n\t\tkey: string,\n\t\tcallback: (value: string | null) => void,\n\t) => () => void;\n};\n\n/**\n * A no-op storage implementation that does nothing.\n * Useful for testing or SSR environments where no storage is needed.\n */\nexport const noopStorage: SyncableStorage = {\n\tgetItem: () => null,\n\tsetItem: () => {},\n\tremoveItem: () => {},\n};\n\n/**\n * Cached localStorage wrapper instance.\n * Lazily initialized on first access to avoid SSR issues.\n */\nlet _safeLocalStorage: SyncableStorage | null = null;\n\n/**\n * Creates the localStorage wrapper, testing for availability.\n * Returns noopStorage if localStorage is unavailable (SSR, private browsing, etc.)\n */\nconst createSafeLocalStorage = (): SyncableStorage => {\n\tif (typeof window === \"undefined\") return noopStorage;\n\n\ttry {\n\t\t// Test that localStorage is accessible (may throw in private browsing)\n\t\tconst testKey = \"__kheopskit_test__\";\n\t\twindow.localStorage.setItem(testKey, testKey);\n\t\twindow.localStorage.removeItem(testKey);\n\n\t\treturn {\n\t\t\tgetItem: (key: string) => window.localStorage.getItem(key),\n\t\t\tsetItem: (key: string, value: string) =>\n\t\t\t\twindow.localStorage.setItem(key, value),\n\t\t\tremoveItem: (key: string) => window.localStorage.removeItem(key),\n\t\t\tsubscribe: (key: string, callback: (value: string | null) => void) => {\n\t\t\t\tconst handler = (event: StorageEvent) => {\n\t\t\t\t\tif (event.key === key) {\n\t\t\t\t\t\tcallback(event.newValue);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t\twindow.addEventListener(\"storage\", handler);\n\t\t\t\treturn () => window.removeEventListener(\"storage\", handler);\n\t\t\t},\n\t\t};\n\t} catch {\n\t\treturn noopStorage;\n\t}\n};\n\n/**\n * A safe localStorage wrapper that falls back to noopStorage\n * when localStorage is not available (e.g., during SSR).\n * Includes cross-tab sync via the native 'storage' event.\n *\n * Lazily initialized on first access to be SSR-safe.\n */\nexport const getSafeLocalStorage = (): SyncableStorage => {\n\tif (_safeLocalStorage === null) {\n\t\t_safeLocalStorage = createSafeLocalStorage();\n\t}\n\treturn _safeLocalStorage;\n};\n\n/**\n * @deprecated Use getSafeLocalStorage() instead. This is kept for backward compatibility.\n * Returns a proxy that lazily initializes on first method call.\n */\nexport const safeLocalStorage: SyncableStorage = {\n\tgetItem: (key: string) => getSafeLocalStorage().getItem(key),\n\tsetItem: (key: string, value: string) =>\n\t\tgetSafeLocalStorage().setItem(key, value),\n\tremoveItem: (key: string) => getSafeLocalStorage().removeItem(key),\n\tsubscribe: (key: string, callback: (value: string | null) => void) => {\n\t\tconst storage = getSafeLocalStorage();\n\t\treturn storage.subscribe?.(key, callback) ?? (() => {});\n\t},\n};\n\n/**\n * Parse a cookie string to extract the value for a specific key.\n * @param cookieString - The full cookie header string (e.g., document.cookie or req.headers.cookie)\n * @param key - The cookie key to find\n * @returns The cookie value or null if not found\n */\nexport const parseCookie = (\n\tcookieString: string | undefined,\n\tkey: string,\n): string | null => {\n\tif (!cookieString) return null;\n\n\tfor (const cookie of cookieString.split(\";\")) {\n\t\tconst [k, ...v] = cookie.split(\"=\");\n\t\tconst cookieKey = k?.trim();\n\t\tif (cookieKey === key) {\n\t\t\ttry {\n\t\t\t\treturn decodeURIComponent(v.join(\"=\").trim());\n\t\t\t} catch {\n\t\t\t\treturn null; // Malformed cookie value\n\t\t\t}\n\t\t}\n\t}\n\n\treturn null;\n};\n\n/**\n * Maximum recommended size for cookie storage (3KB to stay well under 4KB limit).\n *\n * @remarks\n * Cookie storage is subject to browser limits (typically 4KB per cookie).\n * When users connect many wallets, the auto-reconnect list may exceed this limit.\n * If this happens:\n * - A console warning will be logged\n * - Some browsers may silently reject the cookie\n * - Consider using fewer simultaneous wallet connections\n *\n * The stored data includes wallet IDs in format `platform:identifier`\n * (e.g., `polkadot:talisman`, `ethereum:io.metamask`).\n */\nexport const COOKIE_MAX_SIZE = 3 * 1024;\n\n/**\n * BroadcastChannel name for cross-tab cookie sync.\n */\nconst BROADCAST_CHANNEL_NAME = \"kheopskit-storage-sync\";\n\n/**\n * Singleton BroadcastChannel for cross-tab cookie sync.\n * Created once and shared across all cookieStorage instances.\n */\nlet sharedBroadcastChannel: BroadcastChannel | null = null;\n\nconst getBroadcastChannel = (): BroadcastChannel | null => {\n\tif (sharedBroadcastChannel) return sharedBroadcastChannel;\n\tif (typeof BroadcastChannel === \"undefined\") return null;\n\n\ttry {\n\t\tsharedBroadcastChannel = new BroadcastChannel(BROADCAST_CHANNEL_NAME);\n\t} catch {\n\t\t// BroadcastChannel not supported or failed\n\t}\n\treturn sharedBroadcastChannel;\n};\n\n/**\n * Check if the current connection is secure (HTTPS).\n * Must be called at runtime (inside methods) to work correctly after SSR hydration.\n */\nconst isSecureConnection = (): boolean =>\n\ttypeof window !== \"undefined\" && window.location.protocol === \"https:\";\n\n/**\n * A cookie-based storage implementation for SSR environments.\n * Reads cookies from an optional initial cookie string (for SSR hydration),\n * writes to document.cookie on the client.\n *\n * Features:\n * - Secure flag automatically added for HTTPS connections\n * - Cross-tab synchronization via BroadcastChannel API\n * - Size limit warning when data exceeds recommended limits\n *\n * @param initialCookies - Optional cookie string for server-side hydration\n */\nexport const cookieStorage = (initialCookies?: string): SyncableStorage => {\n\treturn {\n\t\tgetItem: (key: string) => {\n\t\t\t// On server, use initialCookies. On client, read from document.cookie\n\t\t\tconst cookieString =\n\t\t\t\ttypeof document !== \"undefined\" ? document.cookie : initialCookies;\n\t\t\treturn parseCookie(cookieString, key);\n\t\t},\n\t\tsetItem: (key: string, value: string) => {\n\t\t\tif (typeof document === \"undefined\") return;\n\n\t\t\t// Warn if value exceeds recommended size\n\t\t\tconst encodedValue = encodeURIComponent(value);\n\t\t\tif (encodedValue.length > COOKIE_MAX_SIZE) {\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`[kheopskit] Cookie value for \"${key}\" exceeds recommended size limit (${encodedValue.length} > ${COOKIE_MAX_SIZE} bytes). ` +\n\t\t\t\t\t\t\"This may cause issues with cookie storage. Consider reducing the number of connected wallets.\",\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t// Set cookie with 1 year expiry\n\t\t\tconst expires = new Date();\n\t\t\texpires.setFullYear(expires.getFullYear() + 1);\n\n\t\t\t// Build cookie string with security attributes\n\t\t\tlet cookieStr = `${key}=${encodedValue};expires=${expires.toUTCString()};path=/;SameSite=Lax`;\n\t\t\tif (isSecureConnection()) {\n\t\t\t\tcookieStr += \";Secure\";\n\t\t\t}\n\n\t\t\t// biome-ignore lint: necessary for cookie storage - direct cookie assignment is the standard API\n\t\t\tdocument.cookie = cookieStr;\n\n\t\t\t// Broadcast change to other tabs\n\t\t\tgetBroadcastChannel()?.postMessage({ type: \"set\", key, value });\n\t\t},\n\t\tremoveItem: (key: string) => {\n\t\t\tif (typeof document === \"undefined\") return;\n\n\t\t\t// Build delete cookie string\n\t\t\tlet cookieStr = `${key}=;expires=Thu, 01 Jan 1970 00:00:01 GMT;path=/;SameSite=Lax`;\n\t\t\tif (isSecureConnection()) {\n\t\t\t\tcookieStr += \";Secure\";\n\t\t\t}\n\n\t\t\t// biome-ignore lint: necessary for cookie storage - direct cookie assignment is the standard API\n\t\t\tdocument.cookie = cookieStr;\n\n\t\t\t// Broadcast change to other tabs\n\t\t\tgetBroadcastChannel()?.postMessage({ type: \"remove\", key });\n\t\t},\n\t\tsubscribe: (key: string, callback: (value: string | null) => void) => {\n\t\t\tconst channel = getBroadcastChannel();\n\t\t\tif (!channel) return () => {};\n\n\t\t\tconst handler = (event: MessageEvent) => {\n\t\t\t\tconst data = event.data as {\n\t\t\t\t\ttype: string;\n\t\t\t\t\tkey: string;\n\t\t\t\t\tvalue?: string;\n\t\t\t\t};\n\t\t\t\tif (data.key === key) {\n\t\t\t\t\tif (data.type === \"set\") {\n\t\t\t\t\t\tcallback(data.value ?? null);\n\t\t\t\t\t} else if (data.type === \"remove\") {\n\t\t\t\t\t\tcallback(null);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t};\n\n\t\t\tchannel.addEventListener(\"message\", handler);\n\t\t\treturn () => {\n\t\t\t\tchannel.removeEventListener(\"message\", handler);\n\t\t\t};\n\t\t},\n\t};\n};\n\n/**\n * Cleanup the shared BroadcastChannel used for cross-tab cookie sync.\n * Call this when you're done using cookie storage (e.g., in tests or when unmounting).\n *\n * @remarks\n * In normal browser usage, you typically don't need to call this -\n * the channel will be cleaned up when the page is closed.\n * This is primarily useful for testing environments where multiple\n * test runs may accumulate channels.\n */\nexport const cleanupBroadcastChannel = (): void => {\n\tif (sharedBroadcastChannel) {\n\t\tsharedBroadcastChannel.close();\n\t\tsharedBroadcastChannel = null;\n\t}\n};\n","import {\n\ttype BaseWallet,\n\ttype BaseWalletAccount,\n\ttype CachedAccount,\n\ttype CachedWallet,\n\tisWalletConnectWallet,\n\ttype PolkadotAccountType,\n\ttype WalletConnectWallet,\n} from \"../api/types\";\nimport { POLKADOT_EXTENSIONS } from \"./polkadotExtensions\";\nimport type { WalletAccountId } from \"./WalletAccountId\";\nimport { parseWalletId, type WalletId } from \"./WalletId\";\n\n/**\n * Looks up the icon for a wallet from known Polkadot extensions only.\n * Ethereum icons will be populated from the localStorage icon cache via the merge function.\n *\n * Note: We DON'T use localStorage icon cache here because hydrateWallet is called\n * during SSR (server) and client hydration. localStorage isn't available on server,\n * so using it would cause a hydration mismatch. Icons for Ethereum wallets will be\n * populated when the hydration buffer merges cached wallets with live wallets.\n */\nconst lookupWalletIcon = (platform: string, identifier: string): string => {\n\t// Only Polkadot extensions have hardcoded icons that are safe for SSR\n\tif (platform === \"polkadot\") {\n\t\treturn POLKADOT_EXTENSIONS[identifier]?.icon ?? \"\";\n\t}\n\t// Ethereum icons come from localStorage or live wallets - not here\n\treturn \"\";\n};\n\n/**\n * Error thrown when trying to use a placeholder wallet that hasn't fully loaded yet.\n */\nclass PendingWalletError extends Error {\n\tconstructor(walletId: string) {\n\t\tsuper(\n\t\t\t`Wallet ${walletId} is still loading. Wait for isHydrating to be false before calling connect/disconnect.`,\n\t\t);\n\t\tthis.name = \"PendingWalletError\";\n\t}\n}\n\n/**\n * Converts a CachedWallet to a placeholder wallet for SSR hydration display.\n *\n * The placeholder carries only the SDK-free {@link BaseWallet} fields; the real\n * wallet (with its injected provider/extension/standard-wallet handle) replaces\n * it once it loads. connect/disconnect throw until then.\n */\nexport const hydrateWallet = (\n\tcached: CachedWallet,\n): BaseWallet | WalletConnectWallet => {\n\tconst throwPending = () => {\n\t\tthrow new PendingWalletError(cached.id);\n\t};\n\n\t// The platform-less WalletConnect connector. `appKit`/`platforms` are SDK\n\t// state absent until the live connector loads (cast like other placeholder\n\t// SDK handles); icon is filled from the localStorage cache by the caller.\n\tif (cached.type === \"walletconnect\") {\n\t\treturn {\n\t\t\tid: cached.id,\n\t\t\ttype: \"walletconnect\",\n\t\t\tplatforms: [],\n\t\t\tname: cached.name,\n\t\t\ticon: \"\",\n\t\t\tisConnected: cached.isConnected,\n\t\t\tconnect: throwPending,\n\t\t\tdisconnect: throwPending,\n\t\t} as unknown as WalletConnectWallet;\n\t}\n\n\tconst { platform, identifier } = parseWalletId(cached.id);\n\n\treturn {\n\t\tid: cached.id,\n\t\tplatform: cached.platform as BaseWallet[\"platform\"],\n\t\ttype: cached.type,\n\t\tname: cached.name,\n\t\ticon: lookupWalletIcon(platform, identifier),\n\t\tisConnected: cached.isConnected,\n\t\tconnect: throwPending,\n\t\tdisconnect: throwPending,\n\t};\n};\n\n/**\n * Converts a CachedAccount to a placeholder account for SSR hydration display.\n *\n * The placeholder carries the SDK-free {@link BaseWalletAccount} fields plus the\n * plain, serializable platform data that lives in the cache — Ethereum `chainId`\n * and the Polkadot key `type`. Those render immediately on reload (no blank →\n * value flicker) and match what the live account will report. Only the SDK\n * handles (`client`/`signer`/`polkadotSigner`) are absent until the real account\n * replaces this placeholder; signing stays gated on `isHydrating` until then.\n */\nexport const hydrateAccount = (cached: CachedAccount): BaseWalletAccount => ({\n\tid: cached.id as WalletAccountId,\n\tplatform: cached.platform,\n\taddress: cached.address,\n\tname: cached.name,\n\twalletId: cached.walletId,\n\twalletName: cached.walletName,\n\t// Spread (not direct keys) so the extra platform fields don't trip the\n\t// excess-property check against BaseWalletAccount; they're read back via the\n\t// platform-specific account types once narrowed by `platform`.\n\t...(cached.platform === \"ethereum\" && { chainId: cached.chainId }),\n\t...(cached.platform === \"polkadot\" && {\n\t\ttype: cached.polkadotAccountType,\n\t}),\n});\n\n/**\n * Converts a wallet to a CachedWallet for storage.\n * Only extracts the serializable properties needed for hydration.\n */\nexport const serializeWallet = (\n\twallet: BaseWallet | WalletConnectWallet,\n): CachedWallet => ({\n\tid: wallet.id,\n\t// The WalletConnect connector has no platform.\n\tplatform: isWalletConnectWallet(wallet) ? undefined : wallet.platform,\n\ttype: wallet.type,\n\tname: wallet.name,\n\t// Note: icon is NOT stored to save cookie space\n\tisConnected: wallet.isConnected,\n});\n\n/**\n * Converts an account to a CachedAccount for storage.\n * Only extracts the serializable properties needed for hydration. Platform-only\n * fields (Ethereum chainId, Polkadot key type) are read defensively so this\n * stays SDK-free.\n */\nexport const serializeAccount = (\n\taccount: BaseWalletAccount,\n): CachedAccount => ({\n\tid: account.id,\n\tplatform: account.platform,\n\taddress: account.address,\n\tname: account.name,\n\tchainId:\n\t\taccount.platform === \"ethereum\"\n\t\t\t? (account as { chainId?: number }).chainId\n\t\t\t: undefined,\n\tpolkadotAccountType:\n\t\taccount.platform === \"polkadot\"\n\t\t\t? (account as { type?: PolkadotAccountType }).type\n\t\t\t: undefined,\n\twalletId: account.walletId as WalletId,\n\twalletName: account.walletName,\n});\n","import { safeLocalStorage } from \"./storage\";\n\n/**\n * Storage key for the icon cache in localStorage.\n */\nconst ICON_CACHE_KEY = \"kheopskit-icons\";\n\n/**\n * Icon cache type: a map of wallet ID to icon data URI or URL.\n */\ntype IconCache = Record<string, string>;\n\n/**\n * In-memory cache to avoid repeated localStorage reads.\n */\nlet memoryCache: IconCache | null = null;\n\n/**\n * Loads the icon cache from localStorage.\n */\nconst loadCache = (): IconCache => {\n\tif (memoryCache !== null) return memoryCache;\n\n\ttry {\n\t\tconst stored = safeLocalStorage.getItem(ICON_CACHE_KEY);\n\t\tmemoryCache = stored ? (JSON.parse(stored) as IconCache) : {};\n\t} catch {\n\t\tmemoryCache = {};\n\t}\n\treturn memoryCache;\n};\n\n/**\n * Saves the icon cache to localStorage.\n */\nconst saveCache = (cache: IconCache): void => {\n\ttry {\n\t\tsafeLocalStorage.setItem(ICON_CACHE_KEY, JSON.stringify(cache));\n\t\tmemoryCache = cache;\n\t} catch {\n\t\t// localStorage may be full or unavailable\n\t}\n};\n\n/**\n * Gets a cached icon for a wallet.\n * @param walletId - The wallet ID (e.g., \"ethereum:io.talisman\")\n * @returns The cached icon data URI, or undefined if not cached\n */\nexport const getCachedIcon = (walletId: string): string | undefined => {\n\tconst cache = loadCache();\n\treturn cache[walletId] || undefined;\n};\n\n/**\n * Sets multiple cached icons at once.\n * More efficient than calling setCachedIcon multiple times.\n * @param icons - Map of wallet ID to icon\n */\nexport const setCachedIcons = (icons: Record<string, string>): void => {\n\tconst cache = loadCache();\n\tlet changed = false;\n\n\tfor (const [walletId, icon] of Object.entries(icons)) {\n\t\tif (icon && cache[walletId] !== icon) {\n\t\t\tcache[walletId] = icon;\n\t\t\tchanged = true;\n\t\t}\n\t}\n\n\tif (changed) {\n\t\tsaveCache(cache);\n\t}\n};\n"],"mappings":"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","names":[]}

package/dist/chunk-DF7EKK4G.mjs

@@ -0,0 +1,106 @@
+import {
+  __publicField
+} from "./chunk-WOPCW2OX.mjs";
+
+// src/utils/isEthereumAddress.ts
+import { keccak_256 } from "@noble/hashes/sha3";
+var HEX_ADDRESS = /^0x[0-9a-fA-F]{40}$/;
+var encoder = new TextEncoder();
+var isChecksumValid = (address) => {
+  const hex = address.slice(2);
+  const hash = keccak_256(encoder.encode(hex.toLowerCase()));
+  for (let i = 0; i < 40; i++) {
+    const char = hex.charAt(i);
+    const isLetter = char >= "a" && char <= "f" || char >= "A" && char <= "F";
+    if (!isLetter) continue;
+    const byte = hash[i >> 1] ?? 0;
+    const nibble = i % 2 === 0 ? byte >> 4 : byte & 15;
+    const isUpper = char <= "F";
+    if (isUpper !== nibble >= 8) return false;
+  }
+  return true;
+};
+var isEthereumAddress = (address) => {
+  if (!HEX_ADDRESS.test(address)) return false;
+  if (address === address.toLowerCase()) return true;
+  return isChecksumValid(address);
+};
+
+// src/utils/isSolanaAddress.ts
+import { base58 } from "@scure/base";
+var isSolanaAddress = (address) => {
+  if (!address) return false;
+  try {
+    return base58.decode(address).length === 32;
+  } catch {
+    return false;
+  }
+};
+
+// src/utils/isSs58Address.ts
+import { blake2b } from "@noble/hashes/blake2b";
+import { base58 as base582 } from "@scure/base";
+var SS58PRE = new Uint8Array([83, 83, 53, 56, 80, 82, 69]);
+var isSs58Address = (address) => {
+  if (!address) return false;
+  let decoded;
+  try {
+    decoded = base582.decode(address);
+  } catch {
+    return false;
+  }
+  const firstByte = decoded[0];
+  if (firstByte === void 0 || firstByte & 128) return false;
+  const prefixLength = firstByte & 64 ? 2 : 1;
+  if (decoded.length !== prefixLength + 32 + 2) return false;
+  const body = decoded.subarray(0, decoded.length - 2);
+  const preimage = new Uint8Array(SS58PRE.length + body.length);
+  preimage.set(SS58PRE);
+  preimage.set(body, SS58PRE.length);
+  const hash = blake2b(preimage, { dkLen: 64 });
+  return decoded[decoded.length - 2] === hash[0] && decoded[decoded.length - 1] === hash[1];
+};
+
+// src/utils/isValidAddress.ts
+var isValidAddress = (address) => {
+  if (address.startsWith("0x")) return isEthereumAddress(address);
+  return isSs58Address(address) || isSolanaAddress(address);
+};
+
+// src/utils/WalletAccountId.ts
+var getWalletAccountId = (walletId, address) => {
+  if (!walletId) throw new Error("Missing walletId");
+  if (!isValidAddress(address)) throw new Error("Invalid address");
+  return `${walletId}::${address}`;
+};
+var parseWalletAccountId = (accountId) => {
+  if (!accountId) throw new Error("Invalid walletAccountId");
+  const [walletId, address] = accountId.split("::");
+  if (!walletId) throw new Error("Missing walletId");
+  if (!address || !isValidAddress(address)) throw new Error("Invalid address");
+  return { walletId, address };
+};
+
+// src/api/errors.ts
+var KheopskitError = class extends Error {
+  constructor(code, message, options) {
+    super(`[kheopskit] ${message}`, { cause: options?.cause });
+    __publicField(this, "code");
+    /** The wallet id this error relates to, when applicable. */
+    __publicField(this, "walletId");
+    this.name = "KheopskitError";
+    this.code = code;
+    this.walletId = options?.walletId;
+  }
+};
+
+export {
+  isEthereumAddress,
+  isSolanaAddress,
+  isSs58Address,
+  isValidAddress,
+  getWalletAccountId,
+  parseWalletAccountId,
+  KheopskitError
+};
+//# sourceMappingURL=chunk-DF7EKK4G.mjs.map

package/dist/chunk-DF7EKK4G.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/isEthereumAddress.ts","../src/utils/isSolanaAddress.ts","../src/utils/isSs58Address.ts","../src/utils/isValidAddress.ts","../src/utils/WalletAccountId.ts","../src/api/errors.ts"],"sourcesContent":["import { keccak_256 } from \"@noble/hashes/sha3\";\n\nconst HEX_ADDRESS = /^0x[0-9a-fA-F]{40}$/;\nconst encoder = new TextEncoder();\n\n/**\n * Verifies the EIP-55 mixed-case checksum of an Ethereum address.\n * Dependency-free (keccak via @noble/hashes) so core stays decoupled from viem.\n */\nconst isChecksumValid = (address: string): boolean => {\n\tconst hex = address.slice(2);\n\tconst hash = keccak_256(encoder.encode(hex.toLowerCase()));\n\tfor (let i = 0; i < 40; i++) {\n\t\tconst char = hex.charAt(i);\n\t\tconst isLetter =\n\t\t\t(char >= \"a\" && char <= \"f\") || (char >= \"A\" && char <= \"F\");\n\t\tif (!isLetter) continue;\n\t\tconst byte = hash[i >> 1] ?? 0;\n\t\tconst nibble = i % 2 === 0 ? byte >> 4 : byte & 0x0f;\n\t\tconst isUpper = char <= \"F\";\n\t\tif (isUpper !== nibble >= 8) return false;\n\t}\n\treturn true;\n};\n\n/**\n * Returns true if `address` is a valid Ethereum address.\n *\n * Mirrors viem's `isAddress` (strict): the shape must be `0x` + 40 hex, and a\n * mixed-case address must pass the EIP-55 checksum. All-lowercase addresses are\n * accepted as non-checksummed.\n */\nexport const isEthereumAddress = (address: string): boolean => {\n\tif (!HEX_ADDRESS.test(address)) return false;\n\tif (address === address.toLowerCase()) return true;\n\treturn isChecksumValid(address);\n};\n","import { base58 } from \"@scure/base\";\n\n/**\n * Returns true if the value is a valid Solana address: a base58-encoded\n * 32-byte ed25519 public key.\n *\n * Solana addresses carry no checksum, so this is a pure base58 + length check.\n * Dependency-free (base58 via @scure/base) so core stays decoupled from\n * @solana/kit.\n */\nexport const isSolanaAddress = (address: string): boolean => {\n\tif (!address) return false;\n\ttry {\n\t\treturn base58.decode(address).length === 32;\n\t} catch {\n\t\treturn false;\n\t}\n};\n","import { blake2b } from \"@noble/hashes/blake2b\";\nimport { base58 } from \"@scure/base\";\n\n// The \"SS58PRE\" prefix used in the SS58 checksum preimage.\nconst SS58PRE = new Uint8Array([0x53, 0x53, 0x35, 0x38, 0x50, 0x52, 0x45]);\n\n/**\n * Returns true if `address` is a valid SS58-encoded 32-byte account id (the\n * only form Substrate wallets inject), verifying the blake2b-512 checksum.\n *\n * Dependency-free (base58 via @scure/base, blake2b via @noble/hashes) so core\n * stays decoupled from polkadot-api.\n */\nexport const isSs58Address = (address: string): boolean => {\n\tif (!address) return false;\n\n\tlet decoded: Uint8Array;\n\ttry {\n\t\tdecoded = base58.decode(address);\n\t} catch {\n\t\treturn false;\n\t}\n\n\t// First byte encodes the network prefix; the high bit is reserved/invalid.\n\tconst firstByte = decoded[0];\n\tif (firstByte === undefined || firstByte & 0b1000_0000) return false;\n\t// The 0b0100_0000 bit marks a 2-byte prefix.\n\tconst prefixLength = firstByte & 0b0100_0000 ? 2 : 1;\n\n\t// AccountId32 layout: prefix + 32-byte pubkey + 2-byte checksum.\n\tif (decoded.length !== prefixLength + 32 + 2) return false;\n\n\tconst body = decoded.subarray(0, decoded.length - 2);\n\tconst preimage = new Uint8Array(SS58PRE.length + body.length);\n\tpreimage.set(SS58PRE);\n\tpreimage.set(body, SS58PRE.length);\n\tconst hash = blake2b(preimage, { dkLen: 64 });\n\n\treturn (\n\t\tdecoded[decoded.length - 2] === hash[0] &&\n\t\tdecoded[decoded.length - 1] === hash[1]\n\t);\n};\n","import { isEthereumAddress } from \"./isEthereumAddress\";\nimport { isSolanaAddress } from \"./isSolanaAddress\";\nimport { isSs58Address } from \"./isSs58Address\";\n\nexport const isValidAddress = (address: string): boolean => {\n\tif (address.startsWith(\"0x\")) return isEthereumAddress(address);\n\t// SS58 (checksummed) and Solana (base58, no checksum) are disjoint: a\n\t// 32-byte Solana pubkey fails SS58 decoding, and an SS58 address decodes to\n\t// more than 32 bytes so it fails the Solana length check.\n\treturn isSs58Address(address) || isSolanaAddress(address);\n};\n","import { isValidAddress } from \"./isValidAddress\";\n\nexport type WalletAccountId = string;\n\nexport const getWalletAccountId = (\n\twalletId: string,\n\taddress: string,\n): WalletAccountId => {\n\tif (!walletId) throw new Error(\"Missing walletId\");\n\tif (!isValidAddress(address)) throw new Error(\"Invalid address\");\n\treturn `${walletId}::${address}`;\n};\n\nexport const parseWalletAccountId = (accountId: string) => {\n\tif (!accountId) throw new Error(\"Invalid walletAccountId\");\n\tconst [walletId, address] = accountId.split(\"::\");\n\tif (!walletId) throw new Error(\"Missing walletId\");\n\tif (!address || !isValidAddress(address)) throw new Error(\"Invalid address\");\n\treturn { walletId, address };\n};\n","import type { WalletId } from \"../utils/WalletId\";\n\n/**\n * Stable error codes thrown by kheopskit. Catch a {@link KheopskitError} and\n * branch on `error.code` instead of matching message strings.\n */\nexport type KheopskitErrorCode =\n\t/** `connect()` called on a wallet that is already connected. */\n\t| \"WALLET_ALREADY_CONNECTED\"\n\t/** `disconnect()` called on a wallet that is not connected. */\n\t| \"WALLET_NOT_CONNECTED\"\n\t/** The wallet does not advertise a capability kheopskit needs to proceed. */\n\t| \"FEATURE_NOT_SUPPORTED\"\n\t/** No active WalletConnect session for the requested operation. */\n\t| \"NO_SESSION\"\n\t/** No provider available for the requested namespace. */\n\t| \"NO_PROVIDER\"\n\t/** The requested chain cannot be used for this operation (e.g. a Solana cluster with no CAIP-2 id over WalletConnect). */\n\t| \"UNSUPPORTED_CHAIN\";\n\n/**\n * Error thrown by kheopskit wallet/account operations. Carries a stable\n * {@link KheopskitErrorCode} and, when relevant, the offending wallet id.\n *\n * @example\n * ```ts\n * try {\n *   await wallet.connect();\n * } catch (error) {\n *   if (error instanceof KheopskitError && error.code === \"WALLET_ALREADY_CONNECTED\") {\n *     // ignore\n *   } else throw error;\n * }\n * ```\n */\nexport class KheopskitError extends Error {\n\treadonly code: KheopskitErrorCode;\n\t/** The wallet id this error relates to, when applicable. */\n\treadonly walletId?: WalletId;\n\n\tconstructor(\n\t\tcode: KheopskitErrorCode,\n\t\tmessage: string,\n\t\toptions?: { walletId?: WalletId; cause?: unknown },\n\t) {\n\t\tsuper(`[kheopskit] ${message}`, { cause: options?.cause });\n\t\tthis.name = \"KheopskitError\";\n\t\tthis.code = code;\n\t\tthis.walletId = options?.walletId;\n\t}\n}\n"],"mappings":"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","names":["base58"]}

package/dist/chunk-EH73P476.js

@@ -0,0 +1,106 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+var _chunkP7BPHHVVjs = require('./chunk-P7BPHHVV.js');
+
+// src/utils/isEthereumAddress.ts
+var _sha3 = require('@noble/hashes/sha3');
+var HEX_ADDRESS = /^0x[0-9a-fA-F]{40}$/;
+var encoder = new TextEncoder();
+var isChecksumValid = (address) => {
+  const hex = address.slice(2);
+  const hash = _sha3.keccak_256.call(void 0, encoder.encode(hex.toLowerCase()));
+  for (let i = 0; i < 40; i++) {
+    const char = hex.charAt(i);
+    const isLetter = char >= "a" && char <= "f" || char >= "A" && char <= "F";
+    if (!isLetter) continue;
+    const byte = _nullishCoalesce(hash[i >> 1], () => ( 0));
+    const nibble = i % 2 === 0 ? byte >> 4 : byte & 15;
+    const isUpper = char <= "F";
+    if (isUpper !== nibble >= 8) return false;
+  }
+  return true;
+};
+var isEthereumAddress = (address) => {
+  if (!HEX_ADDRESS.test(address)) return false;
+  if (address === address.toLowerCase()) return true;
+  return isChecksumValid(address);
+};
+
+// src/utils/isSolanaAddress.ts
+var _base = require('@scure/base');
+var isSolanaAddress = (address) => {
+  if (!address) return false;
+  try {
+    return _base.base58.decode(address).length === 32;
+  } catch (e) {
+    return false;
+  }
+};
+
+// src/utils/isSs58Address.ts
+var _blake2b = require('@noble/hashes/blake2b');
+
+var SS58PRE = new Uint8Array([83, 83, 53, 56, 80, 82, 69]);
+var isSs58Address = (address) => {
+  if (!address) return false;
+  let decoded;
+  try {
+    decoded = _base.base58.decode(address);
+  } catch (e2) {
+    return false;
+  }
+  const firstByte = decoded[0];
+  if (firstByte === void 0 || firstByte & 128) return false;
+  const prefixLength = firstByte & 64 ? 2 : 1;
+  if (decoded.length !== prefixLength + 32 + 2) return false;
+  const body = decoded.subarray(0, decoded.length - 2);
+  const preimage = new Uint8Array(SS58PRE.length + body.length);
+  preimage.set(SS58PRE);
+  preimage.set(body, SS58PRE.length);
+  const hash = _blake2b.blake2b.call(void 0, preimage, { dkLen: 64 });
+  return decoded[decoded.length - 2] === hash[0] && decoded[decoded.length - 1] === hash[1];
+};
+
+// src/utils/isValidAddress.ts
+var isValidAddress = (address) => {
+  if (address.startsWith("0x")) return isEthereumAddress(address);
+  return isSs58Address(address) || isSolanaAddress(address);
+};
+
+// src/utils/WalletAccountId.ts
+var getWalletAccountId = (walletId, address) => {
+  if (!walletId) throw new Error("Missing walletId");
+  if (!isValidAddress(address)) throw new Error("Invalid address");
+  return `${walletId}::${address}`;
+};
+var parseWalletAccountId = (accountId) => {
+  if (!accountId) throw new Error("Invalid walletAccountId");
+  const [walletId, address] = accountId.split("::");
+  if (!walletId) throw new Error("Missing walletId");
+  if (!address || !isValidAddress(address)) throw new Error("Invalid address");
+  return { walletId, address };
+};
+
+// src/api/errors.ts
+var KheopskitError = class extends Error {
+  constructor(code, message, options) {
+    super(`[kheopskit] ${message}`, { cause: _optionalChain([options, 'optionalAccess', _ => _.cause]) });
+    _chunkP7BPHHVVjs.__publicField.call(void 0, this, "code");
+    /** The wallet id this error relates to, when applicable. */
+    _chunkP7BPHHVVjs.__publicField.call(void 0, this, "walletId");
+    this.name = "KheopskitError";
+    this.code = code;
+    this.walletId = _optionalChain([options, 'optionalAccess', _2 => _2.walletId]);
+  }
+};
+
+
+
+
+
+
+
+
+
+exports.isEthereumAddress = isEthereumAddress; exports.isSolanaAddress = isSolanaAddress; exports.isSs58Address = isSs58Address; exports.isValidAddress = isValidAddress; exports.getWalletAccountId = getWalletAccountId; exports.parseWalletAccountId = parseWalletAccountId; exports.KheopskitError = KheopskitError;
+//# sourceMappingURL=chunk-EH73P476.js.map

package/dist/chunk-EH73P476.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/kheopskit/kheopskit/packages/core/dist/chunk-EH73P476.js","../src/utils/isEthereumAddress.ts","../src/utils/isSolanaAddress.ts","../src/utils/isSs58Address.ts","../src/utils/isValidAddress.ts","../src/utils/WalletAccountId.ts","../src/api/errors.ts"],"names":["base58"],"mappings":"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","file":"/home/runner/work/kheopskit/kheopskit/packages/core/dist/chunk-EH73P476.js","sourcesContent":[null,"import { keccak_256 } from \"@noble/hashes/sha3\";\n\nconst HEX_ADDRESS = /^0x[0-9a-fA-F]{40}$/;\nconst encoder = new TextEncoder();\n\n/**\n * Verifies the EIP-55 mixed-case checksum of an Ethereum address.\n * Dependency-free (keccak via @noble/hashes) so core stays decoupled from viem.\n */\nconst isChecksumValid = (address: string): boolean => {\n\tconst hex = address.slice(2);\n\tconst hash = keccak_256(encoder.encode(hex.toLowerCase()));\n\tfor (let i = 0; i < 40; i++) {\n\t\tconst char = hex.charAt(i);\n\t\tconst isLetter =\n\t\t\t(char >= \"a\" && char <= \"f\") || (char >= \"A\" && char <= \"F\");\n\t\tif (!isLetter) continue;\n\t\tconst byte = hash[i >> 1] ?? 0;\n\t\tconst nibble = i % 2 === 0 ? byte >> 4 : byte & 0x0f;\n\t\tconst isUpper = char <= \"F\";\n\t\tif (isUpper !== nibble >= 8) return false;\n\t}\n\treturn true;\n};\n\n/**\n * Returns true if `address` is a valid Ethereum address.\n *\n * Mirrors viem's `isAddress` (strict): the shape must be `0x` + 40 hex, and a\n * mixed-case address must pass the EIP-55 checksum. All-lowercase addresses are\n * accepted as non-checksummed.\n */\nexport const isEthereumAddress = (address: string): boolean => {\n\tif (!HEX_ADDRESS.test(address)) return false;\n\tif (address === address.toLowerCase()) return true;\n\treturn isChecksumValid(address);\n};\n","import { base58 } from \"@scure/base\";\n\n/**\n * Returns true if the value is a valid Solana address: a base58-encoded\n * 32-byte ed25519 public key.\n *\n * Solana addresses carry no checksum, so this is a pure base58 + length check.\n * Dependency-free (base58 via @scure/base) so core stays decoupled from\n * @solana/kit.\n */\nexport const isSolanaAddress = (address: string): boolean => {\n\tif (!address) return false;\n\ttry {\n\t\treturn base58.decode(address).length === 32;\n\t} catch {\n\t\treturn false;\n\t}\n};\n","import { blake2b } from \"@noble/hashes/blake2b\";\nimport { base58 } from \"@scure/base\";\n\n// The \"SS58PRE\" prefix used in the SS58 checksum preimage.\nconst SS58PRE = new Uint8Array([0x53, 0x53, 0x35, 0x38, 0x50, 0x52, 0x45]);\n\n/**\n * Returns true if `address` is a valid SS58-encoded 32-byte account id (the\n * only form Substrate wallets inject), verifying the blake2b-512 checksum.\n *\n * Dependency-free (base58 via @scure/base, blake2b via @noble/hashes) so core\n * stays decoupled from polkadot-api.\n */\nexport const isSs58Address = (address: string): boolean => {\n\tif (!address) return false;\n\n\tlet decoded: Uint8Array;\n\ttry {\n\t\tdecoded = base58.decode(address);\n\t} catch {\n\t\treturn false;\n\t}\n\n\t// First byte encodes the network prefix; the high bit is reserved/invalid.\n\tconst firstByte = decoded[0];\n\tif (firstByte === undefined || firstByte & 0b1000_0000) return false;\n\t// The 0b0100_0000 bit marks a 2-byte prefix.\n\tconst prefixLength = firstByte & 0b0100_0000 ? 2 : 1;\n\n\t// AccountId32 layout: prefix + 32-byte pubkey + 2-byte checksum.\n\tif (decoded.length !== prefixLength + 32 + 2) return false;\n\n\tconst body = decoded.subarray(0, decoded.length - 2);\n\tconst preimage = new Uint8Array(SS58PRE.length + body.length);\n\tpreimage.set(SS58PRE);\n\tpreimage.set(body, SS58PRE.length);\n\tconst hash = blake2b(preimage, { dkLen: 64 });\n\n\treturn (\n\t\tdecoded[decoded.length - 2] === hash[0] &&\n\t\tdecoded[decoded.length - 1] === hash[1]\n\t);\n};\n","import { isEthereumAddress } from \"./isEthereumAddress\";\nimport { isSolanaAddress } from \"./isSolanaAddress\";\nimport { isSs58Address } from \"./isSs58Address\";\n\nexport const isValidAddress = (address: string): boolean => {\n\tif (address.startsWith(\"0x\")) return isEthereumAddress(address);\n\t// SS58 (checksummed) and Solana (base58, no checksum) are disjoint: a\n\t// 32-byte Solana pubkey fails SS58 decoding, and an SS58 address decodes to\n\t// more than 32 bytes so it fails the Solana length check.\n\treturn isSs58Address(address) || isSolanaAddress(address);\n};\n","import { isValidAddress } from \"./isValidAddress\";\n\nexport type WalletAccountId = string;\n\nexport const getWalletAccountId = (\n\twalletId: string,\n\taddress: string,\n): WalletAccountId => {\n\tif (!walletId) throw new Error(\"Missing walletId\");\n\tif (!isValidAddress(address)) throw new Error(\"Invalid address\");\n\treturn `${walletId}::${address}`;\n};\n\nexport const parseWalletAccountId = (accountId: string) => {\n\tif (!accountId) throw new Error(\"Invalid walletAccountId\");\n\tconst [walletId, address] = accountId.split(\"::\");\n\tif (!walletId) throw new Error(\"Missing walletId\");\n\tif (!address || !isValidAddress(address)) throw new Error(\"Invalid address\");\n\treturn { walletId, address };\n};\n","import type { WalletId } from \"../utils/WalletId\";\n\n/**\n * Stable error codes thrown by kheopskit. Catch a {@link KheopskitError} and\n * branch on `error.code` instead of matching message strings.\n */\nexport type KheopskitErrorCode =\n\t/** `connect()` called on a wallet that is already connected. */\n\t| \"WALLET_ALREADY_CONNECTED\"\n\t/** `disconnect()` called on a wallet that is not connected. */\n\t| \"WALLET_NOT_CONNECTED\"\n\t/** The wallet does not advertise a capability kheopskit needs to proceed. */\n\t| \"FEATURE_NOT_SUPPORTED\"\n\t/** No active WalletConnect session for the requested operation. */\n\t| \"NO_SESSION\"\n\t/** No provider available for the requested namespace. */\n\t| \"NO_PROVIDER\"\n\t/** The requested chain cannot be used for this operation (e.g. a Solana cluster with no CAIP-2 id over WalletConnect). */\n\t| \"UNSUPPORTED_CHAIN\";\n\n/**\n * Error thrown by kheopskit wallet/account operations. Carries a stable\n * {@link KheopskitErrorCode} and, when relevant, the offending wallet id.\n *\n * @example\n * ```ts\n * try {\n *   await wallet.connect();\n * } catch (error) {\n *   if (error instanceof KheopskitError && error.code === \"WALLET_ALREADY_CONNECTED\") {\n *     // ignore\n *   } else throw error;\n * }\n * ```\n */\nexport class KheopskitError extends Error {\n\treadonly code: KheopskitErrorCode;\n\t/** The wallet id this error relates to, when applicable. */\n\treadonly walletId?: WalletId;\n\n\tconstructor(\n\t\tcode: KheopskitErrorCode,\n\t\tmessage: string,\n\t\toptions?: { walletId?: WalletId; cause?: unknown },\n\t) {\n\t\tsuper(`[kheopskit] ${message}`, { cause: options?.cause });\n\t\tthis.name = \"KheopskitError\";\n\t\tthis.code = code;\n\t\tthis.walletId = options?.walletId;\n\t}\n}\n"]}