@tuwaio/nova-connect 1.0.0-fix-test-alpha.51.1ef6db6

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,142 @@
+# Satellite Connect React
+
+[![NPM Version](https://img.shields.io/npm/v/@tuwaio/satellite-react.svg)](https://www.npmjs.com/package/@tuwaio/satellite-react)
+[![License](https://img.shields.io/npm/l/@tuwaio/satellite-react.svg)](./LICENSE)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/TuwaIO/satellite-connect/release.yml?branch=main)](https://github.com/TuwaIO/satellite-connect/actions)
+
+React components and hooks for the Satellite Connect ecosystem, providing an easy-to-use interface for integrating Web3 wallet functionality into React applications.
+
+---
+
+## 🏛️ What is `@tuwaio/satellite-react`?
+
+`@tuwaio/satellite-react` is the React integration layer for the Satellite Connect ecosystem. It provides a collection of React hooks and components that make it easy to integrate Web3 wallet functionality into your React applications.
+
+Built on top of `@tuwaio/satellite-core`, this package offers a seamless developer experience for React applications requiring Web3 wallet integration.
+
+---
+
+## ✨ Key Features
+
+- **Type Safety:** Full TypeScript support with proper type definitions
+- **Chain Agnostic:** Unified support for both EVM and Solana wallets
+- **Modern React:** Built with React 19+ features and best practices
+- **Multi-Chain Support:** Seamless integration with multiple blockchain networks
+- **State Management:** Zustand-based store for efficient state handling
+
+---
+
+## 💾 Installation
+
+### Requirements
+- React 19+
+- Node.js 24+
+- TypeScript 5.9+
+
+```bash
+# Using pnpm (recommended)
+pnpm add @tuwaio/satellite-react @tuwaio/satellite-core @tuwaio/orbit-core @wagmi/core @wallet-standard/react gill react immer zustand
+
+# Using npm
+npm install @tuwaio/satellite-react @tuwaio/satellite-core @tuwaio/orbit-core @wagmi/core @wallet-standard/react gill react immer zustand
+
+# Using yarn
+yarn add @tuwaio/satellite-react @tuwaio/satellite-core @tuwaio/orbit-core @wagmi/core @wallet-standard/react gill react immer zustand
+```
+---
+
+## 🚀 Quick Start
+
+### Basic Setup
+```tsx
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { satelliteEVMAdapter } from '@tuwaio/satellite-evm';
+import { EVMWalletsWatcher, SatelliteConnectProvider, SolanaWalletsWatcher } from '@tuwaio/satellite-react';
+import { initializeSolanaMobileConnectors, satelliteSolanaAdapter } from '@tuwaio/satellite-solana';
+import { ReactNode } from 'react';
+import { WagmiProvider } from 'wagmi';
+import { createWagmiConfig } from '@tuwaio/satellite-evm';
+import { Chain, mainnet, sepolia } from 'viem/chains';
+
+export const appConfig = {
+  appName: 'Satellite EVM Test App',
+};
+
+export const solanaRPCUrls = {
+  devnet: 'https://api.devnet.solana.com',
+};
+
+export const appEVMChains = [mainnet, sepolia] as readonly [Chain, ...Chain[]];
+
+export const wagmiConfig = createWagmiConfig({
+  ...appConfig,
+  chains: appEVMChains,
+  ssr: true,
+  syncConnectedChain: true,
+});
+
+
+const queryClient = new QueryClient();
+
+initializeSolanaMobileConnectors({
+  rpcUrls: solanaRPCUrls,
+  ...appConfig,
+});
+
+export function Providers({ children }: { children: ReactNode }) {
+  return (
+    <WagmiProvider config={wagmiConfig}>
+      <QueryClientProvider client={queryClient}>
+        <SatelliteConnectProvider
+          adapter={[satelliteEVMAdapter(wagmiConfig), satelliteSolanaAdapter({ rpcUrls: solanaRPCUrls })]}
+          autoConnect={true}
+        >
+          <EVMWalletsWatcher wagmiConfig={wagmiConfig} />
+          <SolanaWalletsWatcher />
+          {children}
+        </SatelliteConnectProvider>
+      </QueryClientProvider>
+    </WagmiProvider>
+  );
+}
+```
+
+### Using Hooks
+```tsx
+import { useSatelliteConnectStore } from '@tuwaio/satellite-react';
+
+function ExampleGettingActiveWalletFromStore() {
+  const activeWallet = useSatelliteConnectStore((state) => state.activeWallet);
+  return <div>{activeWallet?.address}</div>
+}
+```
+---
+
+### Core Components
+
+1. **Store Access**
+    - `useSatelliteConnectStore`: Access to satellite connect store with full type safety
+    - Provides access to wallet state, connection methods, and chain management
+
+2. **Provider Components**
+    - `SatelliteConnectProvider`: Global context provider with all necessary configurations
+    - `EVMWalletsWatcher`: EVM wallet connection state management
+    - `SolanaWalletsWatcher`: Solana wallet connection state management
+
+---
+
+## 🤝 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/evm/index.cjs

@@ -0,0 +1,2 @@
+'use strict';function r(e){return e!=null&&typeof e=="number"&&e>0}function t(e){return !e||e.length===0?[]:e.map(n=>n.id).filter(r)}function i(e){return e.length>0&&e.every(n=>typeof n=="number")}exports.getEvmChains=t;exports.isEvmChainList=i;//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/evm/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/evm/utils.ts"],"names":["isValidEvmChainId","id","getEvmChains","appChains","chain","isEvmChainList","chains"],"mappings":"aAKA,SAASA,CAAAA,CAAkBC,EAA2B,CACpD,OAA2BA,GAAO,IAAA,EAAQ,OAAOA,CAAAA,EAAO,QAAA,EAAYA,CAAAA,CAAK,CAC3E,CAKO,SAASC,CAAAA,CAAaC,EAAoD,CAC/E,OAAI,CAACA,CAAAA,EAAaA,CAAAA,CAAU,MAAA,GAAW,CAAA,CAC9B,EAAC,CAGHA,EAAU,GAAA,CAAKC,CAAAA,EAAUA,EAAM,EAAE,CAAA,CAAE,OAAOJ,CAAiB,CACpE,CAKO,SAASK,CAAAA,CAAeC,CAAAA,CAAiD,CAC9E,OAAOA,CAAAA,CAAO,OAAS,CAAA,EAAKA,CAAAA,CAAO,MAAOF,CAAAA,EAAU,OAAOA,CAAAA,EAAU,QAAQ,CAC/E","file":"index.cjs","sourcesContent":["import type { Chain } from 'viem/chains';\n\n/**\n * Type guard to check if a value is a valid EVM chain ID\n */\nfunction isValidEvmChainId(id: unknown): id is number {\n  return id !== undefined && id !== null && typeof id === 'number' && id > 0;\n}\n\n/**\n * Get EVM chain IDs from app chains configuration\n */\nexport function getEvmChains(appChains?: readonly [Chain, ...Chain[]]): number[] {\n  if (!appChains || appChains.length === 0) {\n    return [];\n  }\n\n  return appChains.map((chain) => chain.id).filter(isValidEvmChainId);\n}\n\n/**\n * Type guard to check if a chain list contains EVM chain IDs\n */\nexport function isEvmChainList(chains: (string | number)[]): chains is number[] {\n  return chains.length > 0 && chains.every((chain) => typeof chain === 'number');\n}\n"]}

package/dist/evm/index.d.cts

@@ -0,0 +1,31 @@
+import { OrbitAdapter } from '@tuwaio/orbit-core';
+import { Chain } from 'viem/chains';
+export { Chain } from 'viem/chains';
+import { EVMWallet, ConnectorEVM } from '@tuwaio/satellite-evm';
+
+/**
+ * Get EVM chain IDs from app chains configuration
+ */
+declare function getEvmChains(appChains?: readonly [Chain, ...Chain[]]): number[];
+/**
+ * Type guard to check if a chain list contains EVM chain IDs
+ */
+declare function isEvmChainList(chains: (string | number)[]): chains is number[];
+
+declare module '@tuwaio/nova-connect' {
+    interface AllChainConfigs {
+        /**
+         * EVM chains configuration - enhanced from default any type
+         * @override Replaces default `any` with specific Chain typing when viem is available
+         */
+        appChains?: readonly [Chain, ...Chain[]];
+    }
+    interface AllWallets {
+        [OrbitAdapter.EVM]: EVMWallet;
+    }
+    interface AllConnectors {
+        [OrbitAdapter.EVM]: ConnectorEVM;
+    }
+}
+
+export { getEvmChains, isEvmChainList };

package/dist/evm/index.d.ts

@@ -0,0 +1,31 @@
+import { OrbitAdapter } from '@tuwaio/orbit-core';
+import { Chain } from 'viem/chains';
+export { Chain } from 'viem/chains';
+import { EVMWallet, ConnectorEVM } from '@tuwaio/satellite-evm';
+
+/**
+ * Get EVM chain IDs from app chains configuration
+ */
+declare function getEvmChains(appChains?: readonly [Chain, ...Chain[]]): number[];
+/**
+ * Type guard to check if a chain list contains EVM chain IDs
+ */
+declare function isEvmChainList(chains: (string | number)[]): chains is number[];
+
+declare module '@tuwaio/nova-connect' {
+    interface AllChainConfigs {
+        /**
+         * EVM chains configuration - enhanced from default any type
+         * @override Replaces default `any` with specific Chain typing when viem is available
+         */
+        appChains?: readonly [Chain, ...Chain[]];
+    }
+    interface AllWallets {
+        [OrbitAdapter.EVM]: EVMWallet;
+    }
+    interface AllConnectors {
+        [OrbitAdapter.EVM]: ConnectorEVM;
+    }
+}
+
+export { getEvmChains, isEvmChainList };

package/dist/evm/index.js

@@ -0,0 +1,2 @@
+function r(e){return e!=null&&typeof e=="number"&&e>0}function t(e){return !e||e.length===0?[]:e.map(n=>n.id).filter(r)}function i(e){return e.length>0&&e.every(n=>typeof n=="number")}export{t as getEvmChains,i as isEvmChainList};//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/evm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/evm/utils.ts"],"names":["isValidEvmChainId","id","getEvmChains","appChains","chain","isEvmChainList","chains"],"mappings":"AAKA,SAASA,CAAAA,CAAkBC,EAA2B,CACpD,OAA2BA,GAAO,IAAA,EAAQ,OAAOA,CAAAA,EAAO,QAAA,EAAYA,CAAAA,CAAK,CAC3E,CAKO,SAASC,CAAAA,CAAaC,EAAoD,CAC/E,OAAI,CAACA,CAAAA,EAAaA,CAAAA,CAAU,MAAA,GAAW,CAAA,CAC9B,EAAC,CAGHA,EAAU,GAAA,CAAKC,CAAAA,EAAUA,EAAM,EAAE,CAAA,CAAE,OAAOJ,CAAiB,CACpE,CAKO,SAASK,CAAAA,CAAeC,CAAAA,CAAiD,CAC9E,OAAOA,CAAAA,CAAO,OAAS,CAAA,EAAKA,CAAAA,CAAO,MAAOF,CAAAA,EAAU,OAAOA,CAAAA,EAAU,QAAQ,CAC/E","file":"index.js","sourcesContent":["import type { Chain } from 'viem/chains';\n\n/**\n * Type guard to check if a value is a valid EVM chain ID\n */\nfunction isValidEvmChainId(id: unknown): id is number {\n  return id !== undefined && id !== null && typeof id === 'number' && id > 0;\n}\n\n/**\n * Get EVM chain IDs from app chains configuration\n */\nexport function getEvmChains(appChains?: readonly [Chain, ...Chain[]]): number[] {\n  if (!appChains || appChains.length === 0) {\n    return [];\n  }\n\n  return appChains.map((chain) => chain.id).filter(isValidEvmChainId);\n}\n\n/**\n * Type guard to check if a chain list contains EVM chain IDs\n */\nexport function isEvmChainList(chains: (string | number)[]): chains is number[] {\n  return chains.length > 0 && chains.every((chain) => typeof chain === 'number');\n}\n"]}

package/dist/hooks/index.cjs

@@ -0,0 +1,2 @@
+'use strict';var novaCore=require('@tuwaio/nova-core'),orbitCore=require('@tuwaio/orbit-core'),react=require('react');function z(w){let{abbreviateSymbols:r=12,maxNameLength:y=30,autoRetry:C=false,retryDelay:u=3e3,store:f}=w,n=f.getState().activeWallet,N=f.getState().getAdapter,a=react.useMemo(()=>n?.address,[n?.address]),l=react.useMemo(()=>n?.walletType,[n?.walletType]),e=react.useMemo(()=>l?N(orbitCore.getAdapterFromWalletType(l??`${orbitCore.OrbitAdapter.EVM}:not-connected`)):null,[N,l]),[t,o]=react.useState(null),[p,m]=react.useState(null),[W,g]=react.useState(false),[b,s]=react.useState(null),c=react.useRef(null),v=react.useRef(null),x=react.useMemo(()=>{if(!e)return {hasNameResolver:false,hasAvatarResolver:false};let d="getName"in e&&typeof e.getName=="function",i="getAvatar"in e&&typeof e.getAvatar=="function";return {hasNameResolver:d,hasAvatarResolver:i}},[e]),A=react.useCallback(()=>{c.current&&(c.current.abort(),c.current=null),v.current!==null&&(clearTimeout(v.current),v.current=null);},[]),h=react.useCallback(async()=>{if(A(),!a||!e||!x.hasNameResolver){o(null),m(null),g(false),s(null);return}c.current=new AbortController;let{signal:d}=c.current;g(true),s(null),o(null),m(null);try{if(d.aborted)return;let i=await e.getName?.(a);if(d.aborted)return;if(i&&(o(i),x.hasAvatarResolver))try{let B=await e.getAvatar?.(i);d.aborted||m(B??null);}catch(B){console.warn("Failed to fetch avatar:",B),d.aborted||m(null);}}catch(i){if(d.aborted)return;let B=i instanceof Error?i.message:"Failed to fetch name service data";console.error("Failed to fetch name service data:",i),s(B),o(null),m(null),C&&(v.current=setTimeout(()=>{h();},u));}finally{d.aborted||g(false);}},[a,e,x,C,u,A]),I=react.useCallback(()=>{s(null),h();},[h]);react.useEffect(()=>(h(),A),[h,A]),react.useEffect(()=>A,[A]);let M=react.useMemo(()=>t?t.length>y?novaCore.textCenterEllipsis(t,r,r):t:a?novaCore.textCenterEllipsis(a,r,r):void 0,[t,a,y,r]);return {ensName:t,ensAvatar:p,isLoading:W,ensNameAbbreviated:M,error:b,retry:I}}function X({store:w}){let[r,y]=react.useState({}),[C,u]=react.useState(false),f=react.useRef(null),n=w.getState().activeWallet,N=w.getState().getAdapter,a=n?.address,l=n?.chainId,e=react.useMemo(()=>a&&l?`${a}-${l}`:null,[a,l]),t=react.useMemo(()=>n?.walletType?N(orbitCore.getAdapterFromWalletType(n.walletType)):null,[N,n?.walletType]),o=react.useMemo(()=>t&&"getBalance"in t&&typeof t.getBalance=="function",[t]),p=react.useCallback(async(g=false)=>{if(!a||!t||!l||!e||!o){u(false);return}let b=`${e}-${Date.now()}`;if(f.current=b,!g&&r[e]){u(false);return}u(true);try{let s=await t.getBalance(a,l);f.current===b&&y(c=>({...c,[e]:s}));}catch(s){console.error(`Failed to fetch native balance for ${e}:`,s),g&&f.current===b&&y(c=>{let v={...c};return delete v[e],v});}finally{f.current===b&&u(false);}},[a,t,l,e,o,r]),m=react.useCallback(()=>{p(true);},[p]);return react.useEffect(()=>{e&&o&&!r[e]?p(false):(!e||!o)&&u(false);},[e,o,r,p]),react.useEffect(()=>()=>{f.current=null;},[]),{balance:react.useMemo(()=>e&&r[e]||null,[e,r]),isLoading:C,refetch:m}}exports.useGetWalletNameAndAvatar=z;exports.useWalletNativeBalance=X;//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/hooks/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useGetWalletNameAndAvatar.ts","../../src/hooks/useWalletNativeBalance.ts"],"names":["useGetWalletNameAndAvatar","options","abbreviateSymbols","maxNameLength","autoRetry","retryDelay","store","wallet","getAdapter","walletAddress","useMemo","walletType","foundAdapter","getAdapterFromWalletType","OrbitAdapter","ensName","setEnsName","useState","ensAvatar","setEnsAvatar","isLoading","setIsLoading","error","setError","abortControllerRef","useRef","retryTimeoutRef","adapterCapabilities","hasNameResolver","hasAvatarResolver","cleanup","useCallback","fetchNameData","signal","name","avatar","avatarError","errorMessage","retry","useEffect","ensNameAbbreviated","textCenterEllipsis","useWalletNativeBalance","balanceCache","setBalanceCache","fetchOperationRef","currentChainId","cacheKey","hasBalanceResolver","fetchBalance","forceRefresh","operationId","balanceResult","prevCache","newCache","refetch"],"mappings":"sHAsEO,SAASA,CAAAA,CAA0BC,EAAoE,CAC5G,GAAM,CAAE,iBAAA,CAAAC,CAAAA,CAAoB,GAAI,aAAA,CAAAC,CAAAA,CAAgB,GAAI,SAAA,CAAAC,CAAAA,CAAY,MAAO,UAAA,CAAAC,CAAAA,CAAa,IAAM,KAAA,CAAAC,CAAM,EAAIL,CAAAA,CAG9FM,CAAAA,CAASD,CAAAA,CAAM,QAAA,GAAW,YAAA,CAC1BE,CAAAA,CAAaF,EAAM,QAAA,EAAS,CAAE,WAG9BG,CAAAA,CAAgBC,aAAAA,CAAQ,IAAMH,CAAAA,EAAQ,OAAA,CAAS,CAACA,CAAAA,EAAQ,OAAO,CAAC,CAAA,CAChEI,CAAAA,CAAaD,cAAQ,IAAMH,CAAAA,EAAQ,UAAA,CAAY,CAACA,GAAQ,UAAU,CAAC,EAEnEK,CAAAA,CAAeF,aAAAA,CAAQ,IACtBC,CAAAA,CACEH,CAAAA,CAAWK,mCAAyBF,CAAAA,EAAc,CAAA,EAAGG,uBAAa,GAAG,CAAA,cAAA,CAAgB,CAAC,CAAA,CADrE,IAAA,CAEvB,CAACN,CAAAA,CAAYG,CAAU,CAAC,CAAA,CAGrB,CAACI,CAAAA,CAASC,CAAU,EAAIC,cAAAA,CAAwB,IAAI,EACpD,CAACC,CAAAA,CAAWC,CAAY,CAAA,CAAIF,cAAAA,CAAwB,IAAI,CAAA,CACxD,CAACG,EAAWC,CAAY,CAAA,CAAIJ,eAAS,KAAK,CAAA,CAC1C,CAACK,CAAAA,CAAOC,CAAQ,CAAA,CAAIN,cAAAA,CAAwB,IAAI,CAAA,CAGhDO,CAAAA,CAAqBC,aAA+B,IAAI,CAAA,CACxDC,EAAkBD,YAAAA,CAAsB,IAAI,EAG5CE,CAAAA,CAAsBjB,aAAAA,CAAQ,IAAM,CACxC,GAAI,CAACE,CAAAA,CACH,OAAO,CAAE,eAAA,CAAiB,MAAO,iBAAA,CAAmB,KAAM,EAG5D,IAAMgB,CAAAA,CAAkB,YAAahB,CAAAA,EAAgB,OAAOA,EAAa,OAAA,EAAY,UAAA,CAC/EiB,EAAoB,WAAA,GAAejB,CAAAA,EAAgB,OAAOA,CAAAA,CAAa,SAAA,EAAc,WAE3F,OAAO,CAAE,eAAA,CAAAgB,CAAAA,CAAiB,kBAAAC,CAAkB,CAC9C,EAAG,CAACjB,CAAY,CAAC,CAAA,CAGXkB,CAAAA,CAAUC,kBAAY,IAAM,CAC5BP,EAAmB,OAAA,GACrBA,CAAAA,CAAmB,QAAQ,KAAA,EAAM,CACjCA,EAAmB,OAAA,CAAU,IAAA,CAAA,CAE3BE,CAAAA,CAAgB,OAAA,GAAY,OAC9B,YAAA,CAAaA,CAAAA,CAAgB,OAAO,CAAA,CACpCA,CAAAA,CAAgB,QAAU,IAAA,EAE9B,CAAA,CAAG,EAAE,CAAA,CAGCM,EAAgBD,iBAAAA,CAAY,SAAY,CAI5C,GAHAD,CAAAA,GAGI,CAACrB,CAAAA,EAAiB,CAACG,CAAAA,EAAgB,CAACe,CAAAA,CAAoB,eAAA,CAAiB,CAC3EX,CAAAA,CAAW,IAAI,EACfG,CAAAA,CAAa,IAAI,EACjBE,CAAAA,CAAa,KAAK,EAClBE,CAAAA,CAAS,IAAI,EACb,MACF,CAGAC,EAAmB,OAAA,CAAU,IAAI,eAAA,CACjC,GAAM,CAAE,MAAA,CAAAS,CAAO,EAAIT,CAAAA,CAAmB,OAAA,CAGtCH,EAAa,IAAI,CAAA,CACjBE,EAAS,IAAI,CAAA,CACbP,EAAW,IAAI,CAAA,CACfG,EAAa,IAAI,CAAA,CAEjB,GAAI,CAEF,GAAIc,CAAAA,CAAO,OAAA,CAAS,OAGpB,IAAMC,CAAAA,CAAO,MAAMtB,CAAAA,CAAa,OAAA,GAAUH,CAAa,CAAA,CAEvD,GAAIwB,EAAO,OAAA,CAAS,OAEpB,GAAIC,CAAAA,GACFlB,CAAAA,CAAWkB,CAAI,CAAA,CAGXP,CAAAA,CAAoB,mBACtB,GAAI,CACF,IAAMQ,CAAAA,CAAS,MAAMvB,CAAAA,CAAa,SAAA,GAAYsB,CAAI,CAAA,CAC7CD,CAAAA,CAAO,SAEVd,CAAAA,CAAagB,CAAAA,EAAU,IAAI,EAE/B,CAAA,MAASC,EAAa,CAEpB,OAAA,CAAQ,KAAK,yBAAA,CAA2BA,CAAW,EAC9CH,CAAAA,CAAO,OAAA,EACVd,CAAAA,CAAa,IAAI,EAErB,CAGN,CAAA,MAASG,EAAO,CACd,GAAIW,EAAO,OAAA,CAAS,OAEpB,IAAMI,CAAAA,CAAef,CAAAA,YAAiB,MAAQA,CAAAA,CAAM,OAAA,CAAU,oCAC9D,OAAA,CAAQ,KAAA,CAAM,qCAAsCA,CAAK,CAAA,CAEzDC,CAAAA,CAASc,CAAY,EACrBrB,CAAAA,CAAW,IAAI,EACfG,CAAAA,CAAa,IAAI,EAGbf,CAAAA,GACFsB,CAAAA,CAAgB,QAAU,UAAA,CAAW,IAAM,CACzCM,CAAAA,GACF,EAAG3B,CAAU,CAAA,EAEjB,QAAE,CACK4B,CAAAA,CAAO,OAAA,EACVZ,CAAAA,CAAa,KAAK,EAEtB,CACF,EAAG,CAACZ,CAAAA,CAAeG,EAAce,CAAAA,CAAqBvB,CAAAA,CAAWC,EAAYyB,CAAO,CAAC,EAG/EQ,CAAAA,CAAQP,iBAAAA,CAAY,IAAM,CAC9BR,CAAAA,CAAS,IAAI,CAAA,CACbS,CAAAA,GACF,CAAA,CAAG,CAACA,CAAa,CAAC,EAGlBO,eAAAA,CAAU,KACRP,GAAc,CACPF,CAAAA,CAAAA,CACN,CAACE,CAAAA,CAAeF,CAAO,CAAC,CAAA,CAG3BS,eAAAA,CAAU,IACDT,CAAAA,CACN,CAACA,CAAO,CAAC,CAAA,CAGZ,IAAMU,CAAAA,CAAqB9B,cAAQ,IAC7BK,CAAAA,CACKA,EAAQ,MAAA,CAASZ,CAAAA,CACpBsC,4BAAmB1B,CAAAA,CAASb,CAAAA,CAAmBA,CAAiB,CAAA,CAChEa,CAAAA,CAGCN,EAAgBgC,2BAAAA,CAAmBhC,CAAAA,CAAeP,EAAmBA,CAAiB,CAAA,CAAI,OAChG,CAACa,CAAAA,CAASN,CAAAA,CAAeN,CAAAA,CAAeD,CAAiB,CAAC,CAAA,CAE7D,OAAO,CACL,OAAA,CAAAa,EACA,SAAA,CAAAG,CAAAA,CACA,UAAAE,CAAAA,CACA,kBAAA,CAAAoB,EACA,KAAA,CAAAlB,CAAAA,CACA,MAAAgB,CACF,CACF,CCvKO,SAASI,CAAAA,CAAuB,CAAE,MAAApC,CAAM,CAAA,CAA+D,CAI5G,GAAM,CAACqC,CAAAA,CAAcC,CAAe,EAAI3B,cAAAA,CAAuB,EAAE,CAAA,CAG3D,CAACG,EAAWC,CAAY,CAAA,CAAIJ,eAAkB,KAAK,CAAA,CAGnD4B,EAAoBpB,YAAAA,CAAsB,IAAI,EAG9ClB,CAAAA,CAASD,CAAAA,CAAM,UAAS,CAAE,YAAA,CAC1BE,CAAAA,CAAaF,CAAAA,CAAM,UAAS,CAAE,UAAA,CAI9BG,EAAgBF,CAAAA,EAAQ,OAAA,CACxBuC,EAAiBvC,CAAAA,EAAQ,OAAA,CAGzBwC,EAAWrC,aAAAA,CAAQ,IAChBD,GAAiBqC,CAAAA,CAAiB,CAAA,EAAGrC,CAAa,CAAA,CAAA,EAAIqC,CAAc,GAAK,IAAA,CAC/E,CAACrC,CAAAA,CAAeqC,CAAc,CAAC,CAAA,CAG5BlC,CAAAA,CAAeF,cAAQ,IACtBH,CAAAA,EAAQ,WACNC,CAAAA,CAAWK,kCAAAA,CAAyBN,EAAO,UAAU,CAAC,EAD7B,IAAA,CAE/B,CAACC,EAAYD,CAAAA,EAAQ,UAAU,CAAC,CAAA,CAG7ByC,CAAAA,CAAqBtC,aAAAA,CAAQ,IAC1BE,GAAgB,YAAA,GAAgBA,CAAAA,EAAgB,OAAOA,CAAAA,CAAa,UAAA,EAAe,WACzF,CAACA,CAAY,CAAC,CAAA,CAIXqC,CAAAA,CAAelB,kBACnB,MAAOmB,CAAAA,CAAe,QAAU,CAE9B,GAAI,CAACzC,CAAAA,EAAiB,CAACG,CAAAA,EAAgB,CAACkC,GAAkB,CAACC,CAAAA,EAAY,CAACC,CAAAA,CAAoB,CAC1F3B,EAAa,KAAK,CAAA,CAClB,MACF,CAGA,IAAM8B,EAAc,CAAA,EAAGJ,CAAQ,IAAI,IAAA,CAAK,GAAA,EAAK,CAAA,CAAA,CAI7C,GAHAF,CAAAA,CAAkB,OAAA,CAAUM,EAGxB,CAACD,CAAAA,EACmBP,EAAaI,CAAQ,CAAA,CACxB,CACjB1B,CAAAA,CAAa,KAAK,EAClB,MACF,CAGFA,EAAa,IAAI,CAAA,CAEjB,GAAI,CAEF,IAAM+B,EAAqC,MAAMxC,CAAAA,CAAa,UAAA,CAAWH,CAAAA,CAAeqC,CAAc,CAAA,CAGlGD,CAAAA,CAAkB,UAAYM,CAAAA,EAChCP,CAAAA,CAAiBS,IAAe,CAC9B,GAAGA,EACH,CAACN,CAAQ,EAAGK,CACd,CAAA,CAAE,EAEN,CAAA,MAAS9B,CAAAA,CAAO,CACd,OAAA,CAAQ,KAAA,CAAM,CAAA,mCAAA,EAAsCyB,CAAQ,IAAKzB,CAAK,CAAA,CAGlE4B,GAAgBL,CAAAA,CAAkB,OAAA,GAAYM,GAChDP,CAAAA,CAAiBS,CAAAA,EAAc,CAC7B,IAAMC,CAAAA,CAAW,CAAE,GAAGD,CAAU,EAChC,OAAA,OAAOC,CAAAA,CAASP,CAAQ,CAAA,CACjBO,CACT,CAAC,EAEL,QAAE,CAEIT,CAAAA,CAAkB,UAAYM,CAAAA,EAChC9B,CAAAA,CAAa,KAAK,EAEtB,CACF,EACA,CAACZ,CAAAA,CAAeG,EAAckC,CAAAA,CAAgBC,CAAAA,CAAUC,EAAoBL,CAAY,CAC1F,EAGMY,CAAAA,CAAUxB,iBAAAA,CAAY,IAAM,CAChCkB,EAAa,IAAI,EACnB,EAAG,CAACA,CAAY,CAAC,CAAA,CAIjB,OAAAV,gBAAU,IAAM,CAEVQ,GAAYC,CAAAA,EAAsB,CAACL,EAAaI,CAAQ,CAAA,CAC1DE,EAAa,KAAK,CAAA,CAAA,CACT,CAACF,CAAAA,EAAY,CAACC,CAAAA,GAEvB3B,CAAAA,CAAa,KAAK,EAEtB,CAAA,CAAG,CAAC0B,CAAAA,CAAUC,CAAAA,CAAoBL,EAAcM,CAAY,CAAC,EAI7DV,eAAAA,CAAU,IACD,IAAM,CAEXM,CAAAA,CAAkB,QAAU,KAC9B,CAAA,CACC,EAAE,EAUE,CACL,OAAA,CANkCnC,cAAQ,IACnCqC,CAAAA,EAAWJ,EAAaI,CAAQ,CAAA,EAAK,KAC3C,CAACA,CAAAA,CAAUJ,CAAY,CAAC,CAAA,CAKzB,UAAAvB,CAAAA,CACA,OAAA,CAAAmC,CACF,CACF","file":"index.cjs","sourcesContent":["import { textCenterEllipsis } from '@tuwaio/nova-core';\nimport { getAdapterFromWalletType, OrbitAdapter } from '@tuwaio/orbit-core';\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react';\n\nimport { NovaConnectProviderProps } from './useNovaConnect';\n\nexport interface WalletNameAndAvatarData {\n  /** The resolved name from the Name Service (e.g., ENS, like \"alice.eth\"), or null if not found. */\n  ensName: string | null;\n  /** The URL of the avatar associated with the name, or null if not found. */\n  ensAvatar: string | null;\n  /** True while the name service data is being fetched. */\n  isLoading: boolean;\n  /** A truncated version of the name for display, or the abbreviated address if no name. */\n  ensNameAbbreviated: string | undefined;\n  /** Error message if the name resolution failed. */\n  error: string | null;\n  /** Function to retry the name resolution manually. */\n  retry: () => void;\n}\n\ninterface UseGetWalletNameAndAvatarOptions extends Pick<NovaConnectProviderProps, 'store'> {\n  /** Number of characters to show on each side when abbreviating (default: 12) */\n  abbreviateSymbols?: number;\n  /** Maximum length before abbreviation is applied (default: 30) */\n  maxNameLength?: number;\n  /** Whether to automatically retry on failure (default: false) */\n  autoRetry?: boolean;\n  /** Retry delay in milliseconds (default: 3000) */\n  retryDelay?: number;\n}\n\n/**\n * A custom hook to fetch the Name Service (e.g., ENS) name and avatar\n * for the currently active wallet.\n *\n * This hook automatically detects the active wallet and its corresponding\n * adapter via the `useSatelliteConnectStore` and attempts to resolve the\n * wallet address to a human-readable name and avatar.\n *\n * @param options Configuration options for the hook\n * @returns An object containing the resolved name, avatar, loading state, and utility functions\n *\n * @example\n * ```typescript\n * import { useGetWalletNameAndAvatar } from './useGetWalletNameAndAvatar';\n *\n * function DisplayWalletInfo() {\n *   const { ensName, ensAvatar, isLoading, ensNameAbbreviated, error, retry } = useGetWalletNameAndAvatar({\n *     abbreviateSymbols: 8,\n *     maxNameLength: 25\n *   });\n *\n *   if (isLoading) {\n *     return <div>Resolving name...</div>;\n *   }\n *\n *   if (error) {\n *     return <div>Error: {error} <button onClick={retry}>Retry</button></div>;\n *   }\n *\n *   return (\n *     <div className=\"wallet-info\">\n *       {ensAvatar && <img src={ensAvatar} alt=\"Wallet Avatar\" />}\n *       <p title={ensName || ''}>{ensNameAbbreviated || 'No Name Found'}</p>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useGetWalletNameAndAvatar(options: UseGetWalletNameAndAvatarOptions): WalletNameAndAvatarData {\n  const { abbreviateSymbols = 12, maxNameLength = 30, autoRetry = false, retryDelay = 3000, store } = options;\n\n  // Store state selectors - memoized for performance\n  const wallet = store.getState().activeWallet;\n  const getAdapter = store.getState().getAdapter;\n\n  // Memoize wallet address and adapter for dependency tracking\n  const walletAddress = useMemo(() => wallet?.address, [wallet?.address]);\n  const walletType = useMemo(() => wallet?.walletType, [wallet?.walletType]);\n\n  const foundAdapter = useMemo(() => {\n    if (!walletType) return null;\n    return getAdapter(getAdapterFromWalletType(walletType ?? `${OrbitAdapter.EVM}:not-connected`));\n  }, [getAdapter, walletType]);\n\n  // State variables\n  const [ensName, setEnsName] = useState<string | null>(null);\n  const [ensAvatar, setEnsAvatar] = useState<string | null>(null);\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n\n  // Refs for cleanup and retry functionality\n  const abortControllerRef = useRef<AbortController | null>(null);\n  const retryTimeoutRef = useRef<number | null>(null);\n\n  // Memoize adapter capabilities\n  const adapterCapabilities = useMemo(() => {\n    if (!foundAdapter) {\n      return { hasNameResolver: false, hasAvatarResolver: false };\n    }\n\n    const hasNameResolver = 'getName' in foundAdapter && typeof foundAdapter.getName === 'function';\n    const hasAvatarResolver = 'getAvatar' in foundAdapter && typeof foundAdapter.getAvatar === 'function';\n\n    return { hasNameResolver, hasAvatarResolver };\n  }, [foundAdapter]);\n\n  // Cleanup function\n  const cleanup = useCallback(() => {\n    if (abortControllerRef.current) {\n      abortControllerRef.current.abort();\n      abortControllerRef.current = null;\n    }\n    if (retryTimeoutRef.current !== null) {\n      clearTimeout(retryTimeoutRef.current);\n      retryTimeoutRef.current = null;\n    }\n  }, []);\n\n  // Main fetch function\n  const fetchNameData = useCallback(async () => {\n    cleanup();\n\n    // Exit conditions\n    if (!walletAddress || !foundAdapter || !adapterCapabilities.hasNameResolver) {\n      setEnsName(null);\n      setEnsAvatar(null);\n      setIsLoading(false);\n      setError(null);\n      return;\n    }\n\n    // Create new abort controller for this request\n    abortControllerRef.current = new AbortController();\n    const { signal } = abortControllerRef.current;\n\n    // Start loading\n    setIsLoading(true);\n    setError(null);\n    setEnsName(null);\n    setEnsAvatar(null);\n\n    try {\n      // Check if request was aborted\n      if (signal.aborted) return;\n\n      // Attempt to resolve the name\n      const name = await foundAdapter.getName?.(walletAddress);\n\n      if (signal.aborted) return;\n\n      if (name) {\n        setEnsName(name);\n\n        // If avatar resolution is supported, fetch the avatar\n        if (adapterCapabilities.hasAvatarResolver) {\n          try {\n            const avatar = await foundAdapter.getAvatar?.(name);\n            if (!signal.aborted) {\n              // Handle undefined case by converting to null\n              setEnsAvatar(avatar ?? null);\n            }\n          } catch (avatarError) {\n            // Avatar fetch failed, but name succeeded - not critical\n            console.warn('Failed to fetch avatar:', avatarError);\n            if (!signal.aborted) {\n              setEnsAvatar(null);\n            }\n          }\n        }\n      }\n    } catch (error) {\n      if (signal.aborted) return;\n\n      const errorMessage = error instanceof Error ? error.message : 'Failed to fetch name service data';\n      console.error('Failed to fetch name service data:', error);\n\n      setError(errorMessage);\n      setEnsName(null);\n      setEnsAvatar(null);\n\n      // Auto retry if enabled\n      if (autoRetry) {\n        retryTimeoutRef.current = setTimeout(() => {\n          fetchNameData();\n        }, retryDelay) as unknown as number;\n      }\n    } finally {\n      if (!signal.aborted) {\n        setIsLoading(false);\n      }\n    }\n  }, [walletAddress, foundAdapter, adapterCapabilities, autoRetry, retryDelay, cleanup]);\n\n  // Manual retry function\n  const retry = useCallback(() => {\n    setError(null);\n    fetchNameData();\n  }, [fetchNameData]);\n\n  // Effect to fetch data when dependencies change\n  useEffect(() => {\n    fetchNameData();\n    return cleanup;\n  }, [fetchNameData, cleanup]);\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return cleanup;\n  }, [cleanup]);\n\n  // Memoized abbreviated name computation\n  const ensNameAbbreviated = useMemo(() => {\n    if (ensName) {\n      return ensName.length > maxNameLength\n        ? textCenterEllipsis(ensName, abbreviateSymbols, abbreviateSymbols)\n        : ensName;\n    }\n\n    return walletAddress ? textCenterEllipsis(walletAddress, abbreviateSymbols, abbreviateSymbols) : undefined;\n  }, [ensName, walletAddress, maxNameLength, abbreviateSymbols]);\n\n  return {\n    ensName,\n    ensAvatar,\n    isLoading,\n    ensNameAbbreviated,\n    error,\n    retry,\n  };\n}\n","import { getAdapterFromWalletType } from '@tuwaio/orbit-core';\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react';\n\nimport { NovaConnectProviderProps } from './useNovaConnect';\n\n/**\n * @interface NativeBalanceResult\n * Represents the native token balance returned by the adapter.\n * The value is already formatted for human readability.\n * @property {string} value The native token balance formatted to standard decimals (e.g., \"1.5\").\n * @property {string} symbol The symbol of the native token (e.g., \"ETH\").\n */\nexport interface NativeBalanceResult {\n  value: string;\n  symbol: string;\n}\n\n// Type for the balance state within the hook (the fetched data or null).\ntype NativeBalanceState = NativeBalanceResult | null;\n\n// Type for the local cache: \"walletAddress-chainId\" -> { value, symbol }.\ntype BalanceCache = Record<string, NativeBalanceResult>;\n\n/**\n * @interface NativeBalanceData\n * The object returned by the useWalletNativeBalance hook.\n * @property {NativeBalanceState} balance The native token balance and symbol, or null.\n * @property {boolean} isLoading True while the balance is being fetched for the current wallet/chain combination.\n * @property {() => void} refetch Function to manually trigger a balance refresh.\n */\ninterface NativeBalanceData {\n  balance: NativeBalanceState;\n  isLoading: boolean;\n  refetch: () => void;\n}\n\n/**\n * Custom hook to fetch the native token balance for the currently connected wallet\n * on the active chain. It includes a local cache layer to prevent redundant network calls\n * when switching between components or on re-renders for the same wallet/chain.\n *\n * @returns {NativeBalanceData} An object containing the balance data and loading state.\n *\n * @example\n * ```typescript\n * import { useWalletNativeBalance } from './useWalletNativeBalance';\n *\n * function NativeTokenDisplay() {\n *   const { balance, isLoading, refetch } = useWalletNativeBalance();\n *\n *   if (isLoading) {\n *     return <p>Loading balance...</p>;\n *   }\n *\n *   // Display the formatted balance and symbol\n *   return (\n *     <div>\n *       <p>Balance: {balance ? `${balance.value} ${balance.symbol}` : '0.00'}</p>\n *       <button onClick={refetch}>Refresh</button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useWalletNativeBalance({ store }: Pick<NovaConnectProviderProps, 'store'>): NativeBalanceData {\n  // --- 1. STATE & CACHE SETUP ---\n\n  // Local cache storage. Keys combine wallet address and chain ID.\n  const [balanceCache, setBalanceCache] = useState<BalanceCache>({});\n\n  // Local loading state, managed alongside the cache check.\n  const [isLoading, setIsLoading] = useState<boolean>(false);\n\n  // Track the current fetch operation to prevent race conditions\n  const fetchOperationRef = useRef<string | null>(null);\n\n  // Store state selectors - memoized for performance\n  const wallet = store.getState().activeWallet;\n  const getAdapter = store.getState().getAdapter;\n\n  // --- 2. COMPUTED INPUTS ---\n\n  const walletAddress = wallet?.address;\n  const currentChainId = wallet?.chainId;\n\n  // Create the unique key for cache lookups: \"address-chainId\".\n  const cacheKey = useMemo(() => {\n    return walletAddress && currentChainId ? `${walletAddress}-${currentChainId}` : null;\n  }, [walletAddress, currentChainId]);\n\n  // Find the actual adapter object from the adapter map.\n  const foundAdapter = useMemo(() => {\n    if (!wallet?.walletType) return null;\n    return getAdapter(getAdapterFromWalletType(wallet.walletType));\n  }, [getAdapter, wallet?.walletType]);\n\n  // Check if the adapter has balance functionality\n  const hasBalanceResolver = useMemo(() => {\n    return foundAdapter && 'getBalance' in foundAdapter && typeof foundAdapter.getBalance === 'function';\n  }, [foundAdapter]);\n\n  // --- 3. BALANCE FETCHING LOGIC ---\n\n  const fetchBalance = useCallback(\n    async (forceRefresh = false) => {\n      // Exit early if essential data is missing (not connected).\n      if (!walletAddress || !foundAdapter || !currentChainId || !cacheKey || !hasBalanceResolver) {\n        setIsLoading(false);\n        return;\n      }\n\n      // Set the current operation ID to prevent race conditions\n      const operationId = `${cacheKey}-${Date.now()}`;\n      fetchOperationRef.current = operationId;\n\n      // Check cache unless forcing a refresh\n      if (!forceRefresh) {\n        const cachedBalance = balanceCache[cacheKey];\n        if (cachedBalance) {\n          setIsLoading(false);\n          return;\n        }\n      }\n\n      setIsLoading(true);\n\n      try {\n        // Call the adapter's getBalance method\n        const balanceResult: NativeBalanceResult = await foundAdapter.getBalance(walletAddress, currentChainId);\n\n        // Only update if this operation is still the latest one\n        if (fetchOperationRef.current === operationId) {\n          setBalanceCache((prevCache) => ({\n            ...prevCache,\n            [cacheKey]: balanceResult,\n          }));\n        }\n      } catch (error) {\n        console.error(`Failed to fetch native balance for ${cacheKey}:`, error);\n\n        // Optionally clear cache entry on error (if you want to retry on next call)\n        if (forceRefresh && fetchOperationRef.current === operationId) {\n          setBalanceCache((prevCache) => {\n            const newCache = { ...prevCache };\n            delete newCache[cacheKey];\n            return newCache;\n          });\n        }\n      } finally {\n        // Only update loading state if this operation is still current\n        if (fetchOperationRef.current === operationId) {\n          setIsLoading(false);\n        }\n      }\n    },\n    [walletAddress, foundAdapter, currentChainId, cacheKey, hasBalanceResolver, balanceCache],\n  );\n\n  // Memoized refetch function that forces a refresh\n  const refetch = useCallback(() => {\n    fetchBalance(true);\n  }, [fetchBalance]);\n\n  // --- 4. EFFECT FOR INITIAL FETCH ---\n\n  useEffect(() => {\n    // Only fetch if we have all required data and no cached result\n    if (cacheKey && hasBalanceResolver && !balanceCache[cacheKey]) {\n      fetchBalance(false);\n    } else if (!cacheKey || !hasBalanceResolver) {\n      // Reset loading state if we can't fetch\n      setIsLoading(false);\n    }\n  }, [cacheKey, hasBalanceResolver, balanceCache, fetchBalance]);\n\n  // --- 5. CLEANUP EFFECT ---\n\n  useEffect(() => {\n    return () => {\n      // Cancel any ongoing operations when component unmounts\n      fetchOperationRef.current = null;\n    };\n  }, []);\n\n  // --- 6. RETURNED DATA ---\n\n  // The definitive balance is always derived from the cache based on the current key.\n  const balance: NativeBalanceState = useMemo(() => {\n    return cacheKey ? balanceCache[cacheKey] || null : null;\n  }, [cacheKey, balanceCache]);\n\n  // Return the fetched balance data and the loading status.\n  return {\n    balance, // { value: \"1.5\", symbol: \"ETH\" } or null\n    isLoading,\n    refetch,\n  };\n}\n"]}

package/dist/hooks/index.js

@@ -0,0 +1,2 @@
+import {textCenterEllipsis}from'@tuwaio/nova-core';import {getAdapterFromWalletType,OrbitAdapter}from'@tuwaio/orbit-core';import {useMemo,useState,useRef,useCallback,useEffect}from'react';function z(w){let{abbreviateSymbols:r=12,maxNameLength:y=30,autoRetry:C=false,retryDelay:u=3e3,store:f}=w,n=f.getState().activeWallet,N=f.getState().getAdapter,a=useMemo(()=>n?.address,[n?.address]),l=useMemo(()=>n?.walletType,[n?.walletType]),e=useMemo(()=>l?N(getAdapterFromWalletType(l??`${OrbitAdapter.EVM}:not-connected`)):null,[N,l]),[t,o]=useState(null),[p,m]=useState(null),[W,g]=useState(false),[b,s]=useState(null),c=useRef(null),v=useRef(null),x=useMemo(()=>{if(!e)return {hasNameResolver:false,hasAvatarResolver:false};let d="getName"in e&&typeof e.getName=="function",i="getAvatar"in e&&typeof e.getAvatar=="function";return {hasNameResolver:d,hasAvatarResolver:i}},[e]),A=useCallback(()=>{c.current&&(c.current.abort(),c.current=null),v.current!==null&&(clearTimeout(v.current),v.current=null);},[]),h=useCallback(async()=>{if(A(),!a||!e||!x.hasNameResolver){o(null),m(null),g(false),s(null);return}c.current=new AbortController;let{signal:d}=c.current;g(true),s(null),o(null),m(null);try{if(d.aborted)return;let i=await e.getName?.(a);if(d.aborted)return;if(i&&(o(i),x.hasAvatarResolver))try{let B=await e.getAvatar?.(i);d.aborted||m(B??null);}catch(B){console.warn("Failed to fetch avatar:",B),d.aborted||m(null);}}catch(i){if(d.aborted)return;let B=i instanceof Error?i.message:"Failed to fetch name service data";console.error("Failed to fetch name service data:",i),s(B),o(null),m(null),C&&(v.current=setTimeout(()=>{h();},u));}finally{d.aborted||g(false);}},[a,e,x,C,u,A]),I=useCallback(()=>{s(null),h();},[h]);useEffect(()=>(h(),A),[h,A]),useEffect(()=>A,[A]);let M=useMemo(()=>t?t.length>y?textCenterEllipsis(t,r,r):t:a?textCenterEllipsis(a,r,r):void 0,[t,a,y,r]);return {ensName:t,ensAvatar:p,isLoading:W,ensNameAbbreviated:M,error:b,retry:I}}function X({store:w}){let[r,y]=useState({}),[C,u]=useState(false),f=useRef(null),n=w.getState().activeWallet,N=w.getState().getAdapter,a=n?.address,l=n?.chainId,e=useMemo(()=>a&&l?`${a}-${l}`:null,[a,l]),t=useMemo(()=>n?.walletType?N(getAdapterFromWalletType(n.walletType)):null,[N,n?.walletType]),o=useMemo(()=>t&&"getBalance"in t&&typeof t.getBalance=="function",[t]),p=useCallback(async(g=false)=>{if(!a||!t||!l||!e||!o){u(false);return}let b=`${e}-${Date.now()}`;if(f.current=b,!g&&r[e]){u(false);return}u(true);try{let s=await t.getBalance(a,l);f.current===b&&y(c=>({...c,[e]:s}));}catch(s){console.error(`Failed to fetch native balance for ${e}:`,s),g&&f.current===b&&y(c=>{let v={...c};return delete v[e],v});}finally{f.current===b&&u(false);}},[a,t,l,e,o,r]),m=useCallback(()=>{p(true);},[p]);return useEffect(()=>{e&&o&&!r[e]?p(false):(!e||!o)&&u(false);},[e,o,r,p]),useEffect(()=>()=>{f.current=null;},[]),{balance:useMemo(()=>e&&r[e]||null,[e,r]),isLoading:C,refetch:m}}export{z as useGetWalletNameAndAvatar,X as useWalletNativeBalance};//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useGetWalletNameAndAvatar.ts","../../src/hooks/useWalletNativeBalance.ts"],"names":["useGetWalletNameAndAvatar","options","abbreviateSymbols","maxNameLength","autoRetry","retryDelay","store","wallet","getAdapter","walletAddress","useMemo","walletType","foundAdapter","getAdapterFromWalletType","OrbitAdapter","ensName","setEnsName","useState","ensAvatar","setEnsAvatar","isLoading","setIsLoading","error","setError","abortControllerRef","useRef","retryTimeoutRef","adapterCapabilities","hasNameResolver","hasAvatarResolver","cleanup","useCallback","fetchNameData","signal","name","avatar","avatarError","errorMessage","retry","useEffect","ensNameAbbreviated","textCenterEllipsis","useWalletNativeBalance","balanceCache","setBalanceCache","fetchOperationRef","currentChainId","cacheKey","hasBalanceResolver","fetchBalance","forceRefresh","operationId","balanceResult","prevCache","newCache","refetch"],"mappings":"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","file":"index.js","sourcesContent":["import { textCenterEllipsis } from '@tuwaio/nova-core';\nimport { getAdapterFromWalletType, OrbitAdapter } from '@tuwaio/orbit-core';\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react';\n\nimport { NovaConnectProviderProps } from './useNovaConnect';\n\nexport interface WalletNameAndAvatarData {\n  /** The resolved name from the Name Service (e.g., ENS, like \"alice.eth\"), or null if not found. */\n  ensName: string | null;\n  /** The URL of the avatar associated with the name, or null if not found. */\n  ensAvatar: string | null;\n  /** True while the name service data is being fetched. */\n  isLoading: boolean;\n  /** A truncated version of the name for display, or the abbreviated address if no name. */\n  ensNameAbbreviated: string | undefined;\n  /** Error message if the name resolution failed. */\n  error: string | null;\n  /** Function to retry the name resolution manually. */\n  retry: () => void;\n}\n\ninterface UseGetWalletNameAndAvatarOptions extends Pick<NovaConnectProviderProps, 'store'> {\n  /** Number of characters to show on each side when abbreviating (default: 12) */\n  abbreviateSymbols?: number;\n  /** Maximum length before abbreviation is applied (default: 30) */\n  maxNameLength?: number;\n  /** Whether to automatically retry on failure (default: false) */\n  autoRetry?: boolean;\n  /** Retry delay in milliseconds (default: 3000) */\n  retryDelay?: number;\n}\n\n/**\n * A custom hook to fetch the Name Service (e.g., ENS) name and avatar\n * for the currently active wallet.\n *\n * This hook automatically detects the active wallet and its corresponding\n * adapter via the `useSatelliteConnectStore` and attempts to resolve the\n * wallet address to a human-readable name and avatar.\n *\n * @param options Configuration options for the hook\n * @returns An object containing the resolved name, avatar, loading state, and utility functions\n *\n * @example\n * ```typescript\n * import { useGetWalletNameAndAvatar } from './useGetWalletNameAndAvatar';\n *\n * function DisplayWalletInfo() {\n *   const { ensName, ensAvatar, isLoading, ensNameAbbreviated, error, retry } = useGetWalletNameAndAvatar({\n *     abbreviateSymbols: 8,\n *     maxNameLength: 25\n *   });\n *\n *   if (isLoading) {\n *     return <div>Resolving name...</div>;\n *   }\n *\n *   if (error) {\n *     return <div>Error: {error} <button onClick={retry}>Retry</button></div>;\n *   }\n *\n *   return (\n *     <div className=\"wallet-info\">\n *       {ensAvatar && <img src={ensAvatar} alt=\"Wallet Avatar\" />}\n *       <p title={ensName || ''}>{ensNameAbbreviated || 'No Name Found'}</p>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useGetWalletNameAndAvatar(options: UseGetWalletNameAndAvatarOptions): WalletNameAndAvatarData {\n  const { abbreviateSymbols = 12, maxNameLength = 30, autoRetry = false, retryDelay = 3000, store } = options;\n\n  // Store state selectors - memoized for performance\n  const wallet = store.getState().activeWallet;\n  const getAdapter = store.getState().getAdapter;\n\n  // Memoize wallet address and adapter for dependency tracking\n  const walletAddress = useMemo(() => wallet?.address, [wallet?.address]);\n  const walletType = useMemo(() => wallet?.walletType, [wallet?.walletType]);\n\n  const foundAdapter = useMemo(() => {\n    if (!walletType) return null;\n    return getAdapter(getAdapterFromWalletType(walletType ?? `${OrbitAdapter.EVM}:not-connected`));\n  }, [getAdapter, walletType]);\n\n  // State variables\n  const [ensName, setEnsName] = useState<string | null>(null);\n  const [ensAvatar, setEnsAvatar] = useState<string | null>(null);\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n\n  // Refs for cleanup and retry functionality\n  const abortControllerRef = useRef<AbortController | null>(null);\n  const retryTimeoutRef = useRef<number | null>(null);\n\n  // Memoize adapter capabilities\n  const adapterCapabilities = useMemo(() => {\n    if (!foundAdapter) {\n      return { hasNameResolver: false, hasAvatarResolver: false };\n    }\n\n    const hasNameResolver = 'getName' in foundAdapter && typeof foundAdapter.getName === 'function';\n    const hasAvatarResolver = 'getAvatar' in foundAdapter && typeof foundAdapter.getAvatar === 'function';\n\n    return { hasNameResolver, hasAvatarResolver };\n  }, [foundAdapter]);\n\n  // Cleanup function\n  const cleanup = useCallback(() => {\n    if (abortControllerRef.current) {\n      abortControllerRef.current.abort();\n      abortControllerRef.current = null;\n    }\n    if (retryTimeoutRef.current !== null) {\n      clearTimeout(retryTimeoutRef.current);\n      retryTimeoutRef.current = null;\n    }\n  }, []);\n\n  // Main fetch function\n  const fetchNameData = useCallback(async () => {\n    cleanup();\n\n    // Exit conditions\n    if (!walletAddress || !foundAdapter || !adapterCapabilities.hasNameResolver) {\n      setEnsName(null);\n      setEnsAvatar(null);\n      setIsLoading(false);\n      setError(null);\n      return;\n    }\n\n    // Create new abort controller for this request\n    abortControllerRef.current = new AbortController();\n    const { signal } = abortControllerRef.current;\n\n    // Start loading\n    setIsLoading(true);\n    setError(null);\n    setEnsName(null);\n    setEnsAvatar(null);\n\n    try {\n      // Check if request was aborted\n      if (signal.aborted) return;\n\n      // Attempt to resolve the name\n      const name = await foundAdapter.getName?.(walletAddress);\n\n      if (signal.aborted) return;\n\n      if (name) {\n        setEnsName(name);\n\n        // If avatar resolution is supported, fetch the avatar\n        if (adapterCapabilities.hasAvatarResolver) {\n          try {\n            const avatar = await foundAdapter.getAvatar?.(name);\n            if (!signal.aborted) {\n              // Handle undefined case by converting to null\n              setEnsAvatar(avatar ?? null);\n            }\n          } catch (avatarError) {\n            // Avatar fetch failed, but name succeeded - not critical\n            console.warn('Failed to fetch avatar:', avatarError);\n            if (!signal.aborted) {\n              setEnsAvatar(null);\n            }\n          }\n        }\n      }\n    } catch (error) {\n      if (signal.aborted) return;\n\n      const errorMessage = error instanceof Error ? error.message : 'Failed to fetch name service data';\n      console.error('Failed to fetch name service data:', error);\n\n      setError(errorMessage);\n      setEnsName(null);\n      setEnsAvatar(null);\n\n      // Auto retry if enabled\n      if (autoRetry) {\n        retryTimeoutRef.current = setTimeout(() => {\n          fetchNameData();\n        }, retryDelay) as unknown as number;\n      }\n    } finally {\n      if (!signal.aborted) {\n        setIsLoading(false);\n      }\n    }\n  }, [walletAddress, foundAdapter, adapterCapabilities, autoRetry, retryDelay, cleanup]);\n\n  // Manual retry function\n  const retry = useCallback(() => {\n    setError(null);\n    fetchNameData();\n  }, [fetchNameData]);\n\n  // Effect to fetch data when dependencies change\n  useEffect(() => {\n    fetchNameData();\n    return cleanup;\n  }, [fetchNameData, cleanup]);\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return cleanup;\n  }, [cleanup]);\n\n  // Memoized abbreviated name computation\n  const ensNameAbbreviated = useMemo(() => {\n    if (ensName) {\n      return ensName.length > maxNameLength\n        ? textCenterEllipsis(ensName, abbreviateSymbols, abbreviateSymbols)\n        : ensName;\n    }\n\n    return walletAddress ? textCenterEllipsis(walletAddress, abbreviateSymbols, abbreviateSymbols) : undefined;\n  }, [ensName, walletAddress, maxNameLength, abbreviateSymbols]);\n\n  return {\n    ensName,\n    ensAvatar,\n    isLoading,\n    ensNameAbbreviated,\n    error,\n    retry,\n  };\n}\n","import { getAdapterFromWalletType } from '@tuwaio/orbit-core';\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react';\n\nimport { NovaConnectProviderProps } from './useNovaConnect';\n\n/**\n * @interface NativeBalanceResult\n * Represents the native token balance returned by the adapter.\n * The value is already formatted for human readability.\n * @property {string} value The native token balance formatted to standard decimals (e.g., \"1.5\").\n * @property {string} symbol The symbol of the native token (e.g., \"ETH\").\n */\nexport interface NativeBalanceResult {\n  value: string;\n  symbol: string;\n}\n\n// Type for the balance state within the hook (the fetched data or null).\ntype NativeBalanceState = NativeBalanceResult | null;\n\n// Type for the local cache: \"walletAddress-chainId\" -> { value, symbol }.\ntype BalanceCache = Record<string, NativeBalanceResult>;\n\n/**\n * @interface NativeBalanceData\n * The object returned by the useWalletNativeBalance hook.\n * @property {NativeBalanceState} balance The native token balance and symbol, or null.\n * @property {boolean} isLoading True while the balance is being fetched for the current wallet/chain combination.\n * @property {() => void} refetch Function to manually trigger a balance refresh.\n */\ninterface NativeBalanceData {\n  balance: NativeBalanceState;\n  isLoading: boolean;\n  refetch: () => void;\n}\n\n/**\n * Custom hook to fetch the native token balance for the currently connected wallet\n * on the active chain. It includes a local cache layer to prevent redundant network calls\n * when switching between components or on re-renders for the same wallet/chain.\n *\n * @returns {NativeBalanceData} An object containing the balance data and loading state.\n *\n * @example\n * ```typescript\n * import { useWalletNativeBalance } from './useWalletNativeBalance';\n *\n * function NativeTokenDisplay() {\n *   const { balance, isLoading, refetch } = useWalletNativeBalance();\n *\n *   if (isLoading) {\n *     return <p>Loading balance...</p>;\n *   }\n *\n *   // Display the formatted balance and symbol\n *   return (\n *     <div>\n *       <p>Balance: {balance ? `${balance.value} ${balance.symbol}` : '0.00'}</p>\n *       <button onClick={refetch}>Refresh</button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useWalletNativeBalance({ store }: Pick<NovaConnectProviderProps, 'store'>): NativeBalanceData {\n  // --- 1. STATE & CACHE SETUP ---\n\n  // Local cache storage. Keys combine wallet address and chain ID.\n  const [balanceCache, setBalanceCache] = useState<BalanceCache>({});\n\n  // Local loading state, managed alongside the cache check.\n  const [isLoading, setIsLoading] = useState<boolean>(false);\n\n  // Track the current fetch operation to prevent race conditions\n  const fetchOperationRef = useRef<string | null>(null);\n\n  // Store state selectors - memoized for performance\n  const wallet = store.getState().activeWallet;\n  const getAdapter = store.getState().getAdapter;\n\n  // --- 2. COMPUTED INPUTS ---\n\n  const walletAddress = wallet?.address;\n  const currentChainId = wallet?.chainId;\n\n  // Create the unique key for cache lookups: \"address-chainId\".\n  const cacheKey = useMemo(() => {\n    return walletAddress && currentChainId ? `${walletAddress}-${currentChainId}` : null;\n  }, [walletAddress, currentChainId]);\n\n  // Find the actual adapter object from the adapter map.\n  const foundAdapter = useMemo(() => {\n    if (!wallet?.walletType) return null;\n    return getAdapter(getAdapterFromWalletType(wallet.walletType));\n  }, [getAdapter, wallet?.walletType]);\n\n  // Check if the adapter has balance functionality\n  const hasBalanceResolver = useMemo(() => {\n    return foundAdapter && 'getBalance' in foundAdapter && typeof foundAdapter.getBalance === 'function';\n  }, [foundAdapter]);\n\n  // --- 3. BALANCE FETCHING LOGIC ---\n\n  const fetchBalance = useCallback(\n    async (forceRefresh = false) => {\n      // Exit early if essential data is missing (not connected).\n      if (!walletAddress || !foundAdapter || !currentChainId || !cacheKey || !hasBalanceResolver) {\n        setIsLoading(false);\n        return;\n      }\n\n      // Set the current operation ID to prevent race conditions\n      const operationId = `${cacheKey}-${Date.now()}`;\n      fetchOperationRef.current = operationId;\n\n      // Check cache unless forcing a refresh\n      if (!forceRefresh) {\n        const cachedBalance = balanceCache[cacheKey];\n        if (cachedBalance) {\n          setIsLoading(false);\n          return;\n        }\n      }\n\n      setIsLoading(true);\n\n      try {\n        // Call the adapter's getBalance method\n        const balanceResult: NativeBalanceResult = await foundAdapter.getBalance(walletAddress, currentChainId);\n\n        // Only update if this operation is still the latest one\n        if (fetchOperationRef.current === operationId) {\n          setBalanceCache((prevCache) => ({\n            ...prevCache,\n            [cacheKey]: balanceResult,\n          }));\n        }\n      } catch (error) {\n        console.error(`Failed to fetch native balance for ${cacheKey}:`, error);\n\n        // Optionally clear cache entry on error (if you want to retry on next call)\n        if (forceRefresh && fetchOperationRef.current === operationId) {\n          setBalanceCache((prevCache) => {\n            const newCache = { ...prevCache };\n            delete newCache[cacheKey];\n            return newCache;\n          });\n        }\n      } finally {\n        // Only update loading state if this operation is still current\n        if (fetchOperationRef.current === operationId) {\n          setIsLoading(false);\n        }\n      }\n    },\n    [walletAddress, foundAdapter, currentChainId, cacheKey, hasBalanceResolver, balanceCache],\n  );\n\n  // Memoized refetch function that forces a refresh\n  const refetch = useCallback(() => {\n    fetchBalance(true);\n  }, [fetchBalance]);\n\n  // --- 4. EFFECT FOR INITIAL FETCH ---\n\n  useEffect(() => {\n    // Only fetch if we have all required data and no cached result\n    if (cacheKey && hasBalanceResolver && !balanceCache[cacheKey]) {\n      fetchBalance(false);\n    } else if (!cacheKey || !hasBalanceResolver) {\n      // Reset loading state if we can't fetch\n      setIsLoading(false);\n    }\n  }, [cacheKey, hasBalanceResolver, balanceCache, fetchBalance]);\n\n  // --- 5. CLEANUP EFFECT ---\n\n  useEffect(() => {\n    return () => {\n      // Cancel any ongoing operations when component unmounts\n      fetchOperationRef.current = null;\n    };\n  }, []);\n\n  // --- 6. RETURNED DATA ---\n\n  // The definitive balance is always derived from the cache based on the current key.\n  const balance: NativeBalanceState = useMemo(() => {\n    return cacheKey ? balanceCache[cacheKey] || null : null;\n  }, [cacheKey, balanceCache]);\n\n  // Return the fetched balance data and the loading status.\n  return {\n    balance, // { value: \"1.5\", symbol: \"ETH\" } or null\n    isLoading,\n    refetch,\n  };\n}\n"]}