@tuwaio/orbit-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,101 @@
+# Orbit Core
+
+[![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)
+
+A powerful, framework-agnostic library for seamless multi-chain blockchain interactions, providing a unified interface for EVM, Solana, and Starknet operations.
+
+---
+
+## 🏛️ What is `@tuwaio/orbit-core`?
+
+`@tuwaio/orbit-core` is the foundation of the TUWA ecosystem. It's designed as a **headless** and **framework-agnostic** library that provides essential infrastructure for multi-chain blockchain interactions. The library doesn't include UI components or framework-specific code, making it versatile for any JavaScript or TypeScript application.
+
+Its primary purpose is to provide a unified interface for interacting with different blockchain architectures through a flexible adapter system. Built with TypeScript for type safety and maintainability, it serves as the backbone for blockchain applications requiring multi-chain support.
+
+---
+
+## ✨ Key Features
+
+- **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
+- **Optimized Performance:** Minimal overhead for blockchain operations
+- **Robust Error Handling:** Comprehensive error management across different chains
+
+---
+
+## 💾 Installation
+```bash
+# Using pnpm
+pnpm add @tuwaio/orbit-core zustand
+# Using npm
+npm install @tuwaio/orbit-core zustand
+# Using yarn
+yarn add @tuwaio/orbit-core zustand
+``` 
+
+---
+
+## 🚀 Quick Start
+
+### Basic Usage
+```typescript
+import { OrbitAdapter, selectAdapterByKey } from '@tuwaio/orbit-core';
+// Configure your adapter 
+const adapter = { key: OrbitAdapter.EVM };  // adapter implementation
+// Select adapter for specific chain 
+const evmAdapter = selectAdapterByKey({ adapterKey: OrbitAdapter.EVM, adapter, });
+``` 
+
+### Supported Chain Types
+```typescript
+// Available blockchain adapters 
+import { OrbitAdapter } from '@tuwaio/orbit-core';
+const chains = { evm: OrbitAdapter.EVM }; // Ethereum, Polygon, BSC, etc. solana: OrbitAdapter.SOLANA, // Solana blockchain starknet: OrbitAdapter.Starknet // Starknet L2
+``` 
+
+---
+
+## 🔧 Architecture
+
+Orbit Core is built on these main concepts:
+
+1. **Adapters:** Chain-specific implementations that handle blockchain interactions
+2. **Type System:** Comprehensive TypeScript definitions for type-safe development
+3. **Utilities:** Helper functions for common blockchain operations
+
+### Core Components
+
+- `OrbitAdapter`: Enum defining supported blockchain types
+- `selectAdapterByKey`: Utility for runtime adapter selection
+- `createBoundedUseStore`: Store creation helper for state management
+- Chain-specific helpers and utilities
+
+---
+
+## ✨ How It Connects to the Ecosystem
+
+The Orbit ecosystem consists of several packages:
+
+- **`@tuwaio/orbit-core`:** The foundation providing core functionality
+- **`@tuwaio/orbit-evm`:** EVM-specific helpers implementation
+- **`@tuwaio/orbit-solana`:** Solana blockchain helpers
+
+Each package serves a specific purpose while maintaining modularity and flexibility.
+
+---
+
+## 🤝 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.

package/dist/index.d.mts

@@ -0,0 +1,198 @@
+import { StoreApi } from 'zustand';
+
+/**
+ * @file
+ * Core type definitions for the Orbit blockchain adapter system.
+ * This file contains fundamental enums and types that define the supported blockchain architectures
+ * and their adapter interfaces.
+ */
+/**
+ * Defines the supported blockchain adapters in the Orbit system.
+ * Each adapter corresponds to a specific blockchain architecture and implements
+ * the necessary interfaces for that chain's functionality.
+ *
+ * @enum {string}
+ *
+ * @example
+ * ```typescript
+ * // Using adapter types in configuration
+ * const config = {
+ *   chainType: OrbitAdapter.EVM,
+ *   // other configuration...
+ * };
+ *
+ * // Checking adapter compatibility
+ * if (chainType === OrbitAdapter.SOLANA) {
+ *   // Solana-specific logic
+ * }
+ * ```
+ */
+declare enum OrbitAdapter {
+    /**
+     * For Ethereum Virtual Machine (EVM) compatible chains.
+     * Supports networks like:
+     * - Ethereum Mainnet
+     * - Polygon
+     * - Binance Smart Chain
+     * - Avalanche
+     * - Other EVM-compatible L1/L2 chains
+     */
+    EVM = "evm",
+    /**
+     * For the Solana blockchain.
+     * Supports:
+     * - Solana Mainnet
+     * - Devnet
+     * - Testnet
+     */
+    SOLANA = "solana",
+    /**
+     * For the Starknet L2 network.
+     * Supports:
+     * - Starknet Mainnet
+     * - Testnet (Goerli)
+     * - Other Starknet deployments
+     */
+    Starknet = "starknet"
+}
+/**
+ * Generic type for creating blockchain adapters with type safety.
+ * This type ensures that all adapters implement the required interface
+ * and are properly keyed by their blockchain type.
+ *
+ * @typeParam A - Type that extends the base adapter interface with a key property
+ *
+ * @property {A | A[]} adapter - Single adapter instance or array of adapters
+ *
+ * @example
+ * ```typescript
+ * // Single adapter implementation
+ * interface EVMAdapter extends BaseAdapter {
+ *   key: OrbitAdapter.EVM;
+ *   // EVM-specific methods...
+ * }
+ * const evmConfig: OrbitGenericAdapter<EVMAdapter> = {
+ *   adapter: {
+ *     key: OrbitAdapter.EVM,
+ *     // implementation...
+ *   }
+ * };
+ *
+ * // Multiple adapters
+ * const multiChainConfig: OrbitGenericAdapter<BaseAdapter> = {
+ *   adapter: [
+ *     { key: OrbitAdapter.EVM, ... },
+ *     { key: OrbitAdapter.SOLANA, ... }
+ *   ]
+ * };
+ * ```
+ */
+type OrbitGenericAdapter<A extends {
+    key: OrbitAdapter;
+}> = {
+    adapter: A | A[];
+};
+
+/**
+ * @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.
+ *
+ * @see https://docs.pmnd.rs/zustand/guides/typescript#bounded-usestore-hook-for-vanilla-stores
+ */
+
+/**
+ * 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`).
+ */
+type ExtractState<S> = S extends {
+    getState: () => infer T;
+} ? T : never;
+/**
+ * Creates a bounded `useStore` hook from a vanilla Zustand store.
+ *
+ * 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.
+ *
+ * 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.
+ *
+ * @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.
+ */
+declare const createBoundedUseStore: <S extends StoreApi<unknown>>(store: S) => {
+    (): ExtractState<S>;
+    <T>(selector: (state: ExtractState<S>) => T): T;
+};
+
+/**
+ * @file
+ * This module provides adapter selection functionality for the Orbit system.
+ * Part of the core infrastructure for managing blockchain adapters.
+ */
+
+/**
+ * Selects an appropriate adapter based on the provided key from either a single adapter
+ * or an array of adapters.
+ *
+ * @typeParam A - Type extending basic adapter interface with a key property
+ *
+ * @param options - Selection configuration object
+ * @param options.adapterKey - Target adapter key to search for
+ * @param options.adapter - Single adapter or array of adapters to search within
+ *
+ * @returns Selected adapter or undefined if no suitable adapter found
+ *
+ * @remarks
+ * If an array is provided but no matching adapter is found, falls back to the first adapter
+ * in the array with a warning message.
+ *
+ * @example
+ * ```typescript
+ * // Single adapter usage
+ * const singleResult = selectAdapterByKey({
+ *   adapterKey: OrbitAdapter.SOLANA,
+ *   adapter: { key: OrbitAdapter.SOLANA, connect: async () => {...} }
+ * });
+ *
+ * // Multiple adapters usage
+ * const multiResult = selectAdapterByKey({
+ *   adapterKey: OrbitAdapter.EVM,
+ *   adapter: [
+ *     { key: OrbitAdapter.SOLANA, connect: async () => {...} },
+ *     { key: OrbitAdapter.EVM, connect: async () => {...} }
+ *   ]
+ * });
+ * ```
+ *
+ * @throws {Error} Logs error if adapter array is empty
+ * @throws {Warning} Logs warning if requested adapter key not found in array
+ */
+declare const selectAdapterByKey: <A extends {
+    key: OrbitAdapter;
+}>({ adapterKey, adapter, }: {
+    adapterKey: OrbitAdapter;
+} & OrbitGenericAdapter<A>) => A | undefined;
+
+/**
+ * Checks whether the given chain ID belongs to a Solana network.
+ * Supports common Solana network names: 'devnet', 'testnet', 'mainnet-beta', 'mainnet'.
+ *
+ * @param {number | string} chainId - The chain ID or chain name.
+ * @returns {boolean} - True if the chain ID corresponds to a Solana network, false otherwise.
+ */
+declare function isSolanaChain(chainId: number | string): boolean;
+/**
+ * Sets the chain ID to a Solana-specific format if the chain is a Solana network.
+ *
+ * @param {number | string} chainId - The original chain ID or name.
+ * @returns {string | number} - The formatted chain ID prefixed with 'solana:' if Solana, otherwise the original.
+ */
+declare function setChainId(chainId: number | string): string | number;
+
+export { OrbitAdapter, type OrbitGenericAdapter, createBoundedUseStore, isSolanaChain, selectAdapterByKey, setChainId };

package/dist/index.d.ts

@@ -0,0 +1,198 @@
+import { StoreApi } from 'zustand';
+
+/**
+ * @file
+ * Core type definitions for the Orbit blockchain adapter system.
+ * This file contains fundamental enums and types that define the supported blockchain architectures
+ * and their adapter interfaces.
+ */
+/**
+ * Defines the supported blockchain adapters in the Orbit system.
+ * Each adapter corresponds to a specific blockchain architecture and implements
+ * the necessary interfaces for that chain's functionality.
+ *
+ * @enum {string}
+ *
+ * @example
+ * ```typescript
+ * // Using adapter types in configuration
+ * const config = {
+ *   chainType: OrbitAdapter.EVM,
+ *   // other configuration...
+ * };
+ *
+ * // Checking adapter compatibility
+ * if (chainType === OrbitAdapter.SOLANA) {
+ *   // Solana-specific logic
+ * }
+ * ```
+ */
+declare enum OrbitAdapter {
+    /**
+     * For Ethereum Virtual Machine (EVM) compatible chains.
+     * Supports networks like:
+     * - Ethereum Mainnet
+     * - Polygon
+     * - Binance Smart Chain
+     * - Avalanche
+     * - Other EVM-compatible L1/L2 chains
+     */
+    EVM = "evm",
+    /**
+     * For the Solana blockchain.
+     * Supports:
+     * - Solana Mainnet
+     * - Devnet
+     * - Testnet
+     */
+    SOLANA = "solana",
+    /**
+     * For the Starknet L2 network.
+     * Supports:
+     * - Starknet Mainnet
+     * - Testnet (Goerli)
+     * - Other Starknet deployments
+     */
+    Starknet = "starknet"
+}
+/**
+ * Generic type for creating blockchain adapters with type safety.
+ * This type ensures that all adapters implement the required interface
+ * and are properly keyed by their blockchain type.
+ *
+ * @typeParam A - Type that extends the base adapter interface with a key property
+ *
+ * @property {A | A[]} adapter - Single adapter instance or array of adapters
+ *
+ * @example
+ * ```typescript
+ * // Single adapter implementation
+ * interface EVMAdapter extends BaseAdapter {
+ *   key: OrbitAdapter.EVM;
+ *   // EVM-specific methods...
+ * }
+ * const evmConfig: OrbitGenericAdapter<EVMAdapter> = {
+ *   adapter: {
+ *     key: OrbitAdapter.EVM,
+ *     // implementation...
+ *   }
+ * };
+ *
+ * // Multiple adapters
+ * const multiChainConfig: OrbitGenericAdapter<BaseAdapter> = {
+ *   adapter: [
+ *     { key: OrbitAdapter.EVM, ... },
+ *     { key: OrbitAdapter.SOLANA, ... }
+ *   ]
+ * };
+ * ```
+ */
+type OrbitGenericAdapter<A extends {
+    key: OrbitAdapter;
+}> = {
+    adapter: A | A[];
+};
+
+/**
+ * @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.
+ *
+ * @see https://docs.pmnd.rs/zustand/guides/typescript#bounded-usestore-hook-for-vanilla-stores
+ */
+
+/**
+ * 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`).
+ */
+type ExtractState<S> = S extends {
+    getState: () => infer T;
+} ? T : never;
+/**
+ * Creates a bounded `useStore` hook from a vanilla Zustand store.
+ *
+ * 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.
+ *
+ * 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.
+ *
+ * @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.
+ */
+declare const createBoundedUseStore: <S extends StoreApi<unknown>>(store: S) => {
+    (): ExtractState<S>;
+    <T>(selector: (state: ExtractState<S>) => T): T;
+};
+
+/**
+ * @file
+ * This module provides adapter selection functionality for the Orbit system.
+ * Part of the core infrastructure for managing blockchain adapters.
+ */
+
+/**
+ * Selects an appropriate adapter based on the provided key from either a single adapter
+ * or an array of adapters.
+ *
+ * @typeParam A - Type extending basic adapter interface with a key property
+ *
+ * @param options - Selection configuration object
+ * @param options.adapterKey - Target adapter key to search for
+ * @param options.adapter - Single adapter or array of adapters to search within
+ *
+ * @returns Selected adapter or undefined if no suitable adapter found
+ *
+ * @remarks
+ * If an array is provided but no matching adapter is found, falls back to the first adapter
+ * in the array with a warning message.
+ *
+ * @example
+ * ```typescript
+ * // Single adapter usage
+ * const singleResult = selectAdapterByKey({
+ *   adapterKey: OrbitAdapter.SOLANA,
+ *   adapter: { key: OrbitAdapter.SOLANA, connect: async () => {...} }
+ * });
+ *
+ * // Multiple adapters usage
+ * const multiResult = selectAdapterByKey({
+ *   adapterKey: OrbitAdapter.EVM,
+ *   adapter: [
+ *     { key: OrbitAdapter.SOLANA, connect: async () => {...} },
+ *     { key: OrbitAdapter.EVM, connect: async () => {...} }
+ *   ]
+ * });
+ * ```
+ *
+ * @throws {Error} Logs error if adapter array is empty
+ * @throws {Warning} Logs warning if requested adapter key not found in array
+ */
+declare const selectAdapterByKey: <A extends {
+    key: OrbitAdapter;
+}>({ adapterKey, adapter, }: {
+    adapterKey: OrbitAdapter;
+} & OrbitGenericAdapter<A>) => A | undefined;
+
+/**
+ * Checks whether the given chain ID belongs to a Solana network.
+ * Supports common Solana network names: 'devnet', 'testnet', 'mainnet-beta', 'mainnet'.
+ *
+ * @param {number | string} chainId - The chain ID or chain name.
+ * @returns {boolean} - True if the chain ID corresponds to a Solana network, false otherwise.
+ */
+declare function isSolanaChain(chainId: number | string): boolean;
+/**
+ * Sets the chain ID to a Solana-specific format if the chain is a Solana network.
+ *
+ * @param {number | string} chainId - The original chain ID or name.
+ * @returns {string | number} - The formatted chain ID prefixed with 'solana:' if Solana, otherwise the original.
+ */
+declare function setChainId(chainId: number | string): string | number;
+
+export { OrbitAdapter, type OrbitGenericAdapter, createBoundedUseStore, isSolanaChain, selectAdapterByKey, setChainId };

package/dist/index.js

@@ -0,0 +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
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"]}

package/dist/index.mjs

@@ -0,0 +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
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +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"]}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@tuwaio/orbit-core",
+  "version": "0.0.3",
+  "private": false,
+  "author": "Oleksandr Tkach",
+  "license": "Apache-2.0",
+  "description": "The core, with web3 utilities and helpers for TUWA projects.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "web3",
+    "typescript",
+    "core",
+    "headless"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TuwaIO/satellite-connect.git",
+    "directory": "packages/orbit-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": {
+    "zustand": "^5.0.8"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "zustand": "^5.0.8"
+  },
+  "scripts": {
+    "start": "tsup src/index.ts --watch",
+    "build": "tsup"
+  }
+}