@tuwaio/satellite-core 0.0.3

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2025 FOP Tkach Oleksandr
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,97 @@
+# Satellite Connect Core
+
+[![NPM Version](https://img.shields.io/npm/v/@tuwaio/satellite-core.svg)](https://www.npmjs.com/package/@tuwaio/satellite-core)
+[![License](https://img.shields.io/npm/l/@tuwaio/satellite-core.svg)](./LICENSE)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/TuwaIO/satellite-core/release.yml?branch=main)](https://github.com/TuwaIO/satellite-core/actions)
+
+Core of the Satellite ecosystem for Web3 wallet interactions, providing a universal interface for connecting and interacting with various blockchain wallets.
+
+---
+
+## 🏛️ What is `@tuwaio/satellite-core`?
+
+`@tuwaio/satellite-core` is the foundation package of the Satellite ecosystem, designed to unify Web3 wallet interactions. It provides a single interface for connecting and interacting with wallets across different blockchains (EVM, Solana).
+
+Built with TypeScript, it leverages modern tools for state management and type-safe development.
+
+---
+
+## ✨ Key Features
+
+- **Universal Interface:** Single API for interacting with different blockchain wallets
+- **Type Safety:** Full TypeScript support
+- **Modular Architecture:** Easy extension for new wallet types
+- **State Management:** Built-in connection state management system
+- **Bundle Optimization:** Efficient tree-shaking optimization
+
+---
+
+## 💾 Installation
+
+### Requirements
+- Node.js 20+
+- TypeScript 5.9+
+```bash
+# Using pnpm (recommended)
+pnpm add @tuwaio/satellite-core @tuwaio/orbit-core @wagmi/core @wallet-standard/ui immer zustand
+
+# Using npm
+npm install @tuwaio/satellite-core @tuwaio/orbit-core @wagmi/core @wallet-standard/ui immer zustand
+
+# Using yarn
+yarn add @tuwaio/satellite-core @tuwaio/orbit-core @wagmi/core @wallet-standard/ui immer zustand
+```
+---
+
+## 🚀 Quick Start
+
+### Basic Usage
+```typescript
+import { getAdapterFromWalletType } from '@tuwaio/satellite-core';
+// Determine adapter type from wallet type
+const adapter = getAdapterFromWalletType('evm:metamask');
+```
+---
+
+## 🔧 Architecture
+
+The package is structured around these core components:
+
+### Build System
+- Built with `tsup`
+- Supports CommonJS and ESM formats
+- Generates TypeScript declarations
+
+### Core Modules
+- **Store:** Connection state management system
+- **Utils:** Wallet interaction utilities
+- **Types:** Type system for unified wallet operations
+
+---
+
+## ✨ Ecosystem Integration
+
+Satellite Core works in conjunction with other ecosystem packages:
+
+- **`@tuwaio/satellite-core`:** Base functionality (this package)
+- **`@tuwaio/satellite-evm`:** EVM wallet integration
+- **`@tuwaio/satellite-solana`:** Solana wallet integration
+- **`@tuwaio/satellite-react`:** React hooks and components
+
+---
+
+## 🤝 Contributing & Support
+
+Contributions are welcome! Please read our main **[Contribution Guidelines](https://github.com/TuwaIO/workflows/blob/main/CONTRIBUTING.md)**.
+
+If you find this library useful, please consider supporting its development. Every contribution helps!
+
+[**➡️ View Support Options**](https://github.com/TuwaIO/workflows/blob/main/Donation.md)
+
+## 📄 License
+
+This project is licensed under the **Apache-2.0 License** - see the [LICENSE](./LICENSE) file for details.
+
+## 👥 Contributors
+
+- **Oleksandr Tkach** - [GitHub](https://github.com/Argeare5)

package/dist/index.d.mts

@@ -0,0 +1,272 @@
+import * as zustand from 'zustand';
+import { OrbitGenericAdapter, OrbitAdapter } from '@tuwaio/orbit-core';
+import { Connector as Connector$1, CreateConnectorFn } from '@wagmi/core';
+import { UiWallet, UiWalletAccount } from '@wallet-standard/ui';
+
+/**
+ * Type representing a wallet identifier in format "chain:wallet"
+ * @example "evm:metamask" | "solana:phantom"
+ */
+type WalletType = `${OrbitAdapter}:${string}`;
+/**
+ * Configuration properties for initializing wallet connectors
+ */
+type ConnectorsInitProps = {
+    /** Application name displayed in wallet interfaces */
+    appName: string;
+    /** Logo URL for Coinbase Wallet */
+    appLogoUrl?: string;
+    /** WalletConnect project ID (required for WalletConnect functionality) */
+    projectId?: string;
+    /** Logo for WalletConnect interface */
+    appLogo?: string;
+    /** Application description for WalletConnect */
+    description?: string;
+    /** Application URL for WalletConnect */
+    appUrl?: string;
+    /** Array of icon URLs for WalletConnect */
+    appIcons?: string[];
+    /** Function to get impersonated account address for testing */
+    getImpersonatedAccount?: () => string | `0x${string}` | undefined;
+};
+/**
+ * Base interface for connected wallet information
+ */
+interface BaseWallet {
+    /** Unique identifier of the wallet */
+    walletType: WalletType;
+    /** Wallet's public address */
+    address: string | `0x${string}`;
+    /** Connected chain ID */
+    chainId: string | number;
+    /** RPC endpoint URL */
+    rpcURL: string;
+    /** Indicates if the address is a smart contract */
+    isContractAddress: boolean;
+    /** Connection status */
+    isConnected: boolean;
+}
+/**
+ * Extended wallet interface for Solana-specific properties
+ */
+interface SolanaWallet extends BaseWallet {
+    /** Connected Wallet Standard account */
+    connectedAccount?: UiWalletAccount;
+    /** Connected Wallet Standard wallet instance */
+    connectedWallet?: UiWallet;
+}
+/** Union type for all supported wallet types */
+type Wallet = BaseWallet | SolanaWallet;
+/** EVM-specific connector type */
+type ConnectorEVM = Connector$1<CreateConnectorFn>;
+/** Solana-specific connector type */
+type ConnectorSolana = UiWallet;
+/** Union type for all supported connector types */
+type Connector = ConnectorEVM | ConnectorSolana;
+/**
+ * Interface for blockchain network adapters
+ * @remarks
+ * Adapters provide chain-specific implementation for wallet interactions
+ */
+type SatelliteAdapter = {
+    /** Unique identifier for the adapter */
+    key: OrbitAdapter;
+    /**
+     * Initiates wallet connection
+     * @returns Promise resolving to connected wallet instance
+     */
+    connect: ({ walletType, chainId, connectors, }: {
+        walletType: WalletType;
+        chainId: number | string;
+        connectors: Connector[];
+    }) => Promise<Wallet>;
+    /** Disconnects current wallet session */
+    disconnect: () => Promise<void>;
+    /** Retrieves available wallet connectors for this adapter */
+    getConnectors: () => Promise<{
+        adapter: OrbitAdapter;
+        connectors: Connector[];
+    }>;
+    /**
+     * Handles network switching for connected wallet
+     * @param chainId - Target chain ID
+     * @param currentChainId - Current chain ID
+     * @param updateActiveWallet - Callback to update wallet state
+     */
+    checkAndSwitchNetwork: (chainId: string | number, currentChainId?: string | number, updateActiveWallet?: (wallet: Partial<Wallet>) => void) => Promise<void>;
+    /**
+     * 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>;
+    /** Optional method to check if address is a smart contract */
+    checkIsContractWallet?: ({ address, chainId }: {
+        address: string;
+        chainId: string | number;
+    }) => Promise<boolean>;
+};
+/**
+ * Store interface for managing wallet connections
+ */
+type ISatelliteConnectStore = {
+    /** Returns configured adapter(s) */
+    getAdapter: () => SatelliteAdapter | SatelliteAdapter[];
+    /** Information about last connected wallet */
+    lastConnectedWallet?: {
+        walletType: WalletType;
+        chainId: number | string;
+    };
+    /** Available connectors mapped by adapter type */
+    availableConnectors: Partial<Record<OrbitAdapter, Connector[]>>;
+    /** Initializes wallet connectors */
+    initializeAppConnectors: ({ autoConnect }: {
+        autoConnect?: boolean;
+    }) => Promise<void>;
+    /** Connects to specified wallet */
+    connect: ({ walletType, chainId }: {
+        walletType: WalletType;
+        chainId: number | string;
+    }) => Promise<void>;
+    /** Disconnects active wallet */
+    disconnect: () => Promise<void>;
+    /** Indicates ongoing connection attempt */
+    walletConnecting: boolean;
+    /** Contains error message if connection failed */
+    walletConnectionError?: string;
+    /** Currently connected wallet */
+    activeWallet?: Wallet;
+    /** Clears connection error state */
+    resetWalletConnectionError: () => void;
+    /** Updates active wallet properties */
+    updateActiveWallet: (wallet: Partial<Wallet>) => void;
+    /** Switches network for connected wallet */
+    switchNetwork: (chainId: string | number) => Promise<void>;
+    /** Contains error message if network switch failed */
+    switchNetworkError?: string;
+    /** Clears network switch error state */
+    resetSwitchNetworkError: () => void;
+};
+/**
+ * Callback type for successful wallet connections
+ */
+type WalletConnectedCallback = (wallet: Wallet) => void | Promise<void>;
+/**
+ * Configuration parameters for initializing Satellite Connect store
+ */
+type SatelliteConnectStoreInitialParameters = OrbitGenericAdapter<SatelliteAdapter> & {
+    /** Optional callback executed after successful wallet connection */
+    callbackAfterConnected?: WalletConnectedCallback;
+};
+
+/**
+ * Creates a Satellite Connect store instance for managing wallet connections and state
+ *
+ * @param params - Configuration parameters for the store
+ * @param params.adapter - Single adapter or array of adapters for different chains
+ * @param params.callbackAfterConnected - Optional callback function called after successful wallet connection
+ *
+ * @returns A Zustand store instance with wallet connection state and methods
+ */
+declare function createSatelliteConnectStore({ adapter, callbackAfterConnected, }: SatelliteConnectStoreInitialParameters): zustand.StoreApi<ISatelliteConnectStore>;
+
+/**
+ * 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');
+ * ```
+ *
+ * @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;
+
+/**
+ * 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
+ */
+declare function getWalletTypeFromConnectorName(adapter: OrbitAdapter, name: string): string;
+
+/**
+ * Helper utilities for managing impersonated wallet addresses
+ *
+ * @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;
+};
+
+export { type BaseWallet, type Connector, type ConnectorEVM, type ConnectorSolana, type ConnectorsInitProps, type ISatelliteConnectStore, type SatelliteAdapter, type SatelliteConnectStoreInitialParameters, type SolanaWallet, type Wallet, type WalletConnectedCallback, type WalletType, createSatelliteConnectStore, getAdapterFromWalletType, getWalletTypeFromConnectorName, impersonatedHelpers };

package/dist/index.d.ts

@@ -0,0 +1,272 @@
+import * as zustand from 'zustand';
+import { OrbitGenericAdapter, OrbitAdapter } from '@tuwaio/orbit-core';
+import { Connector as Connector$1, CreateConnectorFn } from '@wagmi/core';
+import { UiWallet, UiWalletAccount } from '@wallet-standard/ui';
+
+/**
+ * Type representing a wallet identifier in format "chain:wallet"
+ * @example "evm:metamask" | "solana:phantom"
+ */
+type WalletType = `${OrbitAdapter}:${string}`;
+/**
+ * Configuration properties for initializing wallet connectors
+ */
+type ConnectorsInitProps = {
+    /** Application name displayed in wallet interfaces */
+    appName: string;
+    /** Logo URL for Coinbase Wallet */
+    appLogoUrl?: string;
+    /** WalletConnect project ID (required for WalletConnect functionality) */
+    projectId?: string;
+    /** Logo for WalletConnect interface */
+    appLogo?: string;
+    /** Application description for WalletConnect */
+    description?: string;
+    /** Application URL for WalletConnect */
+    appUrl?: string;
+    /** Array of icon URLs for WalletConnect */
+    appIcons?: string[];
+    /** Function to get impersonated account address for testing */
+    getImpersonatedAccount?: () => string | `0x${string}` | undefined;
+};
+/**
+ * Base interface for connected wallet information
+ */
+interface BaseWallet {
+    /** Unique identifier of the wallet */
+    walletType: WalletType;
+    /** Wallet's public address */
+    address: string | `0x${string}`;
+    /** Connected chain ID */
+    chainId: string | number;
+    /** RPC endpoint URL */
+    rpcURL: string;
+    /** Indicates if the address is a smart contract */
+    isContractAddress: boolean;
+    /** Connection status */
+    isConnected: boolean;
+}
+/**
+ * Extended wallet interface for Solana-specific properties
+ */
+interface SolanaWallet extends BaseWallet {
+    /** Connected Wallet Standard account */
+    connectedAccount?: UiWalletAccount;
+    /** Connected Wallet Standard wallet instance */
+    connectedWallet?: UiWallet;
+}
+/** Union type for all supported wallet types */
+type Wallet = BaseWallet | SolanaWallet;
+/** EVM-specific connector type */
+type ConnectorEVM = Connector$1<CreateConnectorFn>;
+/** Solana-specific connector type */
+type ConnectorSolana = UiWallet;
+/** Union type for all supported connector types */
+type Connector = ConnectorEVM | ConnectorSolana;
+/**
+ * Interface for blockchain network adapters
+ * @remarks
+ * Adapters provide chain-specific implementation for wallet interactions
+ */
+type SatelliteAdapter = {
+    /** Unique identifier for the adapter */
+    key: OrbitAdapter;
+    /**
+     * Initiates wallet connection
+     * @returns Promise resolving to connected wallet instance
+     */
+    connect: ({ walletType, chainId, connectors, }: {
+        walletType: WalletType;
+        chainId: number | string;
+        connectors: Connector[];
+    }) => Promise<Wallet>;
+    /** Disconnects current wallet session */
+    disconnect: () => Promise<void>;
+    /** Retrieves available wallet connectors for this adapter */
+    getConnectors: () => Promise<{
+        adapter: OrbitAdapter;
+        connectors: Connector[];
+    }>;
+    /**
+     * Handles network switching for connected wallet
+     * @param chainId - Target chain ID
+     * @param currentChainId - Current chain ID
+     * @param updateActiveWallet - Callback to update wallet state
+     */
+    checkAndSwitchNetwork: (chainId: string | number, currentChainId?: string | number, updateActiveWallet?: (wallet: Partial<Wallet>) => void) => Promise<void>;
+    /**
+     * 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>;
+    /** Optional method to check if address is a smart contract */
+    checkIsContractWallet?: ({ address, chainId }: {
+        address: string;
+        chainId: string | number;
+    }) => Promise<boolean>;
+};
+/**
+ * Store interface for managing wallet connections
+ */
+type ISatelliteConnectStore = {
+    /** Returns configured adapter(s) */
+    getAdapter: () => SatelliteAdapter | SatelliteAdapter[];
+    /** Information about last connected wallet */
+    lastConnectedWallet?: {
+        walletType: WalletType;
+        chainId: number | string;
+    };
+    /** Available connectors mapped by adapter type */
+    availableConnectors: Partial<Record<OrbitAdapter, Connector[]>>;
+    /** Initializes wallet connectors */
+    initializeAppConnectors: ({ autoConnect }: {
+        autoConnect?: boolean;
+    }) => Promise<void>;
+    /** Connects to specified wallet */
+    connect: ({ walletType, chainId }: {
+        walletType: WalletType;
+        chainId: number | string;
+    }) => Promise<void>;
+    /** Disconnects active wallet */
+    disconnect: () => Promise<void>;
+    /** Indicates ongoing connection attempt */
+    walletConnecting: boolean;
+    /** Contains error message if connection failed */
+    walletConnectionError?: string;
+    /** Currently connected wallet */
+    activeWallet?: Wallet;
+    /** Clears connection error state */
+    resetWalletConnectionError: () => void;
+    /** Updates active wallet properties */
+    updateActiveWallet: (wallet: Partial<Wallet>) => void;
+    /** Switches network for connected wallet */
+    switchNetwork: (chainId: string | number) => Promise<void>;
+    /** Contains error message if network switch failed */
+    switchNetworkError?: string;
+    /** Clears network switch error state */
+    resetSwitchNetworkError: () => void;
+};
+/**
+ * Callback type for successful wallet connections
+ */
+type WalletConnectedCallback = (wallet: Wallet) => void | Promise<void>;
+/**
+ * Configuration parameters for initializing Satellite Connect store
+ */
+type SatelliteConnectStoreInitialParameters = OrbitGenericAdapter<SatelliteAdapter> & {
+    /** Optional callback executed after successful wallet connection */
+    callbackAfterConnected?: WalletConnectedCallback;
+};
+
+/**
+ * Creates a Satellite Connect store instance for managing wallet connections and state
+ *
+ * @param params - Configuration parameters for the store
+ * @param params.adapter - Single adapter or array of adapters for different chains
+ * @param params.callbackAfterConnected - Optional callback function called after successful wallet connection
+ *
+ * @returns A Zustand store instance with wallet connection state and methods
+ */
+declare function createSatelliteConnectStore({ adapter, callbackAfterConnected, }: SatelliteConnectStoreInitialParameters): zustand.StoreApi<ISatelliteConnectStore>;
+
+/**
+ * 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');
+ * ```
+ *
+ * @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;
+
+/**
+ * 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
+ */
+declare function getWalletTypeFromConnectorName(adapter: OrbitAdapter, name: string): string;
+
+/**
+ * Helper utilities for managing impersonated wallet addresses
+ *
+ * @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;
+};
+
+export { type BaseWallet, type Connector, type ConnectorEVM, type ConnectorSolana, type ConnectorsInitProps, type ISatelliteConnectStore, type SatelliteAdapter, type SatelliteConnectStoreInitialParameters, type SolanaWallet, type Wallet, type WalletConnectedCallback, type WalletType, createSatelliteConnectStore, getAdapterFromWalletType, getWalletTypeFromConnectorName, impersonatedHelpers };

package/dist/index.js

@@ -0,0 +1,2 @@
+'use strict';var orbitCore=require('@tuwaio/orbit-core'),immer=require('immer'),vanilla=require('zustand/vanilla');function l(r){return r.split(":")[0]??orbitCore.OrbitAdapter.EVM}function S({adapter:r,callbackAfterConnected:c}){return vanilla.createStore()((a,i)=>({getAdapter:()=>r,availableConnectors:{},initializeAppConnectors:async({autoConnect:t})=>{if(Array.isArray(r))(await Promise.all(r.map(o=>o.getConnectors()))).forEach(o=>{a(e=>immer.produce(e,p=>{p.availableConnectors[o.adapter]=o.connectors;}));});else {let n=await r.getConnectors();a(o=>immer.produce(o,e=>{e.availableConnectors[n.adapter]=n.connectors;}));}if(t){let n=i().lastConnectedWallet;n&&await i().connect({walletType:n.walletType,chainId:n.chainId});}},connect:async({walletType:t,chainId:n})=>{a({walletConnecting:true,walletConnectionError:void 0});let o=orbitCore.selectAdapterByKey({adapter:r,adapterKey:l(t)});try{let e=await o?.connect({walletType:t,chainId:n,connectors:i().availableConnectors[l(t)]??[]});a({activeWallet:e}),o?.checkIsContractWallet&&e&&(i().updateActiveWallet({isContractAddress:await o.checkIsContractWallet({address:e.address,chainId:n})}),c&&await c(e)),a({walletConnecting:!1,lastConnectedWallet:{walletType:t,chainId:n}});}catch(e){a({walletConnecting:false,walletConnectionError:"Wallet connection failed: "+(e instanceof Error?e.message:String(e))});}},disconnect:async()=>{let t=i().activeWallet;t&&(await orbitCore.selectAdapterByKey({adapter:r,adapterKey:l(t.walletType)})?.disconnect(),a({activeWallet:void 0,lastConnectedWallet:void 0}));},walletConnecting:false,resetWalletConnectionError:()=>{a({walletConnectionError:void 0});},updateActiveWallet:t=>{i().activeWallet?a(o=>immer.produce(o,e=>{e.activeWallet&&(e.activeWallet={...e.activeWallet,...t});})):t.walletType!==void 0&&t.chainId!==void 0&&t.address!==void 0&&a({activeWallet:t});},switchNetwork:async t=>{a({switchNetworkError:void 0});let n=i().activeWallet;if(n){let o=orbitCore.selectAdapterByKey({adapter:r,adapterKey:l(n.walletType)});try{await o?.checkAndSwitchNetwork(t,n.chainId,i().updateActiveWallet);}catch(e){a({switchNetworkError:"Switch network failed: "+(e instanceof Error?e.message:String(e))});}}},resetSwitchNetworkError:()=>a({switchNetworkError:void 0})}))}function h(r,c){return `${r}:${c.replace(/\s+/g,"").toLowerCase()}`}var E={impersonatedAddress:typeof window<"u"?window.localStorage.getItem("satellite-connect:impersonatedAddress")??"":"",setImpersonated:r=>typeof window<"u"?window.localStorage.setItem("satellite-connect:impersonatedAddress",r):void 0,getImpersonated:()=>typeof window<"u"?window.localStorage.getItem("satellite-connect:impersonatedAddress"):void 0};exports.createSatelliteConnectStore=S;exports.getAdapterFromWalletType=l;exports.getWalletTypeFromConnectorName=h;exports.impersonatedHelpers=E;//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/getAdapterFromWalletType.ts","../src/store/satelliteConnectStore.ts","../src/utils/getWalletTypeFromConnectorName.ts","../src/utils/impersonatedHelpers.ts"],"names":["getAdapterFromWalletType","walletType","OrbitAdapter","createSatelliteConnectStore","adapter","callbackAfterConnected","createStore","set","get","autoConnect","a","connectors","state","produce","draft","lastConnectedWallet","chainId","foundAdapter","selectAdapterByKey","wallet","activeWallet","getWalletTypeFromConnectorName","name","impersonatedHelpers","address"],"mappings":"mHA0BO,SAASA,CAAAA,CAAyBC,CAAAA,CAAsC,CAC7E,OAAQA,CAAAA,CAAW,KAAA,CAAM,GAAG,CAAA,CAAE,CAAC,CAAA,EAAKC,sBAAAA,CAAa,GACnD,CCZO,SAASC,CAAAA,CAA4B,CAC1C,OAAA,CAAAC,CAAAA,CACA,sBAAA,CAAAC,CACF,CAAA,CAA2C,CACzC,OAAOC,mBAAAA,EAAoC,CAAE,CAACC,EAAKC,CAAAA,IAAS,CAI1D,UAAA,CAAY,IAAMJ,CAAAA,CAKlB,mBAAA,CAAqB,EAAC,CAMtB,uBAAA,CAAyB,MAAO,CAAE,WAAA,CAAAK,CAAY,CAAA,GAAM,CAClD,GAAI,KAAA,CAAM,OAAA,CAAQL,CAAO,CAAA,CAAA,CACJ,MAAM,OAAA,CAAQ,GAAA,CAAIA,CAAAA,CAAQ,GAAA,CAAKM,CAAAA,EAAMA,CAAAA,CAAE,aAAA,EAAe,CAAC,CAAA,EAC/D,OAAA,CAASC,CAAAA,EAAe,CACjCJ,CAAAA,CAAKK,CAAAA,EACHC,aAAAA,CAAQD,CAAAA,CAAQE,CAAAA,EAAU,CACxBA,CAAAA,CAAM,mBAAA,CAAoBH,CAAAA,CAAW,OAAO,EAAIA,CAAAA,CAAW,WAC7D,CAAC,CACH,EACF,CAAC,CAAA,CAAA,KACI,CACL,IAAMA,CAAAA,CAAa,MAAMP,CAAAA,CAAQ,aAAA,EAAc,CAC/CG,EAAKK,CAAAA,EACHC,aAAAA,CAAQD,CAAAA,CAAQE,CAAAA,EAAU,CACxBA,CAAAA,CAAM,mBAAA,CAAoBH,CAAAA,CAAW,OAAO,CAAA,CAAIA,CAAAA,CAAW,WAC7D,CAAC,CACH,EACF,CACA,GAAIF,CAAAA,CAAa,CACf,IAAMM,CAAAA,CAAsBP,CAAAA,EAAI,CAAE,mBAAA,CAC9BO,CAAAA,EACF,MAAMP,CAAAA,EAAI,CAAE,OAAA,CAAQ,CAAE,UAAA,CAAYO,CAAAA,CAAoB,UAAA,CAAY,OAAA,CAASA,CAAAA,CAAoB,OAAQ,CAAC,EAE5G,CACF,CAAA,CAOA,OAAA,CAAS,MAAO,CAAE,UAAA,CAAAd,EAAY,OAAA,CAAAe,CAAQ,CAAA,GAAM,CAC1CT,CAAAA,CAAI,CAAE,gBAAA,CAAkB,IAAA,CAAM,qBAAA,CAAuB,MAAU,CAAC,CAAA,CAChE,IAAMU,CAAAA,CAAeC,6BAAmB,CAAE,OAAA,CAAAd,CAAAA,CAAS,UAAA,CAAYJ,CAAAA,CAAyBC,CAAU,CAAE,CAAC,CAAA,CACrG,GAAI,CACF,IAAMkB,CAAAA,CAAS,MAAMF,GAAc,OAAA,CAAQ,CACzC,UAAA,CAAAhB,CAAAA,CACA,OAAA,CAAAe,CAAAA,CACA,UAAA,CAAYR,CAAAA,EAAI,CAAE,mBAAA,CAAoBR,CAAAA,CAAyBC,CAAU,CAAC,CAAA,EAAK,EACjF,CAAC,CAAA,CACDM,CAAAA,CAAI,CAAE,YAAA,CAAcY,CAAO,CAAC,CAAA,CACxBF,CAAAA,EAAc,qBAAA,EAAyBE,CAAAA,GACzCX,CAAAA,EAAI,CAAE,mBAAmB,CACvB,iBAAA,CAAmB,MAAMS,CAAAA,CAAa,qBAAA,CAAsB,CAC1D,OAAA,CAASE,CAAAA,CAAO,OAAA,CAChB,OAAA,CAAAH,CACF,CAAC,CACH,CAAC,EACGX,CAAAA,EACF,MAAMA,CAAAA,CAAuBc,CAAM,CAAA,CAAA,CAGvCZ,CAAAA,CAAI,CAAE,gBAAA,CAAkB,CAAA,CAAA,CAAO,mBAAA,CAAqB,CAAE,UAAA,CAAAN,CAAAA,CAAY,OAAA,CAAAe,CAAQ,CAAE,CAAC,EAC/E,CAAA,MAAS,CAAA,CAAG,CACVT,EAAI,CACF,gBAAA,CAAkB,KAAA,CAClB,qBAAA,CAAuB,4BAAA,EAAgC,CAAA,YAAa,MAAQ,CAAA,CAAE,OAAA,CAAU,MAAA,CAAO,CAAC,CAAA,CAClG,CAAC,EACH,CACF,CAAA,CAKA,UAAA,CAAY,SAAY,CACtB,IAAMa,CAAAA,CAAeZ,GAAI,CAAE,YAAA,CACvBY,CAAAA,GAKF,MAJqBF,4BAAAA,CAAmB,CACtC,OAAA,CAAAd,CAAAA,CACA,UAAA,CAAYJ,CAAAA,CAAyBoB,CAAAA,CAAa,UAAU,CAC9D,CAAC,GACmB,UAAA,EAAW,CAC/Bb,CAAAA,CAAI,CAAE,YAAA,CAAc,MAAA,CAAW,mBAAA,CAAqB,MAAU,CAAC,CAAA,EAEnE,CAAA,CAEA,gBAAA,CAAkB,KAAA,CAKlB,0BAAA,CAA4B,IAAM,CAChCA,CAAAA,CAAI,CAAE,qBAAA,CAAuB,MAAU,CAAC,EAC1C,CAAA,CAMA,kBAAA,CAAqBY,CAAAA,EAA4B,CAC1BX,CAAAA,EAAI,CAAE,YAAA,CAEzBD,EAAKK,CAAAA,EACHC,aAAAA,CAAQD,CAAAA,CAAQE,CAAAA,EAAU,CACpBA,CAAAA,CAAM,YAAA,GACRA,CAAAA,CAAM,YAAA,CAAe,CACnB,GAAGA,CAAAA,CAAM,YAAA,CACT,GAAGK,CACL,CAAA,EAEJ,CAAC,CACH,CAAA,CAEIA,CAAAA,CAAO,UAAA,GAAe,MAAA,EAAaA,CAAAA,CAAO,OAAA,GAAY,MAAA,EAAaA,CAAAA,CAAO,OAAA,GAAY,MAAA,EACxFZ,CAAAA,CAAI,CAAE,YAAA,CAAcY,CAAiB,CAAC,EAG5C,CAAA,CAMA,aAAA,CAAe,MAAOH,CAAAA,EAA6B,CACjDT,CAAAA,CAAI,CAAE,kBAAA,CAAoB,MAAU,CAAC,EACrC,IAAMa,CAAAA,CAAeZ,CAAAA,EAAI,CAAE,YAAA,CAC3B,GAAIY,CAAAA,CAAc,CAChB,IAAMH,CAAAA,CAAeC,4BAAAA,CAAmB,CACtC,OAAA,CAAAd,CAAAA,CACA,WAAYJ,CAAAA,CAAyBoB,CAAAA,CAAa,UAAU,CAC9D,CAAC,CAAA,CACD,GAAI,CACF,MAAMH,CAAAA,EAAc,qBAAA,CAAsBD,CAAAA,CAASI,CAAAA,CAAa,OAAA,CAASZ,GAAI,CAAE,kBAAkB,EACnG,CAAA,MAAS,CAAA,CAAG,CACVD,CAAAA,CAAI,CAAE,kBAAA,CAAoB,yBAAA,EAA6B,CAAA,YAAa,KAAA,CAAQ,CAAA,CAAE,OAAA,CAAU,OAAO,CAAC,CAAA,CAAG,CAAC,EACtG,CACF,CACF,CAAA,CAKA,uBAAA,CAAyB,IAAMA,CAAAA,CAAI,CAAE,kBAAA,CAAoB,MAAU,CAAC,CACtE,CAAA,CAAE,CACJ,CC7IO,SAASc,CAAAA,CAA+BjB,CAAAA,CAAuBkB,CAAAA,CAAsB,CAC1F,OAAO,CAAA,EAAGlB,CAAO,CAAA,CAAA,EAAIkB,CAAAA,CAAK,OAAA,CAAQ,OAAQ,EAAE,CAAA,CAAE,WAAA,EAAa,CAAA,CAC7D,CCrBO,IAAMC,CAAAA,CAAsB,CAKjC,mBAAA,CACE,OAAO,MAAA,CAAW,GAAA,CAAe,MAAA,CAAO,aAAa,OAAA,CAAQ,uCAAuC,CAAA,EAAK,EAAA,CAAM,EAAA,CAcjH,eAAA,CAAkBC,CAAAA,EAChB,OAAO,MAAA,CAAW,GAAA,CACd,MAAA,CAAO,YAAA,CAAa,OAAA,CAAQ,uCAAA,CAAyCA,CAAO,CAAA,CAC5E,MAAA,CAeN,eAAA,CAAiB,IACf,OAAO,MAAA,CAAW,GAAA,CAAc,MAAA,CAAO,YAAA,CAAa,OAAA,CAAQ,uCAAuC,CAAA,CAAI,MAC3G","file":"index.js","sourcesContent":["import { OrbitAdapter } from '@tuwaio/orbit-core';\n\nimport { 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] ?? OrbitAdapter.EVM) as OrbitAdapter;\n}\n","import { selectAdapterByKey } from '@tuwaio/orbit-core';\nimport { Draft, produce } from 'immer';\nimport { createStore } from 'zustand/vanilla';\n\nimport { Connector, ISatelliteConnectStore, SatelliteConnectStoreInitialParameters, Wallet } from '../types';\nimport { getAdapterFromWalletType } from '../utils/getAdapterFromWalletType';\n\n/**\n * Creates a Satellite Connect store instance for managing wallet connections and state\n *\n * @param params - Configuration parameters for the store\n * @param params.adapter - Single adapter or array of adapters for different chains\n * @param params.callbackAfterConnected - Optional callback function called after successful wallet connection\n *\n * @returns A Zustand store instance with wallet connection state and methods\n */\nexport function createSatelliteConnectStore({\n  adapter,\n  callbackAfterConnected,\n}: SatelliteConnectStoreInitialParameters) {\n  return createStore<ISatelliteConnectStore>()((set, get) => ({\n    /**\n     * Returns configured adapter(s)\n     */\n    getAdapter: () => adapter,\n\n    /**\n     * Available wallet connectors for each chain\n     */\n    availableConnectors: {},\n\n    /**\n     * Initializes wallet connectors for all configured adapters\n     * @param autoConnect - Whether to automatically reconnect to last used wallet\n     */\n    initializeAppConnectors: async ({ autoConnect }) => {\n      if (Array.isArray(adapter)) {\n        const connectors = await Promise.all(adapter.map((a) => a.getConnectors()));\n        connectors.forEach((connectors) => {\n          set((state) =>\n            produce(state, (draft) => {\n              draft.availableConnectors[connectors.adapter] = connectors.connectors as Draft<Connector[]>;\n            }),\n          );\n        });\n      } else {\n        const connectors = await adapter.getConnectors();\n        set((state) =>\n          produce(state, (draft) => {\n            draft.availableConnectors[connectors.adapter] = connectors.connectors as Draft<Connector[]>;\n          }),\n        );\n      }\n      if (autoConnect) {\n        const lastConnectedWallet = get().lastConnectedWallet;\n        if (lastConnectedWallet) {\n          await get().connect({ walletType: lastConnectedWallet.walletType, chainId: lastConnectedWallet.chainId });\n        }\n      }\n    },\n\n    /**\n     * Connects to a wallet\n     * @param walletType - Type of wallet to connect to\n     * @param chainId - Chain ID to connect on\n     */\n    connect: async ({ walletType, chainId }) => {\n      set({ walletConnecting: true, walletConnectionError: undefined });\n      const foundAdapter = selectAdapterByKey({ adapter, adapterKey: getAdapterFromWalletType(walletType) });\n      try {\n        const wallet = await foundAdapter?.connect({\n          walletType,\n          chainId,\n          connectors: get().availableConnectors[getAdapterFromWalletType(walletType)] ?? [],\n        });\n        set({ activeWallet: wallet });\n        if (foundAdapter?.checkIsContractWallet && wallet) {\n          get().updateActiveWallet({\n            isContractAddress: await foundAdapter.checkIsContractWallet({\n              address: wallet.address,\n              chainId,\n            }),\n          });\n          if (callbackAfterConnected) {\n            await callbackAfterConnected(wallet);\n          }\n        }\n        set({ walletConnecting: false, lastConnectedWallet: { walletType, chainId } });\n      } catch (e) {\n        set({\n          walletConnecting: false,\n          walletConnectionError: 'Wallet connection failed: ' + (e instanceof Error ? e.message : String(e)),\n        });\n      }\n    },\n\n    /**\n     * Disconnects the currently active wallet\n     */\n    disconnect: async () => {\n      const activeWallet = get().activeWallet;\n      if (activeWallet) {\n        const foundAdapter = selectAdapterByKey({\n          adapter,\n          adapterKey: getAdapterFromWalletType(activeWallet.walletType),\n        });\n        await foundAdapter?.disconnect();\n        set({ activeWallet: undefined, lastConnectedWallet: undefined });\n      }\n    },\n\n    walletConnecting: false,\n\n    /**\n     * Resets any wallet connection errors\n     */\n    resetWalletConnectionError: () => {\n      set({ walletConnectionError: undefined });\n    },\n\n    /**\n     * Updates the active wallet's properties\n     * @param wallet - Partial wallet object with properties to update\n     */\n    updateActiveWallet: (wallet: Partial<Wallet>) => {\n      const activeWallet = get().activeWallet;\n      if (activeWallet) {\n        set((state) =>\n          produce(state, (draft) => {\n            if (draft.activeWallet) {\n              draft.activeWallet = {\n                ...draft.activeWallet,\n                ...wallet,\n              };\n            }\n          }),\n        );\n      } else {\n        if (wallet.walletType !== undefined && wallet.chainId !== undefined && wallet.address !== undefined) {\n          set({ activeWallet: wallet as Wallet });\n        }\n      }\n    },\n\n    /**\n     * Switches the connected wallet to a different network\n     * @param chainId - Target chain ID to switch to\n     */\n    switchNetwork: async (chainId: string | number) => {\n      set({ switchNetworkError: undefined });\n      const activeWallet = get().activeWallet;\n      if (activeWallet) {\n        const foundAdapter = selectAdapterByKey({\n          adapter,\n          adapterKey: getAdapterFromWalletType(activeWallet.walletType),\n        });\n        try {\n          await foundAdapter?.checkAndSwitchNetwork(chainId, activeWallet.chainId, get().updateActiveWallet);\n        } catch (e) {\n          set({ switchNetworkError: 'Switch network failed: ' + (e instanceof Error ? e.message : String(e)) });\n        }\n      }\n    },\n\n    /**\n     * Resets any network switching errors\n     */\n    resetSwitchNetworkError: () => set({ switchNetworkError: undefined }),\n  }));\n}\n","import { OrbitAdapter } from '@tuwaio/orbit-core';\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"]}

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import {OrbitAdapter,selectAdapterByKey}from'@tuwaio/orbit-core';import {produce}from'immer';import {createStore}from'zustand/vanilla';function l(r){return r.split(":")[0]??OrbitAdapter.EVM}function S({adapter:r,callbackAfterConnected:c}){return createStore()((a,i)=>({getAdapter:()=>r,availableConnectors:{},initializeAppConnectors:async({autoConnect:t})=>{if(Array.isArray(r))(await Promise.all(r.map(o=>o.getConnectors()))).forEach(o=>{a(e=>produce(e,p=>{p.availableConnectors[o.adapter]=o.connectors;}));});else {let n=await r.getConnectors();a(o=>produce(o,e=>{e.availableConnectors[n.adapter]=n.connectors;}));}if(t){let n=i().lastConnectedWallet;n&&await i().connect({walletType:n.walletType,chainId:n.chainId});}},connect:async({walletType:t,chainId:n})=>{a({walletConnecting:true,walletConnectionError:void 0});let o=selectAdapterByKey({adapter:r,adapterKey:l(t)});try{let e=await o?.connect({walletType:t,chainId:n,connectors:i().availableConnectors[l(t)]??[]});a({activeWallet:e}),o?.checkIsContractWallet&&e&&(i().updateActiveWallet({isContractAddress:await o.checkIsContractWallet({address:e.address,chainId:n})}),c&&await c(e)),a({walletConnecting:!1,lastConnectedWallet:{walletType:t,chainId:n}});}catch(e){a({walletConnecting:false,walletConnectionError:"Wallet connection failed: "+(e instanceof Error?e.message:String(e))});}},disconnect:async()=>{let t=i().activeWallet;t&&(await selectAdapterByKey({adapter:r,adapterKey:l(t.walletType)})?.disconnect(),a({activeWallet:void 0,lastConnectedWallet:void 0}));},walletConnecting:false,resetWalletConnectionError:()=>{a({walletConnectionError:void 0});},updateActiveWallet:t=>{i().activeWallet?a(o=>produce(o,e=>{e.activeWallet&&(e.activeWallet={...e.activeWallet,...t});})):t.walletType!==void 0&&t.chainId!==void 0&&t.address!==void 0&&a({activeWallet:t});},switchNetwork:async t=>{a({switchNetworkError:void 0});let n=i().activeWallet;if(n){let o=selectAdapterByKey({adapter:r,adapterKey:l(n.walletType)});try{await o?.checkAndSwitchNetwork(t,n.chainId,i().updateActiveWallet);}catch(e){a({switchNetworkError:"Switch network failed: "+(e instanceof Error?e.message:String(e))});}}},resetSwitchNetworkError:()=>a({switchNetworkError:void 0})}))}function h(r,c){return `${r}:${c.replace(/\s+/g,"").toLowerCase()}`}var E={impersonatedAddress:typeof window<"u"?window.localStorage.getItem("satellite-connect:impersonatedAddress")??"":"",setImpersonated:r=>typeof window<"u"?window.localStorage.setItem("satellite-connect:impersonatedAddress",r):void 0,getImpersonated:()=>typeof window<"u"?window.localStorage.getItem("satellite-connect:impersonatedAddress"):void 0};export{S as createSatelliteConnectStore,l as getAdapterFromWalletType,h as getWalletTypeFromConnectorName,E as impersonatedHelpers};//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/getAdapterFromWalletType.ts","../src/store/satelliteConnectStore.ts","../src/utils/getWalletTypeFromConnectorName.ts","../src/utils/impersonatedHelpers.ts"],"names":["getAdapterFromWalletType","walletType","OrbitAdapter","createSatelliteConnectStore","adapter","callbackAfterConnected","createStore","set","get","autoConnect","a","connectors","state","produce","draft","lastConnectedWallet","chainId","foundAdapter","selectAdapterByKey","wallet","activeWallet","getWalletTypeFromConnectorName","name","impersonatedHelpers","address"],"mappings":"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","file":"index.mjs","sourcesContent":["import { OrbitAdapter } from '@tuwaio/orbit-core';\n\nimport { 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] ?? OrbitAdapter.EVM) as OrbitAdapter;\n}\n","import { selectAdapterByKey } from '@tuwaio/orbit-core';\nimport { Draft, produce } from 'immer';\nimport { createStore } from 'zustand/vanilla';\n\nimport { Connector, ISatelliteConnectStore, SatelliteConnectStoreInitialParameters, Wallet } from '../types';\nimport { getAdapterFromWalletType } from '../utils/getAdapterFromWalletType';\n\n/**\n * Creates a Satellite Connect store instance for managing wallet connections and state\n *\n * @param params - Configuration parameters for the store\n * @param params.adapter - Single adapter or array of adapters for different chains\n * @param params.callbackAfterConnected - Optional callback function called after successful wallet connection\n *\n * @returns A Zustand store instance with wallet connection state and methods\n */\nexport function createSatelliteConnectStore({\n  adapter,\n  callbackAfterConnected,\n}: SatelliteConnectStoreInitialParameters) {\n  return createStore<ISatelliteConnectStore>()((set, get) => ({\n    /**\n     * Returns configured adapter(s)\n     */\n    getAdapter: () => adapter,\n\n    /**\n     * Available wallet connectors for each chain\n     */\n    availableConnectors: {},\n\n    /**\n     * Initializes wallet connectors for all configured adapters\n     * @param autoConnect - Whether to automatically reconnect to last used wallet\n     */\n    initializeAppConnectors: async ({ autoConnect }) => {\n      if (Array.isArray(adapter)) {\n        const connectors = await Promise.all(adapter.map((a) => a.getConnectors()));\n        connectors.forEach((connectors) => {\n          set((state) =>\n            produce(state, (draft) => {\n              draft.availableConnectors[connectors.adapter] = connectors.connectors as Draft<Connector[]>;\n            }),\n          );\n        });\n      } else {\n        const connectors = await adapter.getConnectors();\n        set((state) =>\n          produce(state, (draft) => {\n            draft.availableConnectors[connectors.adapter] = connectors.connectors as Draft<Connector[]>;\n          }),\n        );\n      }\n      if (autoConnect) {\n        const lastConnectedWallet = get().lastConnectedWallet;\n        if (lastConnectedWallet) {\n          await get().connect({ walletType: lastConnectedWallet.walletType, chainId: lastConnectedWallet.chainId });\n        }\n      }\n    },\n\n    /**\n     * Connects to a wallet\n     * @param walletType - Type of wallet to connect to\n     * @param chainId - Chain ID to connect on\n     */\n    connect: async ({ walletType, chainId }) => {\n      set({ walletConnecting: true, walletConnectionError: undefined });\n      const foundAdapter = selectAdapterByKey({ adapter, adapterKey: getAdapterFromWalletType(walletType) });\n      try {\n        const wallet = await foundAdapter?.connect({\n          walletType,\n          chainId,\n          connectors: get().availableConnectors[getAdapterFromWalletType(walletType)] ?? [],\n        });\n        set({ activeWallet: wallet });\n        if (foundAdapter?.checkIsContractWallet && wallet) {\n          get().updateActiveWallet({\n            isContractAddress: await foundAdapter.checkIsContractWallet({\n              address: wallet.address,\n              chainId,\n            }),\n          });\n          if (callbackAfterConnected) {\n            await callbackAfterConnected(wallet);\n          }\n        }\n        set({ walletConnecting: false, lastConnectedWallet: { walletType, chainId } });\n      } catch (e) {\n        set({\n          walletConnecting: false,\n          walletConnectionError: 'Wallet connection failed: ' + (e instanceof Error ? e.message : String(e)),\n        });\n      }\n    },\n\n    /**\n     * Disconnects the currently active wallet\n     */\n    disconnect: async () => {\n      const activeWallet = get().activeWallet;\n      if (activeWallet) {\n        const foundAdapter = selectAdapterByKey({\n          adapter,\n          adapterKey: getAdapterFromWalletType(activeWallet.walletType),\n        });\n        await foundAdapter?.disconnect();\n        set({ activeWallet: undefined, lastConnectedWallet: undefined });\n      }\n    },\n\n    walletConnecting: false,\n\n    /**\n     * Resets any wallet connection errors\n     */\n    resetWalletConnectionError: () => {\n      set({ walletConnectionError: undefined });\n    },\n\n    /**\n     * Updates the active wallet's properties\n     * @param wallet - Partial wallet object with properties to update\n     */\n    updateActiveWallet: (wallet: Partial<Wallet>) => {\n      const activeWallet = get().activeWallet;\n      if (activeWallet) {\n        set((state) =>\n          produce(state, (draft) => {\n            if (draft.activeWallet) {\n              draft.activeWallet = {\n                ...draft.activeWallet,\n                ...wallet,\n              };\n            }\n          }),\n        );\n      } else {\n        if (wallet.walletType !== undefined && wallet.chainId !== undefined && wallet.address !== undefined) {\n          set({ activeWallet: wallet as Wallet });\n        }\n      }\n    },\n\n    /**\n     * Switches the connected wallet to a different network\n     * @param chainId - Target chain ID to switch to\n     */\n    switchNetwork: async (chainId: string | number) => {\n      set({ switchNetworkError: undefined });\n      const activeWallet = get().activeWallet;\n      if (activeWallet) {\n        const foundAdapter = selectAdapterByKey({\n          adapter,\n          adapterKey: getAdapterFromWalletType(activeWallet.walletType),\n        });\n        try {\n          await foundAdapter?.checkAndSwitchNetwork(chainId, activeWallet.chainId, get().updateActiveWallet);\n        } catch (e) {\n          set({ switchNetworkError: 'Switch network failed: ' + (e instanceof Error ? e.message : String(e)) });\n        }\n      }\n    },\n\n    /**\n     * Resets any network switching errors\n     */\n    resetSwitchNetworkError: () => set({ switchNetworkError: undefined }),\n  }));\n}\n","import { OrbitAdapter } from '@tuwaio/orbit-core';\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"]}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@tuwaio/satellite-core",
+  "version": "0.0.3",
+  "private": false,
+  "author": "Oleksandr Tkach",
+  "license": "Apache-2.0",
+  "description": "The core, with store.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "web3",
+    "wallets",
+    "connect",
+    "zustand",
+    "immer",
+    "typescript",
+    "core",
+    "headless"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TuwaIO/satellite-connect.git",
+    "directory": "packages/satellite-core"
+  },
+  "homepage": "https://github.com/TuwaIO/satellite-connect",
+  "bugs": {
+    "url": "https://github.com/TuwaIO/satellite-connect/issues"
+  },
+  "contributors": [
+    {
+      "name": "Oleksandr Tkach",
+      "url": "https://github.com/Argeare5"
+    }
+  ],
+  "peerDependencies": {
+    "@wagmi/core": ">=2.2",
+    "@wallet-standard/ui": ">=1",
+    "@tuwaio/orbit-core": ">=0",
+    "immer": ">=10",
+    "zustand": ">=5"
+  },
+  "devDependencies": {
+    "@wagmi/core": "^2.21.1",
+    "@wallet-standard/ui": "^1.0.1",
+    "immer": "^10.1.3",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "zustand": "^5.0.8",
+    "@tuwaio/orbit-core": "^0.0.3"
+  },
+  "scripts": {
+    "start": "tsup src/index.ts --watch",
+    "build": "tsup"
+  }
+}