@tuwaio/nova-connect 0.1.9 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -15
- package/dist/{ToastError-CaoiEVOK.d.cts → ToastError-C3LvnSma.d.cts} +322 -113
- package/dist/{ToastError-BLFMIzVb.d.ts → ToastError-CVhCoryf.d.ts} +322 -113
- package/dist/chunk-3BMX6JWH.js +2 -0
- package/dist/chunk-3BMX6JWH.js.map +1 -0
- package/dist/chunk-4FB4UCVM.js +6 -0
- package/dist/chunk-4FB4UCVM.js.map +1 -0
- package/dist/chunk-B2NRY4JV.js +2 -0
- package/dist/chunk-B2NRY4JV.js.map +1 -0
- package/dist/chunk-F2VSTHQ4.js +2 -0
- package/dist/chunk-F2VSTHQ4.js.map +1 -0
- package/dist/{chunk-OA6MB7CZ.cjs → chunk-FK4AEST5.cjs} +2 -2
- package/dist/{chunk-OA6MB7CZ.cjs.map → chunk-FK4AEST5.cjs.map} +1 -1
- package/dist/chunk-IMKRWFCZ.cjs +3 -0
- package/dist/chunk-IMKRWFCZ.cjs.map +1 -0
- package/dist/chunk-L5MEEHVK.cjs +2 -0
- package/dist/chunk-L5MEEHVK.cjs.map +1 -0
- package/dist/chunk-P5ZBSLGK.js +2 -0
- package/dist/{chunk-MPEJHQKC.js.map → chunk-P5ZBSLGK.js.map} +1 -1
- package/dist/chunk-PTHXIVB5.cjs +2 -0
- package/dist/chunk-PTHXIVB5.cjs.map +1 -0
- package/dist/chunk-S6WXKVYP.js +3 -0
- package/dist/chunk-S6WXKVYP.js.map +1 -0
- package/dist/chunk-UDTWMOQ2.cjs +6 -0
- package/dist/chunk-UDTWMOQ2.cjs.map +1 -0
- package/dist/chunk-YI7RYSN6.cjs +2 -0
- package/dist/chunk-YI7RYSN6.cjs.map +1 -0
- package/dist/components/index.cjs +1 -1
- package/dist/components/index.d.cts +3 -3
- package/dist/components/index.d.ts +3 -3
- package/dist/components/index.js +1 -1
- package/dist/evm-BVE2G4MP.js +2 -0
- package/dist/evm-BVE2G4MP.js.map +1 -0
- package/dist/evm-DU3VGIPD.cjs +2 -0
- package/dist/evm-DU3VGIPD.cjs.map +1 -0
- package/dist/getChainsListByConnectorType-7W3NDNRC.cjs +2 -0
- package/dist/{getChainsListByWalletType-VMQ4BO2B.js.map → getChainsListByConnectorType-7W3NDNRC.cjs.map} +1 -1
- package/dist/getChainsListByConnectorType-FGTS3CWJ.js +2 -0
- package/dist/{getChainsListByWalletType-CDPECVNS.cjs.map → getChainsListByConnectorType-FGTS3CWJ.js.map} +1 -1
- package/dist/hooks/index.cjs +1 -1
- package/dist/hooks/index.d.cts +23 -4
- package/dist/hooks/index.d.ts +23 -4
- package/dist/hooks/index.js +1 -1
- package/dist/i18n/index.cjs +1 -1
- package/dist/i18n/index.d.cts +1 -1
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.css +112 -63
- package/dist/index.d.cts +23 -23
- package/dist/index.d.ts +23 -23
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/satellite/index.cjs +1 -1
- package/dist/satellite/index.d.cts +1 -1
- package/dist/satellite/index.d.ts +1 -1
- package/dist/satellite/index.js +1 -1
- package/dist/solana/index.cjs +1 -1
- package/dist/solana/index.js +1 -1
- package/dist/solana-CDGGMN74.cjs +2 -0
- package/dist/solana-CDGGMN74.cjs.map +1 -0
- package/dist/solana-DHXEV2TG.js +2 -0
- package/dist/solana-DHXEV2TG.js.map +1 -0
- package/dist/{types-D4Vti05g.d.cts → types-eao2UQcC.d.cts} +7 -1
- package/dist/{types-D4Vti05g.d.ts → types-eao2UQcC.d.ts} +7 -1
- package/dist/{useWalletNativeBalance-CEASeZ6Z.d.ts → useWalletNativeBalance-Cv8QQLQv.d.ts} +2 -2
- package/dist/{useWalletNativeBalance-DSt1VUWC.d.cts → useWalletNativeBalance-D49yGzRi.d.cts} +2 -2
- package/dist/utils-TF3RVHPT.cjs +2 -0
- package/dist/{utils-H5O25MTI.cjs.map → utils-TF3RVHPT.cjs.map} +1 -1
- package/dist/utils-YYMTL3XH.js +2 -0
- package/dist/{utils-SUIRQJIA.js.map → utils-YYMTL3XH.js.map} +1 -1
- package/package.json +38 -43
- package/dist/chunk-7FTV55DQ.cjs +0 -2
- package/dist/chunk-7FTV55DQ.cjs.map +0 -1
- package/dist/chunk-DYDY3FCT.cjs +0 -2
- package/dist/chunk-DYDY3FCT.cjs.map +0 -1
- package/dist/chunk-J4TY3CJF.js +0 -2
- package/dist/chunk-J4TY3CJF.js.map +0 -1
- package/dist/chunk-JVVOBSVI.js +0 -6
- package/dist/chunk-JVVOBSVI.js.map +0 -1
- package/dist/chunk-MPEJHQKC.js +0 -2
- package/dist/chunk-MQGDTFY7.js +0 -2
- package/dist/chunk-MQGDTFY7.js.map +0 -1
- package/dist/chunk-NMQZA377.cjs +0 -2
- package/dist/chunk-NMQZA377.cjs.map +0 -1
- package/dist/chunk-QERPNHKX.cjs +0 -2
- package/dist/chunk-QERPNHKX.cjs.map +0 -1
- package/dist/chunk-S5WT3DLF.js +0 -2
- package/dist/chunk-S5WT3DLF.js.map +0 -1
- package/dist/chunk-TAV7EL23.js +0 -2
- package/dist/chunk-TAV7EL23.js.map +0 -1
- package/dist/chunk-Y3SFEPYJ.cjs +0 -6
- package/dist/chunk-Y3SFEPYJ.cjs.map +0 -1
- package/dist/evm-7NHOTSAK.cjs +0 -2
- package/dist/evm-7NHOTSAK.cjs.map +0 -1
- package/dist/evm-RBGEX4L3.js +0 -2
- package/dist/evm-RBGEX4L3.js.map +0 -1
- package/dist/getChainsListByWalletType-CDPECVNS.cjs +0 -2
- package/dist/getChainsListByWalletType-VMQ4BO2B.js +0 -2
- package/dist/solana-GLHHYZDQ.js +0 -2
- package/dist/solana-GLHHYZDQ.js.map +0 -1
- package/dist/solana-JUU54KQ3.cjs +0 -2
- package/dist/solana-JUU54KQ3.cjs.map +0 -1
- package/dist/utils-H5O25MTI.cjs +0 -2
- package/dist/utils-SUIRQJIA.js +0 -2
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import {a as a$1,i}from'./chunk-B2NRY4JV.js';import {a}from'./chunk-3BMX6JWH.js';import {h as h$1}from'./chunk-P5ZBSLGK.js';import {textCenterEllipsis}from'@tuwaio/nova-core';import {OrbitAdapter,getAdapterFromConnectorType,formatConnectorName}from'@tuwaio/orbit-core';import {createContext,useContext,useMemo,useState,useRef,useCallback,useEffect}from'react';function me(e){let{abbreviateSymbols:t=12,maxNameLength:a=30,autoRetry:o=false,retryDelay:s=3e3}=e,n=h$1(f=>f.activeConnection),i=h$1(f=>f.getAdapter),r=useMemo(()=>n?.address,[n?.address]),d=useMemo(()=>n?.connectorType,[n?.connectorType]),c=useMemo(()=>d?i(getAdapterFromConnectorType(d??`${OrbitAdapter.EVM}:not-connected`)):null,[i,d]),[u,b]=useState(null),[K,p]=useState(null),[y,m]=useState(false),[N,v]=useState(null),L=useRef(null),T=useRef(null),I=useMemo(()=>{if(!c)return {hasNameResolver:false,hasAvatarResolver:false};let f="getName"in c&&typeof c.getName=="function",C="getAvatar"in c&&typeof c.getAvatar=="function";return {hasNameResolver:f,hasAvatarResolver:C}},[c]),g=useCallback(()=>{L.current&&(L.current.abort(),L.current=null),T.current!==null&&(clearTimeout(T.current),T.current=null);},[]),x=useCallback(async()=>{if(g(),!r||!c||!I.hasNameResolver){b(null),p(null),m(false),v(null);return}L.current=new AbortController;let{signal:f}=L.current;m(true),v(null),b(null),p(null);try{if(f.aborted)return;let C=await c.getName?.(r);if(f.aborted)return;if(C&&(b(C),I.hasAvatarResolver))try{let S=await c.getAvatar?.(C);f.aborted||p(S??null);}catch(S){console.warn("Failed to fetch avatar:",S),f.aborted||p(null);}}catch(C){if(f.aborted)return;let S=C instanceof Error?C.message:"Failed to fetch name service data";console.error("Failed to fetch name service data:",C),v(S),b(null),p(null),o&&(T.current=setTimeout(()=>{x();},s));}finally{f.aborted||m(false);}},[r,c,I,o,s,g]),Y=useCallback(()=>{v(null),x();},[x]);useEffect(()=>(x(),g),[x,g]),useEffect(()=>g,[g]);let Z=useMemo(()=>u?u.length>a?textCenterEllipsis(u,t,t):u:r?textCenterEllipsis(r,t,t):void 0,[u,r,a,t]);return {ensName:u,ensAvatar:K,isLoading:y,ensNameAbbreviated:Z,error:N,retry:Y}}var R=class extends Error{constructor(t="useNovaConnect must be used within NovaConnectProvider"){super(t),this.name="NovaConnectProviderError";}},V=createContext(void 0),ye=()=>{let e=useContext(V);if(!e)throw new R;return e},ge=()=>useContext(V)!==void 0,Ae=()=>useContext(V)??null;var re=createContext(a),D=()=>useContext(re),Oe=e=>D()[e],Te=e=>{let t=D(),a={};for(let o of e)a[o]=t[o];return a},ke=(e,t)=>!!e[t]?.trim(),we=e=>{let t=D(),o={actions:["connectWallet","disconnect","connecting","connected","tryAgain","back","connect","close"],states:["success","error","replaced","loading","idle"],accessibility:["chainSelector","closeModal","selectChain","walletControls","openWalletModal"],transactions:["transactionLoading","transactionSuccess","transactionError","transactionReplaced","recent"]}[e],s={};for(let n of o)s[n]=t[n];return s},Ee=e=>e===a,Be=(e,t,a$1)=>{let o=e[t];return o&&o.trim()?o:a$1||a[t]||t.toString()},Ie=(e,t)=>{let a={};for(let o of t)a[o]=e[o];return a};var h={[OrbitAdapter.EVM]:1,[OrbitAdapter.SOLANA]:"mainnet",[OrbitAdapter.Starknet]:"0x534e5f4d41494e"};function Re({selectedAdapter:e,appChains:t,solanaRPCUrls:a}){switch(e){case OrbitAdapter.EVM:{let o=t?.[0];return o?.id&&typeof o.id=="number"?o.id:(process.env.NODE_ENV==="development"&&!t?.length&&console.warn("getConnectChainId: No EVM chains configured, using Ethereum Mainnet"),h[OrbitAdapter.EVM])}case OrbitAdapter.SOLANA:{if(a&&typeof a=="object"){let o=Object.keys(a);if(o.length>0)return o[0]}return process.env.NODE_ENV==="development"&&!a&&console.warn("getConnectChainId: No Solana RPC URLs configured, using mainnet"),h[OrbitAdapter.SOLANA]}case OrbitAdapter.Starknet:return process.env.NODE_ENV==="development"&&console.info("getConnectChainId: Using default Starknet chain ID"),h[OrbitAdapter.Starknet];default:return process.env.NODE_ENV==="development"&&console.error("getConnectChainId: Unknown adapter:",e),h[OrbitAdapter.EVM]}}function We({selectedAdapter:e,appChains:t,solanaRPCUrls:a}){switch(e){case OrbitAdapter.EVM:return t?.map(o=>o.id).filter(Boolean)??[h[OrbitAdapter.EVM]];case OrbitAdapter.SOLANA:return a?Object.keys(a):[h[OrbitAdapter.SOLANA]];case OrbitAdapter.Starknet:return [h[OrbitAdapter.Starknet]];default:return [h[OrbitAdapter.EVM]]}}function se(e,t){if(!e||typeof e!="object")return null;let a=e;return !a.name||typeof a.name!="string"?null:{name:a.name,icon:a.icon,adapter:t,originalConnector:a}}function U({connectors:e,excludeConnectors:t=["injected"]}={connectors:{}}){if(!e||Object.keys(e).length===0)return [];let a=new Set(t.map(n=>formatConnectorName(n))),o=[];Object.entries(e).forEach(([n,i])=>{if(Array.isArray(i)){let r=n;i.forEach(d=>{let c=se(d,r);if(c){let u=formatConnectorName(c.name);a.has(u)||o.push(c);}});}});let s=new Map;return o.forEach(n=>{let i=formatConnectorName(n.name);s.has(i)||s.set(i,{name:n.name,icon:n.icon,adapters:[],connectors:[]});let r=s.get(i);r.adapters.includes(n.adapter)||r.adapters.push(n.adapter),r.connectors.push({...n.originalConnector,adapter:n.adapter}),!r.icon&&n.icon&&(r.icon=n.icon);}),Array.from(s.values()).sort((n,i)=>n.name.localeCompare(i.name,void 0,{sensitivity:"base"}))}function Ke(e){return Object.values(e).some(t=>Array.isArray(t)&&t.length>0)}function ce(e){try{if(e&&typeof e=="object"&&e.adapter)return e.adapter}catch{}}function _(e,t){return ce(e)===t}function Ue({connectors:e,selectedAdapter:t}){if(!e||Object.keys(e).length===0)return [];let a=U({connectors:e});return t?a.filter(o=>o.adapters.includes(t)&&o.connectors.some(s=>_(s,t))).map(o=>{let s=o.connectors.filter(n=>_(n,t));return {...o,adapters:[t],connectors:s}}).filter(o=>o.connectors.length>0):a}function _e(e,t){let a=e[t];return Array.isArray(a)&&a.length>0}var ze=e=>{switch(e){case OrbitAdapter.EVM:return {chainId:1,name:"Ethereum"};case OrbitAdapter.SOLANA:return {chainId:"solana:mainnet",name:"Solana"}}};var Xe={[OrbitAdapter.EVM]:{aboutNetwork:"https://ethereum.org/developers/docs/intro-to-ethereum/",choseWallet:"https://ethereum.org/wallets/find-wallet/",about:"https://ethereum.org/wallets/"},[OrbitAdapter.SOLANA]:{aboutNetwork:"https://solana.com/en/learn/what-is-solana",choseWallet:"https://solana.com/en/solana-wallets",about:"https://solana.com/en/learn/what-is-a-wallet"}};function lt(){return console.warn("getAvailableSolanaClusters: Using synchronous fallback with limited functionality. Use getAvailableSolanaClustersAsync for complete cluster detection."),[]}function ut(e){return console.warn("isValidSolanaCluster: Using synchronous fallback with basic validation. Use isValidSolanaClusterAsync for comprehensive cluster validation."),["mainnet","devnet","testnet","localnet"].includes(e)}function St({activeConnection:e,appChains:t,solanaRPCUrls:a}){let[o,s]=useState([]),[n,i$1]=useState(false);return useEffect(()=>{let r=true;return (async()=>{i$1(true);try{if(!e){let b=await a$1({connectorType:`${OrbitAdapter.EVM}:not-connected`,appChains:t,solanaRPCUrls:a,chains:[]});r&&s(b);return}let c=i(e),u=await a$1({connectorType:e.connectorType,appChains:t,solanaRPCUrls:a,chains:c});r&&s(u);}catch(c){console.error("Failed to fetch chains list:",c),r&&s([]);}finally{r&&i$1(false);}})(),()=>{r=false;}},[e,t,a]),{chainsList:o,isLoading:n}}function Et(){let[e,t]=useState({}),[a,o]=useState(false),s=useRef(null),n=h$1(p=>p.activeConnection),i=h$1(p=>p.getAdapter),r=useMemo(()=>n?.chainId&&n?.address?`${n.address}-${n.chainId}`:null,[n?.chainId,n?.address]),d=useMemo(()=>n?.connectorType?i(getAdapterFromConnectorType(n.connectorType)):null,[i,n?.connectorType]),c=useMemo(()=>d&&"getBalance"in d&&typeof d.getBalance=="function",[d]),u=useCallback(async(p=false)=>{if(!n?.address||!d||!n?.chainId||!r||!c){o(false);return}let y=`${r}-${Date.now()}`;if(s.current=y,!p&&e[r]){o(false);return}o(true);try{let m=await d.getBalance(n.address,n.chainId);s.current===y&&t(N=>({...N,[r]:m}));}catch(m){console.error(`Failed to fetch native balance for ${r}:`,m),p&&s.current===y&&t(N=>{let v={...N};return delete v[r],v});}finally{s.current===y&&o(false);}},[n?.address,d,n?.chainId,r,c,e]),b=useCallback(()=>{u(true);},[u]);return useEffect(()=>{r&&c&&!e[r]?u(false):(!r||!c)&&o(false);},[r,c,e,u]),useEffect(()=>()=>{s.current=null;},[]),{balance:useMemo(()=>r&&e[r]||null,[r,e]),isLoading:a,refetch:b}}
|
|
2
|
+
export{Et as A,me as a,R as b,V as c,ye as d,ge as e,Ae as f,re as g,D as h,Oe as i,Te as j,ke as k,we as l,Ee as m,Be as n,Ie as o,Re as p,We as q,U as r,Ke as s,Ue as t,_e as u,ze as v,Xe as w,lt as x,ut as y,St as z};//# sourceMappingURL=chunk-S6WXKVYP.js.map
|
|
3
|
+
//# sourceMappingURL=chunk-S6WXKVYP.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/hooks/useGetWalletNameAndAvatar.ts","../src/hooks/useNovaConnect.ts","../src/hooks/useNovaConnectLabels.ts","../src/utils/getConnectedChainId.ts","../src/utils/getGroupedConnectors.ts","../src/utils/getFilteredConnectors.ts","../src/utils/getNetworIcon.ts","../src/utils/networksLinks.ts","../src/utils/index.ts","../src/hooks/useWalletChainsList.ts","../src/hooks/useWalletNativeBalance.ts"],"names":["useGetWalletNameAndAvatar","options","abbreviateSymbols","maxNameLength","autoRetry","retryDelay","activeConnection","useSatelliteConnectStore","store","getAdapter","walletAddress","useMemo","connectorType","foundAdapter","getAdapterFromConnectorType","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","NovaConnectProviderError","message","NovaConnectProviderContext","createContext","useNovaConnect","context","useContext","useHasNovaConnectContext","useNovaConnectOptional","NovaConnectLabelsContext","defaultLabels","useNovaConnectLabels","useNovaConnectLabel","key","useNovaConnectLabelsSubset","keys","allLabels","subset","hasLabel","labels","useLabelsByCategory","category","categoryLabels","isDefaultLabels","getLabelWithFallback","fallback","value","createLabelsSubset","DEFAULT_CHAIN_IDS","getConnectChainId","selectedAdapter","appChains","solanaRPCUrls","firstChain","networks","getAvailableChainIds","chain","processConnector","connector","adapter","connectorObj","getGroupedConnectors","connectors","excludeConnectors","excludeSet","formatConnectorName","processedConnectors","adapterKey","adapterConnectors","processed","formattedName","groupedMap","group","a","b","hasAvailableConnectors","getConnectorAdapter","connectorMatchesAdapter","getFilteredConnectors","groupedConnectors","filteredConnectors","hasConnectorsForAdapter","getNetworkIcon","networksLinks","getAvailableSolanaClusters","isValidSolanaCluster","cluster","useWalletChainsList","chainsList","setChainsList","isMounted","list","getChainsListByConnectorType","walletChains","getWalletChains","useWalletNativeBalance","balanceCache","setBalanceCache","fetchOperationRef","cacheKey","hasBalanceResolver","fetchBalance","forceRefresh","operationId","balanceResult","prevCache","newCache","refetch"],"mappings":"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","file":"chunk-S6WXKVYP.js","sourcesContent":["import { textCenterEllipsis } from '@tuwaio/nova-core';\nimport { getAdapterFromConnectorType, OrbitAdapter } from '@tuwaio/orbit-core';\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react';\n\nimport { useSatelliteConnectStore } from '../satellite';\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 {\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 } = options;\n\n // Store state selectors - memoized for performance\n const activeConnection = useSatelliteConnectStore((store) => store.activeConnection);\n const getAdapter = useSatelliteConnectStore((store) => store.getAdapter);\n\n // Memoize wallet address and adapter for dependency tracking\n const walletAddress = useMemo(() => activeConnection?.address, [activeConnection?.address]);\n const connectorType = useMemo(() => activeConnection?.connectorType, [activeConnection?.connectorType]);\n\n const foundAdapter = useMemo(() => {\n if (!connectorType) return null;\n return getAdapter(getAdapterFromConnectorType(connectorType ?? `${OrbitAdapter.EVM}:not-connected`));\n }, [getAdapter, connectorType]);\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 { OrbitAdapter } from '@tuwaio/orbit-core';\nimport { Transaction, TransactionPool, TxAdapter } from '@tuwaio/pulsar-core';\nimport { createContext, useContext } from 'react';\n\nimport { NovaConnectLabels } from '../i18n';\nimport { InitialChains } from '../types';\n\nexport type ButtonTxStatus = 'idle' | 'loading' | 'succeed' | 'failed' | 'replaced';\nexport type ConnectContentType = 'network' | 'connectors' | 'about' | 'getWallet' | 'connecting' | 'impersonate';\nexport type ConnectedContentType = 'main' | 'transactions' | 'chains' | 'connections';\n\n// Provider props interface\nexport interface NovaConnectProviderProps extends InitialChains {\n /** Transaction pool for pending transactions display */\n transactionPool?: TransactionPool<Transaction>;\n /** Pulsar adapter(s) for transaction handling */\n pulsarAdapter?: TxAdapter<Transaction> | TxAdapter<Transaction>[];\n /** Whether balance should be shown */\n withBalance?: boolean;\n /** Whether chain selector should be shown */\n withChain?: boolean;\n /** Whether impersonated wallets are enabled */\n withImpersonated?: boolean;\n children: React.ReactNode;\n labels?: Partial<NovaConnectLabels>;\n}\n\n// Balance type for better type safety\nexport interface WalletBalance {\n value: string;\n symbol: string;\n}\n\n// Provider context type with better organization\nexport interface NovaConnectProviderType\n extends Omit<NovaConnectProviderProps, 'pulsarAdapter' | 'children' | 'labels' | 'transactionPool'> {\n // Modal states\n isConnectModalOpen: boolean;\n setIsConnectModalOpen: (value: boolean) => void;\n isConnectedModalOpen: boolean;\n setIsConnectedModalOpen: (value: boolean) => void;\n\n // Chain selection states\n isChainsListOpen: boolean;\n setIsChainsListOpen: (value: boolean) => void;\n isChainsListOpenMobile: boolean;\n setIsChainsListOpenMobile: (value: boolean) => void;\n\n // Connection states\n connectedButtonStatus: ButtonTxStatus;\n setConnectedButtonStatus: (value: ButtonTxStatus) => void;\n isConnected: boolean;\n setIsConnected: (value: boolean) => void;\n\n // Modal content types\n connectedModalContentType: ConnectedContentType;\n setConnectedModalContentType: (value: ConnectedContentType) => void;\n connectModalContentType: ConnectContentType;\n setConnectModalContentType: (value: ConnectContentType) => void;\n\n // Adapter and connector states\n selectedAdapter: OrbitAdapter | undefined;\n setSelectedAdapter: (value: OrbitAdapter | undefined) => void;\n activeConnector: string | undefined;\n setActiveConnector: (value: string | undefined) => void;\n\n // Impersonation\n impersonatedAddress: string;\n setImpersonatedAddress: (value: string) => void;\n}\n\n// Custom error for hook usage outside provider\nexport class NovaConnectProviderError extends Error {\n constructor(message = 'useNovaConnect must be used within NovaConnectProvider') {\n super(message);\n this.name = 'NovaConnectProviderError';\n }\n}\n\n// Create context with undefined default to enforce provider usage\nexport const NovaConnectProviderContext = createContext<NovaConnectProviderType | undefined>(undefined);\n\n/**\n * Hook to access NovaConnect context\n *\n * @throws {NovaConnectProviderError} When used outside of NovaConnectProvider\n * @returns {NovaConnectProviderType} The NovaConnect context value\n *\n * @example\n * ```typescript\n * function MyComponent() {\n * const { isConnected, handleConnectButtonClick } = useNovaConnect();\n *\n * return (\n * <button onClick={handleConnectButtonClick}>\n * {isConnected ? 'Connected' : 'Connect Wallet'}\n * </button>\n * );\n * }\n * ```\n */\nexport const useNovaConnect = (): NovaConnectProviderType => {\n const context = useContext(NovaConnectProviderContext);\n\n if (!context) {\n throw new NovaConnectProviderError();\n }\n\n return context;\n};\n\n/**\n * Hook to check if NovaConnect context is available\n *\n * @returns {boolean} True if context is available, false otherwise\n *\n * @example\n * ```typescript\n * function ConditionalComponent() {\n * const hasContext = useHasNovaConnectContext();\n *\n * if (!hasContext) {\n * return <div>NovaConnect provider not found</div>;\n * }\n *\n * return <ConnectedComponent />;\n * }\n * ```\n */\nexport const useHasNovaConnectContext = (): boolean => {\n const context = useContext(NovaConnectProviderContext);\n return context !== undefined;\n};\n\n/**\n * Optional hook that returns null if provider is not available\n *\n * @returns {NovaConnectProviderType | null} Context value or null if not available\n *\n * @example\n * ```typescript\n * function OptionalComponent() {\n * const context = useNovaConnectOptional();\n *\n * if (!context) {\n * return <div>No wallet provider available</div>;\n * }\n *\n * return <div>Connected: {context.isConnected}</div>;\n * }\n * ```\n */\nexport const useNovaConnectOptional = (): NovaConnectProviderType | null => {\n const context = useContext(NovaConnectProviderContext);\n return context ?? null;\n};\n","import { createContext, useContext } from 'react';\n\nimport { defaultLabels, NovaConnectLabels } from '../i18n';\n\n/**\n * React Context for storing and providing the UI labels.\n * It is initialized with the default English labels, ensuring that components\n * work even without an explicit provider.\n */\nexport const NovaConnectLabelsContext = createContext<NovaConnectLabels>(defaultLabels);\n\n/**\n * A custom hook to easily access the i18n labels from any component\n * within the `NovaConnectLabelsProvider` tree.\n *\n * This hook provides type-safe access to all UI labels and automatically\n * falls back to default English labels if no provider is found.\n *\n * @returns {NovaConnectLabels} The complete object of UI labels for the current locale.\n *\n * @example\n * ```typescript\n * import { useNovaConnectLabels } from './hooks/useNovaConnectLabels';\n *\n * function MyComponent() {\n * const labels = useNovaConnectLabels();\n *\n * return (\n * <div>\n * <h1>{labels.connectWallet}</h1>\n * <button>{labels.connect}</button>\n * <p aria-label={labels.walletBalance}>{formattedBalance}</p>\n * </div>\n * );\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Destructuring specific labels for better performance\n * function ConnectButton() {\n * const { connectWallet, connecting, connected } = useNovaConnectLabels();\n *\n * return (\n * <button>\n * {isConnecting ? connecting : isConnected ? connected : connectWallet}\n * </button>\n * );\n * }\n * ```\n */\nexport const useNovaConnectLabels = (): NovaConnectLabels => {\n return useContext(NovaConnectLabelsContext);\n};\n\n/**\n * Hook to get a specific label by key path with type safety\n *\n * @param key The label key to retrieve\n * @returns The specific label value\n *\n * @example\n * ```typescript\n * function MyComponent() {\n * const connectLabel = useNovaConnectLabel('connectWallet');\n * const errorLabel = useNovaConnectLabel('connectionError');\n *\n * return <button>{connectLabel}</button>;\n * }\n * ```\n */\nexport const useNovaConnectLabel = <K extends keyof NovaConnectLabels>(key: K): NovaConnectLabels[K] => {\n const labels = useNovaConnectLabels();\n return labels[key];\n};\n\n/**\n * Hook to get multiple specific labels for better performance\n *\n * @param keys Array of label keys to retrieve\n * @returns Object with only the requested labels\n *\n * @example\n * ```typescript\n * function ConnectModal() {\n * const { connectWallet, connecting, disconnect } = useNovaConnectLabelsSubset(['connectWallet', 'connecting', 'disconnect']);\n *\n * return (\n * <div>\n * <h2>{connectWallet}</h2>\n * <span>{connecting}</span>\n * <button>{disconnect}</button>\n * </div>\n * );\n * }\n * ```\n */\nexport const useNovaConnectLabelsSubset = <K extends keyof NovaConnectLabels>(\n keys: K[],\n): Pick<NovaConnectLabels, K> => {\n const allLabels = useNovaConnectLabels();\n\n const subset = {} as Pick<NovaConnectLabels, K>;\n for (const key of keys) {\n subset[key] = allLabels[key];\n }\n\n return subset;\n};\n\n/**\n * Type-safe helper to check if a label exists\n *\n * @param labels The labels object\n * @param key The key to check\n * @returns Whether the key exists and has a non-empty value\n */\nexport const hasLabel = (labels: NovaConnectLabels, key: keyof NovaConnectLabels): boolean => {\n return Boolean(labels[key]?.trim());\n};\n\n/**\n * Utility type for extracting label keys by category\n */\nexport type LabelCategory = {\n actions: Extract<\n keyof NovaConnectLabels,\n 'connectWallet' | 'disconnect' | 'connecting' | 'connected' | 'tryAgain' | 'back' | 'connect' | 'close'\n >;\n states: Extract<keyof NovaConnectLabels, 'success' | 'error' | 'replaced' | 'loading' | 'idle'>;\n accessibility: Extract<\n keyof NovaConnectLabels,\n 'chainSelector' | 'closeModal' | 'selectChain' | 'walletControls' | 'openWalletModal'\n >;\n transactions: Extract<\n keyof NovaConnectLabels,\n 'transactionLoading' | 'transactionSuccess' | 'transactionError' | 'transactionReplaced' | 'recent'\n >;\n};\n\n/**\n * Hook to get labels by category for better organization\n *\n * @param category The category of labels to retrieve\n * @returns Object with labels from the specified category\n */\nexport const useLabelsByCategory = <T extends keyof LabelCategory>(\n category: T,\n): Pick<NovaConnectLabels, LabelCategory[T]> => {\n const allLabels = useNovaConnectLabels();\n\n const categoryKeys: Record<keyof LabelCategory, (keyof NovaConnectLabels)[]> = {\n actions: ['connectWallet', 'disconnect', 'connecting', 'connected', 'tryAgain', 'back', 'connect', 'close'],\n states: ['success', 'error', 'replaced', 'loading', 'idle'],\n accessibility: ['chainSelector', 'closeModal', 'selectChain', 'walletControls', 'openWalletModal'],\n transactions: ['transactionLoading', 'transactionSuccess', 'transactionError', 'transactionReplaced', 'recent'],\n };\n\n const keys = categoryKeys[category] as LabelCategory[T][];\n const categoryLabels = {} as Pick<NovaConnectLabels, LabelCategory[T]>;\n\n for (const key of keys) {\n // eslint-disable-next-line\n (categoryLabels as any)[key] = allLabels[key as keyof NovaConnectLabels];\n }\n\n return categoryLabels;\n};\n\n/**\n * Utility function to check if labels are default ones (for external use)\n * This is a regular function, not a hook, so it can be used anywhere\n *\n * @param labels The labels to check\n * @returns Whether the labels are the default English labels\n *\n * @example\n * ```typescript\n * function SomeUtilityFunction(labels: NovaConnectLabels) {\n * if (isDefaultLabels(labels)) {\n * console.log('Using default English labels');\n * }\n * }\n * ```\n */\nexport const isDefaultLabels = (labels: NovaConnectLabels): boolean => {\n return labels === defaultLabels;\n};\n\n/**\n * Utility function to get a formatted label with fallback\n *\n * @param labels The labels object\n * @param key The label key\n * @param fallback Optional fallback text\n * @returns The label value or fallback\n *\n * @example\n * ```typescript\n * const buttonText = getLabelWithFallback(labels, 'connectWallet', 'Connect');\n * ```\n */\nexport const getLabelWithFallback = (\n labels: NovaConnectLabels,\n key: keyof NovaConnectLabels,\n fallback?: string,\n): string => {\n const value = labels[key];\n if (value && value.trim()) {\n return value;\n }\n return fallback || defaultLabels[key] || key.toString();\n};\n\n/**\n * Utility function to create a labels subset (for use outside of React components)\n *\n * @param labels The source labels object\n * @param keys Array of keys to extract\n * @returns Object with only the requested labels\n *\n * @example\n * ```typescript\n * const actionLabels = createLabelsSubset(labels, ['connect', 'disconnect', 'tryAgain']);\n * ```\n */\nexport const createLabelsSubset = <K extends keyof NovaConnectLabels>(\n labels: NovaConnectLabels,\n keys: K[],\n): Pick<NovaConnectLabels, K> => {\n const subset = {} as Pick<NovaConnectLabels, K>;\n for (const key of keys) {\n subset[key] = labels[key];\n }\n return subset;\n};\n","import { OrbitAdapter } from '@tuwaio/orbit-core';\n\nimport { InitialChains } from '../types';\n\n// Default fallback chain IDs\nconst DEFAULT_CHAIN_IDS = {\n [OrbitAdapter.EVM]: 1, // Ethereum Mainnet\n [OrbitAdapter.SOLANA]: 'mainnet',\n [OrbitAdapter.Starknet]: '0x534e5f4d41494e',\n} as const;\n\n/**\n * Basic interface for chain objects to handle the any type safely\n */\ninterface BasicChain {\n id: number | string;\n [key: string]: any;\n}\n\n/**\n * Gets the appropriate chain ID for connecting based on the selected adapter.\n * Returns the first available chain for the adapter, or a sensible default.\n *\n * @param params - Configuration object\n * @param params.selectedAdapter - The blockchain adapter to use\n * @param params.appChains - Available EVM chains\n * @param params.solanaRPCUrls - Available Solana networks\n * @returns Chain ID (number for EVM/Starknet, string for Solana)\n */\nexport function getConnectChainId({\n selectedAdapter,\n appChains,\n solanaRPCUrls,\n}: { selectedAdapter: OrbitAdapter } & InitialChains): number | string {\n switch (selectedAdapter) {\n case OrbitAdapter.EVM: {\n // Return first available EVM chain or default to Ethereum\n const firstChain = appChains?.[0];\n if (firstChain?.id && typeof firstChain.id === 'number') {\n return firstChain.id;\n }\n\n if (process.env.NODE_ENV === 'development' && !appChains?.length) {\n console.warn('getConnectChainId: No EVM chains configured, using Ethereum Mainnet');\n }\n\n return DEFAULT_CHAIN_IDS[OrbitAdapter.EVM];\n }\n\n case OrbitAdapter.SOLANA: {\n // Return first available Solana network or default to mainnet\n if (solanaRPCUrls && typeof solanaRPCUrls === 'object') {\n const networks = Object.keys(solanaRPCUrls);\n if (networks.length > 0) {\n return networks[0];\n }\n }\n\n if (process.env.NODE_ENV === 'development' && !solanaRPCUrls) {\n console.warn('getConnectChainId: No Solana RPC URLs configured, using mainnet');\n }\n\n return DEFAULT_CHAIN_IDS[OrbitAdapter.SOLANA];\n }\n\n case OrbitAdapter.Starknet: {\n if (process.env.NODE_ENV === 'development') {\n console.info('getConnectChainId: Using default Starknet chain ID');\n }\n\n return DEFAULT_CHAIN_IDS[OrbitAdapter.Starknet];\n }\n\n default: {\n // Handle unknown adapter types gracefully\n if (process.env.NODE_ENV === 'development') {\n console.error('getConnectChainId: Unknown adapter:', selectedAdapter);\n }\n\n return DEFAULT_CHAIN_IDS[OrbitAdapter.EVM];\n }\n }\n}\n\n/**\n * Helper to get all available chain IDs for an adapter\n */\nexport function getAvailableChainIds({\n selectedAdapter,\n appChains,\n solanaRPCUrls,\n}: { selectedAdapter: OrbitAdapter } & InitialChains): Array<number | string> {\n switch (selectedAdapter) {\n case OrbitAdapter.EVM:\n return appChains?.map((chain: BasicChain) => chain.id).filter(Boolean) ?? [DEFAULT_CHAIN_IDS[OrbitAdapter.EVM]];\n\n case OrbitAdapter.SOLANA:\n return solanaRPCUrls ? Object.keys(solanaRPCUrls) : [DEFAULT_CHAIN_IDS[OrbitAdapter.SOLANA]];\n\n case OrbitAdapter.Starknet:\n return [DEFAULT_CHAIN_IDS[OrbitAdapter.Starknet]];\n\n default:\n return [DEFAULT_CHAIN_IDS[OrbitAdapter.EVM]];\n }\n}\n","import { formatConnectorName, OrbitAdapter } from '@tuwaio/orbit-core';\n\nimport { Connector } from '../satellite';\n\nexport interface GroupedConnector {\n name: string;\n icon?: string;\n adapters: OrbitAdapter[];\n connectors: (Connector & { adapter: OrbitAdapter })[];\n}\n\ninterface GetGroupedConnectorsParams {\n connectors: Partial<Record<OrbitAdapter, Connector[]>>;\n excludeConnectors?: string[];\n}\n\n/**\n * Type for a safely processed connector\n */\ntype ProcessedConnector = {\n name: string;\n icon?: string;\n adapter: OrbitAdapter;\n originalConnector: Connector;\n};\n\n/**\n * Safely processes a connector and extracts its properties\n */\nfunction processConnector(connector: unknown, adapter: OrbitAdapter): ProcessedConnector | null {\n if (!connector || typeof connector !== 'object') {\n return null;\n }\n\n const connectorObj = connector as Record<string, Connector>;\n\n if (!connectorObj.name || typeof connectorObj.name !== 'string') {\n return null;\n }\n\n return {\n name: connectorObj.name,\n // @ts-expect-error - types on available correctly on the package level\n icon: connectorObj.icon,\n adapter,\n originalConnector: connectorObj as Connector,\n };\n}\n\n/**\n * Groups wallet connectors by their formatted names across different adapters.\n * Filters out specified excluded connectors (like 'injected' wallets).\n */\nexport function getGroupedConnectors(\n { connectors, excludeConnectors = ['injected'] }: GetGroupedConnectorsParams = { connectors: {} },\n): GroupedConnector[] {\n // Input validation\n if (!connectors || Object.keys(connectors).length === 0) {\n return [];\n }\n\n // Create exclusion set for efficient lookup\n const excludeSet = new Set(excludeConnectors.map((name) => formatConnectorName(name)));\n\n // Process and collect all valid connectors\n const processedConnectors: ProcessedConnector[] = [];\n\n Object.entries(connectors).forEach(([adapterKey, adapterConnectors]) => {\n if (Array.isArray(adapterConnectors)) {\n const adapter = adapterKey as OrbitAdapter;\n\n adapterConnectors.forEach((connector) => {\n const processed = processConnector(connector, adapter);\n if (processed) {\n const formattedName = formatConnectorName(processed.name);\n if (!excludeSet.has(formattedName)) {\n processedConnectors.push(processed);\n }\n }\n });\n }\n });\n\n // Group by formatted wallet name using Map for better performance\n const groupedMap = new Map<string, GroupedConnector>();\n\n processedConnectors.forEach((processed) => {\n const formattedName = formatConnectorName(processed.name);\n\n if (!groupedMap.has(formattedName)) {\n groupedMap.set(formattedName, {\n name: processed.name,\n icon: processed.icon,\n adapters: [],\n connectors: [],\n });\n }\n\n const group = groupedMap.get(formattedName)!;\n\n // Add unique adapter\n if (!group.adapters.includes(processed.adapter)) {\n group.adapters.push(processed.adapter);\n }\n\n group.connectors.push({ ...(processed.originalConnector as Connector), adapter: processed.adapter } as Connector & {\n adapter: OrbitAdapter;\n });\n\n // Update icon if not set\n if (!group.icon && processed.icon) {\n group.icon = processed.icon;\n }\n });\n\n // Return sorted array for consistent ordering\n return Array.from(groupedMap.values()).sort((a, b) =>\n a.name.localeCompare(b.name, undefined, { sensitivity: 'base' }),\n );\n}\n\n/**\n * Quick helper to check if connectors are available\n */\nexport function hasAvailableConnectors(connectors: Partial<Record<OrbitAdapter, Connector[]>>): boolean {\n return Object.values(connectors).some(\n (adapterConnectors) => Array.isArray(adapterConnectors) && adapterConnectors.length > 0,\n );\n}\n","import { OrbitAdapter } from '@tuwaio/orbit-core';\n\nimport { Connector } from '../satellite';\nimport { getGroupedConnectors, GroupedConnector } from './getGroupedConnectors';\n\ninterface GetFilteredConnectorsParams {\n connectors: Partial<Record<OrbitAdapter, Connector[]>>;\n selectedAdapter?: OrbitAdapter;\n}\n\n/**\n * Type for connector with adapter information\n */\ntype ConnectorWithAdapter = Connector & { adapter: OrbitAdapter };\n\n/**\n * Helper function to safely access connector adapter property\n * Uses any type to avoid TypeScript inference issues with complex types\n */\nfunction getConnectorAdapter(connector: any): OrbitAdapter | undefined {\n // Safe property access without type guards\n try {\n if (connector && typeof connector === 'object' && connector.adapter) {\n return connector.adapter as OrbitAdapter;\n }\n } catch {\n // Silently handle any errors in property access\n }\n return undefined;\n}\n\n/**\n * Helper function to check if connector matches the selected adapter\n */\nfunction connectorMatchesAdapter(connector: any, selectedAdapter: OrbitAdapter): boolean {\n const connectorAdapter = getConnectorAdapter(connector);\n return connectorAdapter === selectedAdapter;\n}\n\n/**\n * Filters grouped connectors by the selected adapter.\n * Returns all connectors if no adapter is selected, or only connectors\n * that support the specified adapter if one is provided.\n *\n * @param params Configuration object with connectors and optional adapter filter\n * @returns Filtered array of grouped connectors\n */\nexport function getFilteredConnectors({\n connectors,\n selectedAdapter,\n}: GetFilteredConnectorsParams): GroupedConnector[] {\n // Input validation\n if (!connectors || Object.keys(connectors).length === 0) {\n return [];\n }\n\n const groupedConnectors = getGroupedConnectors({ connectors });\n\n // Return all connectors if no filter is applied\n if (!selectedAdapter) {\n return groupedConnectors;\n }\n\n // Filter and transform connector groups\n return groupedConnectors\n .filter((group) => {\n // Only include groups that support the selected adapter\n return (\n group.adapters.includes(selectedAdapter) &&\n group.connectors.some((connector) => connectorMatchesAdapter(connector, selectedAdapter))\n );\n })\n .map((group) => {\n // Create new group with filtered connectors\n const filteredConnectors = group.connectors.filter((connector) =>\n connectorMatchesAdapter(connector, selectedAdapter),\n );\n\n return {\n ...group,\n // Narrow down to only the selected adapter\n adapters: [selectedAdapter],\n // Cast to proper type since we know these connectors have the adapter property\n connectors: filteredConnectors as ConnectorWithAdapter[],\n };\n })\n .filter((group) => group.connectors.length > 0); // Remove empty groups\n}\n\n/**\n * Quick helper to check if any connectors exist for an adapter\n */\nexport function hasConnectorsForAdapter(\n connectors: Partial<Record<OrbitAdapter, Connector[]>>,\n adapter: OrbitAdapter,\n): boolean {\n const adapterConnectors = connectors[adapter];\n return Array.isArray(adapterConnectors) && adapterConnectors.length > 0;\n}\n","import { OrbitAdapter } from '@tuwaio/orbit-core';\n\nexport const getNetworkIcon = (adapter: OrbitAdapter) => {\n switch (adapter) {\n case OrbitAdapter.EVM:\n return {\n chainId: 1,\n name: 'Ethereum',\n };\n case OrbitAdapter.SOLANA:\n return {\n chainId: 'solana:mainnet',\n name: 'Solana',\n };\n }\n};\n","import { OrbitAdapter } from '@tuwaio/orbit-core';\n\nexport const networksLinks: Partial<\n Record<OrbitAdapter, { aboutNetwork: string; choseWallet: string; about: string }>\n> = {\n [OrbitAdapter.EVM]: {\n aboutNetwork: 'https://ethereum.org/developers/docs/intro-to-ethereum/',\n choseWallet: 'https://ethereum.org/wallets/find-wallet/',\n about: 'https://ethereum.org/wallets/',\n },\n [OrbitAdapter.SOLANA]: {\n aboutNetwork: 'https://solana.com/en/learn/what-is-solana',\n choseWallet: 'https://solana.com/en/solana-wallets',\n about: 'https://solana.com/en/learn/what-is-a-wallet',\n },\n};\n","/**\n * @fileoverview Central export hub for blockchain utility functions and types.\n *\n * This module provides a unified interface for accessing blockchain-related utilities,\n * offering both synchronous and asynchronous versions of functions to support different\n * usage patterns and performance requirements.\n *\n * Export Strategy:\n * - Synchronous functions by default for backward compatibility\n * - Asynchronous versions with \"Async\" suffix for better performance\n * - Adapter management functions for system control\n * - Type exports for TypeScript integration\n *\n * @example\n * ```typescript\n * // Import synchronous version (backward compatible)\n * import { getChainsListByConnectorType, isEvmChainList } from './utils';\n *\n * // Import asynchronous version (better performance)\n * import {\n * getChainsListByWalletTypeAsync,\n * isEvmChainListAsync\n * } from './utils';\n *\n * // Import adapter management\n * import { preloadChainAdapters, getAdapterStatus } from './utils';\n *\n * // Import types\n * import type { ChainAdapter, AdapterLoadStatus } from './utils';\n * ```\n *\n * @since 1.0.0\n */\n\n// ========================================\n// Core Chain Utilities (Re-exports)\n// ========================================\n\n/**\n * Re-export all functions from the main chain utilities module.\n * This includes both sync and async versions with proper naming.\n */\nexport * from './getChainsListByConnectorType';\n\n// ========================================\n// Type Exports\n// ========================================\n\n/**\n * Export adapter-related types for TypeScript integration.\n * These types enable proper type checking when working with adapters.\n */\nexport type { AdapterInfo, AdapterLoadStatus, ChainAdapter } from './adapters/types';\n\n// ========================================\n// Adapter Management Functions\n// ========================================\n\n/**\n * Export adapter management utilities from the main utilities module.\n * These functions provide control over adapter loading and status monitoring.\n */\nexport { getAdapterStatus, getAllAdaptersStatus, preloadChainAdapters } from './getChainsListByConnectorType';\n\n// ========================================\n// Backward Compatibility Layer\n// ========================================\n\n/**\n * Export synchronous versions with original names for backward compatibility.\n * This ensures existing code continues to work without modifications.\n *\n * Mapping:\n * - getChainsListByConnectorType -> getChainsListByWalletTypeSync\n * - isEvmChainList -> isEvmChainListSync\n * - isSolanaChainList -> isSolanaChainListSync\n */\nexport {\n getChainsListByConnectorTypeSync as getChainsListByConnectorType,\n getWalletChains,\n isEvmChainListSync as isEvmChainList,\n isSolanaChainListSync as isSolanaChainList,\n} from './getChainsListByConnectorType';\n\n// ========================================\n// Async Versions with Explicit Naming\n// ========================================\n\n/**\n * Export asynchronous versions with \"Async\" suffix for clarity and performance.\n * These versions should be preferred for new code as they provide better\n * functionality through dynamic adapter loading.\n *\n * Benefits of async versions:\n * - Automatic adapter loading when needed\n * - More comprehensive validation logic\n * - Better error handling and fallbacks\n * - Future-proof architecture\n */\nexport {\n getAvailableSolanaClusters as getAvailableSolanaClustersAsync,\n getChainsListByConnectorType as getChainsListByConnectorTypeAsync,\n isEvmChainList as isEvmChainListAsync,\n isSolanaChainList as isSolanaChainListAsync,\n isValidSolanaCluster as isValidSolanaClusterAsync,\n} from './getChainsListByConnectorType';\n\n// ========================================\n// Fallback Implementations\n// ========================================\n\n/**\n * Synchronous fallback for getting available Solana clusters.\n *\n * This function provides immediate results but with limited functionality.\n * It serves as a compatibility layer for synchronous contexts where the\n * async version cannot be used.\n *\n * @returns Empty array with warning (use async version for real results)\n *\n * @example\n * ```typescript\n * // Synchronous fallback (limited functionality)\n * const clusters = getAvailableSolanaClusters(); // []\n *\n * // Preferred async version (full functionality)\n * const clustersAsync = await getAvailableSolanaClustersAsync();\n * ```\n *\n * @since 1.0.0\n * @deprecated Use getAvailableSolanaClustersAsync for full functionality\n */\nexport function getAvailableSolanaClusters(): string[] {\n console.warn(\n 'getAvailableSolanaClusters: Using synchronous fallback with limited functionality. ' +\n 'Use getAvailableSolanaClustersAsync for complete cluster detection.',\n );\n return [];\n}\n\n/**\n * Synchronous fallback for Solana cluster validation.\n *\n * This function provides basic validation against known cluster names but\n * lacks the comprehensive validation logic of the async version. It performs\n * a simple lookup against standard Solana cluster monikers.\n *\n * @param cluster - Cluster name to validate\n * @returns True if cluster name matches known standard clusters\n *\n * @example\n * ```typescript\n * // Synchronous fallback (basic validation)\n * const isValid = isValidSolanaCluster('mainnet-beta'); // true\n * const isCustom = isValidSolanaCluster('custom-cluster'); // false\n *\n * // Preferred async version (comprehensive validation)\n * const isValidAsync = await isValidSolanaClusterAsync('custom-cluster');\n * ```\n *\n * @since 1.0.0\n * @deprecated Use isValidSolanaClusterAsync for comprehensive validation\n */\nexport function isValidSolanaCluster(cluster: string): boolean {\n console.warn(\n 'isValidSolanaCluster: Using synchronous fallback with basic validation. ' +\n 'Use isValidSolanaClusterAsync for comprehensive cluster validation.',\n );\n\n // Basic validation against known standard clusters\n const knownClusters = ['mainnet', 'devnet', 'testnet', 'localnet'];\n return knownClusters.includes(cluster);\n}\n\n// ========================================\n// Additional Utility Exports\n// ========================================\n\n/**\n * Export additional utility functions that don't require blockchain-specific adapters.\n * These utilities provide general functionality for wallet and network management.\n */\nexport * from './getConnectedChainId';\nexport * from './getFilteredConnectors';\nexport * from './getGroupedConnectors';\nexport * from './getNetworIcon';\nexport * from './networksLinks';\n","import { ConnectorType, OrbitAdapter } from '@tuwaio/orbit-core';\nimport { useEffect, useState } from 'react';\n\nimport { InitialChains } from '../types';\nimport { getChainsListByConnectorTypeAsync, getWalletChains } from '../utils';\n\n/**\n * Props for the useWalletChainsList hook\n */\ninterface UseWalletChainsListProps extends InitialChains {\n /** The active connection object from the store */\n activeConnection: any; // Using any to avoid complex store type imports, similar to usage in components\n}\n\n/**\n * Custom hook to asynchronously fetch the list of available chains for the active wallet.\n * Handles the loading state and updates when the active connection or configuration changes.\n *\n * @param props - Hook properties\n * @returns Object containing the chains list and loading state\n */\nexport function useWalletChainsList({ activeConnection, appChains, solanaRPCUrls }: UseWalletChainsListProps) {\n const [chainsList, setChainsList] = useState<(string | number)[]>([]);\n const [isLoading, setIsLoading] = useState<boolean>(false);\n\n useEffect(() => {\n let isMounted = true;\n\n const fetchChains = async () => {\n setIsLoading(true);\n try {\n if (!activeConnection) {\n const list = await getChainsListByConnectorTypeAsync({\n connectorType: `${OrbitAdapter.EVM}:not-connected` as ConnectorType,\n appChains,\n solanaRPCUrls,\n chains: [],\n });\n if (isMounted) {\n setChainsList(list);\n }\n return;\n }\n\n // Safely extract wallet chains using shared utility\n const walletChains = getWalletChains(activeConnection);\n\n const list = await getChainsListByConnectorTypeAsync({\n connectorType: (activeConnection as { connectorType: ConnectorType }).connectorType,\n appChains,\n solanaRPCUrls,\n chains: walletChains,\n });\n\n if (isMounted) {\n setChainsList(list);\n }\n } catch (error) {\n console.error('Failed to fetch chains list:', error);\n if (isMounted) {\n setChainsList([]);\n }\n } finally {\n if (isMounted) {\n setIsLoading(false);\n }\n }\n };\n\n fetchChains();\n\n return () => {\n isMounted = false;\n };\n }, [activeConnection, appChains, solanaRPCUrls]);\n\n return { chainsList, isLoading };\n}\n","import { getAdapterFromConnectorType } from '@tuwaio/orbit-core';\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react';\n\nimport { useSatelliteConnectStore } from '../satellite';\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(): 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 activeConnection = useSatelliteConnectStore((store) => store.activeConnection);\n const getAdapter = useSatelliteConnectStore((store) => store.getAdapter);\n\n // --- 2. COMPUTED INPUTS ---\n\n // Create the unique key for cache lookups: \"address-chainId\".\n const cacheKey = useMemo(() => {\n return activeConnection?.chainId && activeConnection?.address ? `${activeConnection.address}-${activeConnection.chainId}` : null;\n }, [activeConnection?.chainId, activeConnection?.address]);\n\n // Find the actual adapter object from the adapter map.\n const foundAdapter = useMemo(() => {\n if (!activeConnection?.connectorType) return null;\n return getAdapter(getAdapterFromConnectorType(activeConnection.connectorType));\n }, [getAdapter, activeConnection?.connectorType]);\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 (!activeConnection?.address || !foundAdapter || !activeConnection?.chainId || !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(\n activeConnection.address,\n activeConnection.chainId,\n );\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 [activeConnection?.address, foundAdapter, activeConnection?.chainId, 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"]}
|