@tuwaio/satellite-solana 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,127 @@
+# Satellite Connect Solana
+
+[![NPM Version](https://img.shields.io/npm/v/@tuwaio/satellite-solana.svg)](https://www.npmjs.com/package/@tuwaio/satellite-solana)
+[![License](https://img.shields.io/npm/l/@tuwaio/satellite-solana.svg)](./LICENSE)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/TuwaIO/satellite-solana/release.yml?branch=main)](https://github.com/TuwaIO/satellite-solana/actions)
+
+Solana-specific implementation for the Satellite Connect ecosystem, providing comprehensive utilities and adapters for interacting with Solana wallets and networks.
+
+---
+
+## 🏛️ What is `@tuwaio/satellite-solana`?
+
+`@tuwaio/satellite-solana` is the Solana implementation of the Satellite ecosystem's wallet connection system. It provides specialized adapters and utilities for interacting with Solana-compatible wallets like Phantom, Solflare, and others.
+
+Built on top of `@tuwaio/satellite-core` and leveraging `@tuwaio/orbit-solana` for enhanced Solana interactions.
+
+---
+
+## ✨ Key Features
+
+- **Type Safety:** Full TypeScript support with proper type definitions
+- **Mobile Support:** Built-in mobile wallet connection support
+- **Modern Architecture:** Built on Gill for optimal performance
+- **Multi-Network:** Support for mainnet, devnet and testnet
+
+---
+
+## 💾 Installation
+
+### Requirements
+- Node.js 20+
+- TypeScript 5.9+
+
+```bash
+# Using pnpm (recommended)
+pnpm add @tuwaio/satellite-solana @tuwaio/satellite-core @tuwaio/orbit-core @tuwaio/orbit-solana gill @solana-mobile/wallet-standard-mobile immer zustand wagmi/core @wallet-standard/app @wallet-standard/base @wallet-standard/features @wallet-standard/ui @wallet-standard/ui-registry
+
+# Using npm
+npm install @tuwaio/satellite-solana @tuwaio/satellite-core @tuwaio/orbit-core @tuwaio/orbit-solana gill @solana-mobile/wallet-standard-mobile immer zustand wagmi/core @wallet-standard/app @wallet-standard/base @wallet-standard/features @wallet-standard/ui @wallet-standard/ui-registry
+
+# Using yarn
+yarn add @tuwaio/satellite-solana @tuwaio/satellite-core @tuwaio/orbit-core @tuwaio/orbit-solana gill @solana-mobile/wallet-standard-mobile immer zustand wagmi/core @wallet-standard/app @wallet-standard/base @wallet-standard/features @wallet-standard/ui @wallet-standard/ui-registry
+```
+---
+
+## 🚀 Quick Start
+
+### Basic Setup
+```typescript
+import { satelliteSolanaAdapter } from '@tuwaio/satellite-solana';
+
+// Configure RPC endpoints
+const solanaRPCUrls = {
+    devnet: 'https://api.devnet.solana.com',
+    mainnet: 'https://api.mainnet-beta.solana.com'
+};
+
+// Create Solana adapter
+const adapter = satelliteSolanaAdapter({
+  rpcUrls: solanaRPCUrls
+});
+```
+
+### Mobile Support Setup
+
+```typescript
+import { initializeSolanaMobileConnectors } from '@tuwaio/satellite-solana';
+
+// Initialize mobile connectors
+initializeSolanaMobileConnectors({
+    rpcUrls: solanaRPCUrls,
+    appName: 'Your dApp Name'
+});
+```
+---
+
+### Core Components
+
+1. **Adapters**
+   - Wallet-specific implementations
+   - Mobile wallet adapters
+
+2. **Mobile Support**
+   - Mobile wallet detection
+   - Mobile-specific connection flows
+   - Universal link handlers
+
+3. **Utils**
+   - Connection utilities
+
+---
+
+## 🌐 Supported Wallets
+
+- Phantom
+- Solflare
+- Backpack
+- Trust Wallet (Solana)
+- Mobile Wallets (via Mobile Wallet Adapter)
+- And other Solana-compatible wallets
+
+---
+
+## 🔗 Network Support
+
+Built-in support for all Solana networks:
+- Mainnet
+- Devnet
+- Testnet
+
+---
+
+## 🤝 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,109 @@
+import { SolanaRPCUrls } from '@tuwaio/orbit-solana';
+import { SatelliteAdapter, ConnectorsInitProps } from '@tuwaio/satellite-core';
+import { StandardConnectMethod } from '@wallet-standard/features';
+import { UiWallet, UiWalletAccount } from '@wallet-standard/ui';
+
+/**
+ * Creates a Solana blockchain adapter for the Satellite Connect system
+ *
+ * @remarks
+ * This adapter implements the SatelliteAdapter interface for Solana blockchain,
+ * providing wallet connection, network switching, and name resolution capabilities.
+ * It uses the Wallet Standard for consistent wallet interactions.
+ *
+ * @param rpcUrls - Configuration object containing RPC endpoints for different Solana networks
+ * @returns SatelliteAdapter implementation for Solana
+ *
+ * @example
+ * ```typescript
+ * const solanaAdapter = satelliteSolanaAdapter({
+ *   rpcUrls: {
+ *     mainnet: 'https://api.mainnet-beta.solana.com',
+ *     devnet: 'https://api.devnet.solana.com',
+ *     testnet: 'https://api.testnet.solana.com'
+ *   }
+ * });
+ * ```
+ */
+declare function satelliteSolanaAdapter({ rpcUrls }: SolanaRPCUrls): SatelliteAdapter;
+
+/**
+ * Combined props for initializing Solana mobile connectors
+ */
+type InitializeSolanaMobileConnectorsProps = ConnectorsInitProps & SolanaRPCUrls;
+/**
+ * Initializes Solana Mobile Wallet Adapter (MWA) for mobile wallet connections
+ *
+ * @remarks
+ * This function sets up the Solana Mobile Wallet Adapter with appropriate configuration
+ * for secure mobile wallet connections. It includes security checks and chain validation.
+ * Only works in secure contexts (HTTPS) and requires at least one valid chain configuration.
+ *
+ * @param props - Combined initialization properties
+ * @param props.rpcUrls - RPC endpoints for different Solana networks
+ * @param props.appName - Application name to display in wallet
+ * @param props.appUrl - Application URL
+ * @param props.appLogoUrl - Application logo URL
+ *
+ * @example
+ * ```typescript
+ * initializeSolanaMobileConnectors({
+ *   rpcUrls: {
+ *     mainnet: 'https://api.mainnet-beta.solana.com',
+ *     devnet: 'https://api.devnet.solana.com'
+ *   },
+ *   appName: 'My Solana App',
+ *   appUrl: 'https://myapp.com',
+ *   appLogoUrl: 'https://myapp.com/logo.png'
+ * });
+ * ```
+ *
+ * @throws {Warning} If not in secure context (non-HTTPS)
+ * @throws {Warning} If no chains are configured
+ */
+declare function initializeSolanaMobileConnectors({ rpcUrls, ...props }: InitializeSolanaMobileConnectorsProps): void;
+
+/**
+ * Establishes connection with a wallet using Wallet Standard
+ *
+ * @remarks
+ * Connects to a wallet that implements the Wallet Standard interface.
+ * Uses the StandardConnect feature to establish connection and retrieve accounts.
+ * Converts standard wallet accounts to UI wallet accounts.
+ *
+ * @param uiWallet - Wallet instance implementing the UI Wallet interface
+ * @param input - Optional connection parameters (excluding silent flag)
+ * @returns Promise resolving to array of connected wallet accounts
+ *
+ * @throws {Error} If wallet doesn't support StandardConnect feature
+ * @throws {Error} If connection attempt fails
+ *
+ * @example
+ * ```typescript
+ * const accounts = await connect(wallet, {
+ *   // Optional connection parameters
+ * });
+ * const firstAccount = accounts[0];
+ * console.log('Connected account:', firstAccount.address);
+ * ```
+ */
+declare function connect(uiWallet: UiWallet, input?: Omit<NonNullable<Parameters<StandardConnectMethod>[0]>, 'silent'>): Promise<readonly UiWalletAccount[]>;
+/**
+ * Disconnects from a connected wallet
+ *
+ * @remarks
+ * Safely disconnects from a wallet if it supports the StandardDisconnect feature.
+ * If the wallet doesn't support disconnection, the operation is silently ignored.
+ *
+ * @param uiWallet - Wallet instance implementing the UI Wallet interface
+ * @returns Promise that resolves when disconnection is complete
+ *
+ * @example
+ * ```typescript
+ * await disconnect(wallet);
+ * console.log('Wallet disconnected');
+ * ```
+ */
+declare function disconnect(uiWallet: UiWallet): Promise<void>;
+
+export { connect, disconnect, initializeSolanaMobileConnectors, satelliteSolanaAdapter };

package/dist/index.d.ts

@@ -0,0 +1,109 @@
+import { SolanaRPCUrls } from '@tuwaio/orbit-solana';
+import { SatelliteAdapter, ConnectorsInitProps } from '@tuwaio/satellite-core';
+import { StandardConnectMethod } from '@wallet-standard/features';
+import { UiWallet, UiWalletAccount } from '@wallet-standard/ui';
+
+/**
+ * Creates a Solana blockchain adapter for the Satellite Connect system
+ *
+ * @remarks
+ * This adapter implements the SatelliteAdapter interface for Solana blockchain,
+ * providing wallet connection, network switching, and name resolution capabilities.
+ * It uses the Wallet Standard for consistent wallet interactions.
+ *
+ * @param rpcUrls - Configuration object containing RPC endpoints for different Solana networks
+ * @returns SatelliteAdapter implementation for Solana
+ *
+ * @example
+ * ```typescript
+ * const solanaAdapter = satelliteSolanaAdapter({
+ *   rpcUrls: {
+ *     mainnet: 'https://api.mainnet-beta.solana.com',
+ *     devnet: 'https://api.devnet.solana.com',
+ *     testnet: 'https://api.testnet.solana.com'
+ *   }
+ * });
+ * ```
+ */
+declare function satelliteSolanaAdapter({ rpcUrls }: SolanaRPCUrls): SatelliteAdapter;
+
+/**
+ * Combined props for initializing Solana mobile connectors
+ */
+type InitializeSolanaMobileConnectorsProps = ConnectorsInitProps & SolanaRPCUrls;
+/**
+ * Initializes Solana Mobile Wallet Adapter (MWA) for mobile wallet connections
+ *
+ * @remarks
+ * This function sets up the Solana Mobile Wallet Adapter with appropriate configuration
+ * for secure mobile wallet connections. It includes security checks and chain validation.
+ * Only works in secure contexts (HTTPS) and requires at least one valid chain configuration.
+ *
+ * @param props - Combined initialization properties
+ * @param props.rpcUrls - RPC endpoints for different Solana networks
+ * @param props.appName - Application name to display in wallet
+ * @param props.appUrl - Application URL
+ * @param props.appLogoUrl - Application logo URL
+ *
+ * @example
+ * ```typescript
+ * initializeSolanaMobileConnectors({
+ *   rpcUrls: {
+ *     mainnet: 'https://api.mainnet-beta.solana.com',
+ *     devnet: 'https://api.devnet.solana.com'
+ *   },
+ *   appName: 'My Solana App',
+ *   appUrl: 'https://myapp.com',
+ *   appLogoUrl: 'https://myapp.com/logo.png'
+ * });
+ * ```
+ *
+ * @throws {Warning} If not in secure context (non-HTTPS)
+ * @throws {Warning} If no chains are configured
+ */
+declare function initializeSolanaMobileConnectors({ rpcUrls, ...props }: InitializeSolanaMobileConnectorsProps): void;
+
+/**
+ * Establishes connection with a wallet using Wallet Standard
+ *
+ * @remarks
+ * Connects to a wallet that implements the Wallet Standard interface.
+ * Uses the StandardConnect feature to establish connection and retrieve accounts.
+ * Converts standard wallet accounts to UI wallet accounts.
+ *
+ * @param uiWallet - Wallet instance implementing the UI Wallet interface
+ * @param input - Optional connection parameters (excluding silent flag)
+ * @returns Promise resolving to array of connected wallet accounts
+ *
+ * @throws {Error} If wallet doesn't support StandardConnect feature
+ * @throws {Error} If connection attempt fails
+ *
+ * @example
+ * ```typescript
+ * const accounts = await connect(wallet, {
+ *   // Optional connection parameters
+ * });
+ * const firstAccount = accounts[0];
+ * console.log('Connected account:', firstAccount.address);
+ * ```
+ */
+declare function connect(uiWallet: UiWallet, input?: Omit<NonNullable<Parameters<StandardConnectMethod>[0]>, 'silent'>): Promise<readonly UiWalletAccount[]>;
+/**
+ * Disconnects from a connected wallet
+ *
+ * @remarks
+ * Safely disconnects from a wallet if it supports the StandardDisconnect feature.
+ * If the wallet doesn't support disconnection, the operation is silently ignored.
+ *
+ * @param uiWallet - Wallet instance implementing the UI Wallet interface
+ * @returns Promise that resolves when disconnection is complete
+ *
+ * @example
+ * ```typescript
+ * await disconnect(wallet);
+ * console.log('Wallet disconnected');
+ * ```
+ */
+declare function disconnect(uiWallet: UiWallet): Promise<void>;
+
+export { connect, disconnect, initializeSolanaMobileConnectors, satelliteSolanaAdapter };

package/dist/index.js

@@ -0,0 +1,2 @@
+'use strict';var orbitCore=require('@tuwaio/orbit-core'),orbitSolana=require('@tuwaio/orbit-solana'),satelliteCore=require('@tuwaio/satellite-core'),app=require('@wallet-standard/app'),uiRegistry=require('@wallet-standard/ui-registry'),features=require('@wallet-standard/features'),ui=require('@wallet-standard/ui'),walletStandardMobile=require('@solana-mobile/wallet-standard-mobile');async function u(r,n){let t=ui.getWalletFeature(r,features.StandardConnect),{accounts:e}=await t.connect(n);return e.map(o=>uiRegistry.getOrCreateUiWalletAccountForStandardWalletAccount_DO_NOT_USE_OR_YOU_WILL_BE_FIRED(uiRegistry.getWalletForHandle_DO_NOT_USE_OR_YOU_WILL_BE_FIRED(r),o))}async function p(r){await ui.getWalletFeature(r,features.StandardDisconnect)?.disconnect();}function H({rpcUrls:r}){let n=()=>app.getWallets().get().map(uiRegistry.getOrCreateUiWalletForStandardWallet_DO_NOT_USE_OR_YOU_WILL_BE_FIRED);return {key:orbitCore.OrbitAdapter.SOLANA,async connect({walletType:t,chainId:e,connectors:o}){let c=o.find(a=>satelliteCore.getWalletTypeFromConnectorName(orbitCore.OrbitAdapter.SOLANA,a.name)===t);if(!c)throw new Error("Cannot find connector with this wallet type");try{let a=await u(c),f=n(),i=orbitSolana.getCluster({cluster:e});return {walletType:t,address:a[0].address,chainId:i,rpcURL:orbitSolana.getRpcUrlForCluster({cluster:i,rpcUrls:r}),isConnected:!0,isContractAddress:!1,connectedAccount:a,connectedWallet:f.filter(S=>S.accounts.length>0)[0]}}catch(a){throw new Error(a instanceof Error?a.message:String(a))}},async disconnect(){let e=n().filter(o=>o.accounts.length>0)[0];await p(e);},async getConnectors(){let t=n();return {adapter:orbitCore.OrbitAdapter.SOLANA,connectors:t}},async checkAndSwitchNetwork(t,e,o){if(e!==t&&o){let c=orbitSolana.getCluster({cluster:t});o({chainId:c,rpcURL:orbitSolana.getRpcUrlForCluster({cluster:c,rpcUrls:r})});}},getExplorerUrl(t,e){let o=orbitSolana.getCluster({cluster:e})??"mainnet";return orbitSolana.getSolanaExplorerLink(t,o)},async getName(t){return n().filter(c=>c.accounts.some(a=>a.address.toLowerCase()===t.toLowerCase()))[0]?.accounts[0]?.label??t},async getAvatar(t){return n().filter(c=>c.accounts.some(a=>a.label?.toLowerCase()===t.toLowerCase()))[0]?.accounts[0]?.icon??t}}}function $({rpcUrls:r,...n}){if(typeof window>"u")return;if(!window.isSecureContext){console.warn("Solana Mobile Connectors not loaded: https connection required");return}let t=Object.keys(r).map(e=>`solana:${e}`);if(t.length===0){console.warn("Solana Mobile Connectors not loaded: no chains provided");return}walletStandardMobile.registerMwa({appIdentity:{uri:n?.appUrl,icon:n?.appLogoUrl,name:n?.appName},authorizationCache:walletStandardMobile.createDefaultAuthorizationCache(),chains:t,chainSelector:walletStandardMobile.createDefaultChainSelector(),onWalletNotFound:walletStandardMobile.createDefaultWalletNotFoundHandler()});}exports.connect=u;exports.disconnect=p;exports.initializeSolanaMobileConnectors=$;exports.satelliteSolanaAdapter=H;//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/connectionUtils.ts","../src/adapters/solanaAdapter.ts","../src/connectors/initializeSolanaMobileConnectors.ts"],"names":["connect","uiWallet","input","connectFeature","getWalletFeature","StandardConnect","accounts","account","getOrCreateUiWalletAccountForStandardWalletAccount","getWalletForHandle","disconnect","StandardDisconnect","satelliteSolanaAdapter","rpcUrls","getAvailableWallets","getWallets","getOrCreateUiWalletForStandardWallet","OrbitAdapter","walletType","chainId","connectors","connector","getWalletTypeFromConnectorName","connectedAccount","wallets","cluster","getCluster","getRpcUrlForCluster","wallet","e","connectedWallet","currentChainId","updateActiveWallet","url","getSolanaExplorerLink","address","name","initializeSolanaMobileConnectors","props","chains","key","registerMwa","createDefaultAuthorizationCache","createDefaultChainSelector","createDefaultWalletNotFoundHandler"],"mappings":"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","file":"index.js","sourcesContent":["import type {\n  StandardConnectFeature,\n  StandardConnectMethod,\n  StandardDisconnectFeature,\n} from '@wallet-standard/features';\nimport { StandardConnect, StandardDisconnect } from '@wallet-standard/features';\nimport { getWalletFeature, type UiWallet, type UiWalletAccount } from '@wallet-standard/ui';\nimport {\n  getOrCreateUiWalletAccountForStandardWalletAccount_DO_NOT_USE_OR_YOU_WILL_BE_FIRED as getOrCreateUiWalletAccountForStandardWalletAccount,\n  getWalletForHandle_DO_NOT_USE_OR_YOU_WILL_BE_FIRED as getWalletForHandle,\n} from '@wallet-standard/ui-registry';\n\n/**\n * Establishes connection with a wallet using Wallet Standard\n *\n * @remarks\n * Connects to a wallet that implements the Wallet Standard interface.\n * Uses the StandardConnect feature to establish connection and retrieve accounts.\n * Converts standard wallet accounts to UI wallet accounts.\n *\n * @param uiWallet - Wallet instance implementing the UI Wallet interface\n * @param input - Optional connection parameters (excluding silent flag)\n * @returns Promise resolving to array of connected wallet accounts\n *\n * @throws {Error} If wallet doesn't support StandardConnect feature\n * @throws {Error} If connection attempt fails\n *\n * @example\n * ```typescript\n * const accounts = await connect(wallet, {\n *   // Optional connection parameters\n * });\n * const firstAccount = accounts[0];\n * console.log('Connected account:', firstAccount.address);\n * ```\n */\nexport async function connect(\n  uiWallet: UiWallet,\n  input?: Omit<NonNullable<Parameters<StandardConnectMethod>[0]>, 'silent'>,\n): Promise<readonly UiWalletAccount[]> {\n  // Get the connect feature from the wallet\n  const connectFeature = getWalletFeature(uiWallet, StandardConnect) as StandardConnectFeature[typeof StandardConnect];\n\n  // Initiate connection and get accounts\n  const { accounts } = await connectFeature.connect(input);\n\n  // Convert accounts to UI wallet accounts\n  return accounts.map((account) =>\n    getOrCreateUiWalletAccountForStandardWalletAccount(getWalletForHandle(uiWallet), account),\n  );\n}\n\n/**\n * Disconnects from a connected wallet\n *\n * @remarks\n * Safely disconnects from a wallet if it supports the StandardDisconnect feature.\n * If the wallet doesn't support disconnection, the operation is silently ignored.\n *\n * @param uiWallet - Wallet instance implementing the UI Wallet interface\n * @returns Promise that resolves when disconnection is complete\n *\n * @example\n * ```typescript\n * await disconnect(wallet);\n * console.log('Wallet disconnected');\n * ```\n */\nexport async function disconnect(uiWallet: UiWallet): Promise<void> {\n  // Get the disconnect feature if available\n  const disconnectFeature = getWalletFeature(uiWallet, StandardDisconnect) as\n    | StandardDisconnectFeature[typeof StandardDisconnect]\n    | undefined;\n\n  // Attempt disconnection if feature is supported\n  await disconnectFeature?.disconnect();\n}\n","import { OrbitAdapter } from '@tuwaio/orbit-core';\nimport { getCluster, getRpcUrlForCluster, getSolanaExplorerLink, SolanaRPCUrls } from '@tuwaio/orbit-solana';\nimport { ConnectorSolana, getWalletTypeFromConnectorName, SatelliteAdapter } from '@tuwaio/satellite-core';\nimport { getWallets } from '@wallet-standard/app';\nimport { UiWallet } from '@wallet-standard/ui';\nimport { getOrCreateUiWalletForStandardWallet_DO_NOT_USE_OR_YOU_WILL_BE_FIRED as getOrCreateUiWalletForStandardWallet } from '@wallet-standard/ui-registry';\nimport { SolanaClusterMoniker } from 'gill';\n\nimport { connect, disconnect } from '../utils/connectionUtils';\n\n/**\n * Creates a Solana blockchain adapter for the Satellite Connect system\n *\n * @remarks\n * This adapter implements the SatelliteAdapter interface for Solana blockchain,\n * providing wallet connection, network switching, and name resolution capabilities.\n * It uses the Wallet Standard for consistent wallet interactions.\n *\n * @param rpcUrls - Configuration object containing RPC endpoints for different Solana networks\n * @returns SatelliteAdapter implementation for Solana\n *\n * @example\n * ```typescript\n * const solanaAdapter = satelliteSolanaAdapter({\n *   rpcUrls: {\n *     mainnet: 'https://api.mainnet-beta.solana.com',\n *     devnet: 'https://api.devnet.solana.com',\n *     testnet: 'https://api.testnet.solana.com'\n *   }\n * });\n * ```\n */\nexport function satelliteSolanaAdapter({ rpcUrls }: SolanaRPCUrls): SatelliteAdapter {\n  /**\n   * Helper to get all available wallets\n   */\n  const getAvailableWallets = () => getWallets().get().map(getOrCreateUiWalletForStandardWallet);\n\n  return {\n    key: OrbitAdapter.SOLANA,\n\n    async connect({ walletType, chainId, connectors }) {\n      const connector = connectors.find(\n        (connector) => getWalletTypeFromConnectorName(OrbitAdapter.SOLANA, connector.name) === walletType,\n      );\n      if (!connector) throw new Error('Cannot find connector with this wallet type');\n\n      try {\n        const connectedAccount = await connect(connector as UiWallet);\n        const wallets = getAvailableWallets();\n        const cluster = getCluster({ cluster: chainId as string });\n\n        return {\n          walletType,\n          address: connectedAccount[0].address,\n          chainId: cluster,\n          rpcURL: getRpcUrlForCluster({\n            cluster: cluster as SolanaClusterMoniker,\n            rpcUrls,\n          }),\n          isConnected: true,\n          isContractAddress: false,\n          connectedAccount,\n          connectedWallet: wallets.filter((wallet) => wallet.accounts.length > 0)[0],\n        };\n      } catch (e) {\n        throw new Error(e instanceof Error ? e.message : String(e));\n      }\n    },\n\n    async disconnect() {\n      const wallets = getAvailableWallets();\n      const connectedWallet = wallets.filter((wallet) => wallet.accounts.length > 0)[0];\n      await disconnect(connectedWallet);\n    },\n\n    async getConnectors() {\n      const connectors = getAvailableWallets();\n      return {\n        adapter: OrbitAdapter.SOLANA,\n        connectors: connectors as ConnectorSolana[],\n      };\n    },\n\n    async checkAndSwitchNetwork(chainId, currentChainId, updateActiveWallet) {\n      if (currentChainId !== chainId && updateActiveWallet) {\n        const cluster = getCluster({ cluster: chainId as string });\n        updateActiveWallet({\n          chainId: cluster,\n          rpcURL: getRpcUrlForCluster({\n            cluster: cluster as SolanaClusterMoniker,\n            rpcUrls,\n          }),\n        });\n      }\n    },\n\n    getExplorerUrl(url, chainId) {\n      const cluster = getCluster({ cluster: chainId as string }) ?? 'mainnet';\n      return getSolanaExplorerLink(url, cluster as SolanaClusterMoniker);\n    },\n\n    async getName(address) {\n      const wallets = getAvailableWallets();\n      const connectedWallet = wallets.filter((wallet) =>\n        wallet.accounts.some((account) => account.address.toLowerCase() === address.toLowerCase()),\n      )[0];\n      return connectedWallet?.accounts[0]?.label ?? address;\n    },\n\n    async getAvatar(name) {\n      const wallets = getAvailableWallets();\n      const connectedWallet = wallets.filter((wallet) =>\n        wallet.accounts.some((account) => account.label?.toLowerCase() === name.toLowerCase()),\n      )[0];\n      return connectedWallet?.accounts[0]?.icon ?? name;\n    },\n  };\n}\n","import {\n  createDefaultAuthorizationCache,\n  createDefaultChainSelector,\n  createDefaultWalletNotFoundHandler,\n  registerMwa,\n} from '@solana-mobile/wallet-standard-mobile';\nimport { SolanaRPCUrls } from '@tuwaio/orbit-solana';\nimport { ConnectorsInitProps } from '@tuwaio/satellite-core';\n\n/**\n * Combined props for initializing Solana mobile connectors\n */\ntype InitializeSolanaMobileConnectorsProps = ConnectorsInitProps & SolanaRPCUrls;\n\n/**\n * Initializes Solana Mobile Wallet Adapter (MWA) for mobile wallet connections\n *\n * @remarks\n * This function sets up the Solana Mobile Wallet Adapter with appropriate configuration\n * for secure mobile wallet connections. It includes security checks and chain validation.\n * Only works in secure contexts (HTTPS) and requires at least one valid chain configuration.\n *\n * @param props - Combined initialization properties\n * @param props.rpcUrls - RPC endpoints for different Solana networks\n * @param props.appName - Application name to display in wallet\n * @param props.appUrl - Application URL\n * @param props.appLogoUrl - Application logo URL\n *\n * @example\n * ```typescript\n * initializeSolanaMobileConnectors({\n *   rpcUrls: {\n *     mainnet: 'https://api.mainnet-beta.solana.com',\n *     devnet: 'https://api.devnet.solana.com'\n *   },\n *   appName: 'My Solana App',\n *   appUrl: 'https://myapp.com',\n *   appLogoUrl: 'https://myapp.com/logo.png'\n * });\n * ```\n *\n * @throws {Warning} If not in secure context (non-HTTPS)\n * @throws {Warning} If no chains are configured\n */\nexport function initializeSolanaMobileConnectors({ rpcUrls, ...props }: InitializeSolanaMobileConnectorsProps): void {\n  // Only run in browser environment\n  if (typeof window === 'undefined') {\n    return;\n  }\n  // Ensure secure context (HTTPS)\n  if (!window.isSecureContext) {\n    console.warn('Solana Mobile Connectors not loaded: https connection required');\n    return;\n  }\n\n  // Generate chain identifiers\n  const chains = Object.keys(rpcUrls).map((key) => `solana:${key}` as `solana:${string}`);\n\n  // Validate chain configuration\n  if (chains.length === 0) {\n    console.warn('Solana Mobile Connectors not loaded: no chains provided');\n    return;\n  }\n\n  // Register Mobile Wallet Adapter\n  registerMwa({\n    appIdentity: {\n      uri: props?.appUrl,\n      icon: props?.appLogoUrl,\n      name: props?.appName,\n    },\n    authorizationCache: createDefaultAuthorizationCache(),\n    chains,\n    chainSelector: createDefaultChainSelector(),\n    onWalletNotFound: createDefaultWalletNotFoundHandler(),\n  });\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import {OrbitAdapter}from'@tuwaio/orbit-core';import {getCluster,getSolanaExplorerLink,getRpcUrlForCluster}from'@tuwaio/orbit-solana';import {getWalletTypeFromConnectorName}from'@tuwaio/satellite-core';import {getWallets}from'@wallet-standard/app';import {getOrCreateUiWalletAccountForStandardWalletAccount_DO_NOT_USE_OR_YOU_WILL_BE_FIRED,getWalletForHandle_DO_NOT_USE_OR_YOU_WILL_BE_FIRED,getOrCreateUiWalletForStandardWallet_DO_NOT_USE_OR_YOU_WILL_BE_FIRED}from'@wallet-standard/ui-registry';import {StandardConnect,StandardDisconnect}from'@wallet-standard/features';import {getWalletFeature}from'@wallet-standard/ui';import {registerMwa,createDefaultWalletNotFoundHandler,createDefaultChainSelector,createDefaultAuthorizationCache}from'@solana-mobile/wallet-standard-mobile';async function u(r,n){let t=getWalletFeature(r,StandardConnect),{accounts:e}=await t.connect(n);return e.map(o=>getOrCreateUiWalletAccountForStandardWalletAccount_DO_NOT_USE_OR_YOU_WILL_BE_FIRED(getWalletForHandle_DO_NOT_USE_OR_YOU_WILL_BE_FIRED(r),o))}async function p(r){await getWalletFeature(r,StandardDisconnect)?.disconnect();}function H({rpcUrls:r}){let n=()=>getWallets().get().map(getOrCreateUiWalletForStandardWallet_DO_NOT_USE_OR_YOU_WILL_BE_FIRED);return {key:OrbitAdapter.SOLANA,async connect({walletType:t,chainId:e,connectors:o}){let c=o.find(a=>getWalletTypeFromConnectorName(OrbitAdapter.SOLANA,a.name)===t);if(!c)throw new Error("Cannot find connector with this wallet type");try{let a=await u(c),f=n(),i=getCluster({cluster:e});return {walletType:t,address:a[0].address,chainId:i,rpcURL:getRpcUrlForCluster({cluster:i,rpcUrls:r}),isConnected:!0,isContractAddress:!1,connectedAccount:a,connectedWallet:f.filter(S=>S.accounts.length>0)[0]}}catch(a){throw new Error(a instanceof Error?a.message:String(a))}},async disconnect(){let e=n().filter(o=>o.accounts.length>0)[0];await p(e);},async getConnectors(){let t=n();return {adapter:OrbitAdapter.SOLANA,connectors:t}},async checkAndSwitchNetwork(t,e,o){if(e!==t&&o){let c=getCluster({cluster:t});o({chainId:c,rpcURL:getRpcUrlForCluster({cluster:c,rpcUrls:r})});}},getExplorerUrl(t,e){let o=getCluster({cluster:e})??"mainnet";return getSolanaExplorerLink(t,o)},async getName(t){return n().filter(c=>c.accounts.some(a=>a.address.toLowerCase()===t.toLowerCase()))[0]?.accounts[0]?.label??t},async getAvatar(t){return n().filter(c=>c.accounts.some(a=>a.label?.toLowerCase()===t.toLowerCase()))[0]?.accounts[0]?.icon??t}}}function $({rpcUrls:r,...n}){if(typeof window>"u")return;if(!window.isSecureContext){console.warn("Solana Mobile Connectors not loaded: https connection required");return}let t=Object.keys(r).map(e=>`solana:${e}`);if(t.length===0){console.warn("Solana Mobile Connectors not loaded: no chains provided");return}registerMwa({appIdentity:{uri:n?.appUrl,icon:n?.appLogoUrl,name:n?.appName},authorizationCache:createDefaultAuthorizationCache(),chains:t,chainSelector:createDefaultChainSelector(),onWalletNotFound:createDefaultWalletNotFoundHandler()});}export{u as connect,p as disconnect,$ as initializeSolanaMobileConnectors,H as satelliteSolanaAdapter};//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/connectionUtils.ts","../src/adapters/solanaAdapter.ts","../src/connectors/initializeSolanaMobileConnectors.ts"],"names":["connect","uiWallet","input","connectFeature","getWalletFeature","StandardConnect","accounts","account","getOrCreateUiWalletAccountForStandardWalletAccount","getWalletForHandle","disconnect","StandardDisconnect","satelliteSolanaAdapter","rpcUrls","getAvailableWallets","getWallets","getOrCreateUiWalletForStandardWallet","OrbitAdapter","walletType","chainId","connectors","connector","getWalletTypeFromConnectorName","connectedAccount","wallets","cluster","getCluster","getRpcUrlForCluster","wallet","e","connectedWallet","currentChainId","updateActiveWallet","url","getSolanaExplorerLink","address","name","initializeSolanaMobileConnectors","props","chains","key","registerMwa","createDefaultAuthorizationCache","createDefaultChainSelector","createDefaultWalletNotFoundHandler"],"mappings":"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","file":"index.mjs","sourcesContent":["import type {\n  StandardConnectFeature,\n  StandardConnectMethod,\n  StandardDisconnectFeature,\n} from '@wallet-standard/features';\nimport { StandardConnect, StandardDisconnect } from '@wallet-standard/features';\nimport { getWalletFeature, type UiWallet, type UiWalletAccount } from '@wallet-standard/ui';\nimport {\n  getOrCreateUiWalletAccountForStandardWalletAccount_DO_NOT_USE_OR_YOU_WILL_BE_FIRED as getOrCreateUiWalletAccountForStandardWalletAccount,\n  getWalletForHandle_DO_NOT_USE_OR_YOU_WILL_BE_FIRED as getWalletForHandle,\n} from '@wallet-standard/ui-registry';\n\n/**\n * Establishes connection with a wallet using Wallet Standard\n *\n * @remarks\n * Connects to a wallet that implements the Wallet Standard interface.\n * Uses the StandardConnect feature to establish connection and retrieve accounts.\n * Converts standard wallet accounts to UI wallet accounts.\n *\n * @param uiWallet - Wallet instance implementing the UI Wallet interface\n * @param input - Optional connection parameters (excluding silent flag)\n * @returns Promise resolving to array of connected wallet accounts\n *\n * @throws {Error} If wallet doesn't support StandardConnect feature\n * @throws {Error} If connection attempt fails\n *\n * @example\n * ```typescript\n * const accounts = await connect(wallet, {\n *   // Optional connection parameters\n * });\n * const firstAccount = accounts[0];\n * console.log('Connected account:', firstAccount.address);\n * ```\n */\nexport async function connect(\n  uiWallet: UiWallet,\n  input?: Omit<NonNullable<Parameters<StandardConnectMethod>[0]>, 'silent'>,\n): Promise<readonly UiWalletAccount[]> {\n  // Get the connect feature from the wallet\n  const connectFeature = getWalletFeature(uiWallet, StandardConnect) as StandardConnectFeature[typeof StandardConnect];\n\n  // Initiate connection and get accounts\n  const { accounts } = await connectFeature.connect(input);\n\n  // Convert accounts to UI wallet accounts\n  return accounts.map((account) =>\n    getOrCreateUiWalletAccountForStandardWalletAccount(getWalletForHandle(uiWallet), account),\n  );\n}\n\n/**\n * Disconnects from a connected wallet\n *\n * @remarks\n * Safely disconnects from a wallet if it supports the StandardDisconnect feature.\n * If the wallet doesn't support disconnection, the operation is silently ignored.\n *\n * @param uiWallet - Wallet instance implementing the UI Wallet interface\n * @returns Promise that resolves when disconnection is complete\n *\n * @example\n * ```typescript\n * await disconnect(wallet);\n * console.log('Wallet disconnected');\n * ```\n */\nexport async function disconnect(uiWallet: UiWallet): Promise<void> {\n  // Get the disconnect feature if available\n  const disconnectFeature = getWalletFeature(uiWallet, StandardDisconnect) as\n    | StandardDisconnectFeature[typeof StandardDisconnect]\n    | undefined;\n\n  // Attempt disconnection if feature is supported\n  await disconnectFeature?.disconnect();\n}\n","import { OrbitAdapter } from '@tuwaio/orbit-core';\nimport { getCluster, getRpcUrlForCluster, getSolanaExplorerLink, SolanaRPCUrls } from '@tuwaio/orbit-solana';\nimport { ConnectorSolana, getWalletTypeFromConnectorName, SatelliteAdapter } from '@tuwaio/satellite-core';\nimport { getWallets } from '@wallet-standard/app';\nimport { UiWallet } from '@wallet-standard/ui';\nimport { getOrCreateUiWalletForStandardWallet_DO_NOT_USE_OR_YOU_WILL_BE_FIRED as getOrCreateUiWalletForStandardWallet } from '@wallet-standard/ui-registry';\nimport { SolanaClusterMoniker } from 'gill';\n\nimport { connect, disconnect } from '../utils/connectionUtils';\n\n/**\n * Creates a Solana blockchain adapter for the Satellite Connect system\n *\n * @remarks\n * This adapter implements the SatelliteAdapter interface for Solana blockchain,\n * providing wallet connection, network switching, and name resolution capabilities.\n * It uses the Wallet Standard for consistent wallet interactions.\n *\n * @param rpcUrls - Configuration object containing RPC endpoints for different Solana networks\n * @returns SatelliteAdapter implementation for Solana\n *\n * @example\n * ```typescript\n * const solanaAdapter = satelliteSolanaAdapter({\n *   rpcUrls: {\n *     mainnet: 'https://api.mainnet-beta.solana.com',\n *     devnet: 'https://api.devnet.solana.com',\n *     testnet: 'https://api.testnet.solana.com'\n *   }\n * });\n * ```\n */\nexport function satelliteSolanaAdapter({ rpcUrls }: SolanaRPCUrls): SatelliteAdapter {\n  /**\n   * Helper to get all available wallets\n   */\n  const getAvailableWallets = () => getWallets().get().map(getOrCreateUiWalletForStandardWallet);\n\n  return {\n    key: OrbitAdapter.SOLANA,\n\n    async connect({ walletType, chainId, connectors }) {\n      const connector = connectors.find(\n        (connector) => getWalletTypeFromConnectorName(OrbitAdapter.SOLANA, connector.name) === walletType,\n      );\n      if (!connector) throw new Error('Cannot find connector with this wallet type');\n\n      try {\n        const connectedAccount = await connect(connector as UiWallet);\n        const wallets = getAvailableWallets();\n        const cluster = getCluster({ cluster: chainId as string });\n\n        return {\n          walletType,\n          address: connectedAccount[0].address,\n          chainId: cluster,\n          rpcURL: getRpcUrlForCluster({\n            cluster: cluster as SolanaClusterMoniker,\n            rpcUrls,\n          }),\n          isConnected: true,\n          isContractAddress: false,\n          connectedAccount,\n          connectedWallet: wallets.filter((wallet) => wallet.accounts.length > 0)[0],\n        };\n      } catch (e) {\n        throw new Error(e instanceof Error ? e.message : String(e));\n      }\n    },\n\n    async disconnect() {\n      const wallets = getAvailableWallets();\n      const connectedWallet = wallets.filter((wallet) => wallet.accounts.length > 0)[0];\n      await disconnect(connectedWallet);\n    },\n\n    async getConnectors() {\n      const connectors = getAvailableWallets();\n      return {\n        adapter: OrbitAdapter.SOLANA,\n        connectors: connectors as ConnectorSolana[],\n      };\n    },\n\n    async checkAndSwitchNetwork(chainId, currentChainId, updateActiveWallet) {\n      if (currentChainId !== chainId && updateActiveWallet) {\n        const cluster = getCluster({ cluster: chainId as string });\n        updateActiveWallet({\n          chainId: cluster,\n          rpcURL: getRpcUrlForCluster({\n            cluster: cluster as SolanaClusterMoniker,\n            rpcUrls,\n          }),\n        });\n      }\n    },\n\n    getExplorerUrl(url, chainId) {\n      const cluster = getCluster({ cluster: chainId as string }) ?? 'mainnet';\n      return getSolanaExplorerLink(url, cluster as SolanaClusterMoniker);\n    },\n\n    async getName(address) {\n      const wallets = getAvailableWallets();\n      const connectedWallet = wallets.filter((wallet) =>\n        wallet.accounts.some((account) => account.address.toLowerCase() === address.toLowerCase()),\n      )[0];\n      return connectedWallet?.accounts[0]?.label ?? address;\n    },\n\n    async getAvatar(name) {\n      const wallets = getAvailableWallets();\n      const connectedWallet = wallets.filter((wallet) =>\n        wallet.accounts.some((account) => account.label?.toLowerCase() === name.toLowerCase()),\n      )[0];\n      return connectedWallet?.accounts[0]?.icon ?? name;\n    },\n  };\n}\n","import {\n  createDefaultAuthorizationCache,\n  createDefaultChainSelector,\n  createDefaultWalletNotFoundHandler,\n  registerMwa,\n} from '@solana-mobile/wallet-standard-mobile';\nimport { SolanaRPCUrls } from '@tuwaio/orbit-solana';\nimport { ConnectorsInitProps } from '@tuwaio/satellite-core';\n\n/**\n * Combined props for initializing Solana mobile connectors\n */\ntype InitializeSolanaMobileConnectorsProps = ConnectorsInitProps & SolanaRPCUrls;\n\n/**\n * Initializes Solana Mobile Wallet Adapter (MWA) for mobile wallet connections\n *\n * @remarks\n * This function sets up the Solana Mobile Wallet Adapter with appropriate configuration\n * for secure mobile wallet connections. It includes security checks and chain validation.\n * Only works in secure contexts (HTTPS) and requires at least one valid chain configuration.\n *\n * @param props - Combined initialization properties\n * @param props.rpcUrls - RPC endpoints for different Solana networks\n * @param props.appName - Application name to display in wallet\n * @param props.appUrl - Application URL\n * @param props.appLogoUrl - Application logo URL\n *\n * @example\n * ```typescript\n * initializeSolanaMobileConnectors({\n *   rpcUrls: {\n *     mainnet: 'https://api.mainnet-beta.solana.com',\n *     devnet: 'https://api.devnet.solana.com'\n *   },\n *   appName: 'My Solana App',\n *   appUrl: 'https://myapp.com',\n *   appLogoUrl: 'https://myapp.com/logo.png'\n * });\n * ```\n *\n * @throws {Warning} If not in secure context (non-HTTPS)\n * @throws {Warning} If no chains are configured\n */\nexport function initializeSolanaMobileConnectors({ rpcUrls, ...props }: InitializeSolanaMobileConnectorsProps): void {\n  // Only run in browser environment\n  if (typeof window === 'undefined') {\n    return;\n  }\n  // Ensure secure context (HTTPS)\n  if (!window.isSecureContext) {\n    console.warn('Solana Mobile Connectors not loaded: https connection required');\n    return;\n  }\n\n  // Generate chain identifiers\n  const chains = Object.keys(rpcUrls).map((key) => `solana:${key}` as `solana:${string}`);\n\n  // Validate chain configuration\n  if (chains.length === 0) {\n    console.warn('Solana Mobile Connectors not loaded: no chains provided');\n    return;\n  }\n\n  // Register Mobile Wallet Adapter\n  registerMwa({\n    appIdentity: {\n      uri: props?.appUrl,\n      icon: props?.appLogoUrl,\n      name: props?.appName,\n    },\n    authorizationCache: createDefaultAuthorizationCache(),\n    chains,\n    chainSelector: createDefaultChainSelector(),\n    onWalletNotFound: createDefaultWalletNotFoundHandler(),\n  });\n}\n"]}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@tuwaio/satellite-solana",
+  "version": "0.0.3",
+  "private": false,
+  "author": "Oleksandr Tkach",
+  "license": "Apache-2.0",
+  "description": "An adapter for the Satellite Connect that adds support for connect Web3 Wallet on the Solana blockchain.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "web3",
+    "solana",
+    "wallet",
+    "connect",
+    "gill",
+    "zustand"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TuwaIO/satellite-connect.git",
+    "directory": "packages/satellite-solana"
+  },
+  "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": {
+    "@tuwaio/orbit-core": ">=0",
+    "@tuwaio/orbit-solana": ">=0",
+    "@tuwaio/satellite-core": ">=0",
+    "@solana-mobile/wallet-standard-mobile": ">=0.4",
+    "gill": ">=0.11",
+    "immer": ">=10",
+    "zustand": ">=5",
+    "@wagmi/core": ">=2.2",
+    "@wallet-standard/app": ">=1.1",
+    "@wallet-standard/base": ">=1.1",
+    "@wallet-standard/features": ">=1.1",
+    "@wallet-standard/ui": ">=1",
+    "@wallet-standard/ui-registry": ">=1"
+  },
+  "devDependencies": {
+    "@solana-mobile/wallet-standard-mobile": "^0.4.1",
+    "@wallet-standard/app": "^1.1.0",
+    "@wallet-standard/base": "^1.1.0",
+    "@wallet-standard/features": "^1.1.0",
+    "@wallet-standard/ui": "^1.0.1",
+    "@wallet-standard/ui-registry": "^1.0.1",
+    "gill": "^0.11.0",
+    "immer": "^10.1.3",
+    "jsdom": "^26.1.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4",
+    "zustand": "^5.0.8",
+    "@tuwaio/orbit-core": "^0.0.3",
+    "@tuwaio/orbit-solana": "^0.0.3",
+    "@tuwaio/satellite-core": "^0.0.3"
+  },
+  "scripts": {
+    "start": "tsup src/index.ts --watch",
+    "build": "tsup",
+    "test": "vitest"
+  }
+}