@kheopskit/core 1.0.0 → 4.0.0

package/dist/chunk-KWFQDD7E.mjs

@@ -0,0 +1,578 @@
+import {
+  __publicField,
+  clearCachedObservablesByPrefix,
+  cookieStorage,
+  getWalletId,
+  isValidWalletId,
+  isWalletPlatform,
+  parseWalletId,
+  safeLocalStorage
+} from "./chunk-PNPPI5CH.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/isSs58Address.ts
+import { blake2b } from "@noble/hashes/blake2b";
+import { base58 } 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 = base58.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/isSolanaAddress.ts
+import { base58 as base582 } from "@scure/base";
+var isSolanaAddress = (address) => {
+  if (!address) return false;
+  try {
+    return base582.decode(address).length === 32;
+  } catch {
+    return false;
+  }
+};
+
+// 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}`;
+};
+
+// src/api/appKit.ts
+import {
+  BehaviorSubject,
+  combineLatest,
+  distinctUntilChanged,
+  from,
+  map,
+  Observable,
+  of,
+  shareReplay,
+  switchMap,
+  tap
+} from "rxjs";
+var loadAppKit = async () => {
+  try {
+    const { createAppKit } = await import("@reown/appkit/core");
+    return createAppKit;
+  } catch (cause) {
+    console.error(
+      "[kheopskit] WalletConnect is configured but @reown/appkit could not be loaded. Install it with `pnpm add @reown/appkit` (or remove config.walletConnect). WalletConnect wallets are disabled; injected wallets still work.",
+      cause
+    );
+    return null;
+  }
+};
+var WALLET_CONNECT_ICON = "data:image/svg+xml;base64,PHN2ZyBmaWxsPSJub25lIiBoZWlnaHQ9IjQwMCIgdmlld0JveD0iMCAwIDQwMCA0MDAiIHdpZHRoPSI0MDAiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgeG1sbnM6eGxpbms9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkveGxpbmsiPjxjbGlwUGF0aCBpZD0iYSI+PHBhdGggZD0ibTAgMGg0MDB2NDAwaC00MDB6Ii8+PC9jbGlwUGF0aD48ZyBjbGlwLXBhdGg9InVybCgjYSkiPjxjaXJjbGUgY3g9IjIwMCIgY3k9IjIwMCIgZmlsbD0iIzMzOTZmZiIgcj0iMTk5LjUiIHN0cm9rZT0iIzY2YjFmZiIvPjxwYXRoIGQ9Im0xMjIuNTE5IDE0OC45NjVjNDIuNzkxLTQxLjcyOSAxMTIuMTcxLTQxLjcyOSAxNTQuOTYyIDBsNS4xNSA1LjAyMmMyLjE0IDIuMDg2IDIuMTQgNS40NjkgMCA3LjU1NWwtMTcuNjE3IDE3LjE4Yy0xLjA3IDEuMDQzLTIuODA0IDEuMDQzLTMuODc0IDBsLTcuMDg3LTYuOTExYy0yOS44NTMtMjkuMTExLTc4LjI1My0yOS4xMTEtMTA4LjEwNiAwbC03LjU5IDcuNDAxYy0xLjA3IDEuMDQzLTIuODA0IDEuMDQzLTMuODc0IDBsLTE3LjYxNy0xNy4xOGMtMi4xNC0yLjA4Ni0yLjE0LTUuNDY5IDAtNy41NTV6bTE5MS4zOTcgMzUuNTI5IDE1LjY3OSAxNS4yOWMyLjE0IDIuMDg2IDIuMTQgNS40NjkgMCA3LjU1NWwtNzAuNyA2OC45NDRjLTIuMTM5IDIuMDg3LTUuNjA4IDIuMDg3LTcuNzQ4IDBsLTUwLjE3OC00OC45MzFjLS41MzUtLjUyMi0xLjQwMi0uNTIyLTEuOTM3IDBsLTUwLjE3OCA0OC45MzFjLTIuMTM5IDIuMDg3LTUuNjA4IDIuMDg3LTcuNzQ4IDBsLTcwLjcwMTUtNjguOTQ1Yy0yLjEzOTYtMi4wODYtMi4xMzk2LTUuNDY5IDAtNy41NTVsMTUuNjc5NS0xNS4yOWMyLjEzOTYtMi4wODYgNS42MDg1LTIuMDg2IDcuNzQ4MSAwbDUwLjE3ODkgNDguOTMyYy41MzUuNTIyIDEuNDAyLjUyMiAxLjkzNyAwbDUwLjE3Ny00OC45MzJjMi4xMzktMi4wODcgNS42MDgtMi4wODcgNy43NDggMGw1MC4xNzkgNDguOTMyYy41MzUuNTIyIDEuNDAyLjUyMiAxLjkzNyAwbDUwLjE3OS00OC45MzFjMi4xMzktMi4wODcgNS42MDgtMi4wODcgNy43NDggMHoiIGZpbGw9IiNmZmYiLz48L2c+PC9zdmc+";
+var APPKIT_SYMBOL = /* @__PURE__ */ Symbol.for("kheopskit.cachedAppKit");
+var getCachedAppKit = () => globalThis[APPKIT_SYMBOL];
+var setCachedAppKit = (value) => {
+  globalThis[APPKIT_SYMBOL] = value;
+};
+var resetAppKitCache = () => {
+  setCachedAppKit(void 0);
+};
+var clearAccountsCacheOnDisconnect = (platform) => (isConnected) => {
+  if (!isConnected)
+    clearCachedObservablesByPrefix(
+      `accounts:${getWalletId(platform, "walletconnect")}:`
+    );
+};
+var getAppKitWallets$ = (config) => {
+  if (!config.walletConnect) return of({});
+  if (typeof window === "undefined") return of({});
+  const walletConnect = config.walletConnect;
+  let cachedAppKit = getCachedAppKit();
+  if (!cachedAppKit) {
+    cachedAppKit = from(loadAppKit()).pipe(
+      switchMap((createAppKit) => {
+        if (!createAppKit) return of({});
+        return new Observable((subscriber) => {
+          const appKit = createAppKit({
+            projectId: walletConnect.projectId,
+            metadata: walletConnect.metadata,
+            // Loosely typed in WalletConnectConfig to keep @reown/appkit's
+            // types out of core; forwarded to AppKit verbatim.
+            networks: walletConnect.networks,
+            themeMode: walletConnect.themeMode,
+            themeVariables: walletConnect.themeVariables,
+            universalProviderConfigOverride: {
+              methods: {
+                polkadot: ["polkadot_signTransaction", "polkadot_signMessage"],
+                solana: [
+                  "solana_signTransaction",
+                  "solana_signMessage",
+                  "solana_signAndSendTransaction"
+                ]
+              }
+            },
+            allWallets: "HIDE",
+            debug: config.debug,
+            allowUnsupportedChain: true
+          });
+          const appKitInstance = appKit;
+          const status$ = new BehaviorSubject({
+            isPolkadotConnected: false,
+            isEthereumConnected: false,
+            isSolanaConnected: false
+          });
+          const unsubProviders = appKit.subscribeProviders((providers) => {
+            status$.next({
+              isPolkadotConnected: !!providers.polkadot,
+              isEthereumConnected: !!providers.eip155,
+              isSolanaConnected: !!providers.solana
+            });
+          });
+          const polkadotWallet$ = appKit.chainNamespaces.includes("polkadot") ? status$.pipe(
+            map((s) => s.isPolkadotConnected),
+            distinctUntilChanged(),
+            tap(clearAccountsCacheOnDisconnect("polkadot")),
+            map((isConnected) => {
+              const walletInfo = appKit.getWalletInfo();
+              const walletId = getWalletId("polkadot", "walletconnect");
+              return {
+                id: walletId,
+                platform: "polkadot",
+                type: "appKit",
+                appKit: appKitInstance,
+                name: walletInfo?.name ?? "WalletConnect",
+                icon: walletInfo?.icon ?? WALLET_CONNECT_ICON,
+                connect: async () => {
+                  if (!isConnected) await appKit.open();
+                },
+                disconnect: async () => {
+                  if (isConnected) await appKit.disconnect();
+                },
+                isConnected
+              };
+            })
+          ) : of(void 0);
+          const ethereumWallet$ = appKit.chainNamespaces.includes("eip155") ? status$.pipe(
+            map((s) => s.isEthereumConnected),
+            distinctUntilChanged(),
+            tap(clearAccountsCacheOnDisconnect("ethereum")),
+            map((isConnected) => {
+              const walletInfo = appKit.getWalletInfo();
+              const walletId = getWalletId("ethereum", "walletconnect");
+              return {
+                id: walletId,
+                platform: "ethereum",
+                type: "appKit",
+                appKit: appKitInstance,
+                name: walletInfo?.name ?? "WalletConnect",
+                icon: walletInfo?.icon ?? WALLET_CONNECT_ICON,
+                connect: () => appKit.open(),
+                disconnect: async () => {
+                  await appKit.disconnect();
+                },
+                isConnected
+              };
+            })
+          ) : of(void 0);
+          const solanaWallet$ = appKit.chainNamespaces.includes("solana") ? status$.pipe(
+            map((s) => s.isSolanaConnected),
+            distinctUntilChanged(),
+            tap(clearAccountsCacheOnDisconnect("solana")),
+            map((isConnected) => {
+              const walletInfo = appKit.getWalletInfo();
+              const walletId = getWalletId("solana", "walletconnect");
+              return {
+                id: walletId,
+                platform: "solana",
+                type: "appKit",
+                appKit: appKitInstance,
+                name: walletInfo?.name ?? "WalletConnect",
+                icon: walletInfo?.icon ?? WALLET_CONNECT_ICON,
+                connect: () => appKit.open(),
+                disconnect: async () => {
+                  await appKit.disconnect();
+                },
+                isConnected
+              };
+            })
+          ) : of(void 0);
+          const sub = combineLatest({
+            polkadot: polkadotWallet$,
+            ethereum: ethereumWallet$,
+            solana: solanaWallet$
+          }).subscribe(subscriber);
+          return () => {
+            sub.unsubscribe();
+            unsubProviders();
+          };
+        });
+      }),
+      shareReplay({ refCount: true, bufferSize: 1 })
+    );
+    setCachedAppKit(cachedAppKit);
+  }
+  return cachedAppKit;
+};
+
+// 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;
+  }
+};
+
+// src/api/config.ts
+var DEFAULT_STORAGE_KEY = "kheopskit";
+var DEFAULTS = {
+  autoReconnect: true,
+  debug: false,
+  storageKey: DEFAULT_STORAGE_KEY,
+  hydrationGracePeriod: 500
+};
+var resolveConfig = (config) => {
+  const platforms = config?.platforms ?? [];
+  const invalidPlatforms = platforms.filter(
+    (p) => typeof p !== "object" || p === null || typeof p.getWallets$ !== "function"
+  );
+  if (invalidPlatforms.length > 0) {
+    throw new Error(
+      `[kheopskit] config.platforms must contain plugin instances created by the per-platform factories (e.g. platforms: [polkadot(), ethereum(), solana()] imported from "@kheopskit/core/<platform>"). Invalid entries: ${JSON.stringify(invalidPlatforms)}. String platform names like "polkadot" were removed in v4 \u2014 see MIGRATING_TO_V4.md.`
+    );
+  }
+  if (platforms.length === 0) {
+    console.warn(
+      '[kheopskit] No platforms configured; wallets and accounts will be empty. Pass e.g. platforms: [polkadot()] from "@kheopskit/core/polkadot".'
+    );
+  }
+  return Object.assign({}, DEFAULTS, config, { platforms });
+};
+
+// src/api/store.ts
+import { uniq } from "lodash-es";
+
+// src/utils/createStore.ts
+import { BehaviorSubject as BehaviorSubject2 } from "rxjs";
+var createStore = (key, defaultValue, storage = safeLocalStorage) => {
+  const subject = new BehaviorSubject2(
+    getStoredData(key, defaultValue, storage)
+  );
+  let unsubscribeStorage;
+  if (typeof window !== "undefined" && storage.subscribe) {
+    unsubscribeStorage = storage.subscribe(key, (newValue) => {
+      subject.next(parseData(newValue, defaultValue));
+    });
+  }
+  const update = (val) => {
+    setStoredData(key, val, storage);
+    subject.next(val);
+  };
+  return {
+    observable: subject.asObservable(),
+    set: (val) => update(val),
+    mutate: (transform) => update(transform(subject.getValue())),
+    get: () => structuredClone(subject.getValue()),
+    /**
+     * Cleanup subscriptions. Call this when the store is no longer needed.
+     */
+    destroy: () => {
+      unsubscribeStorage?.();
+      subject.complete();
+    }
+  };
+};
+var parseData = (str, defaultValue) => {
+  try {
+    if (str) return JSON.parse(str);
+  } catch {
+  }
+  return defaultValue;
+};
+var getStoredData = (key, defaultValue, storage) => {
+  const str = storage.getItem(key);
+  return parseData(str, defaultValue);
+};
+var setStoredData = (key, val, storage) => {
+  const str = JSON.stringify(val);
+  storage.setItem(key, str);
+};
+
+// src/api/store.ts
+var DEFAULT_SETTINGS = {};
+var isValidCachedWallet = (value) => {
+  if (!value || typeof value !== "object") return false;
+  const w = value;
+  return isValidWalletId(w.id) && isWalletPlatform(w.platform) && typeof w.name === "string" && (w.type === "injected" || w.type === "appKit") && typeof w.isConnected === "boolean";
+};
+var isValidCachedAccount = (value) => {
+  if (!value || typeof value !== "object") return false;
+  const a = value;
+  return typeof a.id === "string" && !!a.id && isWalletPlatform(a.platform) && typeof a.address === "string" && !!a.address && isValidWalletId(a.walletId) && typeof a.walletName === "string";
+};
+var toCompactPolkadotAccountType = (type) => {
+  switch (type) {
+    case "sr25519":
+      return 0;
+    case "ed25519":
+      return 1;
+    case "ecdsa":
+      return 2;
+    case "ethereum":
+      return 3;
+    default:
+      return null;
+  }
+};
+var fromCompactPolkadotAccountType = (type) => {
+  switch (type) {
+    case 0:
+      return "sr25519";
+    case 1:
+      return "ed25519";
+    case 2:
+      return "ecdsa";
+    case 3:
+      return "ethereum";
+    default:
+      return void 0;
+  }
+};
+var createKheopskitStore = (options = {}) => {
+  const { ssrCookies, storageKey = DEFAULT_STORAGE_KEY } = options;
+  const storage = ssrCookies !== void 0 ? createCompactCookieStorage(ssrCookies) : safeLocalStorage;
+  const store2 = createStore(storageKey, DEFAULT_SETTINGS, storage);
+  const addEnabledWalletId = (walletId) => {
+    parseWalletId(walletId);
+    store2.mutate((prev) => ({
+      ...prev,
+      autoReconnect: uniq((prev.autoReconnect ?? []).concat(walletId))
+    }));
+  };
+  const removeEnabledWalletId = (walletId) => {
+    store2.mutate((prev) => ({
+      ...prev,
+      autoReconnect: uniq(
+        (prev.autoReconnect ?? []).filter((id) => id !== walletId)
+      )
+    }));
+  };
+  const getCachedState = () => {
+    const data = store2.get();
+    const cachedWallets = Array.isArray(data?.cachedWallets) ? data.cachedWallets : [];
+    const cachedAccounts = Array.isArray(data?.cachedAccounts) ? data.cachedAccounts : [];
+    return {
+      wallets: cachedWallets.filter(isValidCachedWallet),
+      accounts: cachedAccounts.filter(isValidCachedAccount)
+    };
+  };
+  const setCachedState = (wallets, accounts) => {
+    store2.mutate((prev) => ({
+      ...prev,
+      cachedWallets: wallets,
+      cachedAccounts: accounts
+    }));
+  };
+  return {
+    observable: store2.observable,
+    addEnabledWalletId,
+    removeEnabledWalletId,
+    getCachedState,
+    setCachedState
+  };
+};
+var DEFAULT_STORE_SYMBOL = /* @__PURE__ */ Symbol.for("kheopskit.defaultStore");
+var getDefaultStore = () => {
+  const g = globalThis;
+  if (!g[DEFAULT_STORE_SYMBOL]) {
+    g[DEFAULT_STORE_SYMBOL] = createKheopskitStore();
+  }
+  return g[DEFAULT_STORE_SYMBOL];
+};
+var store = {
+  get observable() {
+    return getDefaultStore().observable;
+  },
+  addEnabledWalletId: (walletId) => getDefaultStore().addEnabledWalletId(walletId),
+  removeEnabledWalletId: (walletId) => getDefaultStore().removeEnabledWalletId(walletId),
+  getCachedState: () => getDefaultStore().getCachedState(),
+  setCachedState: (wallets, accounts) => getDefaultStore().setCachedState(wallets, accounts)
+};
+var isCompactStore = (value) => {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  if ("cachedWallets" in value || "cachedAccounts" in value) return false;
+  return "v" in value || "w" in value || "a" in value || "r" in value;
+};
+var toCompactStore = (data) => {
+  const wallets = data.cachedWallets?.map(
+    (wallet) => [
+      wallet.id,
+      wallet.name,
+      wallet.isConnected ? 1 : 0,
+      wallet.type === "appKit" ? 1 : 0
+    ]
+  );
+  const accounts = data.cachedAccounts?.map(
+    (account) => [
+      account.walletId,
+      account.address,
+      account.name ?? null,
+      account.chainId ?? null,
+      toCompactPolkadotAccountType(account.polkadotAccountType)
+    ]
+  );
+  return {
+    v: 1,
+    r: data.autoReconnect,
+    w: wallets?.length ? wallets : void 0,
+    a: accounts?.length ? accounts : void 0
+  };
+};
+var fromCompactStore = (data) => {
+  const walletNameMap = /* @__PURE__ */ new Map();
+  const wallets = [];
+  for (const item of Array.isArray(data.w) ? data.w : []) {
+    if (!Array.isArray(item)) continue;
+    const [id, name, isConnected, type] = item;
+    if (!isValidWalletId(id)) continue;
+    const { platform } = parseWalletId(id);
+    walletNameMap.set(id, name);
+    wallets.push({
+      id,
+      platform,
+      type: type === 1 ? "appKit" : "injected",
+      name,
+      isConnected: isConnected === 1
+    });
+  }
+  const accounts = [];
+  for (const item of Array.isArray(data.a) ? data.a : []) {
+    if (!Array.isArray(item)) continue;
+    const [walletId, address, name, chainId, polkadotAccountType] = item;
+    if (!isValidWalletId(walletId) || typeof address !== "string" || !address)
+      continue;
+    const { platform } = parseWalletId(walletId);
+    accounts.push({
+      id: getWalletAccountId(walletId, address),
+      platform,
+      address,
+      name: name ?? void 0,
+      chainId: chainId ?? void 0,
+      polkadotAccountType: platform === "polkadot" ? fromCompactPolkadotAccountType(polkadotAccountType) : void 0,
+      walletId,
+      walletName: walletNameMap.get(walletId) ?? walletId
+    });
+  }
+  return {
+    autoReconnect: data.r,
+    cachedWallets: wallets,
+    cachedAccounts: accounts
+  };
+};
+var decodeStore = (raw, fallback) => {
+  try {
+    const parsed = JSON.parse(raw);
+    if (isCompactStore(parsed)) return fromCompactStore(parsed);
+    return parsed;
+  } catch {
+    return fallback;
+  }
+};
+var encodeStore = (data) => JSON.stringify(toCompactStore(data));
+var createCompactCookieStorage = (initialCookies) => {
+  const base = cookieStorage(initialCookies);
+  return {
+    getItem: (key) => {
+      const raw = base.getItem(key);
+      if (!raw) return null;
+      const expanded = decodeStore(raw, DEFAULT_SETTINGS);
+      if (typeof document !== "undefined") {
+        try {
+          const parsed = JSON.parse(raw);
+          if (!isCompactStore(parsed)) {
+            base.setItem(key, encodeStore(expanded));
+          }
+        } catch {
+        }
+      }
+      return JSON.stringify(expanded);
+    },
+    setItem: (key, value) => {
+      const expanded = decodeStore(value, DEFAULT_SETTINGS);
+      base.setItem(key, encodeStore(expanded));
+    },
+    removeItem: base.removeItem,
+    subscribe: (key, callback) => {
+      const unsubscribe = base.subscribe?.(key, (value) => {
+        if (!value) {
+          callback(null);
+          return;
+        }
+        const expanded = decodeStore(value, DEFAULT_SETTINGS);
+        callback(JSON.stringify(expanded));
+      });
+      return () => {
+        unsubscribe?.();
+      };
+    }
+  };
+};
+
+export {
+  isEthereumAddress,
+  isSs58Address,
+  isSolanaAddress,
+  isValidAddress,
+  getWalletAccountId,
+  resetAppKitCache,
+  getAppKitWallets$,
+  KheopskitError,
+  DEFAULT_STORAGE_KEY,
+  resolveConfig,
+  createKheopskitStore,
+  getDefaultStore,
+  store
+};
+//# sourceMappingURL=chunk-KWFQDD7E.mjs.map