@tuwaio/orbit-core 0.0.3 → 0.1.0

package/README.md

@@ -2,7 +2,7 @@
 
 [![NPM Version](https://img.shields.io/npm/v/@tuwaio/orbit-core.svg)](https://www.npmjs.com/package/@tuwaio/orbit-core)
 [![License](https://img.shields.io/npm/l/@tuwaio/orbit-core.svg)](./LICENSE)
-[![Build Status](https://img.shields.io/github/actions/workflow/status/TuwaIO/orbit-core/release.yml?branch=main)](https://github.com/TuwaIO/orbit-core/actions)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/TuwaIO/orbit/release.yml?branch=main)](https://github.com/TuwaIO/orbit/actions)
 
 A powerful, framework-agnostic library for seamless multi-chain blockchain interactions, providing a unified interface for EVM, Solana, and Starknet operations.
 
@@ -18,7 +18,7 @@ Its primary purpose is to provide a unified interface for interacting with diffe
 
 ## ✨ Key Features
 
-- **Multi-Chain Architecture:** Native support for EVM, Solana, and Starknet through a unified adapter interface
+- **Multi-Chain Architecture:** Native support for EVM, Solana, and Starknet through a unified adapter interface.
 - **Framework Independence:** Compatible with any JavaScript framework or vanilla JS
 - **Type-Safe Development:** Full TypeScript support with comprehensive type definitions
 - **Flexible Adapter System:** Easily extensible for new blockchain architectures
@@ -30,11 +30,11 @@ Its primary purpose is to provide a unified interface for interacting with diffe
 ## 💾 Installation
 ```bash
 # Using pnpm
-pnpm add @tuwaio/orbit-core zustand
+pnpm add @tuwaio/orbit-core
 # Using npm
-npm install @tuwaio/orbit-core zustand
+npm install @tuwaio/orbit-core
 # Using yarn
-yarn add @tuwaio/orbit-core zustand
+yarn add @tuwaio/orbit-core
 ``` 
 
 ---
@@ -71,7 +71,6 @@ Orbit Core is built on these main concepts:
 
 - `OrbitAdapter`: Enum defining supported blockchain types
 - `selectAdapterByKey`: Utility for runtime adapter selection
-- `createBoundedUseStore`: Store creation helper for state management
 - Chain-specific helpers and utilities
 
 ---

package/dist/index.d.mts

@@ -1,5 +1,3 @@
-import { StoreApi } from 'zustand';
-
 /**
  * @file
  * Core type definitions for the Orbit blockchain adapter system.
@@ -79,7 +77,7 @@ declare enum OrbitAdapter {
  * };
  *
  * // Multiple adapters
- * const multiChainConfig: OrbitGenericAdapter<BaseAdapter> = {
+ * const multiChainConfig: OrbitGenericAdapter<EVMAdapter> = {
  *   adapter: [
  *     { key: OrbitAdapter.EVM, ... },
  *     { key: OrbitAdapter.SOLANA, ... }
@@ -92,42 +90,253 @@ type OrbitGenericAdapter<A extends {
 }> = {
     adapter: A | A[];
 };
+type BaseAdapter = {
+    /**
+     * Generates blockchain explorer URL
+     * @returns Explorer URL or undefined if not available
+     */
+    getExplorerUrl: (url?: string, chainId?: string | number) => string | undefined;
+    /** Optional method to resolve ENS-like names */
+    getName?: (address: string) => Promise<string | null>;
+    /** Optional method to get avatar for resolved names */
+    getAvatar?: (name: string) => Promise<string | null>;
+};
+/**
+ * Type representing a wallet identifier in format "OrbitAdapter:wallet"
+ * @example "evm:metamask" | "solana:phantom"
+ */
+type WalletType = `${OrbitAdapter}:${string}`;
+
+/**
+ * @name delay
+ *
+ * Ensures the global 'window' object is available (if running in a browser-like environment),
+ * then pauses execution for a specified duration, and finally resolves the Promise with the given value.
+ *
+ * This utility function is designed to be safe for use in Server-Side Rendering (SSR) environments.
+ * It asynchronously waits for the 'window' object to be defined before starting the actual timer,
+ * helping to prevent errors during the initial server render while still providing a time delay on the client.
+ *
+ * @template T - The type of the value being resolved.
+ *
+ * @param {T} value - The value to resolve the Promise with after the delay.
+ * @param {number} ms - The number of milliseconds (delay) to wait before resolving the Promise after 'window' is available.
+ *
+ * @returns {Promise<T>} A Promise that resolves with the provided `value` after both the 'window' check and the delay (`ms`) are complete.
+ *
+ * @example
+ * ```typescript
+ * // Use this in an environment where 'window' might not be immediately available (e.g., Next.js component).
+ * async function waitForWindowAndDelay() {
+ * console.log("Start wait...");
+ * // This will wait for window, and then wait 100ms.
+ * const data = await delay("Ready to connect", 100);
+ * console.log(data);
+ * }
+ * waitForWindowAndDelay();
+ * ```
+ */
+declare const delay: <T>(value: T, ms: number) => Promise<T>;
+
+/**
+ * Filters an array of objects to keep only the first occurrence of an object
+ * based on a unique value of a specified key.
+ *
+ * This function is generic and type-safe. It iterates through the array and uses a
+ * Set to track already encountered key values, effectively removing duplicates.
+ *
+ * @template T The type of the objects in the array.
+ * @param {T[]} array - The array of objects to be filtered.
+ * @param {keyof T} key - The object key (property name) whose values must be unique.
+ * @returns {T[]} The filtered array containing only objects with unique key values.
+ */
+declare function filterUniqueByKey<T>(array: T[], key: keyof T): T[];
+
+declare function formatWalletChainId(chainId: string | number, connectedAdapter: OrbitAdapter): string | number;
+
+declare const formatWalletName: (walletName: string) => string;
 
 /**
- * @file This file provides a utility for creating a type-safe, bounded Zustand hook from a vanilla store.
- * This pattern is recommended by the official Zustand documentation to ensure full type
- * safety when integrating vanilla stores with React.
+ * Extracts the adapter type from a wallet type string
+ *
+ * @example
+ * ```typescript
+ * // Returns OrbitAdapter.EVM
+ * getAdapterFromWalletType('evm:metamask');
+ *
+ * // Returns OrbitAdapter.SOLANA
+ * getAdapterFromWalletType('solana:phantom');
+ *
+ * // Returns OrbitAdapter.EVM (default)
+ * getAdapterFromWalletType('unknown');
+ * ```
  *
- * @see https://docs.pmnd.rs/zustand/guides/typescript#bounded-usestore-hook-for-vanilla-stores
+ * @param walletType - Wallet type in format "chain:wallet" (e.g. "evm:metamask", "solana:phantom")
+ * @returns The corresponding {@link OrbitAdapter} type or EVM as default
+ *
+ * @remarks
+ * The function splits the wallet type string by ":" and takes the first part as the adapter type.
+ * If the split fails or the first part is empty, it defaults to EVM adapter.
+ */
+declare function getAdapterFromWalletType(walletType: WalletType): OrbitAdapter;
+
+/**
+ * Internal function for safely retrieving and parsing data from localStorage.
+ *
+ * @param key - The key for localStorage
+ * @returns The parsed LastConnectedWallet object or undefined if data is not found/invalid
  */
+declare function getParsedStorageItem<ReturnType>(key: string): ReturnType | undefined;
 
 /**
- * A utility type that infers the state shape from a Zustand `StoreApi`.
- * It extracts the return type of the `getState` method.
- * @template S - The type of the Zustand store (`StoreApi`).
+ * Generates a standardized wallet type identifier from adapter type and connector name
+ *
+ * @example
+ * ```typescript
+ * // Returns "evm:metamask"
+ * getWalletTypeFromConnectorName(OrbitAdapter.EVM, "MetaMask");
+ *
+ * // Returns "solana:phantom"
+ * getWalletTypeFromConnectorName(OrbitAdapter.SOLANA, "Phantom");
+ *
+ * // Returns "evm:coinbasewallet" (removes spaces)
+ * getWalletTypeFromConnectorName(OrbitAdapter.EVM, "Coinbase Wallet");
+ * ```
+ *
+ * @param adapter - The blockchain adapter type (e.g. EVM, SOLANA)
+ * @param name - The wallet connector name (e.g. "MetaMask", "Phantom")
+ * @returns A formatted wallet type string in format "chain:wallet"
+ *
+ * @remarks
+ * The function:
+ * 1. Combines adapter type with connector name using ":" as separator
+ * 2. Removes all whitespace from connector name
+ * 3. Converts connector name to lowercase
+ * This ensures consistent wallet type identifiers across the application
  */
-type ExtractState<S> = S extends {
-    getState: () => infer T;
-} ? T : never;
+declare function getWalletTypeFromConnectorName(adapter: OrbitAdapter, name: string): string;
+
 /**
- * Creates a bounded `useStore` hook from a vanilla Zustand store.
+ * Helper utilities for managing impersonated wallet addresses
  *
- * This function takes a vanilla Zustand store instance and returns a React hook
- * that is pre-bound to that store. This approach provides a cleaner API and
- * enhances type inference, eliminating the need to pass the store instance
- * on every use.
+ * @remarks
+ * These utilities are primarily used for development and testing purposes.
+ * They provide a way to simulate different wallet addresses without actually connecting a wallet.
+ * All data is stored in localStorage with the 'satellite-connect:impersonatedAddress' key.
+ * Functions are safe to use in both browser and SSR environments.
+ */
+declare const impersonatedHelpers: {
+    /**
+     * Currently impersonated address from localStorage
+     * Returns empty string if not set or in SSR context
+     */
+    impersonatedAddress: string;
+    /**
+     * Stores an impersonated address in localStorage
+     *
+     * @example
+     * ```typescript
+     * // Set impersonated address
+     * impersonatedHelpers.setImpersonated('0x1234...5678');
+     * ```
+     *
+     * @param address - Ethereum or Solana address to impersonate
+     * @returns undefined in SSR context, void in browser
+     */
+    setImpersonated: (address: string) => void;
+    /**
+     * Retrieves the current impersonated address from localStorage
+     *
+     * @example
+     * ```typescript
+     * // Get current impersonated address
+     * const address = impersonatedHelpers.getImpersonated();
+     * if (address) {
+     *   console.log('Currently impersonating:', address);
+     * }
+     * ```
+     * @returns The impersonated address or undefined if not set or in SSR context
+     */
+    getImpersonated: () => string | null | undefined;
+    removeImpersonated: () => void;
+};
+
+declare const isSafeApp: boolean;
+
+type LastConnectedWallet = {
+    walletType: WalletType;
+    chainId: number | string;
+    address?: string;
+};
+/**
+ * Helper utilities for managing the last connected wallet state
  *
- * The returned hook supports two signatures:
- * 1. `useBoundedStore()`: Selects the entire state.
- * 2. `useBoundedStore(selector)`: Selects a slice of the state, returning only what the selector function specifies.
+ * @remarks
+ * All data is stored in localStorage with the 'orbit-core:lastConnectedWallet' key.
+ * Functions are safe to use in both browser and SSR environments.
+ */
+declare const lastConnectedWalletHelpers: {
+    STORAGE_KEY: string;
+    /**
+     * The value of the last connected wallet, initialized when the module loads.
+     * Returns undefined if not set, invalid, or in an SSR context.
+     */
+    lastConnectedWallet: LastConnectedWallet | undefined;
+    /**
+     * Stores the last connected wallet data in localStorage.
+     *
+     * @param data - Object containing the wallet type and chain ID.
+     * @returns undefined in SSR context, void in browser
+     */
+    setLastConnectedWallet: ({ walletType, chainId, address }: LastConnectedWallet) => void;
+    /**
+     * Retrieves the current last connected wallet data from localStorage.
+     *
+     * @returns The LastConnectedWallet object or undefined if not set or in SSR context
+     */
+    getLastConnectedWallet: () => LastConnectedWallet | undefined;
+    /**
+     * Removes the last connected wallet data from localStorage.
+     *
+     * @returns undefined in SSR context, void in browser
+     */
+    removeLastConnectedWallet: () => void;
+};
+
+type RecentConnectedWallet = Record<OrbitAdapter, Record<string, boolean>>;
+/**
+ * Helper utilities for managing the last connected wallet state
  *
- * @template S - The type of the Zustand store (`StoreApi`).
- * @param {S} store - The vanilla Zustand store instance to bind the hook to.
- * @returns {function} A fully typed React hook for accessing the store's state.
+ * @remarks
+ * All data is stored in localStorage with the 'orbit-core:lastConnectedWallet' key.
+ * Functions are safe to use in both browser and SSR environments.
  */
-declare const createBoundedUseStore: <S extends StoreApi<unknown>>(store: S) => {
-    (): ExtractState<S>;
-    <T>(selector: (state: ExtractState<S>) => T): T;
+declare const recentConnectedWalletHelpers: {
+    STORAGE_KEY: string;
+    /**
+     * The value of the last connected wallet, initialized when the module loads.
+     * Returns undefined if not set, invalid, or in an SSR context.
+     */
+    recentConnectedWallet: RecentConnectedWallet | undefined;
+    /**
+     * Stores the last connected wallet data in localStorage.
+     *
+     * @param wallets - RecentConnectedWallet
+     * @returns undefined in SSR context, void in browser
+     */
+    setRecentConnectedWallet: (wallets: RecentConnectedWallet) => void;
+    /**
+     * Retrieves the current last connected wallet data from localStorage.
+     *
+     * @returns The LastConnectedWallet object or undefined if not set or in SSR context
+     */
+    getRecentConnectedWallet: () => RecentConnectedWallet | undefined;
+    /**
+     * Removes the last connected wallet data from localStorage.
+     *
+     * @returns undefined in SSR context, void in browser
+     */
+    removeRecentConnectedWallet: () => void;
 };
 
 /**
@@ -179,6 +388,8 @@ declare const selectAdapterByKey: <A extends {
     adapterKey: OrbitAdapter;
 } & OrbitGenericAdapter<A>) => A | undefined;
 
+declare function waitFor(predicate: () => boolean | undefined, maxChecks?: number, checkIntervalMs?: number): Promise<void>;
+
 /**
  * Checks whether the given chain ID belongs to a Solana network.
  * Supports common Solana network names: 'devnet', 'testnet', 'mainnet-beta', 'mainnet'.
@@ -195,4 +406,4 @@ declare function isSolanaChain(chainId: number | string): boolean;
  */
 declare function setChainId(chainId: number | string): string | number;
 
-export { OrbitAdapter, type OrbitGenericAdapter, createBoundedUseStore, isSolanaChain, selectAdapterByKey, setChainId };
+export { type BaseAdapter, OrbitAdapter, type OrbitGenericAdapter, type RecentConnectedWallet, type WalletType, delay, filterUniqueByKey, formatWalletChainId, formatWalletName, getAdapterFromWalletType, getParsedStorageItem, getWalletTypeFromConnectorName, impersonatedHelpers, isSafeApp, isSolanaChain, lastConnectedWalletHelpers, recentConnectedWalletHelpers, selectAdapterByKey, setChainId, waitFor };

package/dist/index.d.ts

@@ -1,5 +1,3 @@
-import { StoreApi } from 'zustand';
-
 /**
  * @file
  * Core type definitions for the Orbit blockchain adapter system.
@@ -79,7 +77,7 @@ declare enum OrbitAdapter {
  * };
  *
  * // Multiple adapters
- * const multiChainConfig: OrbitGenericAdapter<BaseAdapter> = {
+ * const multiChainConfig: OrbitGenericAdapter<EVMAdapter> = {
  *   adapter: [
  *     { key: OrbitAdapter.EVM, ... },
  *     { key: OrbitAdapter.SOLANA, ... }
@@ -92,42 +90,253 @@ type OrbitGenericAdapter<A extends {
 }> = {
     adapter: A | A[];
 };
+type BaseAdapter = {
+    /**
+     * Generates blockchain explorer URL
+     * @returns Explorer URL or undefined if not available
+     */
+    getExplorerUrl: (url?: string, chainId?: string | number) => string | undefined;
+    /** Optional method to resolve ENS-like names */
+    getName?: (address: string) => Promise<string | null>;
+    /** Optional method to get avatar for resolved names */
+    getAvatar?: (name: string) => Promise<string | null>;
+};
+/**
+ * Type representing a wallet identifier in format "OrbitAdapter:wallet"
+ * @example "evm:metamask" | "solana:phantom"
+ */
+type WalletType = `${OrbitAdapter}:${string}`;
+
+/**
+ * @name delay
+ *
+ * Ensures the global 'window' object is available (if running in a browser-like environment),
+ * then pauses execution for a specified duration, and finally resolves the Promise with the given value.
+ *
+ * This utility function is designed to be safe for use in Server-Side Rendering (SSR) environments.
+ * It asynchronously waits for the 'window' object to be defined before starting the actual timer,
+ * helping to prevent errors during the initial server render while still providing a time delay on the client.
+ *
+ * @template T - The type of the value being resolved.
+ *
+ * @param {T} value - The value to resolve the Promise with after the delay.
+ * @param {number} ms - The number of milliseconds (delay) to wait before resolving the Promise after 'window' is available.
+ *
+ * @returns {Promise<T>} A Promise that resolves with the provided `value` after both the 'window' check and the delay (`ms`) are complete.
+ *
+ * @example
+ * ```typescript
+ * // Use this in an environment where 'window' might not be immediately available (e.g., Next.js component).
+ * async function waitForWindowAndDelay() {
+ * console.log("Start wait...");
+ * // This will wait for window, and then wait 100ms.
+ * const data = await delay("Ready to connect", 100);
+ * console.log(data);
+ * }
+ * waitForWindowAndDelay();
+ * ```
+ */
+declare const delay: <T>(value: T, ms: number) => Promise<T>;
+
+/**
+ * Filters an array of objects to keep only the first occurrence of an object
+ * based on a unique value of a specified key.
+ *
+ * This function is generic and type-safe. It iterates through the array and uses a
+ * Set to track already encountered key values, effectively removing duplicates.
+ *
+ * @template T The type of the objects in the array.
+ * @param {T[]} array - The array of objects to be filtered.
+ * @param {keyof T} key - The object key (property name) whose values must be unique.
+ * @returns {T[]} The filtered array containing only objects with unique key values.
+ */
+declare function filterUniqueByKey<T>(array: T[], key: keyof T): T[];
+
+declare function formatWalletChainId(chainId: string | number, connectedAdapter: OrbitAdapter): string | number;
+
+declare const formatWalletName: (walletName: string) => string;
 
 /**
- * @file This file provides a utility for creating a type-safe, bounded Zustand hook from a vanilla store.
- * This pattern is recommended by the official Zustand documentation to ensure full type
- * safety when integrating vanilla stores with React.
+ * Extracts the adapter type from a wallet type string
+ *
+ * @example
+ * ```typescript
+ * // Returns OrbitAdapter.EVM
+ * getAdapterFromWalletType('evm:metamask');
+ *
+ * // Returns OrbitAdapter.SOLANA
+ * getAdapterFromWalletType('solana:phantom');
+ *
+ * // Returns OrbitAdapter.EVM (default)
+ * getAdapterFromWalletType('unknown');
+ * ```
  *
- * @see https://docs.pmnd.rs/zustand/guides/typescript#bounded-usestore-hook-for-vanilla-stores
+ * @param walletType - Wallet type in format "chain:wallet" (e.g. "evm:metamask", "solana:phantom")
+ * @returns The corresponding {@link OrbitAdapter} type or EVM as default
+ *
+ * @remarks
+ * The function splits the wallet type string by ":" and takes the first part as the adapter type.
+ * If the split fails or the first part is empty, it defaults to EVM adapter.
+ */
+declare function getAdapterFromWalletType(walletType: WalletType): OrbitAdapter;
+
+/**
+ * Internal function for safely retrieving and parsing data from localStorage.
+ *
+ * @param key - The key for localStorage
+ * @returns The parsed LastConnectedWallet object or undefined if data is not found/invalid
  */
+declare function getParsedStorageItem<ReturnType>(key: string): ReturnType | undefined;
 
 /**
- * A utility type that infers the state shape from a Zustand `StoreApi`.
- * It extracts the return type of the `getState` method.
- * @template S - The type of the Zustand store (`StoreApi`).
+ * Generates a standardized wallet type identifier from adapter type and connector name
+ *
+ * @example
+ * ```typescript
+ * // Returns "evm:metamask"
+ * getWalletTypeFromConnectorName(OrbitAdapter.EVM, "MetaMask");
+ *
+ * // Returns "solana:phantom"
+ * getWalletTypeFromConnectorName(OrbitAdapter.SOLANA, "Phantom");
+ *
+ * // Returns "evm:coinbasewallet" (removes spaces)
+ * getWalletTypeFromConnectorName(OrbitAdapter.EVM, "Coinbase Wallet");
+ * ```
+ *
+ * @param adapter - The blockchain adapter type (e.g. EVM, SOLANA)
+ * @param name - The wallet connector name (e.g. "MetaMask", "Phantom")
+ * @returns A formatted wallet type string in format "chain:wallet"
+ *
+ * @remarks
+ * The function:
+ * 1. Combines adapter type with connector name using ":" as separator
+ * 2. Removes all whitespace from connector name
+ * 3. Converts connector name to lowercase
+ * This ensures consistent wallet type identifiers across the application
  */
-type ExtractState<S> = S extends {
-    getState: () => infer T;
-} ? T : never;
+declare function getWalletTypeFromConnectorName(adapter: OrbitAdapter, name: string): string;
+
 /**
- * Creates a bounded `useStore` hook from a vanilla Zustand store.
+ * Helper utilities for managing impersonated wallet addresses
  *
- * This function takes a vanilla Zustand store instance and returns a React hook
- * that is pre-bound to that store. This approach provides a cleaner API and
- * enhances type inference, eliminating the need to pass the store instance
- * on every use.
+ * @remarks
+ * These utilities are primarily used for development and testing purposes.
+ * They provide a way to simulate different wallet addresses without actually connecting a wallet.
+ * All data is stored in localStorage with the 'satellite-connect:impersonatedAddress' key.
+ * Functions are safe to use in both browser and SSR environments.
+ */
+declare const impersonatedHelpers: {
+    /**
+     * Currently impersonated address from localStorage
+     * Returns empty string if not set or in SSR context
+     */
+    impersonatedAddress: string;
+    /**
+     * Stores an impersonated address in localStorage
+     *
+     * @example
+     * ```typescript
+     * // Set impersonated address
+     * impersonatedHelpers.setImpersonated('0x1234...5678');
+     * ```
+     *
+     * @param address - Ethereum or Solana address to impersonate
+     * @returns undefined in SSR context, void in browser
+     */
+    setImpersonated: (address: string) => void;
+    /**
+     * Retrieves the current impersonated address from localStorage
+     *
+     * @example
+     * ```typescript
+     * // Get current impersonated address
+     * const address = impersonatedHelpers.getImpersonated();
+     * if (address) {
+     *   console.log('Currently impersonating:', address);
+     * }
+     * ```
+     * @returns The impersonated address or undefined if not set or in SSR context
+     */
+    getImpersonated: () => string | null | undefined;
+    removeImpersonated: () => void;
+};
+
+declare const isSafeApp: boolean;
+
+type LastConnectedWallet = {
+    walletType: WalletType;
+    chainId: number | string;
+    address?: string;
+};
+/**
+ * Helper utilities for managing the last connected wallet state
  *
- * The returned hook supports two signatures:
- * 1. `useBoundedStore()`: Selects the entire state.
- * 2. `useBoundedStore(selector)`: Selects a slice of the state, returning only what the selector function specifies.
+ * @remarks
+ * All data is stored in localStorage with the 'orbit-core:lastConnectedWallet' key.
+ * Functions are safe to use in both browser and SSR environments.
+ */
+declare const lastConnectedWalletHelpers: {
+    STORAGE_KEY: string;
+    /**
+     * The value of the last connected wallet, initialized when the module loads.
+     * Returns undefined if not set, invalid, or in an SSR context.
+     */
+    lastConnectedWallet: LastConnectedWallet | undefined;
+    /**
+     * Stores the last connected wallet data in localStorage.
+     *
+     * @param data - Object containing the wallet type and chain ID.
+     * @returns undefined in SSR context, void in browser
+     */
+    setLastConnectedWallet: ({ walletType, chainId, address }: LastConnectedWallet) => void;
+    /**
+     * Retrieves the current last connected wallet data from localStorage.
+     *
+     * @returns The LastConnectedWallet object or undefined if not set or in SSR context
+     */
+    getLastConnectedWallet: () => LastConnectedWallet | undefined;
+    /**
+     * Removes the last connected wallet data from localStorage.
+     *
+     * @returns undefined in SSR context, void in browser
+     */
+    removeLastConnectedWallet: () => void;
+};
+
+type RecentConnectedWallet = Record<OrbitAdapter, Record<string, boolean>>;
+/**
+ * Helper utilities for managing the last connected wallet state
  *
- * @template S - The type of the Zustand store (`StoreApi`).
- * @param {S} store - The vanilla Zustand store instance to bind the hook to.
- * @returns {function} A fully typed React hook for accessing the store's state.
+ * @remarks
+ * All data is stored in localStorage with the 'orbit-core:lastConnectedWallet' key.
+ * Functions are safe to use in both browser and SSR environments.
  */
-declare const createBoundedUseStore: <S extends StoreApi<unknown>>(store: S) => {
-    (): ExtractState<S>;
-    <T>(selector: (state: ExtractState<S>) => T): T;
+declare const recentConnectedWalletHelpers: {
+    STORAGE_KEY: string;
+    /**
+     * The value of the last connected wallet, initialized when the module loads.
+     * Returns undefined if not set, invalid, or in an SSR context.
+     */
+    recentConnectedWallet: RecentConnectedWallet | undefined;
+    /**
+     * Stores the last connected wallet data in localStorage.
+     *
+     * @param wallets - RecentConnectedWallet
+     * @returns undefined in SSR context, void in browser
+     */
+    setRecentConnectedWallet: (wallets: RecentConnectedWallet) => void;
+    /**
+     * Retrieves the current last connected wallet data from localStorage.
+     *
+     * @returns The LastConnectedWallet object or undefined if not set or in SSR context
+     */
+    getRecentConnectedWallet: () => RecentConnectedWallet | undefined;
+    /**
+     * Removes the last connected wallet data from localStorage.
+     *
+     * @returns undefined in SSR context, void in browser
+     */
+    removeRecentConnectedWallet: () => void;
 };
 
 /**
@@ -179,6 +388,8 @@ declare const selectAdapterByKey: <A extends {
     adapterKey: OrbitAdapter;
 } & OrbitGenericAdapter<A>) => A | undefined;
 
+declare function waitFor(predicate: () => boolean | undefined, maxChecks?: number, checkIntervalMs?: number): Promise<void>;
+
 /**
  * Checks whether the given chain ID belongs to a Solana network.
  * Supports common Solana network names: 'devnet', 'testnet', 'mainnet-beta', 'mainnet'.
@@ -195,4 +406,4 @@ declare function isSolanaChain(chainId: number | string): boolean;
  */
 declare function setChainId(chainId: number | string): string | number;
 
-export { OrbitAdapter, type OrbitGenericAdapter, createBoundedUseStore, isSolanaChain, selectAdapterByKey, setChainId };
+export { type BaseAdapter, OrbitAdapter, type OrbitGenericAdapter, type RecentConnectedWallet, type WalletType, delay, filterUniqueByKey, formatWalletChainId, formatWalletName, getAdapterFromWalletType, getParsedStorageItem, getWalletTypeFromConnectorName, impersonatedHelpers, isSafeApp, isSolanaChain, lastConnectedWalletHelpers, recentConnectedWalletHelpers, selectAdapterByKey, setChainId, waitFor };

package/dist/index.js

@@ -1,2 +1,2 @@
-'use strict';var zustand=require('zustand');var o=(r=>(r.EVM="evm",r.SOLANA="solana",r.Starknet="starknet",r))(o||{});var d=(e=>t=>zustand.useStore(e,t));var l=({adapterKey:e,adapter:t})=>{if(Array.isArray(t)){if(t.length===0){console.error("Adapter selection failed: The provided adapters array is empty.");return}let n=t.find(r=>r.key===e);return n||(console.warn(`No adapter found for key: "${e}". Falling back to the first available adapter: "${t[0].key}".`),t[0])}return t};function i(e){return typeof e=="string"?["devnet","testnet","mainnet-beta","mainnet"].includes(e):false}function x(e){return i(e)?`solana:${e}`:e}exports.OrbitAdapter=o;exports.createBoundedUseStore=d;exports.isSolanaChain=i;exports.selectAdapterByKey=l;exports.setChainId=x;//# sourceMappingURL=index.js.map
+'use strict';var l=(n=>(n.EVM="evm",n.SOLANA="solana",n.Starknet="starknet",n))(l||{});var c=(e,t)=>new Promise(r=>{let n=()=>{setTimeout(()=>r(e),t);};typeof window<"u"?n():setTimeout(n,0);});function u(e,t){let r=new Set;return e.filter(n=>{let a=n[t];return r.has(a)?false:(r.add(a),true)})}function g(e,t){return typeof e=="string"?`${t}:${e}`:e}var s=new Map([["Impersonated Connector","impersonatedwallet"],["Safe","safewallet"],["Trust","trustwallet"],["Trust Wallet","trustwallet"],["Brave \u041A\u043E\u0448\u0435\u043B\u0435\u043A","bravewallet"],["Brave Wallet","bravewallet"]]),A=e=>s.get(e)??e.replace(/\s+/g,"").toLowerCase();function W(e){return e?.split(":")[0]??"evm"}function o(e){if(typeof window>"u")return;let t=window.localStorage.getItem(e);if(t)try{return JSON.parse(t)}catch(r){console.error(`Error parsing ${e} from localStorage:`,r);return}}function O(e,t){return `${e}:${t.replace(/\s+/g,"").toLowerCase()}`}var R={impersonatedAddress:typeof window<"u"?window.localStorage.getItem("satellite-connect:impersonatedAddress")??"":"",setImpersonated:e=>typeof window<"u"?window.localStorage.setItem("satellite-connect:impersonatedAddress",e):void 0,getImpersonated:()=>typeof window<"u"?window.localStorage.getItem("satellite-connect:impersonatedAddress"):void 0,removeImpersonated:()=>typeof window<"u"?window.localStorage.removeItem("satellite-connect:impersonatedAddress"):void 0};var v=typeof window<"u"&&window!==window.parent;var i={STORAGE_KEY:"orbit-core:lastConnectedWallet",lastConnectedWallet:o("orbit-core:lastConnectedWallet"),setLastConnectedWallet:({walletType:e,chainId:t,address:r})=>typeof window<"u"?window.localStorage.setItem(i.STORAGE_KEY,JSON.stringify({walletType:e,chainId:t,address:r})):void 0,getLastConnectedWallet:()=>o(i.STORAGE_KEY),removeLastConnectedWallet:()=>typeof window<"u"?window.localStorage.removeItem(i.STORAGE_KEY):void 0};var d={STORAGE_KEY:"orbit-core:recentConnectedWallet",recentConnectedWallet:o("orbit-core:recentConnectedWallets"),setRecentConnectedWallet:e=>typeof window<"u"?window.localStorage.setItem(d.STORAGE_KEY,JSON.stringify(e)):void 0,getRecentConnectedWallet:()=>o(d.STORAGE_KEY),removeRecentConnectedWallet:()=>typeof window<"u"?window.localStorage.removeItem(d.STORAGE_KEY):void 0};var $=({adapterKey:e,adapter:t})=>{if(Array.isArray(t)){if(t.length===0){console.error("Adapter selection failed: The provided adapters array is empty.");return}let r=t.find(n=>n.key===e);return r||(console.warn(`No adapter found for key: "${e}". Falling back to the first available adapter: "${t[0].key}".`),t[0])}return t};async function N(e,t=50,r=200){for(let n=0;n<t;n++){if(e())return;await new Promise(a=>setTimeout(a,r));}throw new Error("Predicate not fulfilled in time")}function p(e){return typeof e=="string"?["devnet","testnet","mainnet-beta","mainnet"].includes(e):false}function h(e){return p(e)?`solana:${e}`:e}exports.OrbitAdapter=l;exports.delay=c;exports.filterUniqueByKey=u;exports.formatWalletChainId=g;exports.formatWalletName=A;exports.getAdapterFromWalletType=W;exports.getParsedStorageItem=o;exports.getWalletTypeFromConnectorName=O;exports.impersonatedHelpers=R;exports.isSafeApp=v;exports.isSolanaChain=p;exports.lastConnectedWalletHelpers=i;exports.recentConnectedWalletHelpers=d;exports.selectAdapterByKey=$;exports.setChainId=h;exports.waitFor=N;//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts","../src/utils/createBoundedUseStore.ts","../src/utils/selectAdapterByKey.ts","../src/utils/%D1%81hainHelpers.ts"],"names":["OrbitAdapter","createBoundedUseStore","store","selector","useStore","selectAdapterByKey","adapterKey","adapter","foundAdapter","a","isSolanaChain","chainId","setChainId"],"mappings":"4CAgCO,IAAKA,CAAAA,CAAAA,CAAAA,CAAAA,GAUVA,CAAAA,CAAA,GAAA,CAAM,KAAA,CASNA,CAAAA,CAAA,OAAS,QAAA,CASTA,CAAAA,CAAA,QAAA,CAAW,UAAA,CA5BDA,CAAAA,CAAAA,EAAAA,CAAAA,EAAA,EAAA,ECCL,IAAMC,CAAAA,EAA0BC,CAAAA,EAAWC,GAAaC,gBAAAA,CAASF,CAAAA,CAAOC,CAAQ,CAAA,ECYhF,IAAME,CAAAA,CAAqB,CAAkC,CAClE,UAAA,CAAAC,CAAAA,CACA,OAAA,CAAAC,CACF,CAAA,GAA4E,CAC1E,GAAI,KAAA,CAAM,OAAA,CAAQA,CAAO,CAAA,CAAG,CAC1B,GAAIA,CAAAA,CAAQ,MAAA,GAAW,CAAA,CAAG,CACxB,OAAA,CAAQ,KAAA,CAAM,iEAAiE,CAAA,CAC/E,MACF,CAEA,IAAMC,CAAAA,CAAeD,CAAAA,CAAQ,IAAA,CAAME,GAAMA,CAAAA,CAAE,GAAA,GAAQH,CAAU,CAAA,CAE7D,OAAIE,CAAAA,GAGF,QAAQ,IAAA,CACN,CAAA,2BAAA,EAA8BF,CAAU,CAAA,iDAAA,EAAoDC,CAAAA,CAAQ,CAAC,EAAE,GAAG,CAAA,EAAA,CAC5G,CAAA,CACOA,CAAAA,CAAQ,CAAC,CAAA,CAEpB,CACA,OAAOA,CACT,EC5DO,SAASG,CAAAA,CAAcC,CAAAA,CAAmC,CAC/D,OAAI,OAAOA,CAAAA,EAAY,QAAA,CACd,CAAC,QAAA,CAAU,UAAW,cAAA,CAAgB,SAAS,CAAA,CAAE,QAAA,CAASA,CAAO,CAAA,CAEnE,KACT,CAQO,SAASC,CAAAA,CAAWD,CAAAA,CAA2C,CACpE,OAAID,CAAAA,CAAcC,CAAO,CAAA,CAChB,CAAA,OAAA,EAAUA,CAAO,CAAA,CAAA,CAEjBA,CAEX","file":"index.js","sourcesContent":["/**\n * @file\n * Core type definitions for the Orbit blockchain adapter system.\n * This file contains fundamental enums and types that define the supported blockchain architectures\n * and their adapter interfaces.\n */\n\n// =================================================================================================\n// 1. ENUMS AND CORE TRANSACTION TYPES\n// =================================================================================================\n\n/**\n * Defines the supported blockchain adapters in the Orbit system.\n * Each adapter corresponds to a specific blockchain architecture and implements\n * the necessary interfaces for that chain's functionality.\n *\n * @enum {string}\n *\n * @example\n * ```typescript\n * // Using adapter types in configuration\n * const config = {\n *   chainType: OrbitAdapter.EVM,\n *   // other configuration...\n * };\n *\n * // Checking adapter compatibility\n * if (chainType === OrbitAdapter.SOLANA) {\n *   // Solana-specific logic\n * }\n * ```\n */\nexport enum OrbitAdapter {\n  /**\n   * For Ethereum Virtual Machine (EVM) compatible chains.\n   * Supports networks like:\n   * - Ethereum Mainnet\n   * - Polygon\n   * - Binance Smart Chain\n   * - Avalanche\n   * - Other EVM-compatible L1/L2 chains\n   */\n  EVM = 'evm',\n\n  /**\n   * For the Solana blockchain.\n   * Supports:\n   * - Solana Mainnet\n   * - Devnet\n   * - Testnet\n   */\n  SOLANA = 'solana',\n\n  /**\n   * For the Starknet L2 network.\n   * Supports:\n   * - Starknet Mainnet\n   * - Testnet (Goerli)\n   * - Other Starknet deployments\n   */\n  Starknet = 'starknet',\n}\n\n/**\n * Generic type for creating blockchain adapters with type safety.\n * This type ensures that all adapters implement the required interface\n * and are properly keyed by their blockchain type.\n *\n * @typeParam A - Type that extends the base adapter interface with a key property\n *\n * @property {A | A[]} adapter - Single adapter instance or array of adapters\n *\n * @example\n * ```typescript\n * // Single adapter implementation\n * interface EVMAdapter extends BaseAdapter {\n *   key: OrbitAdapter.EVM;\n *   // EVM-specific methods...\n * }\n * const evmConfig: OrbitGenericAdapter<EVMAdapter> = {\n *   adapter: {\n *     key: OrbitAdapter.EVM,\n *     // implementation...\n *   }\n * };\n *\n * // Multiple adapters\n * const multiChainConfig: OrbitGenericAdapter<BaseAdapter> = {\n *   adapter: [\n *     { key: OrbitAdapter.EVM, ... },\n *     { key: OrbitAdapter.SOLANA, ... }\n *   ]\n * };\n * ```\n */\nexport type OrbitGenericAdapter<A extends { key: OrbitAdapter }> = {\n  adapter: A | A[];\n};\n","/**\n * @file This file provides a utility for creating a type-safe, bounded Zustand hook from a vanilla store.\n * This pattern is recommended by the official Zustand documentation to ensure full type\n * safety when integrating vanilla stores with React.\n *\n * @see https://docs.pmnd.rs/zustand/guides/typescript#bounded-usestore-hook-for-vanilla-stores\n */\n\nimport { StoreApi, useStore } from 'zustand';\n\n/**\n * A utility type that infers the state shape from a Zustand `StoreApi`.\n * It extracts the return type of the `getState` method.\n * @template S - The type of the Zustand store (`StoreApi`).\n */\ntype ExtractState<S> = S extends { getState: () => infer T } ? T : never;\n\n/**\n * Creates a bounded `useStore` hook from a vanilla Zustand store.\n *\n * This function takes a vanilla Zustand store instance and returns a React hook\n * that is pre-bound to that store. This approach provides a cleaner API and\n * enhances type inference, eliminating the need to pass the store instance\n * on every use.\n *\n * The returned hook supports two signatures:\n * 1. `useBoundedStore()`: Selects the entire state.\n * 2. `useBoundedStore(selector)`: Selects a slice of the state, returning only what the selector function specifies.\n *\n * @template S - The type of the Zustand store (`StoreApi`).\n * @param {S} store - The vanilla Zustand store instance to bind the hook to.\n * @returns {function} A fully typed React hook for accessing the store's state.\n */\nexport const createBoundedUseStore = ((store) => (selector) => useStore(store, selector)) as <\n  S extends StoreApi<unknown>,\n>(\n  store: S,\n) => {\n  // This implementation uses a Immediately Invoked Function Expression (IIFE)\n  // trick combined with casting to achieve the desired overloaded function signature in a concise way.\n  (): ExtractState<S>;\n  <T>(selector: (state: ExtractState<S>) => T): T;\n};\n","/**\n * @file\n * This module provides adapter selection functionality for the Orbit system.\n * Part of the core infrastructure for managing blockchain adapters.\n */\n\nimport { OrbitAdapter, OrbitGenericAdapter } from '../types';\n\n/**\n * Selects an appropriate adapter based on the provided key from either a single adapter\n * or an array of adapters.\n *\n * @typeParam A - Type extending basic adapter interface with a key property\n *\n * @param options - Selection configuration object\n * @param options.adapterKey - Target adapter key to search for\n * @param options.adapter - Single adapter or array of adapters to search within\n *\n * @returns Selected adapter or undefined if no suitable adapter found\n *\n * @remarks\n * If an array is provided but no matching adapter is found, falls back to the first adapter\n * in the array with a warning message.\n *\n * @example\n * ```typescript\n * // Single adapter usage\n * const singleResult = selectAdapterByKey({\n *   adapterKey: OrbitAdapter.SOLANA,\n *   adapter: { key: OrbitAdapter.SOLANA, connect: async () => {...} }\n * });\n *\n * // Multiple adapters usage\n * const multiResult = selectAdapterByKey({\n *   adapterKey: OrbitAdapter.EVM,\n *   adapter: [\n *     { key: OrbitAdapter.SOLANA, connect: async () => {...} },\n *     { key: OrbitAdapter.EVM, connect: async () => {...} }\n *   ]\n * });\n * ```\n *\n * @throws {Error} Logs error if adapter array is empty\n * @throws {Warning} Logs warning if requested adapter key not found in array\n */\nexport const selectAdapterByKey = <A extends { key: OrbitAdapter }>({\n  adapterKey,\n  adapter,\n}: { adapterKey: OrbitAdapter } & OrbitGenericAdapter<A>): A | undefined => {\n  if (Array.isArray(adapter)) {\n    if (adapter.length === 0) {\n      console.error('Adapter selection failed: The provided adapters array is empty.');\n      return undefined;\n    }\n\n    const foundAdapter = adapter.find((a) => a.key === adapterKey);\n\n    if (foundAdapter) {\n      return foundAdapter;\n    } else {\n      console.warn(\n        `No adapter found for key: \"${adapterKey}\". Falling back to the first available adapter: \"${adapter[0].key}\".`,\n      );\n      return adapter[0];\n    }\n  }\n  return adapter;\n};\n","/**\n * Checks whether the given chain ID belongs to a Solana network.\n * Supports common Solana network names: 'devnet', 'testnet', 'mainnet-beta', 'mainnet'.\n *\n * @param {number | string} chainId - The chain ID or chain name.\n * @returns {boolean} - True if the chain ID corresponds to a Solana network, false otherwise.\n */\nexport function isSolanaChain(chainId: number | string): boolean {\n  if (typeof chainId === 'string') {\n    return ['devnet', 'testnet', 'mainnet-beta', 'mainnet'].includes(chainId);\n  }\n  return false;\n}\n\n/**\n * Sets the chain ID to a Solana-specific format if the chain is a Solana network.\n *\n * @param {number | string} chainId - The original chain ID or name.\n * @returns {string | number} - The formatted chain ID prefixed with 'solana:' if Solana, otherwise the original.\n */\nexport function setChainId(chainId: number | string): string | number {\n  if (isSolanaChain(chainId)) {\n    return `solana:${chainId}`;\n  } else {\n    return chainId;\n  }\n}\n"]}
+{"version":3,"sources":["../src/types.ts","../src/utils/delay.ts","../src/utils/filterUniqueByKey.ts","../src/utils/formatWalletChainId.ts","../src/utils/formatWalletName.ts","../src/utils/getAdapterFromWalletType.ts","../src/utils/getParsedStorageItem.ts","../src/utils/getWalletTypeFromConnectorName.ts","../src/utils/impersonatedHelpers.ts","../src/utils/isSafeApp.ts","../src/utils/lastConnectedWalletHelpers.ts","../src/utils/recentConnectedWalletHelpers.ts","../src/utils/selectAdapterByKey.ts","../src/utils/waitFor.ts","../src/utils/%D1%81hainHelpers.ts"],"names":["OrbitAdapter","delay","value","ms","resolve","runTimeout","filterUniqueByKey","array","key","seenValues","item","keyValue","formatWalletChainId","chainId","connectedAdapter","WALLET_MAPPINGS","formatWalletName","walletName","getAdapterFromWalletType","walletType","getParsedStorageItem","error","getWalletTypeFromConnectorName","adapter","name","impersonatedHelpers","address","isSafeApp","lastConnectedWalletHelpers","recentConnectedWalletHelpers","wallets","selectAdapterByKey","adapterKey","foundAdapter","a","waitFor","predicate","maxChecks","checkIntervalMs","i","isSolanaChain","setChainId"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @file\n * Core type definitions for the Orbit blockchain adapter system.\n * This file contains fundamental enums and types that define the supported blockchain architectures\n * and their adapter interfaces.\n */\n\n// =================================================================================================\n// 1. ENUMS AND CORE TRANSACTION TYPES\n// =================================================================================================\n\n/**\n * Defines the supported blockchain adapters in the Orbit system.\n * Each adapter corresponds to a specific blockchain architecture and implements\n * the necessary interfaces for that chain's functionality.\n *\n * @enum {string}\n *\n * @example\n * ```typescript\n * // Using adapter types in configuration\n * const config = {\n *   chainType: OrbitAdapter.EVM,\n *   // other configuration...\n * };\n *\n * // Checking adapter compatibility\n * if (chainType === OrbitAdapter.SOLANA) {\n *   // Solana-specific logic\n * }\n * ```\n */\nexport enum OrbitAdapter {\n  /**\n   * For Ethereum Virtual Machine (EVM) compatible chains.\n   * Supports networks like:\n   * - Ethereum Mainnet\n   * - Polygon\n   * - Binance Smart Chain\n   * - Avalanche\n   * - Other EVM-compatible L1/L2 chains\n   */\n  EVM = 'evm',\n\n  /**\n   * For the Solana blockchain.\n   * Supports:\n   * - Solana Mainnet\n   * - Devnet\n   * - Testnet\n   */\n  SOLANA = 'solana',\n\n  /**\n   * For the Starknet L2 network.\n   * Supports:\n   * - Starknet Mainnet\n   * - Testnet (Goerli)\n   * - Other Starknet deployments\n   */\n  Starknet = 'starknet',\n}\n\n/**\n * Generic type for creating blockchain adapters with type safety.\n * This type ensures that all adapters implement the required interface\n * and are properly keyed by their blockchain type.\n *\n * @typeParam A - Type that extends the base adapter interface with a key property\n *\n * @property {A | A[]} adapter - Single adapter instance or array of adapters\n *\n * @example\n * ```typescript\n * // Single adapter implementation\n * interface EVMAdapter extends BaseAdapter {\n *   key: OrbitAdapter.EVM;\n *   // EVM-specific methods...\n * }\n * const evmConfig: OrbitGenericAdapter<EVMAdapter> = {\n *   adapter: {\n *     key: OrbitAdapter.EVM,\n *     // implementation...\n *   }\n * };\n *\n * // Multiple adapters\n * const multiChainConfig: OrbitGenericAdapter<EVMAdapter> = {\n *   adapter: [\n *     { key: OrbitAdapter.EVM, ... },\n *     { key: OrbitAdapter.SOLANA, ... }\n *   ]\n * };\n * ```\n */\nexport type OrbitGenericAdapter<A extends { key: OrbitAdapter }> = {\n  adapter: A | A[];\n};\n\nexport type BaseAdapter = {\n  /**\n   * Generates blockchain explorer URL\n   * @returns Explorer URL or undefined if not available\n   */\n  getExplorerUrl: (url?: string, chainId?: string | number) => string | undefined;\n\n  /** Optional method to resolve ENS-like names */\n  getName?: (address: string) => Promise<string | null>;\n\n  /** Optional method to get avatar for resolved names */\n  getAvatar?: (name: string) => Promise<string | null>;\n};\n\n/**\n * Type representing a wallet identifier in format \"OrbitAdapter:wallet\"\n * @example \"evm:metamask\" | \"solana:phantom\"\n */\nexport type WalletType = `${OrbitAdapter}:${string}`;\n","/**\n * @name delay\n *\n * Ensures the global 'window' object is available (if running in a browser-like environment),\n * then pauses execution for a specified duration, and finally resolves the Promise with the given value.\n *\n * This utility function is designed to be safe for use in Server-Side Rendering (SSR) environments.\n * It asynchronously waits for the 'window' object to be defined before starting the actual timer,\n * helping to prevent errors during the initial server render while still providing a time delay on the client.\n *\n * @template T - The type of the value being resolved.\n *\n * @param {T} value - The value to resolve the Promise with after the delay.\n * @param {number} ms - The number of milliseconds (delay) to wait before resolving the Promise after 'window' is available.\n *\n * @returns {Promise<T>} A Promise that resolves with the provided `value` after both the 'window' check and the delay (`ms`) are complete.\n *\n * @example\n * ```typescript\n * // Use this in an environment where 'window' might not be immediately available (e.g., Next.js component).\n * async function waitForWindowAndDelay() {\n * console.log(\"Start wait...\");\n * // This will wait for window, and then wait 100ms.\n * const data = await delay(\"Ready to connect\", 100);\n * console.log(data);\n * }\n * waitForWindowAndDelay();\n * ```\n */\nexport const delay = <T>(value: T, ms: number): Promise<T> => {\n  return new Promise((resolve) => {\n    const runTimeout = () => {\n      setTimeout(() => resolve(value), ms);\n    };\n\n    if (typeof window !== 'undefined') {\n      runTimeout();\n    } else {\n      setTimeout(runTimeout, 0);\n    }\n  });\n};\n","/**\n * Filters an array of objects to keep only the first occurrence of an object\n * based on a unique value of a specified key.\n *\n * This function is generic and type-safe. It iterates through the array and uses a\n * Set to track already encountered key values, effectively removing duplicates.\n *\n * @template T The type of the objects in the array.\n * @param {T[]} array - The array of objects to be filtered.\n * @param {keyof T} key - The object key (property name) whose values must be unique.\n * @returns {T[]} The filtered array containing only objects with unique key values.\n */\nexport function filterUniqueByKey<T>(array: T[], key: keyof T): T[] {\n  // 1. Create a Set to store the unique values of the key encountered so far.\n  // Set is a collection of unique values, which is perfect for fast duplicate checks.\n  const seenValues = new Set<T[keyof T]>();\n\n  // 2. Use the native Array.prototype.filter() method to create a new, filtered array.\n  return array.filter((item) => {\n    // Access the value of the specified key from the current object.\n    const keyValue = item[key];\n\n    // 3. Check if this key value has been seen before.\n    if (seenValues.has(keyValue)) {\n      // If the value is already in the Set, return false.\n      // This object is a duplicate and will be excluded from the result.\n      return false;\n    } else {\n      // If the value is encountered for the first time, add it to the Set.\n      seenValues.add(keyValue);\n      // Return true to include the object in the resulting unique array.\n      return true;\n    }\n  });\n}\n","import { OrbitAdapter } from '../types';\n\nexport function formatWalletChainId(chainId: string | number, connectedAdapter: OrbitAdapter) {\n  if (typeof chainId === 'string') {\n    return `${connectedAdapter}:${chainId}`;\n  } else {\n    return chainId;\n  }\n}\n","const WALLET_MAPPINGS = new Map([\n  ['Impersonated Connector', 'impersonatedwallet'],\n  ['Safe', 'safewallet'],\n  ['Trust', 'trustwallet'],\n  ['Trust Wallet', 'trustwallet'],\n  ['Brave Кошелек', 'bravewallet'],\n  ['Brave Wallet', 'bravewallet'],\n]);\n\nexport const formatWalletName = (walletName: string): string => {\n  return WALLET_MAPPINGS.get(walletName) ?? walletName.replace(/\\s+/g, '').toLowerCase();\n};\n","import { OrbitAdapter, WalletType } from '../types';\n\n/**\n * Extracts the adapter type from a wallet type string\n *\n * @example\n * ```typescript\n * // Returns OrbitAdapter.EVM\n * getAdapterFromWalletType('evm:metamask');\n *\n * // Returns OrbitAdapter.SOLANA\n * getAdapterFromWalletType('solana:phantom');\n *\n * // Returns OrbitAdapter.EVM (default)\n * getAdapterFromWalletType('unknown');\n * ```\n *\n * @param walletType - Wallet type in format \"chain:wallet\" (e.g. \"evm:metamask\", \"solana:phantom\")\n * @returns The corresponding {@link OrbitAdapter} type or EVM as default\n *\n * @remarks\n * The function splits the wallet type string by \":\" and takes the first part as the adapter type.\n * If the split fails or the first part is empty, it defaults to EVM adapter.\n */\nexport function getAdapterFromWalletType(walletType: WalletType): OrbitAdapter {\n  return (walletType?.split(':')[0] as OrbitAdapter.EVM) ?? OrbitAdapter.EVM;\n}\n","/**\n * Internal function for safely retrieving and parsing data from localStorage.\n *\n * @param key - The key for localStorage\n * @returns The parsed LastConnectedWallet object or undefined if data is not found/invalid\n */\nexport function getParsedStorageItem<ReturnType>(key: string): ReturnType | undefined {\n  if (typeof window === 'undefined') {\n    return undefined;\n  }\n\n  const item = window.localStorage.getItem(key);\n\n  // If the item is null (not set) or an empty string, return undefined\n  if (!item) {\n    return undefined;\n  }\n\n  try {\n    // Safe JSON parsing\n    return JSON.parse(item) as ReturnType;\n  } catch (error) {\n    // In case of a parsing error (e.g., invalid JSON), log the error and return undefined\n    console.error(`Error parsing ${key} from localStorage:`, error);\n    return undefined;\n  }\n}\n","import { OrbitAdapter } from '../types';\n\n/**\n * Generates a standardized wallet type identifier from adapter type and connector name\n *\n * @example\n * ```typescript\n * // Returns \"evm:metamask\"\n * getWalletTypeFromConnectorName(OrbitAdapter.EVM, \"MetaMask\");\n *\n * // Returns \"solana:phantom\"\n * getWalletTypeFromConnectorName(OrbitAdapter.SOLANA, \"Phantom\");\n *\n * // Returns \"evm:coinbasewallet\" (removes spaces)\n * getWalletTypeFromConnectorName(OrbitAdapter.EVM, \"Coinbase Wallet\");\n * ```\n *\n * @param adapter - The blockchain adapter type (e.g. EVM, SOLANA)\n * @param name - The wallet connector name (e.g. \"MetaMask\", \"Phantom\")\n * @returns A formatted wallet type string in format \"chain:wallet\"\n *\n * @remarks\n * The function:\n * 1. Combines adapter type with connector name using \":\" as separator\n * 2. Removes all whitespace from connector name\n * 3. Converts connector name to lowercase\n * This ensures consistent wallet type identifiers across the application\n */\nexport function getWalletTypeFromConnectorName(adapter: OrbitAdapter, name: string): string {\n  return `${adapter}:${name.replace(/\\s+/g, '').toLowerCase()}`;\n}\n","/**\n * Helper utilities for managing impersonated wallet addresses\n *\n * @remarks\n * These utilities are primarily used for development and testing purposes.\n * They provide a way to simulate different wallet addresses without actually connecting a wallet.\n * All data is stored in localStorage with the 'satellite-connect:impersonatedAddress' key.\n * Functions are safe to use in both browser and SSR environments.\n */\nexport const impersonatedHelpers = {\n  /**\n   * Currently impersonated address from localStorage\n   * Returns empty string if not set or in SSR context\n   */\n  impersonatedAddress:\n    typeof window !== 'undefined' ? (window.localStorage.getItem('satellite-connect:impersonatedAddress') ?? '') : '',\n\n  /**\n   * Stores an impersonated address in localStorage\n   *\n   * @example\n   * ```typescript\n   * // Set impersonated address\n   * impersonatedHelpers.setImpersonated('0x1234...5678');\n   * ```\n   *\n   * @param address - Ethereum or Solana address to impersonate\n   * @returns undefined in SSR context, void in browser\n   */\n  setImpersonated: (address: string) =>\n    typeof window !== 'undefined'\n      ? window.localStorage.setItem('satellite-connect:impersonatedAddress', address)\n      : undefined,\n\n  /**\n   * Retrieves the current impersonated address from localStorage\n   *\n   * @example\n   * ```typescript\n   * // Get current impersonated address\n   * const address = impersonatedHelpers.getImpersonated();\n   * if (address) {\n   *   console.log('Currently impersonating:', address);\n   * }\n   * ```\n   * @returns The impersonated address or undefined if not set or in SSR context\n   */\n  getImpersonated: () =>\n    typeof window !== 'undefined' ? window.localStorage.getItem('satellite-connect:impersonatedAddress') : undefined,\n\n  removeImpersonated: () =>\n    typeof window !== 'undefined' ? window.localStorage.removeItem('satellite-connect:impersonatedAddress') : undefined,\n};\n","export const isSafeApp = typeof window !== 'undefined' && window !== window.parent;\n","import { WalletType } from '../types';\nimport { getParsedStorageItem } from './getParsedStorageItem';\n\ntype LastConnectedWallet = { walletType: WalletType; chainId: number | string; address?: string };\n\n/**\n * Helper utilities for managing the last connected wallet state\n *\n * @remarks\n * All data is stored in localStorage with the 'orbit-core:lastConnectedWallet' key.\n * Functions are safe to use in both browser and SSR environments.\n */\nexport const lastConnectedWalletHelpers = {\n  // Key used for localStorage\n  STORAGE_KEY: 'orbit-core:lastConnectedWallet',\n\n  /**\n   * The value of the last connected wallet, initialized when the module loads.\n   * Returns undefined if not set, invalid, or in an SSR context.\n   */\n  lastConnectedWallet: getParsedStorageItem<LastConnectedWallet>('orbit-core:lastConnectedWallet'),\n\n  /**\n   * Stores the last connected wallet data in localStorage.\n   *\n   * @param data - Object containing the wallet type and chain ID.\n   * @returns undefined in SSR context, void in browser\n   */\n  setLastConnectedWallet: ({ walletType, chainId, address }: LastConnectedWallet) =>\n    typeof window !== 'undefined'\n      ? window.localStorage.setItem(\n          lastConnectedWalletHelpers.STORAGE_KEY,\n          JSON.stringify({ walletType, chainId, address }),\n        )\n      : undefined,\n\n  /**\n   * Retrieves the current last connected wallet data from localStorage.\n   *\n   * @returns The LastConnectedWallet object or undefined if not set or in SSR context\n   */\n  getLastConnectedWallet: () => getParsedStorageItem<LastConnectedWallet>(lastConnectedWalletHelpers.STORAGE_KEY),\n\n  /**\n   * Removes the last connected wallet data from localStorage.\n   *\n   * @returns undefined in SSR context, void in browser\n   */\n  removeLastConnectedWallet: () =>\n    typeof window !== 'undefined' ? window.localStorage.removeItem(lastConnectedWalletHelpers.STORAGE_KEY) : undefined,\n};\n","import { OrbitAdapter } from '../types';\nimport { getParsedStorageItem } from './getParsedStorageItem';\n\nexport type RecentConnectedWallet = Record<OrbitAdapter, Record<string, boolean>>;\n\n/**\n * Helper utilities for managing the last connected wallet state\n *\n * @remarks\n * All data is stored in localStorage with the 'orbit-core:lastConnectedWallet' key.\n * Functions are safe to use in both browser and SSR environments.\n */\nexport const recentConnectedWalletHelpers = {\n  // Key used for localStorage\n  STORAGE_KEY: 'orbit-core:recentConnectedWallet',\n\n  /**\n   * The value of the last connected wallet, initialized when the module loads.\n   * Returns undefined if not set, invalid, or in an SSR context.\n   */\n  recentConnectedWallet: getParsedStorageItem<RecentConnectedWallet>('orbit-core:recentConnectedWallets'),\n\n  /**\n   * Stores the last connected wallet data in localStorage.\n   *\n   * @param wallets - RecentConnectedWallet\n   * @returns undefined in SSR context, void in browser\n   */\n  setRecentConnectedWallet: (wallets: RecentConnectedWallet) =>\n    typeof window !== 'undefined'\n      ? window.localStorage.setItem(recentConnectedWalletHelpers.STORAGE_KEY, JSON.stringify(wallets))\n      : undefined,\n\n  /**\n   * Retrieves the current last connected wallet data from localStorage.\n   *\n   * @returns The LastConnectedWallet object or undefined if not set or in SSR context\n   */\n  getRecentConnectedWallet: () => getParsedStorageItem<RecentConnectedWallet>(recentConnectedWalletHelpers.STORAGE_KEY),\n\n  /**\n   * Removes the last connected wallet data from localStorage.\n   *\n   * @returns undefined in SSR context, void in browser\n   */\n  removeRecentConnectedWallet: () =>\n    typeof window !== 'undefined'\n      ? window.localStorage.removeItem(recentConnectedWalletHelpers.STORAGE_KEY)\n      : undefined,\n};\n","/**\n * @file\n * This module provides adapter selection functionality for the Orbit system.\n * Part of the core infrastructure for managing blockchain adapters.\n */\n\nimport { OrbitAdapter, OrbitGenericAdapter } from '../types';\n\n/**\n * Selects an appropriate adapter based on the provided key from either a single adapter\n * or an array of adapters.\n *\n * @typeParam A - Type extending basic adapter interface with a key property\n *\n * @param options - Selection configuration object\n * @param options.adapterKey - Target adapter key to search for\n * @param options.adapter - Single adapter or array of adapters to search within\n *\n * @returns Selected adapter or undefined if no suitable adapter found\n *\n * @remarks\n * If an array is provided but no matching adapter is found, falls back to the first adapter\n * in the array with a warning message.\n *\n * @example\n * ```typescript\n * // Single adapter usage\n * const singleResult = selectAdapterByKey({\n *   adapterKey: OrbitAdapter.SOLANA,\n *   adapter: { key: OrbitAdapter.SOLANA, connect: async () => {...} }\n * });\n *\n * // Multiple adapters usage\n * const multiResult = selectAdapterByKey({\n *   adapterKey: OrbitAdapter.EVM,\n *   adapter: [\n *     { key: OrbitAdapter.SOLANA, connect: async () => {...} },\n *     { key: OrbitAdapter.EVM, connect: async () => {...} }\n *   ]\n * });\n * ```\n *\n * @throws {Error} Logs error if adapter array is empty\n * @throws {Warning} Logs warning if requested adapter key not found in array\n */\nexport const selectAdapterByKey = <A extends { key: OrbitAdapter }>({\n  adapterKey,\n  adapter,\n}: { adapterKey: OrbitAdapter } & OrbitGenericAdapter<A>): A | undefined => {\n  if (Array.isArray(adapter)) {\n    if (adapter.length === 0) {\n      console.error('Adapter selection failed: The provided adapters array is empty.');\n      return undefined;\n    }\n\n    const foundAdapter = adapter.find((a) => a.key === adapterKey);\n\n    if (foundAdapter) {\n      return foundAdapter;\n    } else {\n      console.warn(\n        `No adapter found for key: \"${adapterKey}\". Falling back to the first available adapter: \"${adapter[0].key}\".`,\n      );\n      return adapter[0];\n    }\n  }\n  return adapter;\n};\n","export async function waitFor(\n  predicate: () => boolean | undefined,\n  maxChecks: number = 50,\n  checkIntervalMs: number = 200,\n) {\n  for (let i = 0; i < maxChecks; i++) {\n    if (predicate()) {\n      return;\n    }\n    await new Promise((resolve) => setTimeout(resolve, checkIntervalMs));\n  }\n  throw new Error('Predicate not fulfilled in time');\n}\n","/**\n * Checks whether the given chain ID belongs to a Solana network.\n * Supports common Solana network names: 'devnet', 'testnet', 'mainnet-beta', 'mainnet'.\n *\n * @param {number | string} chainId - The chain ID or chain name.\n * @returns {boolean} - True if the chain ID corresponds to a Solana network, false otherwise.\n */\nexport function isSolanaChain(chainId: number | string): boolean {\n  if (typeof chainId === 'string') {\n    return ['devnet', 'testnet', 'mainnet-beta', 'mainnet'].includes(chainId);\n  }\n  return false;\n}\n\n/**\n * Sets the chain ID to a Solana-specific format if the chain is a Solana network.\n *\n * @param {number | string} chainId - The original chain ID or name.\n * @returns {string | number} - The formatted chain ID prefixed with 'solana:' if Solana, otherwise the original.\n */\nexport function setChainId(chainId: number | string): string | number {\n  if (isSolanaChain(chainId)) {\n    return `solana:${chainId}`;\n  } else {\n    return chainId;\n  }\n}\n"]}

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import {useStore}from'zustand';var o=(r=>(r.EVM="evm",r.SOLANA="solana",r.Starknet="starknet",r))(o||{});var d=(e=>t=>useStore(e,t));var l=({adapterKey:e,adapter:t})=>{if(Array.isArray(t)){if(t.length===0){console.error("Adapter selection failed: The provided adapters array is empty.");return}let n=t.find(r=>r.key===e);return n||(console.warn(`No adapter found for key: "${e}". Falling back to the first available adapter: "${t[0].key}".`),t[0])}return t};function i(e){return typeof e=="string"?["devnet","testnet","mainnet-beta","mainnet"].includes(e):false}function x(e){return i(e)?`solana:${e}`:e}export{o as OrbitAdapter,d as createBoundedUseStore,i as isSolanaChain,l as selectAdapterByKey,x as setChainId};//# sourceMappingURL=index.mjs.map
+var l=(n=>(n.EVM="evm",n.SOLANA="solana",n.Starknet="starknet",n))(l||{});var c=(e,t)=>new Promise(r=>{let n=()=>{setTimeout(()=>r(e),t);};typeof window<"u"?n():setTimeout(n,0);});function u(e,t){let r=new Set;return e.filter(n=>{let a=n[t];return r.has(a)?false:(r.add(a),true)})}function g(e,t){return typeof e=="string"?`${t}:${e}`:e}var s=new Map([["Impersonated Connector","impersonatedwallet"],["Safe","safewallet"],["Trust","trustwallet"],["Trust Wallet","trustwallet"],["Brave \u041A\u043E\u0448\u0435\u043B\u0435\u043A","bravewallet"],["Brave Wallet","bravewallet"]]),A=e=>s.get(e)??e.replace(/\s+/g,"").toLowerCase();function W(e){return e?.split(":")[0]??"evm"}function o(e){if(typeof window>"u")return;let t=window.localStorage.getItem(e);if(t)try{return JSON.parse(t)}catch(r){console.error(`Error parsing ${e} from localStorage:`,r);return}}function O(e,t){return `${e}:${t.replace(/\s+/g,"").toLowerCase()}`}var R={impersonatedAddress:typeof window<"u"?window.localStorage.getItem("satellite-connect:impersonatedAddress")??"":"",setImpersonated:e=>typeof window<"u"?window.localStorage.setItem("satellite-connect:impersonatedAddress",e):void 0,getImpersonated:()=>typeof window<"u"?window.localStorage.getItem("satellite-connect:impersonatedAddress"):void 0,removeImpersonated:()=>typeof window<"u"?window.localStorage.removeItem("satellite-connect:impersonatedAddress"):void 0};var v=typeof window<"u"&&window!==window.parent;var i={STORAGE_KEY:"orbit-core:lastConnectedWallet",lastConnectedWallet:o("orbit-core:lastConnectedWallet"),setLastConnectedWallet:({walletType:e,chainId:t,address:r})=>typeof window<"u"?window.localStorage.setItem(i.STORAGE_KEY,JSON.stringify({walletType:e,chainId:t,address:r})):void 0,getLastConnectedWallet:()=>o(i.STORAGE_KEY),removeLastConnectedWallet:()=>typeof window<"u"?window.localStorage.removeItem(i.STORAGE_KEY):void 0};var d={STORAGE_KEY:"orbit-core:recentConnectedWallet",recentConnectedWallet:o("orbit-core:recentConnectedWallets"),setRecentConnectedWallet:e=>typeof window<"u"?window.localStorage.setItem(d.STORAGE_KEY,JSON.stringify(e)):void 0,getRecentConnectedWallet:()=>o(d.STORAGE_KEY),removeRecentConnectedWallet:()=>typeof window<"u"?window.localStorage.removeItem(d.STORAGE_KEY):void 0};var $=({adapterKey:e,adapter:t})=>{if(Array.isArray(t)){if(t.length===0){console.error("Adapter selection failed: The provided adapters array is empty.");return}let r=t.find(n=>n.key===e);return r||(console.warn(`No adapter found for key: "${e}". Falling back to the first available adapter: "${t[0].key}".`),t[0])}return t};async function N(e,t=50,r=200){for(let n=0;n<t;n++){if(e())return;await new Promise(a=>setTimeout(a,r));}throw new Error("Predicate not fulfilled in time")}function p(e){return typeof e=="string"?["devnet","testnet","mainnet-beta","mainnet"].includes(e):false}function h(e){return p(e)?`solana:${e}`:e}export{l as OrbitAdapter,c as delay,u as filterUniqueByKey,g as formatWalletChainId,A as formatWalletName,W as getAdapterFromWalletType,o as getParsedStorageItem,O as getWalletTypeFromConnectorName,R as impersonatedHelpers,v as isSafeApp,p as isSolanaChain,i as lastConnectedWalletHelpers,d as recentConnectedWalletHelpers,$ as selectAdapterByKey,h as setChainId,N as waitFor};//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts","../src/utils/createBoundedUseStore.ts","../src/utils/selectAdapterByKey.ts","../src/utils/%D1%81hainHelpers.ts"],"names":["OrbitAdapter","createBoundedUseStore","store","selector","useStore","selectAdapterByKey","adapterKey","adapter","foundAdapter","a","isSolanaChain","chainId","setChainId"],"mappings":"+BAgCO,IAAKA,CAAAA,CAAAA,CAAAA,CAAAA,GAUVA,CAAAA,CAAA,GAAA,CAAM,KAAA,CASNA,CAAAA,CAAA,OAAS,QAAA,CASTA,CAAAA,CAAA,QAAA,CAAW,UAAA,CA5BDA,CAAAA,CAAAA,EAAAA,CAAAA,EAAA,EAAA,ECCL,IAAMC,CAAAA,EAA0BC,CAAAA,EAAWC,GAAaC,QAAAA,CAASF,CAAAA,CAAOC,CAAQ,CAAA,ECYhF,IAAME,CAAAA,CAAqB,CAAkC,CAClE,UAAA,CAAAC,CAAAA,CACA,OAAA,CAAAC,CACF,CAAA,GAA4E,CAC1E,GAAI,KAAA,CAAM,OAAA,CAAQA,CAAO,CAAA,CAAG,CAC1B,GAAIA,CAAAA,CAAQ,MAAA,GAAW,CAAA,CAAG,CACxB,OAAA,CAAQ,KAAA,CAAM,iEAAiE,CAAA,CAC/E,MACF,CAEA,IAAMC,CAAAA,CAAeD,CAAAA,CAAQ,IAAA,CAAME,GAAMA,CAAAA,CAAE,GAAA,GAAQH,CAAU,CAAA,CAE7D,OAAIE,CAAAA,GAGF,QAAQ,IAAA,CACN,CAAA,2BAAA,EAA8BF,CAAU,CAAA,iDAAA,EAAoDC,CAAAA,CAAQ,CAAC,EAAE,GAAG,CAAA,EAAA,CAC5G,CAAA,CACOA,CAAAA,CAAQ,CAAC,CAAA,CAEpB,CACA,OAAOA,CACT,EC5DO,SAASG,CAAAA,CAAcC,CAAAA,CAAmC,CAC/D,OAAI,OAAOA,CAAAA,EAAY,QAAA,CACd,CAAC,QAAA,CAAU,UAAW,cAAA,CAAgB,SAAS,CAAA,CAAE,QAAA,CAASA,CAAO,CAAA,CAEnE,KACT,CAQO,SAASC,CAAAA,CAAWD,CAAAA,CAA2C,CACpE,OAAID,CAAAA,CAAcC,CAAO,CAAA,CAChB,CAAA,OAAA,EAAUA,CAAO,CAAA,CAAA,CAEjBA,CAEX","file":"index.mjs","sourcesContent":["/**\n * @file\n * Core type definitions for the Orbit blockchain adapter system.\n * This file contains fundamental enums and types that define the supported blockchain architectures\n * and their adapter interfaces.\n */\n\n// =================================================================================================\n// 1. ENUMS AND CORE TRANSACTION TYPES\n// =================================================================================================\n\n/**\n * Defines the supported blockchain adapters in the Orbit system.\n * Each adapter corresponds to a specific blockchain architecture and implements\n * the necessary interfaces for that chain's functionality.\n *\n * @enum {string}\n *\n * @example\n * ```typescript\n * // Using adapter types in configuration\n * const config = {\n *   chainType: OrbitAdapter.EVM,\n *   // other configuration...\n * };\n *\n * // Checking adapter compatibility\n * if (chainType === OrbitAdapter.SOLANA) {\n *   // Solana-specific logic\n * }\n * ```\n */\nexport enum OrbitAdapter {\n  /**\n   * For Ethereum Virtual Machine (EVM) compatible chains.\n   * Supports networks like:\n   * - Ethereum Mainnet\n   * - Polygon\n   * - Binance Smart Chain\n   * - Avalanche\n   * - Other EVM-compatible L1/L2 chains\n   */\n  EVM = 'evm',\n\n  /**\n   * For the Solana blockchain.\n   * Supports:\n   * - Solana Mainnet\n   * - Devnet\n   * - Testnet\n   */\n  SOLANA = 'solana',\n\n  /**\n   * For the Starknet L2 network.\n   * Supports:\n   * - Starknet Mainnet\n   * - Testnet (Goerli)\n   * - Other Starknet deployments\n   */\n  Starknet = 'starknet',\n}\n\n/**\n * Generic type for creating blockchain adapters with type safety.\n * This type ensures that all adapters implement the required interface\n * and are properly keyed by their blockchain type.\n *\n * @typeParam A - Type that extends the base adapter interface with a key property\n *\n * @property {A | A[]} adapter - Single adapter instance or array of adapters\n *\n * @example\n * ```typescript\n * // Single adapter implementation\n * interface EVMAdapter extends BaseAdapter {\n *   key: OrbitAdapter.EVM;\n *   // EVM-specific methods...\n * }\n * const evmConfig: OrbitGenericAdapter<EVMAdapter> = {\n *   adapter: {\n *     key: OrbitAdapter.EVM,\n *     // implementation...\n *   }\n * };\n *\n * // Multiple adapters\n * const multiChainConfig: OrbitGenericAdapter<BaseAdapter> = {\n *   adapter: [\n *     { key: OrbitAdapter.EVM, ... },\n *     { key: OrbitAdapter.SOLANA, ... }\n *   ]\n * };\n * ```\n */\nexport type OrbitGenericAdapter<A extends { key: OrbitAdapter }> = {\n  adapter: A | A[];\n};\n","/**\n * @file This file provides a utility for creating a type-safe, bounded Zustand hook from a vanilla store.\n * This pattern is recommended by the official Zustand documentation to ensure full type\n * safety when integrating vanilla stores with React.\n *\n * @see https://docs.pmnd.rs/zustand/guides/typescript#bounded-usestore-hook-for-vanilla-stores\n */\n\nimport { StoreApi, useStore } from 'zustand';\n\n/**\n * A utility type that infers the state shape from a Zustand `StoreApi`.\n * It extracts the return type of the `getState` method.\n * @template S - The type of the Zustand store (`StoreApi`).\n */\ntype ExtractState<S> = S extends { getState: () => infer T } ? T : never;\n\n/**\n * Creates a bounded `useStore` hook from a vanilla Zustand store.\n *\n * This function takes a vanilla Zustand store instance and returns a React hook\n * that is pre-bound to that store. This approach provides a cleaner API and\n * enhances type inference, eliminating the need to pass the store instance\n * on every use.\n *\n * The returned hook supports two signatures:\n * 1. `useBoundedStore()`: Selects the entire state.\n * 2. `useBoundedStore(selector)`: Selects a slice of the state, returning only what the selector function specifies.\n *\n * @template S - The type of the Zustand store (`StoreApi`).\n * @param {S} store - The vanilla Zustand store instance to bind the hook to.\n * @returns {function} A fully typed React hook for accessing the store's state.\n */\nexport const createBoundedUseStore = ((store) => (selector) => useStore(store, selector)) as <\n  S extends StoreApi<unknown>,\n>(\n  store: S,\n) => {\n  // This implementation uses a Immediately Invoked Function Expression (IIFE)\n  // trick combined with casting to achieve the desired overloaded function signature in a concise way.\n  (): ExtractState<S>;\n  <T>(selector: (state: ExtractState<S>) => T): T;\n};\n","/**\n * @file\n * This module provides adapter selection functionality for the Orbit system.\n * Part of the core infrastructure for managing blockchain adapters.\n */\n\nimport { OrbitAdapter, OrbitGenericAdapter } from '../types';\n\n/**\n * Selects an appropriate adapter based on the provided key from either a single adapter\n * or an array of adapters.\n *\n * @typeParam A - Type extending basic adapter interface with a key property\n *\n * @param options - Selection configuration object\n * @param options.adapterKey - Target adapter key to search for\n * @param options.adapter - Single adapter or array of adapters to search within\n *\n * @returns Selected adapter or undefined if no suitable adapter found\n *\n * @remarks\n * If an array is provided but no matching adapter is found, falls back to the first adapter\n * in the array with a warning message.\n *\n * @example\n * ```typescript\n * // Single adapter usage\n * const singleResult = selectAdapterByKey({\n *   adapterKey: OrbitAdapter.SOLANA,\n *   adapter: { key: OrbitAdapter.SOLANA, connect: async () => {...} }\n * });\n *\n * // Multiple adapters usage\n * const multiResult = selectAdapterByKey({\n *   adapterKey: OrbitAdapter.EVM,\n *   adapter: [\n *     { key: OrbitAdapter.SOLANA, connect: async () => {...} },\n *     { key: OrbitAdapter.EVM, connect: async () => {...} }\n *   ]\n * });\n * ```\n *\n * @throws {Error} Logs error if adapter array is empty\n * @throws {Warning} Logs warning if requested adapter key not found in array\n */\nexport const selectAdapterByKey = <A extends { key: OrbitAdapter }>({\n  adapterKey,\n  adapter,\n}: { adapterKey: OrbitAdapter } & OrbitGenericAdapter<A>): A | undefined => {\n  if (Array.isArray(adapter)) {\n    if (adapter.length === 0) {\n      console.error('Adapter selection failed: The provided adapters array is empty.');\n      return undefined;\n    }\n\n    const foundAdapter = adapter.find((a) => a.key === adapterKey);\n\n    if (foundAdapter) {\n      return foundAdapter;\n    } else {\n      console.warn(\n        `No adapter found for key: \"${adapterKey}\". Falling back to the first available adapter: \"${adapter[0].key}\".`,\n      );\n      return adapter[0];\n    }\n  }\n  return adapter;\n};\n","/**\n * Checks whether the given chain ID belongs to a Solana network.\n * Supports common Solana network names: 'devnet', 'testnet', 'mainnet-beta', 'mainnet'.\n *\n * @param {number | string} chainId - The chain ID or chain name.\n * @returns {boolean} - True if the chain ID corresponds to a Solana network, false otherwise.\n */\nexport function isSolanaChain(chainId: number | string): boolean {\n  if (typeof chainId === 'string') {\n    return ['devnet', 'testnet', 'mainnet-beta', 'mainnet'].includes(chainId);\n  }\n  return false;\n}\n\n/**\n * Sets the chain ID to a Solana-specific format if the chain is a Solana network.\n *\n * @param {number | string} chainId - The original chain ID or name.\n * @returns {string | number} - The formatted chain ID prefixed with 'solana:' if Solana, otherwise the original.\n */\nexport function setChainId(chainId: number | string): string | number {\n  if (isSolanaChain(chainId)) {\n    return `solana:${chainId}`;\n  } else {\n    return chainId;\n  }\n}\n"]}
+{"version":3,"sources":["../src/types.ts","../src/utils/delay.ts","../src/utils/filterUniqueByKey.ts","../src/utils/formatWalletChainId.ts","../src/utils/formatWalletName.ts","../src/utils/getAdapterFromWalletType.ts","../src/utils/getParsedStorageItem.ts","../src/utils/getWalletTypeFromConnectorName.ts","../src/utils/impersonatedHelpers.ts","../src/utils/isSafeApp.ts","../src/utils/lastConnectedWalletHelpers.ts","../src/utils/recentConnectedWalletHelpers.ts","../src/utils/selectAdapterByKey.ts","../src/utils/waitFor.ts","../src/utils/%D1%81hainHelpers.ts"],"names":["OrbitAdapter","delay","value","ms","resolve","runTimeout","filterUniqueByKey","array","key","seenValues","item","keyValue","formatWalletChainId","chainId","connectedAdapter","WALLET_MAPPINGS","formatWalletName","walletName","getAdapterFromWalletType","walletType","getParsedStorageItem","error","getWalletTypeFromConnectorName","adapter","name","impersonatedHelpers","address","isSafeApp","lastConnectedWalletHelpers","recentConnectedWalletHelpers","wallets","selectAdapterByKey","adapterKey","foundAdapter","a","waitFor","predicate","maxChecks","checkIntervalMs","i","isSolanaChain","setChainId"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * @file\n * Core type definitions for the Orbit blockchain adapter system.\n * This file contains fundamental enums and types that define the supported blockchain architectures\n * and their adapter interfaces.\n */\n\n// =================================================================================================\n// 1. ENUMS AND CORE TRANSACTION TYPES\n// =================================================================================================\n\n/**\n * Defines the supported blockchain adapters in the Orbit system.\n * Each adapter corresponds to a specific blockchain architecture and implements\n * the necessary interfaces for that chain's functionality.\n *\n * @enum {string}\n *\n * @example\n * ```typescript\n * // Using adapter types in configuration\n * const config = {\n *   chainType: OrbitAdapter.EVM,\n *   // other configuration...\n * };\n *\n * // Checking adapter compatibility\n * if (chainType === OrbitAdapter.SOLANA) {\n *   // Solana-specific logic\n * }\n * ```\n */\nexport enum OrbitAdapter {\n  /**\n   * For Ethereum Virtual Machine (EVM) compatible chains.\n   * Supports networks like:\n   * - Ethereum Mainnet\n   * - Polygon\n   * - Binance Smart Chain\n   * - Avalanche\n   * - Other EVM-compatible L1/L2 chains\n   */\n  EVM = 'evm',\n\n  /**\n   * For the Solana blockchain.\n   * Supports:\n   * - Solana Mainnet\n   * - Devnet\n   * - Testnet\n   */\n  SOLANA = 'solana',\n\n  /**\n   * For the Starknet L2 network.\n   * Supports:\n   * - Starknet Mainnet\n   * - Testnet (Goerli)\n   * - Other Starknet deployments\n   */\n  Starknet = 'starknet',\n}\n\n/**\n * Generic type for creating blockchain adapters with type safety.\n * This type ensures that all adapters implement the required interface\n * and are properly keyed by their blockchain type.\n *\n * @typeParam A - Type that extends the base adapter interface with a key property\n *\n * @property {A | A[]} adapter - Single adapter instance or array of adapters\n *\n * @example\n * ```typescript\n * // Single adapter implementation\n * interface EVMAdapter extends BaseAdapter {\n *   key: OrbitAdapter.EVM;\n *   // EVM-specific methods...\n * }\n * const evmConfig: OrbitGenericAdapter<EVMAdapter> = {\n *   adapter: {\n *     key: OrbitAdapter.EVM,\n *     // implementation...\n *   }\n * };\n *\n * // Multiple adapters\n * const multiChainConfig: OrbitGenericAdapter<EVMAdapter> = {\n *   adapter: [\n *     { key: OrbitAdapter.EVM, ... },\n *     { key: OrbitAdapter.SOLANA, ... }\n *   ]\n * };\n * ```\n */\nexport type OrbitGenericAdapter<A extends { key: OrbitAdapter }> = {\n  adapter: A | A[];\n};\n\nexport type BaseAdapter = {\n  /**\n   * Generates blockchain explorer URL\n   * @returns Explorer URL or undefined if not available\n   */\n  getExplorerUrl: (url?: string, chainId?: string | number) => string | undefined;\n\n  /** Optional method to resolve ENS-like names */\n  getName?: (address: string) => Promise<string | null>;\n\n  /** Optional method to get avatar for resolved names */\n  getAvatar?: (name: string) => Promise<string | null>;\n};\n\n/**\n * Type representing a wallet identifier in format \"OrbitAdapter:wallet\"\n * @example \"evm:metamask\" | \"solana:phantom\"\n */\nexport type WalletType = `${OrbitAdapter}:${string}`;\n","/**\n * @name delay\n *\n * Ensures the global 'window' object is available (if running in a browser-like environment),\n * then pauses execution for a specified duration, and finally resolves the Promise with the given value.\n *\n * This utility function is designed to be safe for use in Server-Side Rendering (SSR) environments.\n * It asynchronously waits for the 'window' object to be defined before starting the actual timer,\n * helping to prevent errors during the initial server render while still providing a time delay on the client.\n *\n * @template T - The type of the value being resolved.\n *\n * @param {T} value - The value to resolve the Promise with after the delay.\n * @param {number} ms - The number of milliseconds (delay) to wait before resolving the Promise after 'window' is available.\n *\n * @returns {Promise<T>} A Promise that resolves with the provided `value` after both the 'window' check and the delay (`ms`) are complete.\n *\n * @example\n * ```typescript\n * // Use this in an environment where 'window' might not be immediately available (e.g., Next.js component).\n * async function waitForWindowAndDelay() {\n * console.log(\"Start wait...\");\n * // This will wait for window, and then wait 100ms.\n * const data = await delay(\"Ready to connect\", 100);\n * console.log(data);\n * }\n * waitForWindowAndDelay();\n * ```\n */\nexport const delay = <T>(value: T, ms: number): Promise<T> => {\n  return new Promise((resolve) => {\n    const runTimeout = () => {\n      setTimeout(() => resolve(value), ms);\n    };\n\n    if (typeof window !== 'undefined') {\n      runTimeout();\n    } else {\n      setTimeout(runTimeout, 0);\n    }\n  });\n};\n","/**\n * Filters an array of objects to keep only the first occurrence of an object\n * based on a unique value of a specified key.\n *\n * This function is generic and type-safe. It iterates through the array and uses a\n * Set to track already encountered key values, effectively removing duplicates.\n *\n * @template T The type of the objects in the array.\n * @param {T[]} array - The array of objects to be filtered.\n * @param {keyof T} key - The object key (property name) whose values must be unique.\n * @returns {T[]} The filtered array containing only objects with unique key values.\n */\nexport function filterUniqueByKey<T>(array: T[], key: keyof T): T[] {\n  // 1. Create a Set to store the unique values of the key encountered so far.\n  // Set is a collection of unique values, which is perfect for fast duplicate checks.\n  const seenValues = new Set<T[keyof T]>();\n\n  // 2. Use the native Array.prototype.filter() method to create a new, filtered array.\n  return array.filter((item) => {\n    // Access the value of the specified key from the current object.\n    const keyValue = item[key];\n\n    // 3. Check if this key value has been seen before.\n    if (seenValues.has(keyValue)) {\n      // If the value is already in the Set, return false.\n      // This object is a duplicate and will be excluded from the result.\n      return false;\n    } else {\n      // If the value is encountered for the first time, add it to the Set.\n      seenValues.add(keyValue);\n      // Return true to include the object in the resulting unique array.\n      return true;\n    }\n  });\n}\n","import { OrbitAdapter } from '../types';\n\nexport function formatWalletChainId(chainId: string | number, connectedAdapter: OrbitAdapter) {\n  if (typeof chainId === 'string') {\n    return `${connectedAdapter}:${chainId}`;\n  } else {\n    return chainId;\n  }\n}\n","const WALLET_MAPPINGS = new Map([\n  ['Impersonated Connector', 'impersonatedwallet'],\n  ['Safe', 'safewallet'],\n  ['Trust', 'trustwallet'],\n  ['Trust Wallet', 'trustwallet'],\n  ['Brave Кошелек', 'bravewallet'],\n  ['Brave Wallet', 'bravewallet'],\n]);\n\nexport const formatWalletName = (walletName: string): string => {\n  return WALLET_MAPPINGS.get(walletName) ?? walletName.replace(/\\s+/g, '').toLowerCase();\n};\n","import { OrbitAdapter, WalletType } from '../types';\n\n/**\n * Extracts the adapter type from a wallet type string\n *\n * @example\n * ```typescript\n * // Returns OrbitAdapter.EVM\n * getAdapterFromWalletType('evm:metamask');\n *\n * // Returns OrbitAdapter.SOLANA\n * getAdapterFromWalletType('solana:phantom');\n *\n * // Returns OrbitAdapter.EVM (default)\n * getAdapterFromWalletType('unknown');\n * ```\n *\n * @param walletType - Wallet type in format \"chain:wallet\" (e.g. \"evm:metamask\", \"solana:phantom\")\n * @returns The corresponding {@link OrbitAdapter} type or EVM as default\n *\n * @remarks\n * The function splits the wallet type string by \":\" and takes the first part as the adapter type.\n * If the split fails or the first part is empty, it defaults to EVM adapter.\n */\nexport function getAdapterFromWalletType(walletType: WalletType): OrbitAdapter {\n  return (walletType?.split(':')[0] as OrbitAdapter.EVM) ?? OrbitAdapter.EVM;\n}\n","/**\n * Internal function for safely retrieving and parsing data from localStorage.\n *\n * @param key - The key for localStorage\n * @returns The parsed LastConnectedWallet object or undefined if data is not found/invalid\n */\nexport function getParsedStorageItem<ReturnType>(key: string): ReturnType | undefined {\n  if (typeof window === 'undefined') {\n    return undefined;\n  }\n\n  const item = window.localStorage.getItem(key);\n\n  // If the item is null (not set) or an empty string, return undefined\n  if (!item) {\n    return undefined;\n  }\n\n  try {\n    // Safe JSON parsing\n    return JSON.parse(item) as ReturnType;\n  } catch (error) {\n    // In case of a parsing error (e.g., invalid JSON), log the error and return undefined\n    console.error(`Error parsing ${key} from localStorage:`, error);\n    return undefined;\n  }\n}\n","import { OrbitAdapter } from '../types';\n\n/**\n * Generates a standardized wallet type identifier from adapter type and connector name\n *\n * @example\n * ```typescript\n * // Returns \"evm:metamask\"\n * getWalletTypeFromConnectorName(OrbitAdapter.EVM, \"MetaMask\");\n *\n * // Returns \"solana:phantom\"\n * getWalletTypeFromConnectorName(OrbitAdapter.SOLANA, \"Phantom\");\n *\n * // Returns \"evm:coinbasewallet\" (removes spaces)\n * getWalletTypeFromConnectorName(OrbitAdapter.EVM, \"Coinbase Wallet\");\n * ```\n *\n * @param adapter - The blockchain adapter type (e.g. EVM, SOLANA)\n * @param name - The wallet connector name (e.g. \"MetaMask\", \"Phantom\")\n * @returns A formatted wallet type string in format \"chain:wallet\"\n *\n * @remarks\n * The function:\n * 1. Combines adapter type with connector name using \":\" as separator\n * 2. Removes all whitespace from connector name\n * 3. Converts connector name to lowercase\n * This ensures consistent wallet type identifiers across the application\n */\nexport function getWalletTypeFromConnectorName(adapter: OrbitAdapter, name: string): string {\n  return `${adapter}:${name.replace(/\\s+/g, '').toLowerCase()}`;\n}\n","/**\n * Helper utilities for managing impersonated wallet addresses\n *\n * @remarks\n * These utilities are primarily used for development and testing purposes.\n * They provide a way to simulate different wallet addresses without actually connecting a wallet.\n * All data is stored in localStorage with the 'satellite-connect:impersonatedAddress' key.\n * Functions are safe to use in both browser and SSR environments.\n */\nexport const impersonatedHelpers = {\n  /**\n   * Currently impersonated address from localStorage\n   * Returns empty string if not set or in SSR context\n   */\n  impersonatedAddress:\n    typeof window !== 'undefined' ? (window.localStorage.getItem('satellite-connect:impersonatedAddress') ?? '') : '',\n\n  /**\n   * Stores an impersonated address in localStorage\n   *\n   * @example\n   * ```typescript\n   * // Set impersonated address\n   * impersonatedHelpers.setImpersonated('0x1234...5678');\n   * ```\n   *\n   * @param address - Ethereum or Solana address to impersonate\n   * @returns undefined in SSR context, void in browser\n   */\n  setImpersonated: (address: string) =>\n    typeof window !== 'undefined'\n      ? window.localStorage.setItem('satellite-connect:impersonatedAddress', address)\n      : undefined,\n\n  /**\n   * Retrieves the current impersonated address from localStorage\n   *\n   * @example\n   * ```typescript\n   * // Get current impersonated address\n   * const address = impersonatedHelpers.getImpersonated();\n   * if (address) {\n   *   console.log('Currently impersonating:', address);\n   * }\n   * ```\n   * @returns The impersonated address or undefined if not set or in SSR context\n   */\n  getImpersonated: () =>\n    typeof window !== 'undefined' ? window.localStorage.getItem('satellite-connect:impersonatedAddress') : undefined,\n\n  removeImpersonated: () =>\n    typeof window !== 'undefined' ? window.localStorage.removeItem('satellite-connect:impersonatedAddress') : undefined,\n};\n","export const isSafeApp = typeof window !== 'undefined' && window !== window.parent;\n","import { WalletType } from '../types';\nimport { getParsedStorageItem } from './getParsedStorageItem';\n\ntype LastConnectedWallet = { walletType: WalletType; chainId: number | string; address?: string };\n\n/**\n * Helper utilities for managing the last connected wallet state\n *\n * @remarks\n * All data is stored in localStorage with the 'orbit-core:lastConnectedWallet' key.\n * Functions are safe to use in both browser and SSR environments.\n */\nexport const lastConnectedWalletHelpers = {\n  // Key used for localStorage\n  STORAGE_KEY: 'orbit-core:lastConnectedWallet',\n\n  /**\n   * The value of the last connected wallet, initialized when the module loads.\n   * Returns undefined if not set, invalid, or in an SSR context.\n   */\n  lastConnectedWallet: getParsedStorageItem<LastConnectedWallet>('orbit-core:lastConnectedWallet'),\n\n  /**\n   * Stores the last connected wallet data in localStorage.\n   *\n   * @param data - Object containing the wallet type and chain ID.\n   * @returns undefined in SSR context, void in browser\n   */\n  setLastConnectedWallet: ({ walletType, chainId, address }: LastConnectedWallet) =>\n    typeof window !== 'undefined'\n      ? window.localStorage.setItem(\n          lastConnectedWalletHelpers.STORAGE_KEY,\n          JSON.stringify({ walletType, chainId, address }),\n        )\n      : undefined,\n\n  /**\n   * Retrieves the current last connected wallet data from localStorage.\n   *\n   * @returns The LastConnectedWallet object or undefined if not set or in SSR context\n   */\n  getLastConnectedWallet: () => getParsedStorageItem<LastConnectedWallet>(lastConnectedWalletHelpers.STORAGE_KEY),\n\n  /**\n   * Removes the last connected wallet data from localStorage.\n   *\n   * @returns undefined in SSR context, void in browser\n   */\n  removeLastConnectedWallet: () =>\n    typeof window !== 'undefined' ? window.localStorage.removeItem(lastConnectedWalletHelpers.STORAGE_KEY) : undefined,\n};\n","import { OrbitAdapter } from '../types';\nimport { getParsedStorageItem } from './getParsedStorageItem';\n\nexport type RecentConnectedWallet = Record<OrbitAdapter, Record<string, boolean>>;\n\n/**\n * Helper utilities for managing the last connected wallet state\n *\n * @remarks\n * All data is stored in localStorage with the 'orbit-core:lastConnectedWallet' key.\n * Functions are safe to use in both browser and SSR environments.\n */\nexport const recentConnectedWalletHelpers = {\n  // Key used for localStorage\n  STORAGE_KEY: 'orbit-core:recentConnectedWallet',\n\n  /**\n   * The value of the last connected wallet, initialized when the module loads.\n   * Returns undefined if not set, invalid, or in an SSR context.\n   */\n  recentConnectedWallet: getParsedStorageItem<RecentConnectedWallet>('orbit-core:recentConnectedWallets'),\n\n  /**\n   * Stores the last connected wallet data in localStorage.\n   *\n   * @param wallets - RecentConnectedWallet\n   * @returns undefined in SSR context, void in browser\n   */\n  setRecentConnectedWallet: (wallets: RecentConnectedWallet) =>\n    typeof window !== 'undefined'\n      ? window.localStorage.setItem(recentConnectedWalletHelpers.STORAGE_KEY, JSON.stringify(wallets))\n      : undefined,\n\n  /**\n   * Retrieves the current last connected wallet data from localStorage.\n   *\n   * @returns The LastConnectedWallet object or undefined if not set or in SSR context\n   */\n  getRecentConnectedWallet: () => getParsedStorageItem<RecentConnectedWallet>(recentConnectedWalletHelpers.STORAGE_KEY),\n\n  /**\n   * Removes the last connected wallet data from localStorage.\n   *\n   * @returns undefined in SSR context, void in browser\n   */\n  removeRecentConnectedWallet: () =>\n    typeof window !== 'undefined'\n      ? window.localStorage.removeItem(recentConnectedWalletHelpers.STORAGE_KEY)\n      : undefined,\n};\n","/**\n * @file\n * This module provides adapter selection functionality for the Orbit system.\n * Part of the core infrastructure for managing blockchain adapters.\n */\n\nimport { OrbitAdapter, OrbitGenericAdapter } from '../types';\n\n/**\n * Selects an appropriate adapter based on the provided key from either a single adapter\n * or an array of adapters.\n *\n * @typeParam A - Type extending basic adapter interface with a key property\n *\n * @param options - Selection configuration object\n * @param options.adapterKey - Target adapter key to search for\n * @param options.adapter - Single adapter or array of adapters to search within\n *\n * @returns Selected adapter or undefined if no suitable adapter found\n *\n * @remarks\n * If an array is provided but no matching adapter is found, falls back to the first adapter\n * in the array with a warning message.\n *\n * @example\n * ```typescript\n * // Single adapter usage\n * const singleResult = selectAdapterByKey({\n *   adapterKey: OrbitAdapter.SOLANA,\n *   adapter: { key: OrbitAdapter.SOLANA, connect: async () => {...} }\n * });\n *\n * // Multiple adapters usage\n * const multiResult = selectAdapterByKey({\n *   adapterKey: OrbitAdapter.EVM,\n *   adapter: [\n *     { key: OrbitAdapter.SOLANA, connect: async () => {...} },\n *     { key: OrbitAdapter.EVM, connect: async () => {...} }\n *   ]\n * });\n * ```\n *\n * @throws {Error} Logs error if adapter array is empty\n * @throws {Warning} Logs warning if requested adapter key not found in array\n */\nexport const selectAdapterByKey = <A extends { key: OrbitAdapter }>({\n  adapterKey,\n  adapter,\n}: { adapterKey: OrbitAdapter } & OrbitGenericAdapter<A>): A | undefined => {\n  if (Array.isArray(adapter)) {\n    if (adapter.length === 0) {\n      console.error('Adapter selection failed: The provided adapters array is empty.');\n      return undefined;\n    }\n\n    const foundAdapter = adapter.find((a) => a.key === adapterKey);\n\n    if (foundAdapter) {\n      return foundAdapter;\n    } else {\n      console.warn(\n        `No adapter found for key: \"${adapterKey}\". Falling back to the first available adapter: \"${adapter[0].key}\".`,\n      );\n      return adapter[0];\n    }\n  }\n  return adapter;\n};\n","export async function waitFor(\n  predicate: () => boolean | undefined,\n  maxChecks: number = 50,\n  checkIntervalMs: number = 200,\n) {\n  for (let i = 0; i < maxChecks; i++) {\n    if (predicate()) {\n      return;\n    }\n    await new Promise((resolve) => setTimeout(resolve, checkIntervalMs));\n  }\n  throw new Error('Predicate not fulfilled in time');\n}\n","/**\n * Checks whether the given chain ID belongs to a Solana network.\n * Supports common Solana network names: 'devnet', 'testnet', 'mainnet-beta', 'mainnet'.\n *\n * @param {number | string} chainId - The chain ID or chain name.\n * @returns {boolean} - True if the chain ID corresponds to a Solana network, false otherwise.\n */\nexport function isSolanaChain(chainId: number | string): boolean {\n  if (typeof chainId === 'string') {\n    return ['devnet', 'testnet', 'mainnet-beta', 'mainnet'].includes(chainId);\n  }\n  return false;\n}\n\n/**\n * Sets the chain ID to a Solana-specific format if the chain is a Solana network.\n *\n * @param {number | string} chainId - The original chain ID or name.\n * @returns {string | number} - The formatted chain ID prefixed with 'solana:' if Solana, otherwise the original.\n */\nexport function setChainId(chainId: number | string): string | number {\n  if (isSolanaChain(chainId)) {\n    return `solana:${chainId}`;\n  } else {\n    return chainId;\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuwaio/orbit-core",
-  "version": "0.0.3",
+  "version": "0.1.0",
   "private": false,
   "author": "Oleksandr Tkach",
   "license": "Apache-2.0",
@@ -22,12 +22,12 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/TuwaIO/satellite-connect.git",
+    "url": "git+https://github.com/TuwaIO/orbit.git",
     "directory": "packages/orbit-core"
   },
-  "homepage": "https://github.com/TuwaIO/satellite-connect",
+  "homepage": "https://github.com/TuwaIO/orbit",
   "bugs": {
-    "url": "https://github.com/TuwaIO/satellite-connect/issues"
+    "url": "https://github.com/TuwaIO/orbit/issues"
   },
   "contributors": [
     {
@@ -35,13 +35,9 @@
       "url": "https://github.com/Argeare5"
     }
   ],
-  "peerDependencies": {
-    "zustand": "^5.0.8"
-  },
   "devDependencies": {
     "tsup": "^8.5.0",
-    "typescript": "^5.9.2",
-    "zustand": "^5.0.8"
+    "typescript": "^5.9.3"
   },
   "scripts": {
     "start": "tsup src/index.ts --watch",