@kheopskit/core 1.0.1 → 5.0.0

package/dist/chunk-YDLCHYHH.mjs

@@ -0,0 +1,179 @@
+import {
+  POLKADOT_EXTENSIONS
+} from "./chunk-BWUUHUDK.mjs";
+import {
+  isWalletConnectWallet,
+  parseWalletId,
+  safeLocalStorage
+} from "./chunk-7QSGAJ4A.mjs";
+
+// src/utils/hydrateState.ts
+var lookupWalletIcon = (platform, identifier) => {
+  if (platform === "polkadot") {
+    return POLKADOT_EXTENSIONS[identifier]?.icon ?? "";
+  }
+  return "";
+};
+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 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/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 memoryCache;
+};
+var saveCache = (cache) => {
+  try {
+    safeLocalStorage.setItem(ICON_CACHE_KEY, JSON.stringify(cache));
+    memoryCache = cache;
+  } catch {
+  }
+};
+var getCachedIcon = (walletId) => {
+  const cache = loadCache();
+  return cache[walletId] || void 0;
+};
+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);
+  }
+};
+
+// src/utils/sortAccounts.ts
+var PLATFORM_ORDER = {
+  polkadot: 0,
+  ethereum: 1,
+  solana: 2
+};
+var byWalletName = (a1, a2) => {
+  if (a1.walletName.toLowerCase() === "talisman") return -1;
+  if (a2.walletName.toLowerCase() === "talisman") return 1;
+  return a1.walletName.localeCompare(a2.walletName);
+};
+var sortAccounts = (a1, a2) => {
+  if (a1.platform !== a2.platform)
+    return PLATFORM_ORDER[a1.platform] - PLATFORM_ORDER[a2.platform];
+  if (a1.walletName !== a2.walletName) return byWalletName(a1, a2);
+  if (a1.platform === "polkadot" && a2.platform === "polkadot")
+    return a1.name !== a2.name ? (a1.name ?? "").localeCompare(a2.name ?? "") : a1.address.localeCompare(a2.address);
+  return a1.id.localeCompare(a2.id);
+};
+
+// src/utils/sortWallets.ts
+var PLATFORM_ORDER2 = {
+  polkadot: 0,
+  ethereum: 1,
+  solana: 2
+};
+var orderOf = (wallet) => isWalletConnectWallet(wallet) ? 3 : PLATFORM_ORDER2[wallet.platform];
+var sortWallets = (w1, w2) => {
+  const o1 = orderOf(w1);
+  const o2 = orderOf(w2);
+  if (o1 !== o2) return o1 - o2;
+  if (w1.name.toLowerCase() === "talisman") return -1;
+  if (w2.name.toLowerCase() === "talisman") return 1;
+  return w1.name.localeCompare(w2.name);
+};
+
+// src/api/platform.ts
+var acceptsCachedAccount = (cached, platforms) => {
+  const plugin = platforms.find((p) => p.platform === cached.platform);
+  return plugin?.acceptsCachedAccount?.(cached) ?? true;
+};
+
+export {
+  hydrateWallet,
+  hydrateAccount,
+  serializeWallet,
+  serializeAccount,
+  getCachedIcon,
+  setCachedIcons,
+  sortAccounts,
+  sortWallets,
+  acceptsCachedAccount
+};
+//# sourceMappingURL=chunk-YDLCHYHH.mjs.map

package/dist/chunk-YDLCHYHH.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/hydrateState.ts","../src/utils/iconCache.ts","../src/utils/sortAccounts.ts","../src/utils/sortWallets.ts","../src/api/platform.ts"],"sourcesContent":["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","import type { BaseWalletAccount, WalletPlatform } from \"../api/types\";\n\nconst PLATFORM_ORDER: Record<WalletPlatform, number> = {\n\tpolkadot: 0,\n\tethereum: 1,\n\tsolana: 2,\n};\n\n// Group accounts by wallet, surfacing Talisman first (case-insensitive).\nconst byWalletName = (a1: BaseWalletAccount, a2: BaseWalletAccount) => {\n\tif (a1.walletName.toLowerCase() === \"talisman\") return -1;\n\tif (a2.walletName.toLowerCase() === \"talisman\") return 1;\n\treturn a1.walletName.localeCompare(a2.walletName);\n};\n\nexport const sortAccounts = (a1: BaseWalletAccount, a2: BaseWalletAccount) => {\n\t// Sort by platform first: polkadot, then ethereum, then solana\n\tif (a1.platform !== a2.platform)\n\t\treturn PLATFORM_ORDER[a1.platform] - PLATFORM_ORDER[a2.platform];\n\n\t// Then group by wallet name\n\tif (a1.walletName !== a2.walletName) return byWalletName(a1, a2);\n\n\t// Polkadot accounts expose a friendly name; fall back to address\n\tif (a1.platform === \"polkadot\" && a2.platform === \"polkadot\")\n\t\treturn a1.name !== a2.name\n\t\t\t? (a1.name ?? \"\").localeCompare(a2.name ?? \"\")\n\t\t\t: a1.address.localeCompare(a2.address);\n\n\t// Ethereum and Solana accounts disambiguate by id\n\treturn a1.id.localeCompare(a2.id);\n};\n","import {\n\ttype BaseWallet,\n\tisWalletConnectWallet,\n\ttype WalletConnectWallet,\n\ttype WalletPlatform,\n} from \"../api/types\";\n\nconst PLATFORM_ORDER: Record<WalletPlatform, number> = {\n\tpolkadot: 0,\n\tethereum: 1,\n\tsolana: 2,\n};\n\n// The platform-less WalletConnect connector sorts after all platform wallets.\nconst orderOf = (wallet: BaseWallet | WalletConnectWallet) =>\n\tisWalletConnectWallet(wallet) ? 3 : PLATFORM_ORDER[wallet.platform];\n\nexport const sortWallets = (\n\tw1: BaseWallet | WalletConnectWallet,\n\tw2: BaseWallet | WalletConnectWallet,\n) => {\n\t// Sort by platform first: polkadot, then ethereum, then solana, then WC\n\tconst o1 = orderOf(w1);\n\tconst o2 = orderOf(w2);\n\tif (o1 !== o2) return o1 - o2;\n\n\t// Sort by name, but Talisman first\n\tif (w1.name.toLowerCase() === \"talisman\") return -1;\n\tif (w2.name.toLowerCase() === \"talisman\") return 1;\n\n\treturn w1.name.localeCompare(w2.name);\n};\n","import type { CachedAccount, KheopskitPlatform } from \"./types\";\n\n/**\n * Whether a cached account should survive SSR hydration, per its platform\n * plugin's `acceptsCachedAccount` hook. Plugins without the hook (and platforms\n * with no enabled plugin) accept all — matching the pre-plugin behavior where\n * only Polkadot accounts were filtered (by key type).\n */\nexport const acceptsCachedAccount = (\n\tcached: CachedAccount,\n\tplatforms: readonly KheopskitPlatform[],\n): boolean => {\n\tconst plugin = platforms.find((p) => p.platform === cached.platform);\n\treturn plugin?.acceptsCachedAccount?.(cached) ?? true;\n};\n"],"mappings":"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","names":["PLATFORM_ORDER"]}

package/dist/ethereum.d.mts

@@ -0,0 +1,61 @@
+import { W as WalletAccountId, a as WalletId, K as KheopskitPlatform } from './types-C7V7DGlg.mjs';
+export { b as WalletConnectWallet, i as isInjectedWallet, c as isWalletConnectWallet } from './types-C7V7DGlg.mjs';
+import { WalletClient, CustomTransport, Account, EIP1193Provider } from 'viem';
+import 'rxjs';
+
+/**
+ * Returns true if `address` is a valid Ethereum address.
+ *
+ * Mirrors viem's `isAddress` (strict): the shape must be `0x` + 40 hex, and a
+ * mixed-case address must pass the EIP-55 checksum. All-lowercase addresses are
+ * accepted as non-checksummed.
+ */
+declare const isEthereumAddress: (address: string) => boolean;
+
+type EthereumInjectedWallet = {
+    platform: "ethereum";
+    type: "injected";
+    id: WalletId;
+    /**
+     * Stable identifier of the underlying wallet source. For Ethereum this is the
+     * EIP-6963 `rdns`. Named consistently across platforms (Solana: Wallet
+     * Standard name; Polkadot: extension identifier).
+     */
+    sourceId: string;
+    provider: EIP1193Provider;
+    name: string;
+    icon: string;
+    isConnected: boolean;
+    connect: () => Promise<void>;
+    disconnect: () => Promise<void>;
+};
+type EthereumWallet = EthereumInjectedWallet;
+type EthereumAccount = {
+    id: WalletAccountId;
+    platform: "ethereum";
+    /**
+     * Signing surface for this account: a viem {@link WalletClient} bound to the
+     * wallet's provider (sign/send via viem actions). Per-platform signing
+     * surfaces differ — Solana exposes `signer`/`getSigner(chain)`, Polkadot
+     * exposes `polkadotSigner`. Absent while `state.isHydrating` is `true`.
+     */
+    client: WalletClient<CustomTransport, undefined, Account, undefined>;
+    address: `0x${string}`;
+    /** Current chain ID the wallet is connected to. `undefined` while loading or after provider disconnect. */
+    chainId: number | undefined;
+    walletName: string;
+    walletId: WalletId;
+};
+
+/**
+ * Ethereum platform plugin. Pass to `getKheopskit$({ platforms: [ethereum()] })`.
+ *
+ * @example
+ * ```ts
+ * import { ethereum } from "@kheopskit/core/ethereum";
+ * ethereum();
+ * ```
+ */
+declare const ethereum: () => KheopskitPlatform<"ethereum", EthereumWallet, EthereumAccount>;
+
+export { type EthereumAccount, type EthereumInjectedWallet, type EthereumWallet, ethereum, isEthereumAddress };

package/dist/ethereum.d.ts

@@ -0,0 +1,61 @@
+import { W as WalletAccountId, a as WalletId, K as KheopskitPlatform } from './types-C7V7DGlg.js';
+export { b as WalletConnectWallet, i as isInjectedWallet, c as isWalletConnectWallet } from './types-C7V7DGlg.js';
+import { WalletClient, CustomTransport, Account, EIP1193Provider } from 'viem';
+import 'rxjs';
+
+/**
+ * Returns true if `address` is a valid Ethereum address.
+ *
+ * Mirrors viem's `isAddress` (strict): the shape must be `0x` + 40 hex, and a
+ * mixed-case address must pass the EIP-55 checksum. All-lowercase addresses are
+ * accepted as non-checksummed.
+ */
+declare const isEthereumAddress: (address: string) => boolean;
+
+type EthereumInjectedWallet = {
+    platform: "ethereum";
+    type: "injected";
+    id: WalletId;
+    /**
+     * Stable identifier of the underlying wallet source. For Ethereum this is the
+     * EIP-6963 `rdns`. Named consistently across platforms (Solana: Wallet
+     * Standard name; Polkadot: extension identifier).
+     */
+    sourceId: string;
+    provider: EIP1193Provider;
+    name: string;
+    icon: string;
+    isConnected: boolean;
+    connect: () => Promise<void>;
+    disconnect: () => Promise<void>;
+};
+type EthereumWallet = EthereumInjectedWallet;
+type EthereumAccount = {
+    id: WalletAccountId;
+    platform: "ethereum";
+    /**
+     * Signing surface for this account: a viem {@link WalletClient} bound to the
+     * wallet's provider (sign/send via viem actions). Per-platform signing
+     * surfaces differ — Solana exposes `signer`/`getSigner(chain)`, Polkadot
+     * exposes `polkadotSigner`. Absent while `state.isHydrating` is `true`.
+     */
+    client: WalletClient<CustomTransport, undefined, Account, undefined>;
+    address: `0x${string}`;
+    /** Current chain ID the wallet is connected to. `undefined` while loading or after provider disconnect. */
+    chainId: number | undefined;
+    walletName: string;
+    walletId: WalletId;
+};
+
+/**
+ * Ethereum platform plugin. Pass to `getKheopskit$({ platforms: [ethereum()] })`.
+ *
+ * @example
+ * ```ts
+ * import { ethereum } from "@kheopskit/core/ethereum";
+ * ethereum();
+ * ```
+ */
+declare const ethereum: () => KheopskitPlatform<"ethereum", EthereumWallet, EthereumAccount>;
+
+export { type EthereumAccount, type EthereumInjectedWallet, type EthereumWallet, ethereum, isEthereumAddress };

package/dist/ethereum.js

@@ -0,0 +1,351 @@
+"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 _chunkXQWJM3KCjs = require('./chunk-XQWJM3KC.js');
+
+
+
+
+
+
+var _chunk4ENHC7G4js = require('./chunk-4ENHC7G4.js');
+
+// src/api/ethereum/accounts.ts
+
+
+
+
+
+
+
+
+
+var _rxjs = require('rxjs');
+
+
+
+
+var _viem = require('viem');
+var normalizeEvmChainId = (value) => {
+  let raw = value;
+  if (typeof raw === "string" && raw.startsWith("eip155:")) {
+    raw = raw.slice("eip155:".length);
+  }
+  if (typeof raw === "bigint") {
+    return raw >= 0n ? Number(raw) : void 0;
+  }
+  if (typeof raw === "number") {
+    return Number.isInteger(raw) && raw >= 0 ? raw : void 0;
+  }
+  if (typeof raw === "string") {
+    const normalized = raw.trim().toLowerCase();
+    if (!normalized) return void 0;
+    const parsed = normalized.startsWith("0x") ? Number.parseInt(normalized, 16) : Number.parseInt(normalized, 10);
+    return Number.isNaN(parsed) ? void 0 : parsed;
+  }
+  return void 0;
+};
+var toCaipNetworkId = (value) => {
+  const chainId = normalizeEvmChainId(value);
+  return chainId === void 0 ? void 0 : `eip155:${chainId}`;
+};
+var getInjectedWalletAccounts$ = (wallet) => {
+  if (!wallet.isConnected) return _rxjs.of.call(void 0, []);
+  return _chunk4ENHC7G4js.getCachedObservable$.call(void 0, 
+    `accounts:${wallet.id}`,
+    () => new (0, _rxjs.Observable)((subscriber) => {
+      const addresses$ = new (0, _rxjs.ReplaySubject)(1);
+      const chainId$ = new (0, _rxjs.ReplaySubject)(1);
+      const getAccount = (address, chainId) => {
+        const client = _viem.createWalletClient.call(void 0, {
+          account: address,
+          transport: _viem.custom.call(void 0, wallet.provider)
+        });
+        return {
+          id: _chunkXQWJM3KCjs.getWalletAccountId.call(void 0, wallet.id, address),
+          platform: "ethereum",
+          client,
+          address: _viem.getAddress.call(void 0, address),
+          chainId,
+          walletName: wallet.name,
+          walletId: wallet.id
+        };
+      };
+      const handleAccountsChanged = (addrs) => {
+        addresses$.next(addrs);
+      };
+      const handleChainChanged = (chainIdHex) => {
+        chainId$.next(normalizeEvmChainId(chainIdHex));
+      };
+      const handleDisconnect = () => {
+        chainId$.next(void 0);
+      };
+      wallet.provider.on("accountsChanged", handleAccountsChanged);
+      wallet.provider.on("chainChanged", handleChainChanged);
+      wallet.provider.on("disconnect", handleDisconnect);
+      wallet.provider.request({ method: "eth_accounts" }).then((addrs) => addresses$.next(addrs)).catch((err) => {
+        console.error("Failed to get accounts", err);
+        addresses$.next([]);
+      });
+      wallet.provider.request({ method: "eth_chainId" }).then(handleChainChanged).catch(() => chainId$.next(void 0));
+      const sub = _rxjs.combineLatest.call(void 0, [addresses$, chainId$]).pipe(
+        _rxjs.map.call(void 0, 
+          ([addresses, chainId]) => addresses.map((addr) => getAccount(addr, chainId))
+        )
+      ).subscribe(subscriber);
+      return () => {
+        wallet.provider.removeListener(
+          "accountsChanged",
+          handleAccountsChanged
+        );
+        wallet.provider.removeListener("chainChanged", handleChainChanged);
+        wallet.provider.removeListener("disconnect", handleDisconnect);
+        sub.unsubscribe();
+      };
+    }).pipe(_rxjs.shareReplay.call(void 0, { refCount: true, bufferSize: 1 }))
+  );
+};
+var wrapWalletConnectProvider = (provider, sessionTopic, caipNetworkId) => {
+  return new Proxy(provider, {
+    get(target, prop, receiver) {
+      if (prop !== "request") return Reflect.get(target, prop, receiver);
+      return (args) => {
+        if (!args || typeof args !== "object" || !args.method)
+          return target.request(args);
+        const next = { ...args };
+        if (next.topic === void 0) next.topic = sessionTopic;
+        if (next.chainId === void 0 && caipNetworkId !== void 0)
+          next.chainId = caipNetworkId;
+        return target.request(next);
+      };
+    }
+  });
+};
+var sameAddresses = (a, b) => a.length === b.length && a.every((addr, i) => addr === b[i]);
+var getWalletConnectAccounts$ = (wallet) => {
+  const provider = wallet.appKit.getProvider("eip155");
+  if (!wallet.platforms.includes("ethereum") || !_optionalChain([provider, 'optionalAccess', _ => _.session]))
+    return _rxjs.of.call(void 0, []);
+  return _chunk4ENHC7G4js.getCachedObservable$.call(void 0, 
+    `accounts:${wallet.id}:ethereum:`,
+    () => new (0, _rxjs.Observable)((subscriber) => {
+      const caipNetworkId$ = new (0, _rxjs.ReplaySubject)(1);
+      const addresses$ = new (0, _rxjs.ReplaySubject)(1);
+      const readAddresses = () => {
+        const session = provider.session;
+        if (!session) return [];
+        const addresses = /* @__PURE__ */ new Set();
+        for (const namespace of Object.values(session.namespaces)) {
+          for (const account of _nullishCoalesce(namespace.accounts, () => ( []))) {
+            if (!account.startsWith("eip155:")) continue;
+            const raw = account.split(":")[2];
+            if (!raw) continue;
+            try {
+              addresses.add(_viem.getAddress.call(void 0, raw));
+            } catch (e) {
+            }
+          }
+        }
+        return [...addresses];
+      };
+      const readCaipNetworkId = () => {
+        const session = provider.session;
+        if (!session) return void 0;
+        for (const namespace of Object.values(session.namespaces)) {
+          for (const account of _nullishCoalesce(namespace.accounts, () => ( []))) {
+            if (!account.startsWith("eip155:")) continue;
+            const ref = account.split(":")[1];
+            if (ref) return `eip155:${ref}`;
+          }
+        }
+        return void 0;
+      };
+      const handleChainChanged = (chainId) => {
+        const caipNetworkId = toCaipNetworkId(chainId);
+        if (caipNetworkId) {
+          caipNetworkId$.next(caipNetworkId);
+        }
+      };
+      const handleAccountsChanged = () => addresses$.next(readAddresses());
+      provider.on("chainChanged", handleChainChanged);
+      provider.on("accountsChanged", handleAccountsChanged);
+      provider.on("session_update", handleAccountsChanged);
+      caipNetworkId$.next(readCaipNetworkId());
+      provider.request({ method: "eth_chainId" }).then(handleChainChanged).catch(() => {
+      });
+      addresses$.next(readAddresses());
+      const sub = _rxjs.combineLatest.call(void 0, [
+        caipNetworkId$.pipe(_rxjs.distinctUntilChanged.call(void 0, )),
+        addresses$.pipe(_rxjs.distinctUntilChanged.call(void 0, sameAddresses))
+      ]).pipe(
+        _rxjs.map.call(void 0, ([caipNetworkId, addresses]) => {
+          const chainId = normalizeEvmChainId(caipNetworkId);
+          const transport = _viem.custom.call(void 0, 
+            wrapWalletConnectProvider(
+              provider,
+              // biome-ignore lint/style/noNonNullAssertion: legacy
+              provider.session.topic,
+              caipNetworkId
+            )
+          );
+          return addresses.map((addr) => {
+            const client = _viem.createWalletClient.call(void 0, {
+              account: addr,
+              transport
+            });
+            return {
+              id: _chunkXQWJM3KCjs.getWalletAccountId.call(void 0, wallet.id, addr),
+              platform: "ethereum",
+              walletName: wallet.name,
+              walletId: wallet.id,
+              address: addr,
+              client,
+              chainId
+            };
+          });
+        })
+      ).subscribe(subscriber);
+      return () => {
+        provider.off("chainChanged", handleChainChanged);
+        provider.off("accountsChanged", handleAccountsChanged);
+        provider.off("session_update", handleAccountsChanged);
+        sub.unsubscribe();
+      };
+    }).pipe(_rxjs.shareReplay.call(void 0, { refCount: true, bufferSize: 1 }))
+  );
+};
+var getEthereumAccounts$ = (ethereumWallets) => new (0, _rxjs.Observable)((subscriber) => {
+  const sub = ethereumWallets.pipe(
+    _rxjs.map.call(void 0, (wallets) => wallets.filter((w) => w.isConnected)),
+    _rxjs.switchMap.call(void 0, (wallets) => {
+      return wallets.length ? _rxjs.combineLatest.call(void 0, [
+        ...wallets.filter((w) => w.type === "injected").map(getInjectedWalletAccounts$),
+        ...wallets.filter(_chunk4ENHC7G4js.isWalletConnectWallet).map(getWalletConnectAccounts$)
+      ]) : _rxjs.of.call(void 0, []);
+    }),
+    _rxjs.map.call(void 0, (accounts) => accounts.flat()),
+    _rxjs.distinctUntilChanged.call(void 0, isSameAccountsList)
+  ).subscribe(subscriber);
+  return () => {
+    sub.unsubscribe();
+  };
+}).pipe(
+  // logObservable("ethereumAccounts$", true),
+  _rxjs.shareReplay.call(void 0, { refCount: true, bufferSize: 1 })
+);
+var isSameAccountsList = (a, b) => {
+  if (a.length !== b.length) return false;
+  return a.every(
+    (account, i) => account.id === _optionalChain([b, 'access', _2 => _2[i], 'optionalAccess', _3 => _3.id]) && account.chainId === _optionalChain([b, 'access', _4 => _4[i], 'optionalAccess', _5 => _5.chainId])
+  );
+};
+
+// src/api/ethereum/wallets.ts
+
+
+var _mipd = require('mipd');
+
+
+
+
+
+
+
+
+var providersDetails$ = new (0, _rxjs.Observable)(
+  (subscriber) => {
+    if (typeof window === "undefined") {
+      subscriber.next([]);
+      return () => {
+      };
+    }
+    const mipdStore = _mipd.createStore.call(void 0, );
+    const unsubscribe = mipdStore.subscribe((providerDetails2) => {
+      subscriber.next(providerDetails2);
+    });
+    const providerDetails = mipdStore.getProviders();
+    subscriber.next(providerDetails);
+    return () => {
+      unsubscribe();
+      mipdStore.destroy();
+    };
+  }
+).pipe(_rxjs.shareReplay.call(void 0, { refCount: true, bufferSize: 1 }));
+var createEthereumInjectedWallets$ = (store2) => new (0, _rxjs.Observable)((subscriber) => {
+  const enabledWalletIds$ = new (0, _rxjs.BehaviorSubject)(/* @__PURE__ */ new Set());
+  const connectWallet = async (walletId, provider) => {
+    if (enabledWalletIds$.value.has(walletId))
+      throw new (0, _chunkXQWJM3KCjs.KheopskitError)(
+        "WALLET_ALREADY_CONNECTED",
+        `wallet ${walletId} is already connected`,
+        { walletId }
+      );
+    await provider.request({
+      method: "eth_requestAccounts"
+    });
+    const newSet = new Set(enabledWalletIds$.value);
+    newSet.add(walletId);
+    enabledWalletIds$.next(newSet);
+    store2.addEnabledWalletId(walletId);
+  };
+  const disconnectWallet = async (walletId) => {
+    if (!enabledWalletIds$.value.has(walletId))
+      throw new (0, _chunkXQWJM3KCjs.KheopskitError)(
+        "WALLET_NOT_CONNECTED",
+        `wallet ${walletId} is not connected`,
+        { walletId }
+      );
+    const newSet = new Set(enabledWalletIds$.value);
+    newSet.delete(walletId);
+    enabledWalletIds$.next(newSet);
+    store2.removeEnabledWalletId(walletId);
+    _chunk4ENHC7G4js.clearCachedObservable.call(void 0, `accounts:${walletId}`);
+  };
+  const sub = _rxjs.combineLatest.call(void 0, [providersDetails$, enabledWalletIds$]).pipe(
+    _rxjs.map.call(void 0, ([providerDetails, enabledWalletIds]) => {
+      return providerDetails.map((pd) => {
+        const walletId = _chunk4ENHC7G4js.getWalletId.call(void 0, "ethereum", pd.info.rdns);
+        const provider = pd.provider;
+        return {
+          platform: "ethereum",
+          type: "injected",
+          id: walletId,
+          name: pd.info.name,
+          icon: pd.info.icon,
+          provider,
+          isConnected: enabledWalletIds.has(walletId),
+          sourceId: pd.info.rdns,
+          connect: () => connectWallet(walletId, provider),
+          disconnect: () => disconnectWallet(walletId)
+        };
+      });
+    }),
+    _rxjs.distinctUntilChanged.call(void 0, walletsEqual)
+  ).subscribe(subscriber);
+  return () => {
+    sub.unsubscribe();
+  };
+}).pipe(_rxjs.shareReplay.call(void 0, { refCount: true, bufferSize: 1 }));
+var getEthereumWallets$ = (store2 = _chunkXQWJM3KCjs.store) => createEthereumInjectedWallets$(store2);
+var walletsEqual = (a, b) => {
+  if (a.length !== b.length) return false;
+  return a.every(
+    (w, i) => w.id === _optionalChain([b, 'access', _6 => _6[i], 'optionalAccess', _7 => _7.id]) && w.isConnected === _optionalChain([b, 'access', _8 => _8[i], 'optionalAccess', _9 => _9.isConnected]) && w.name === _optionalChain([b, 'access', _10 => _10[i], 'optionalAccess', _11 => _11.name])
+  );
+};
+
+// src/api/ethereum/plugin.ts
+var ethereum = () => ({
+  platform: "ethereum",
+  getWallets$: (ctx) => getEthereumWallets$(ctx.store),
+  getAccounts$: (wallets$) => getEthereumAccounts$(wallets$)
+});
+
+
+
+
+
+exports.ethereum = ethereum; exports.isEthereumAddress = _chunkXQWJM3KCjs.isEthereumAddress; exports.isInjectedWallet = _chunk4ENHC7G4js.isInjectedWallet; exports.isWalletConnectWallet = _chunk4ENHC7G4js.isWalletConnectWallet;
+//# sourceMappingURL=ethereum.js.map