@kheopskit/core 1.0.0 → 4.0.0

package/dist/types-BNzRUNw-.d.mts

@@ -0,0 +1,319 @@
+import * as rxjs from 'rxjs';
+import { Observable } from 'rxjs';
+
+type WalletAccountId = string;
+declare const getWalletAccountId: (walletId: string, address: string) => WalletAccountId;
+
+type WalletId = string;
+declare const getWalletId: (platform: WalletPlatform, identifier: string) => WalletId;
+declare const parseWalletId: (walletId: string) => {
+    platform: WalletPlatform;
+    identifier: string;
+};
+
+type KheopskitStoreData = {
+    autoReconnect?: WalletId[];
+    /** Cached wallet state for SSR hydration to prevent UI flash */
+    cachedWallets?: CachedWallet[];
+    /** Cached account state for SSR hydration to prevent UI flash */
+    cachedAccounts?: CachedAccount[];
+};
+type CreateKheopskitStoreOptions = {
+    /**
+     * Cookie string for SSR hydration.
+     * When provided, uses cookieStorage instead of localStorage.
+     */
+    ssrCookies?: string;
+    /**
+     * Custom storage key to namespace the stored data.
+     * @default "kheopskit"
+     */
+    storageKey?: string;
+};
+/**
+ * Creates a kheopskit store with the appropriate storage backend.
+ * Uses cookieStorage when ssrCookies is provided (for SSR hydration),
+ * otherwise falls back to safeLocalStorage.
+ *
+ * @param options - Configuration options for the store
+ */
+declare const createKheopskitStore: (options?: CreateKheopskitStoreOptions) => {
+    observable: rxjs.Observable<KheopskitStoreData>;
+    addEnabledWalletId: (walletId: WalletId) => void;
+    removeEnabledWalletId: (walletId: WalletId) => void;
+    getCachedState: () => {
+        wallets: CachedWallet[];
+        accounts: CachedAccount[];
+    };
+    setCachedState: (wallets: CachedWallet[], accounts: CachedAccount[]) => void;
+};
+type KheopskitStore = ReturnType<typeof createKheopskitStore>;
+/**
+ * Gets the default store, creating it on first access.
+ * Uses localStorage on client, noop on server.
+ * Lazily initialized to avoid SSR issues with module-level code.
+ */
+declare const getDefaultStore: () => KheopskitStore;
+
+type WalletPlatform = "polkadot" | "ethereum" | "solana";
+/**
+ * Minimal structural view of a WalletConnect `UniversalProvider` — the subset
+ * kheopskit reads. Declared locally so core never depends on
+ * `@walletconnect/universal-provider`. The concrete instance comes from
+ * `@reown/appkit` at runtime.
+ */
+type WalletConnectProvider = {
+    session?: {
+        topic: string;
+        namespaces: Record<string, {
+            accounts?: string[];
+        }>;
+    };
+    client: {
+        request<T = unknown>(args: {
+            topic: string;
+            chainId: string;
+            request: {
+                method: string;
+                params: unknown;
+            };
+        }): Promise<T>;
+    };
+    request(args: {
+        method: string;
+        params?: unknown;
+    }): Promise<unknown>;
+    on(event: string, listener: (...args: unknown[]) => void): void;
+    off(event: string, listener: (...args: unknown[]) => void): void;
+};
+/**
+ * Minimal structural view of the Reown AppKit instance — the subset kheopskit's
+ * account factories use. Exposed as the `appKit` escape hatch on AppKit wallets;
+ * cast it to `@reown/appkit`'s `AppKit` type for the full API. Declared locally
+ * so core never depends on `@reown/appkit`'s types (it's an optional peer).
+ */
+type AppKitInstance = {
+    getProvider<T = WalletConnectProvider>(namespace: string): T | undefined;
+    getAccount(namespace: string): {
+        allAccounts: {
+            address: string;
+        }[];
+    } | undefined;
+    getCaipNetworks(namespace: string): {
+        caipNetworkId?: string;
+    }[];
+};
+type WalletType = "injected" | "appKit";
+type PolkadotAccountType = "sr25519" | "ed25519" | "ecdsa" | "ethereum";
+/**
+ * SDK-free fields common to every wallet, regardless of platform. Platform
+ * packages (`@kheopskit/core/<platform>`) extend this with SDK-typed fields
+ * (the injected provider/extension/standard-wallet handle).
+ */
+type BaseWallet = {
+    id: WalletId;
+    platform: WalletPlatform;
+    type: WalletType;
+    name: string;
+    icon: string;
+    isConnected: boolean;
+    connect: () => Promise<void>;
+    /**
+     * Disconnect the wallet. Resolves once the underlying provider/extension
+     * disconnect completes; rejects if it fails so callers can surface or retry.
+     */
+    disconnect: () => Promise<void>;
+};
+/**
+ * SDK-free fields common to every account, regardless of platform. Platform
+ * packages extend this with their SDK-typed signer/client.
+ */
+type BaseWalletAccount = {
+    id: WalletAccountId;
+    platform: WalletPlatform;
+    /** Base58 (Solana), SS58 (Polkadot) or 0x-hex (Ethereum) address. */
+    address: string;
+    /** Friendly account name, when the wallet exposes one (e.g. Polkadot). */
+    name?: string;
+    walletName: string;
+    walletId: WalletId;
+};
+/**
+ * AppKit (WalletConnect) wallet handle for a given platform. References only
+ * `@reown/appkit` (a hard dependency) — no optional platform SDK — so it lives
+ * in core and is shared by every platform's wallet union.
+ *
+ * The per-platform aliases below (`PolkadotAppKitWallet`, … ) are kept so each
+ * platform entry point can re-export a concrete name.
+ */
+type AppKitWallet<P extends WalletPlatform = WalletPlatform> = {
+    id: WalletId;
+    platform: P;
+    type: "appKit";
+    /**
+     * Raw Reown AppKit instance, exposed as an escape hatch for advanced use
+     * (custom modal control, reading providers directly). Most consumers should
+     * use the wallet's `connect`/`disconnect` and the derived accounts instead.
+     */
+    appKit: AppKitInstance;
+    name: string;
+    icon: string;
+    isConnected: boolean;
+    connect: () => Promise<void>;
+    disconnect: () => Promise<void>;
+};
+type PolkadotAppKitWallet = AppKitWallet<"polkadot">;
+type EthereumAppKitWallet = AppKitWallet<"ethereum">;
+type SolanaAppKitWallet = AppKitWallet<"solana">;
+/**
+ * Dapp metadata shown in the WalletConnect modal. Mirrors WalletConnect's
+ * `Metadata`, declared locally so core doesn't depend on
+ * `@walletconnect/universal-provider`.
+ */
+type WalletConnectMetadata = {
+    name: string;
+    description: string;
+    url: string;
+    icons: string[];
+};
+type WalletConnectConfig = {
+    projectId: string;
+    metadata: WalletConnectMetadata;
+    /** Defaults to wss://relay.walletconnect.com */
+    relayUrl?: string;
+    /**
+     * Networks AppKit should enable. Pass `AppKitNetwork[]` from
+     * `@reown/appkit/networks` (see
+     * https://docs.reown.com/advanced/multichain/polkadot/dapp-integration-guide#walletconnect-code%2Fcomponent-setup).
+     * Loosely typed (`unknown`) so core doesn't depend on `@reown/appkit`'s
+     * types — the value is forwarded to AppKit as-is.
+     */
+    networks: [unknown, ...unknown[]];
+    themeMode?: "light" | "dark";
+    themeVariables?: Record<string, string | number>;
+};
+/**
+ * Context passed to a platform plugin's `getWallets$`. Carries the shared store
+ * and the resolved core config (for WalletConnect / debug).
+ */
+type PlatformContext = {
+    store: KheopskitStore;
+    config: KheopskitConfig;
+};
+/**
+ * A platform plugin. Created by the per-platform factories exported from
+ * `@kheopskit/core/polkadot`, `/ethereum`, `/solana`. Core iterates plugins
+ * generically and never imports a platform SDK itself.
+ *
+ * @typeParam TPlatform - the platform discriminant
+ * @typeParam TWallet - the platform's wallet type (extends {@link BaseWallet})
+ * @typeParam TAccount - the platform's account type (extends {@link BaseWalletAccount})
+ */
+type KheopskitPlatform<TPlatform extends WalletPlatform = WalletPlatform, TWallet extends BaseWallet = BaseWallet, TAccount extends BaseWalletAccount = BaseWalletAccount> = {
+    readonly platform: TPlatform;
+    getWallets$(ctx: PlatformContext): Observable<TWallet[]>;
+    getAccounts$(wallets$: Observable<TWallet[]>): Observable<TAccount[]>;
+    /**
+     * Optional hydration filter. Cached accounts for which this returns false are
+     * dropped during SSR hydration (Polkadot uses it to honour `accountTypes`).
+     */
+    acceptsCachedAccount?(cached: CachedAccount): boolean;
+};
+type ElementOf<T> = T extends readonly (infer E)[] ? E : never;
+/** The account type produced by a plugin (inferred from its `getAccounts$`). */
+type AccountOf<T> = T extends {
+    getAccounts$: (wallets$: never) => Observable<infer R>;
+} ? ElementOf<R> : never;
+/** The wallet type produced by a plugin (inferred from its `getWallets$`). */
+type WalletOf<T> = T extends {
+    getWallets$: (ctx: never) => Observable<infer R>;
+} ? ElementOf<R> : never;
+type KheopskitConfig<P extends readonly KheopskitPlatform[] = readonly KheopskitPlatform[]> = {
+    autoReconnect: boolean;
+    /**
+     * Platform plugins to enable, e.g. `[polkadot(), solana({ chain })]`.
+     * Import factories from `@kheopskit/core/<platform>`.
+     */
+    platforms: P;
+    walletConnect?: WalletConnectConfig;
+    debug: boolean;
+    /**
+     * Custom storage key for persisting wallet connection state.
+     * Useful when running multiple kheopskit instances on the same domain
+     * to prevent state conflicts between different dapps.
+     *
+     * @default "kheopskit"
+     */
+    storageKey: string;
+    /**
+     * Grace period in milliseconds to wait for wallets to inject before
+     * syncing to actual state. During this period, cached wallet/account
+     * state from storage is preserved to prevent UI flashing.
+     *
+     * Set to 0 to disable hydration buffering.
+     *
+     * @default 500
+     */
+    hydrationGracePeriod: number;
+};
+/**
+ * The current kheopskit state.
+ *
+ * @remarks
+ * While {@link KheopskitState.isHydrating} is `true`, `wallets` and `accounts`
+ * may contain cached placeholders restored from storage. The **SDK handles** the
+ * platform types advertise (e.g. `account.signer` / `getSigner` on Solana,
+ * `account.client` on Ethereum, `wallet.provider` / `extension`) are **absent at
+ * runtime even though the types claim them**, and placeholder wallets throw if
+ * `connect`/`disconnect` is called. Guard all access to those behind
+ * `!isHydrating`.
+ *
+ * The plain, serializable platform data that is persisted in the cache IS
+ * restored on the placeholders (Ethereum `chainId`, Polkadot key `type`), so it
+ * renders immediately on reload without flashing. Solana `chains` is not cached,
+ * so it remains absent until the live account loads.
+ */
+type KheopskitState<P extends readonly KheopskitPlatform[] = readonly KheopskitPlatform[]> = {
+    wallets: WalletOf<P[number]>[];
+    accounts: AccountOf<P[number]>[];
+    config: KheopskitConfig<P>;
+    /**
+     * Whether the state is still being hydrated from cache.
+     *
+     * During hydration, cached wallets/accounts may be displayed before the
+     * actual wallet extensions have injected. See the type-level remarks: while
+     * this is `true`, SDK-typed fields (signer/client/provider/extension) are not
+     * present at runtime — guard all access behind `!isHydrating`.
+     */
+    isHydrating: boolean;
+};
+/**
+ * Serializable wallet data for SSR hydration cache.
+ * Contains only the data needed to render wallet UI without flash.
+ * Note: icon is NOT stored to save cookie space - it's looked up at hydration time.
+ */
+type CachedWallet = {
+    id: WalletId;
+    platform: WalletPlatform;
+    type: WalletType;
+    name: string;
+    isConnected: boolean;
+};
+/**
+ * Serializable account data for SSR hydration cache.
+ * Contains only the data needed to render account UI without flash.
+ */
+type CachedAccount = {
+    id: string;
+    platform: WalletPlatform;
+    address: string;
+    name?: string;
+    /** Cached chain ID for Ethereum accounts. */
+    chainId?: number;
+    /** Cached key type for Polkadot accounts. */
+    polkadotAccountType?: PolkadotAccountType;
+    walletId: WalletId;
+    walletName: string;
+};
+
+export { type AccountOf as A, type BaseWallet as B, type CachedAccount as C, type EthereumAppKitWallet as E, type KheopskitPlatform as K, type PlatformContext as P, type SolanaAppKitWallet as S, type WalletAccountId as W, type WalletId as a, type KheopskitConfig as b, createKheopskitStore as c, type KheopskitState as d, type AppKitInstance as e, type AppKitWallet as f, type BaseWalletAccount as g, type CachedWallet as h, type PolkadotAccountType as i, type PolkadotAppKitWallet as j, type WalletConnectConfig as k, type WalletConnectMetadata as l, type WalletConnectProvider as m, type WalletOf as n, type WalletPlatform as o, type WalletType as p, getDefaultStore as q, getWalletAccountId as r, getWalletId as s, parseWalletId as t };

package/dist/types-BNzRUNw-.d.ts

@@ -0,0 +1,319 @@
+import * as rxjs from 'rxjs';
+import { Observable } from 'rxjs';
+
+type WalletAccountId = string;
+declare const getWalletAccountId: (walletId: string, address: string) => WalletAccountId;
+
+type WalletId = string;
+declare const getWalletId: (platform: WalletPlatform, identifier: string) => WalletId;
+declare const parseWalletId: (walletId: string) => {
+    platform: WalletPlatform;
+    identifier: string;
+};
+
+type KheopskitStoreData = {
+    autoReconnect?: WalletId[];
+    /** Cached wallet state for SSR hydration to prevent UI flash */
+    cachedWallets?: CachedWallet[];
+    /** Cached account state for SSR hydration to prevent UI flash */
+    cachedAccounts?: CachedAccount[];
+};
+type CreateKheopskitStoreOptions = {
+    /**
+     * Cookie string for SSR hydration.
+     * When provided, uses cookieStorage instead of localStorage.
+     */
+    ssrCookies?: string;
+    /**
+     * Custom storage key to namespace the stored data.
+     * @default "kheopskit"
+     */
+    storageKey?: string;
+};
+/**
+ * Creates a kheopskit store with the appropriate storage backend.
+ * Uses cookieStorage when ssrCookies is provided (for SSR hydration),
+ * otherwise falls back to safeLocalStorage.
+ *
+ * @param options - Configuration options for the store
+ */
+declare const createKheopskitStore: (options?: CreateKheopskitStoreOptions) => {
+    observable: rxjs.Observable<KheopskitStoreData>;
+    addEnabledWalletId: (walletId: WalletId) => void;
+    removeEnabledWalletId: (walletId: WalletId) => void;
+    getCachedState: () => {
+        wallets: CachedWallet[];
+        accounts: CachedAccount[];
+    };
+    setCachedState: (wallets: CachedWallet[], accounts: CachedAccount[]) => void;
+};
+type KheopskitStore = ReturnType<typeof createKheopskitStore>;
+/**
+ * Gets the default store, creating it on first access.
+ * Uses localStorage on client, noop on server.
+ * Lazily initialized to avoid SSR issues with module-level code.
+ */
+declare const getDefaultStore: () => KheopskitStore;
+
+type WalletPlatform = "polkadot" | "ethereum" | "solana";
+/**
+ * Minimal structural view of a WalletConnect `UniversalProvider` — the subset
+ * kheopskit reads. Declared locally so core never depends on
+ * `@walletconnect/universal-provider`. The concrete instance comes from
+ * `@reown/appkit` at runtime.
+ */
+type WalletConnectProvider = {
+    session?: {
+        topic: string;
+        namespaces: Record<string, {
+            accounts?: string[];
+        }>;
+    };
+    client: {
+        request<T = unknown>(args: {
+            topic: string;
+            chainId: string;
+            request: {
+                method: string;
+                params: unknown;
+            };
+        }): Promise<T>;
+    };
+    request(args: {
+        method: string;
+        params?: unknown;
+    }): Promise<unknown>;
+    on(event: string, listener: (...args: unknown[]) => void): void;
+    off(event: string, listener: (...args: unknown[]) => void): void;
+};
+/**
+ * Minimal structural view of the Reown AppKit instance — the subset kheopskit's
+ * account factories use. Exposed as the `appKit` escape hatch on AppKit wallets;
+ * cast it to `@reown/appkit`'s `AppKit` type for the full API. Declared locally
+ * so core never depends on `@reown/appkit`'s types (it's an optional peer).
+ */
+type AppKitInstance = {
+    getProvider<T = WalletConnectProvider>(namespace: string): T | undefined;
+    getAccount(namespace: string): {
+        allAccounts: {
+            address: string;
+        }[];
+    } | undefined;
+    getCaipNetworks(namespace: string): {
+        caipNetworkId?: string;
+    }[];
+};
+type WalletType = "injected" | "appKit";
+type PolkadotAccountType = "sr25519" | "ed25519" | "ecdsa" | "ethereum";
+/**
+ * SDK-free fields common to every wallet, regardless of platform. Platform
+ * packages (`@kheopskit/core/<platform>`) extend this with SDK-typed fields
+ * (the injected provider/extension/standard-wallet handle).
+ */
+type BaseWallet = {
+    id: WalletId;
+    platform: WalletPlatform;
+    type: WalletType;
+    name: string;
+    icon: string;
+    isConnected: boolean;
+    connect: () => Promise<void>;
+    /**
+     * Disconnect the wallet. Resolves once the underlying provider/extension
+     * disconnect completes; rejects if it fails so callers can surface or retry.
+     */
+    disconnect: () => Promise<void>;
+};
+/**
+ * SDK-free fields common to every account, regardless of platform. Platform
+ * packages extend this with their SDK-typed signer/client.
+ */
+type BaseWalletAccount = {
+    id: WalletAccountId;
+    platform: WalletPlatform;
+    /** Base58 (Solana), SS58 (Polkadot) or 0x-hex (Ethereum) address. */
+    address: string;
+    /** Friendly account name, when the wallet exposes one (e.g. Polkadot). */
+    name?: string;
+    walletName: string;
+    walletId: WalletId;
+};
+/**
+ * AppKit (WalletConnect) wallet handle for a given platform. References only
+ * `@reown/appkit` (a hard dependency) — no optional platform SDK — so it lives
+ * in core and is shared by every platform's wallet union.
+ *
+ * The per-platform aliases below (`PolkadotAppKitWallet`, … ) are kept so each
+ * platform entry point can re-export a concrete name.
+ */
+type AppKitWallet<P extends WalletPlatform = WalletPlatform> = {
+    id: WalletId;
+    platform: P;
+    type: "appKit";
+    /**
+     * Raw Reown AppKit instance, exposed as an escape hatch for advanced use
+     * (custom modal control, reading providers directly). Most consumers should
+     * use the wallet's `connect`/`disconnect` and the derived accounts instead.
+     */
+    appKit: AppKitInstance;
+    name: string;
+    icon: string;
+    isConnected: boolean;
+    connect: () => Promise<void>;
+    disconnect: () => Promise<void>;
+};
+type PolkadotAppKitWallet = AppKitWallet<"polkadot">;
+type EthereumAppKitWallet = AppKitWallet<"ethereum">;
+type SolanaAppKitWallet = AppKitWallet<"solana">;
+/**
+ * Dapp metadata shown in the WalletConnect modal. Mirrors WalletConnect's
+ * `Metadata`, declared locally so core doesn't depend on
+ * `@walletconnect/universal-provider`.
+ */
+type WalletConnectMetadata = {
+    name: string;
+    description: string;
+    url: string;
+    icons: string[];
+};
+type WalletConnectConfig = {
+    projectId: string;
+    metadata: WalletConnectMetadata;
+    /** Defaults to wss://relay.walletconnect.com */
+    relayUrl?: string;
+    /**
+     * Networks AppKit should enable. Pass `AppKitNetwork[]` from
+     * `@reown/appkit/networks` (see
+     * https://docs.reown.com/advanced/multichain/polkadot/dapp-integration-guide#walletconnect-code%2Fcomponent-setup).
+     * Loosely typed (`unknown`) so core doesn't depend on `@reown/appkit`'s
+     * types — the value is forwarded to AppKit as-is.
+     */
+    networks: [unknown, ...unknown[]];
+    themeMode?: "light" | "dark";
+    themeVariables?: Record<string, string | number>;
+};
+/**
+ * Context passed to a platform plugin's `getWallets$`. Carries the shared store
+ * and the resolved core config (for WalletConnect / debug).
+ */
+type PlatformContext = {
+    store: KheopskitStore;
+    config: KheopskitConfig;
+};
+/**
+ * A platform plugin. Created by the per-platform factories exported from
+ * `@kheopskit/core/polkadot`, `/ethereum`, `/solana`. Core iterates plugins
+ * generically and never imports a platform SDK itself.
+ *
+ * @typeParam TPlatform - the platform discriminant
+ * @typeParam TWallet - the platform's wallet type (extends {@link BaseWallet})
+ * @typeParam TAccount - the platform's account type (extends {@link BaseWalletAccount})
+ */
+type KheopskitPlatform<TPlatform extends WalletPlatform = WalletPlatform, TWallet extends BaseWallet = BaseWallet, TAccount extends BaseWalletAccount = BaseWalletAccount> = {
+    readonly platform: TPlatform;
+    getWallets$(ctx: PlatformContext): Observable<TWallet[]>;
+    getAccounts$(wallets$: Observable<TWallet[]>): Observable<TAccount[]>;
+    /**
+     * Optional hydration filter. Cached accounts for which this returns false are
+     * dropped during SSR hydration (Polkadot uses it to honour `accountTypes`).
+     */
+    acceptsCachedAccount?(cached: CachedAccount): boolean;
+};
+type ElementOf<T> = T extends readonly (infer E)[] ? E : never;
+/** The account type produced by a plugin (inferred from its `getAccounts$`). */
+type AccountOf<T> = T extends {
+    getAccounts$: (wallets$: never) => Observable<infer R>;
+} ? ElementOf<R> : never;
+/** The wallet type produced by a plugin (inferred from its `getWallets$`). */
+type WalletOf<T> = T extends {
+    getWallets$: (ctx: never) => Observable<infer R>;
+} ? ElementOf<R> : never;
+type KheopskitConfig<P extends readonly KheopskitPlatform[] = readonly KheopskitPlatform[]> = {
+    autoReconnect: boolean;
+    /**
+     * Platform plugins to enable, e.g. `[polkadot(), solana({ chain })]`.
+     * Import factories from `@kheopskit/core/<platform>`.
+     */
+    platforms: P;
+    walletConnect?: WalletConnectConfig;
+    debug: boolean;
+    /**
+     * Custom storage key for persisting wallet connection state.
+     * Useful when running multiple kheopskit instances on the same domain
+     * to prevent state conflicts between different dapps.
+     *
+     * @default "kheopskit"
+     */
+    storageKey: string;
+    /**
+     * Grace period in milliseconds to wait for wallets to inject before
+     * syncing to actual state. During this period, cached wallet/account
+     * state from storage is preserved to prevent UI flashing.
+     *
+     * Set to 0 to disable hydration buffering.
+     *
+     * @default 500
+     */
+    hydrationGracePeriod: number;
+};
+/**
+ * The current kheopskit state.
+ *
+ * @remarks
+ * While {@link KheopskitState.isHydrating} is `true`, `wallets` and `accounts`
+ * may contain cached placeholders restored from storage. The **SDK handles** the
+ * platform types advertise (e.g. `account.signer` / `getSigner` on Solana,
+ * `account.client` on Ethereum, `wallet.provider` / `extension`) are **absent at
+ * runtime even though the types claim them**, and placeholder wallets throw if
+ * `connect`/`disconnect` is called. Guard all access to those behind
+ * `!isHydrating`.
+ *
+ * The plain, serializable platform data that is persisted in the cache IS
+ * restored on the placeholders (Ethereum `chainId`, Polkadot key `type`), so it
+ * renders immediately on reload without flashing. Solana `chains` is not cached,
+ * so it remains absent until the live account loads.
+ */
+type KheopskitState<P extends readonly KheopskitPlatform[] = readonly KheopskitPlatform[]> = {
+    wallets: WalletOf<P[number]>[];
+    accounts: AccountOf<P[number]>[];
+    config: KheopskitConfig<P>;
+    /**
+     * Whether the state is still being hydrated from cache.
+     *
+     * During hydration, cached wallets/accounts may be displayed before the
+     * actual wallet extensions have injected. See the type-level remarks: while
+     * this is `true`, SDK-typed fields (signer/client/provider/extension) are not
+     * present at runtime — guard all access behind `!isHydrating`.
+     */
+    isHydrating: boolean;
+};
+/**
+ * Serializable wallet data for SSR hydration cache.
+ * Contains only the data needed to render wallet UI without flash.
+ * Note: icon is NOT stored to save cookie space - it's looked up at hydration time.
+ */
+type CachedWallet = {
+    id: WalletId;
+    platform: WalletPlatform;
+    type: WalletType;
+    name: string;
+    isConnected: boolean;
+};
+/**
+ * Serializable account data for SSR hydration cache.
+ * Contains only the data needed to render account UI without flash.
+ */
+type CachedAccount = {
+    id: string;
+    platform: WalletPlatform;
+    address: string;
+    name?: string;
+    /** Cached chain ID for Ethereum accounts. */
+    chainId?: number;
+    /** Cached key type for Polkadot accounts. */
+    polkadotAccountType?: PolkadotAccountType;
+    walletId: WalletId;
+    walletName: string;
+};
+
+export { type AccountOf as A, type BaseWallet as B, type CachedAccount as C, type EthereumAppKitWallet as E, type KheopskitPlatform as K, type PlatformContext as P, type SolanaAppKitWallet as S, type WalletAccountId as W, type WalletId as a, type KheopskitConfig as b, createKheopskitStore as c, type KheopskitState as d, type AppKitInstance as e, type AppKitWallet as f, type BaseWalletAccount as g, type CachedWallet as h, type PolkadotAccountType as i, type PolkadotAppKitWallet as j, type WalletConnectConfig as k, type WalletConnectMetadata as l, type WalletConnectProvider as m, type WalletOf as n, type WalletPlatform as o, type WalletType as p, getDefaultStore as q, getWalletAccountId as r, getWalletId as s, parseWalletId as t };