@tuwaio/orbit-evm 0.0.3 → 0.1.0

package/README.md

@@ -2,7 +2,7 @@
 
 [![NPM Version](https://img.shields.io/npm/v/@tuwaio/orbit-evm.svg)](https://www.npmjs.com/package/@tuwaio/orbit-evm)
 [![License](https://img.shields.io/npm/l/@tuwaio/orbit-evm.svg)](./LICENSE)
-[![Build Status](https://img.shields.io/github/actions/workflow/status/TuwaIO/orbit-evm/release.yml?branch=main)](https://github.com/TuwaIO/orbit-evm/actions)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/TuwaIO/orbit/release.yml?branch=main)](https://github.com/TuwaIO/orbit/actions)
 
 EVM-specific implementation for the TUWA ecosystem, providing comprehensive utilities and helpers for interacting with EVM-compatible blockchains.
 
@@ -17,7 +17,7 @@ EVM-specific implementation for the TUWA ecosystem, providing comprehensive util
 ## ✨ Key Features
 
 - **Type-Safe Development:** Full TypeScript 5.9 support
-- **Tree-Shaking Optimized:** Efficient bundle size through careful exports
+- **Tree-Shaking Optimized:** Efficient bundle size through careful exports.
 
 ---
 

package/dist/index.d.mts

@@ -26,7 +26,7 @@ declare function checkAndSwitchChain(chainId: number, config: Config): Promise<v
  */
 
 /**
- * Creates a viem Public Client for a specific chain.
+ * Creates or retrieves a cached viem Public Client for a specific chain.
  *
  * This client is used for read-only interactions with the blockchain, such as fetching
  * transaction receipts or reading contract state, without needing a wallet connection.
@@ -47,6 +47,7 @@ declare function createViemClient(chainId: number, chains: readonly [Chain, ...C
 
 /**
  * Fetches the primary ENS name for a given Ethereum address from the Ethereum Mainnet.
+ * Includes caching for performance.
  *
  * @param {Hex} address - The Ethereum address to look up.
  * @returns {Promise<string | null>} The ENS name if found, otherwise null.
@@ -54,6 +55,7 @@ declare function createViemClient(chainId: number, chains: readonly [Chain, ...C
 declare const getName: (address: Hex) => Promise<string | null>;
 /**
  * Fetches the avatar URL for a given ENS name from the Ethereum Mainnet.
+ * Includes caching for performance.
  *
  * @param {string} name - The ENS name (e.g., 'vitalik.eth').
  * @returns {Promise<string | null>} The URL of the avatar image if found, otherwise null.
@@ -61,6 +63,7 @@ declare const getName: (address: Hex) => Promise<string | null>;
 declare const getAvatar: (name: string) => Promise<string | null>;
 /**
  * Fetches the Ethereum address associated with a given ENS name from the Ethereum Mainnet.
+ * Includes caching for performance.
  *
  * @param {string} name - The ENS name to resolve (e.g., 'vitalik.eth').
  * @returns {Promise<Address | null>} The associated Ethereum address (lowercase) or null if not found.

package/dist/index.d.ts

@@ -26,7 +26,7 @@ declare function checkAndSwitchChain(chainId: number, config: Config): Promise<v
  */
 
 /**
- * Creates a viem Public Client for a specific chain.
+ * Creates or retrieves a cached viem Public Client for a specific chain.
  *
  * This client is used for read-only interactions with the blockchain, such as fetching
  * transaction receipts or reading contract state, without needing a wallet connection.
@@ -47,6 +47,7 @@ declare function createViemClient(chainId: number, chains: readonly [Chain, ...C
 
 /**
  * Fetches the primary ENS name for a given Ethereum address from the Ethereum Mainnet.
+ * Includes caching for performance.
  *
  * @param {Hex} address - The Ethereum address to look up.
  * @returns {Promise<string | null>} The ENS name if found, otherwise null.
@@ -54,6 +55,7 @@ declare function createViemClient(chainId: number, chains: readonly [Chain, ...C
 declare const getName: (address: Hex) => Promise<string | null>;
 /**
  * Fetches the avatar URL for a given ENS name from the Ethereum Mainnet.
+ * Includes caching for performance.
  *
  * @param {string} name - The ENS name (e.g., 'vitalik.eth').
  * @returns {Promise<string | null>} The URL of the avatar image if found, otherwise null.
@@ -61,6 +63,7 @@ declare const getName: (address: Hex) => Promise<string | null>;
 declare const getAvatar: (name: string) => Promise<string | null>;
 /**
  * Fetches the Ethereum address associated with a given ENS name from the Ethereum Mainnet.
+ * Includes caching for performance.
  *
  * @param {string} name - The ENS name to resolve (e.g., 'vitalik.eth').
  * @returns {Promise<Address | null>} The associated Ethereum address (lowercase) or null if not found.

package/dist/index.js

@@ -1,2 +1,2 @@
-'use strict';var core=require('@wagmi/core'),viem=require('viem'),chains=require('viem/chains'),ens=require('viem/ens');async function x(r,e){let{connector:n,chainId:o}=core.getAccount(e);if(n&&o!==r)try{await core.switchChain(e,{chainId:r});}catch(i){throw i.cause?.name==="UserRejectedRequestError"?new Error("User rejected the request to switch network."):(console.error("Failed to switch network:",i),new Error("An error occurred while switching the network."))}}function a(r,e){let n=e.find(o=>o.id===r);if(n)return viem.createPublicClient({chain:n,transport:viem.http()});console.warn(`createViemClient: No chain configuration found for chainId ${r}. A client could not be created.`);}var t=a(chains.mainnet.id,[chains.mainnet]),V=async r=>{if(!t)return null;try{return await ens.getEnsName(t,{address:r})}catch(e){return console.error(`ENS name lookup failed for address ${r}:`,e),null}},j=async r=>{if(!t)return null;try{return await ens.getEnsAvatar(t,{name:ens.normalize(r)})}catch(e){return console.error(`ENS avatar lookup failed for name ${r}:`,e),null}},q=async r=>{if(!t)return null;try{let e=await ens.getEnsAddress(t,{name:ens.normalize(r)});return e?e.toLowerCase():null}catch(e){return console.error(`ENS address lookup failed for name ${r}:`,e),null}},H=r=>r.includes(".")&&!viem.isAddress(r);exports.checkAndSwitchChain=x;exports.createViemClient=a;exports.getAddress=q;exports.getAvatar=j;exports.getName=V;exports.isEnsName=H;//# sourceMappingURL=index.js.map
+'use strict';var core=require('@wagmi/core'),viem=require('viem'),chains=require('viem/chains'),ens=require('viem/ens');async function N(e,r){let{connector:n,chainId:t}=core.getAccount(r);if(n&&t!==e)try{await core.switchChain(r,{chainId:e});}catch(o){throw o.cause?.name==="UserRejectedRequestError"?new Error("User rejected the request to switch network."):(console.error("Failed to switch network:",o),new Error("An error occurred while switching the network."))}}var s=new Map;function a(e,r){let n=s.get(e);if(n)return n;let t=r.find(o=>o.id===e);if(t){let o=viem.createPublicClient({chain:t,transport:viem.http()});return s.set(e,o),o}console.warn(`createViemClient: No chain configuration found for chainId ${e}. A client could not be created.`);}var l=new Map,u=new Map,d=new Map,i=a(chains.mainnet.id,[chains.mainnet]),V=async e=>{if(!i)return null;let r=l.get(e);if(r!==void 0)return r;try{let n=await ens.getEnsName(i,{address:e});return l.set(e,n),n}catch(n){return console.error(`ENS name lookup failed for address ${e}:`,n),null}},j=async e=>{if(!i)return null;let r=ens.normalize(e),n=u.get(r);if(n!==void 0)return n;try{let t=await ens.getEnsAvatar(i,{name:r});return u.set(r,t),t}catch(t){return console.error(`ENS avatar lookup failed for name ${e}:`,t),null}},q=async e=>{if(!i)return null;let r=ens.normalize(e),n=d.get(r);if(n!==void 0)return n;try{let t=await ens.getEnsAddress(i,{name:r}),o=t?t.toLowerCase():null;return d.set(r,o),o}catch(t){return console.error(`ENS address lookup failed for name ${e}:`,t),null}},R=e=>e.includes(".")&&!viem.isAddress(e);exports.checkAndSwitchChain=N;exports.createViemClient=a;exports.getAddress=q;exports.getAvatar=j;exports.getName=V;exports.isEnsName=R;//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils/checkAndSwitchChain.ts","../src/utils/createViemClient.ts","../src/utils/ensUtils.ts"],"names":["checkAndSwitchChain","chainId","config","connector","activeChainId","getAccount","switchChain","error","createViemClient","chains","chain","c","createPublicClient","http","ensClient","mainnet","getName","address","getEnsName","getAvatar","name","getEnsAvatar","normalize","getAddress","getEnsAddress","isEnsName","nameOrAddress","isAddress"],"mappings":"wHAmBA,eAAsBA,CAAAA,CAAoBC,CAAAA,CAAiBC,CAAAA,CAA+B,CACxF,GAAM,CAAE,SAAA,CAAAC,EAAW,OAAA,CAASC,CAAc,CAAA,CAAIC,eAAAA,CAAWH,CAAM,CAAA,CAG/D,GAAIC,CAAAA,EAAaC,CAAAA,GAAkBH,CAAAA,CACjC,GAAI,CAEF,MAAMK,gBAAAA,CAAYJ,EAAQ,CAAE,OAAA,CAAAD,CAAQ,CAAC,EACvC,CAAA,MAASM,CAAAA,CAAO,CACd,MAAKA,CAAAA,CAAc,KAAA,EAAO,IAAA,GAAS,0BAAA,CAC3B,IAAI,KAAA,CAAM,8CAA8C,CAAA,EAEhE,OAAA,CAAQ,KAAA,CAAM,2BAAA,CAA6BA,CAAK,CAAA,CAC1C,IAAI,KAAA,CAAM,gDAAgD,CAAA,CAClE,CAEJ,CChBO,SAASC,CAAAA,CAAiBP,CAAAA,CAAiBQ,CAAAA,CAAgE,CAChH,IAAMC,CAAAA,CAAQD,CAAAA,CAAO,IAAA,CAAME,CAAAA,EAAMA,CAAAA,CAAE,KAAOV,CAAO,CAAA,CAEjD,GAAIS,CAAAA,CACF,OAAOE,uBAAAA,CAAmB,CACxB,KAAA,CAAOF,CAAAA,CACP,SAAA,CAAWG,SAAAA,EACb,CAAC,CAAA,CAGH,QAAQ,IAAA,CAAK,CAAA,2DAAA,EAA8DZ,CAAO,CAAA,gCAAA,CAAkC,EAGtH,CClBA,IAAMa,CAAAA,CAAYN,CAAAA,CAAiBO,cAAAA,CAAQ,EAAA,CAAI,CAACA,cAAO,CAAC,CAAA,CAQ3CC,CAAAA,CAAU,MAAOC,CAAAA,EAAyC,CACrE,GAAI,CAACH,CAAAA,CAAW,OAAO,IAAA,CACvB,GAAI,CAEF,OAAO,MAAMI,cAAAA,CAAWJ,CAAAA,CAAW,CAAE,OAAA,CAAAG,CAAQ,CAAC,CAChD,CAAA,MAASV,CAAAA,CAAO,CACd,OAAA,OAAA,CAAQ,KAAA,CAAM,CAAA,mCAAA,EAAsCU,CAAO,IAAKV,CAAK,CAAA,CAC9D,IACT,CACF,CAAA,CAQaY,CAAAA,CAAY,MAAOC,CAAAA,EAAyC,CACvE,GAAI,CAACN,CAAAA,CAAW,OAAO,IAAA,CACvB,GAAI,CAEF,OAAO,MAAMO,gBAAAA,CAAaP,CAAAA,CAAW,CAAE,IAAA,CAAMQ,aAAAA,CAAUF,CAAI,CAAE,CAAC,CAChE,CAAA,MAASb,CAAAA,CAAO,CACd,eAAQ,KAAA,CAAM,CAAA,kCAAA,EAAqCa,CAAI,CAAA,CAAA,CAAA,CAAKb,CAAK,CAAA,CAC1D,IACT,CACF,CAAA,CAQagB,CAAAA,CAAa,MAAOH,CAAAA,EAA0C,CACzE,GAAI,CAACN,CAAAA,CAAW,OAAO,IAAA,CACvB,GAAI,CACF,IAAMG,CAAAA,CAAU,MAAMO,iBAAAA,CAAcV,CAAAA,CAAW,CAAE,IAAA,CAAMQ,aAAAA,CAAUF,CAAI,CAAE,CAAC,CAAA,CAExE,OAAOH,CAAAA,CAAWA,CAAAA,CAAQ,WAAA,EAAY,CAAgB,IACxD,CAAA,MAASV,CAAAA,CAAO,CACd,OAAA,OAAA,CAAQ,KAAA,CAAM,CAAA,mCAAA,EAAsCa,CAAI,CAAA,CAAA,CAAA,CAAKb,CAAK,CAAA,CAC3D,IACT,CACF,CAAA,CAgBakB,CAAAA,CAAaC,CAAAA,EACjBA,CAAAA,CAAc,QAAA,CAAS,GAAG,CAAA,EAAK,CAACC,cAAAA,CAAUD,CAAa","file":"index.js","sourcesContent":["/**\n * @file This file contains a utility to ensure the user's wallet is connected to the correct chain before proceeding with a transaction.\n */\n\nimport { Config, getAccount, switchChain } from '@wagmi/core';\n\n/**\n * Checks if the user's wallet is connected to the specified chain. If not, it prompts\n * the user to switch to the correct chain.\n *\n * This function is a crucial prerequisite for any action that requires a specific network.\n *\n * @param {number} chainId - The ID of the desired blockchain network.\n * @param {Config} config - The wagmi configuration object.\n * @returns {Promise<void>} A promise that resolves when the wallet is on the correct chain.\n * It rejects if the user cancels the switch or if another error occurs.\n *\n * @throws {Error} Throws a specific error if the user rejects the chain switch or if the switch fails for other reasons.\n */\nexport async function checkAndSwitchChain(chainId: number, config: Config): Promise<void> {\n  const { connector, chainId: activeChainId } = getAccount(config);\n\n  // Proceed only if a wallet is connected and it is on a different chain than required.\n  if (connector && activeChainId !== chainId) {\n    try {\n      // Pause execution and wait for the user to confirm the chain switch in their wallet.\n      await switchChain(config, { chainId });\n    } catch (error) {\n      if ((error as any).cause?.name === 'UserRejectedRequestError') {\n        throw new Error('User rejected the request to switch network.');\n      }\n      console.error('Failed to switch network:', error);\n      throw new Error('An error occurred while switching the network.');\n    }\n  }\n}\n","/**\n * @file This file contains a utility function for creating a viem Public Client.\n */\n\nimport { createPublicClient, http, PublicClient } from 'viem';\nimport { Chain } from 'viem/chains';\n\n/**\n * Creates a viem Public Client for a specific chain.\n *\n * This client is used for read-only interactions with the blockchain, such as fetching\n * transaction receipts or reading contract state, without needing a wallet connection.\n *\n * @param {number} chainId - The ID of the chain for which to create the client.\n * @param {Chain[]} chains - An array of supported viem Chain objects.\n *\n * @returns {import('viem').PublicClient | undefined} A viem PublicClient instance if a matching chain is found, otherwise undefined.\n * It will also log a warning to the console if the chain is not configured.\n */\nexport function createViemClient(chainId: number, chains: readonly [Chain, ...Chain[]]): PublicClient | undefined {\n  const chain = chains.find((c) => c.id === chainId);\n\n  if (chain) {\n    return createPublicClient({\n      chain: chain,\n      transport: http(),\n    });\n  }\n  // Log a warning for easier debugging if a chain configuration is missing.\n  console.warn(`createViemClient: No chain configuration found for chainId ${chainId}. A client could not be created.`);\n\n  return undefined;\n}\n","/**\n * @file This file contains utility functions for interacting with the Ethereum Name Service (ENS).\n * It provides methods for resolving names to addresses, addresses to names, and fetching avatars,\n * all specifically targeting the Ethereum Mainnet where ENS is deployed.\n */\n\nimport { Address, Hex, isAddress } from 'viem';\nimport { mainnet } from 'viem/chains';\nimport { getEnsAddress, getEnsAvatar, getEnsName, normalize } from 'viem/ens';\n\nimport { createViemClient } from './createViemClient';\n\n// A single, shared viem client for all ENS lookups.\n// ENS lookups are always performed against Ethereum Mainnet, regardless of the app's connected chain.\nconst ensClient = createViemClient(mainnet.id, [mainnet]);\n\n/**\n * Fetches the primary ENS name for a given Ethereum address from the Ethereum Mainnet.\n *\n * @param {Hex} address - The Ethereum address to look up.\n * @returns {Promise<string | null>} The ENS name if found, otherwise null.\n */\nexport const getName = async (address: Hex): Promise<string | null> => {\n  if (!ensClient) return null;\n  try {\n    // getEnsName returns the name or null if not found.\n    return await getEnsName(ensClient, { address });\n  } catch (error) {\n    console.error(`ENS name lookup failed for address ${address}:`, error);\n    return null;\n  }\n};\n\n/**\n * Fetches the avatar URL for a given ENS name from the Ethereum Mainnet.\n *\n * @param {string} name - The ENS name (e.g., 'vitalik.eth').\n * @returns {Promise<string | null>} The URL of the avatar image if found, otherwise null.\n */\nexport const getAvatar = async (name: string): Promise<string | null> => {\n  if (!ensClient) return null;\n  try {\n    // getEnsAvatar returns the URL or null if not found.\n    return await getEnsAvatar(ensClient, { name: normalize(name) });\n  } catch (error) {\n    console.error(`ENS avatar lookup failed for name ${name}:`, error);\n    return null;\n  }\n};\n\n/**\n * Fetches the Ethereum address associated with a given ENS name from the Ethereum Mainnet.\n *\n * @param {string} name - The ENS name to resolve (e.g., 'vitalik.eth').\n * @returns {Promise<Address | null>} The associated Ethereum address (lowercase) or null if not found.\n */\nexport const getAddress = async (name: string): Promise<Address | null> => {\n  if (!ensClient) return null;\n  try {\n    const address = await getEnsAddress(ensClient, { name: normalize(name) });\n    // viem returns the address or null. We ensure it's lowercase if it exists.\n    return address ? (address.toLowerCase() as Address) : null;\n  } catch (error) {\n    console.error(`ENS address lookup failed for name ${name}:`, error);\n    return null;\n  }\n};\n\n/**\n * A heuristic to check if a string is likely an ENS name.\n *\n * This is not a foolproof validation but a quick check. A valid ENS name\n * must contain at least one dot and should not be a valid Ethereum address.\n *\n * @param {string} nameOrAddress - The string to check.\n * @returns {boolean} True if the string is likely an ENS name.\n *\n * @example\n * isEnsName('vitalik.eth') // true\n * isEnsName('0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045') // false\n * isEnsName('notanaddress') // false (doesn't contain a dot)\n */\nexport const isEnsName = (nameOrAddress: string): boolean => {\n  return nameOrAddress.includes('.') && !isAddress(nameOrAddress);\n};\n"]}
+{"version":3,"sources":["../src/utils/checkAndSwitchChain.ts","../src/utils/createViemClient.ts","../src/utils/ensUtils.ts"],"names":["checkAndSwitchChain","chainId","config","connector","activeChainId","getAccount","switchChain","error","viemClientCache","createViemClient","chains","cachedClient","chain","c","newClient","createPublicClient","http","nameCache","avatarCache","addressCache","ensClient","mainnet","getName","address","cachedName","name","getEnsName","getAvatar","normalizedName","normalize","cachedAvatar","avatarUrl","getEnsAvatar","getAddress","cachedAddress","getEnsAddress","lowercasedAddress","isEnsName","nameOrAddress","isAddress"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @file This file contains a utility to ensure the user's wallet is connected to the correct chain before proceeding with a transaction.\n */\n\nimport { Config, getAccount, switchChain } from '@wagmi/core';\n\n/**\n * Checks if the user's wallet is connected to the specified chain. If not, it prompts\n * the user to switch to the correct chain.\n *\n * This function is a crucial prerequisite for any action that requires a specific network.\n *\n * @param {number} chainId - The ID of the desired blockchain network.\n * @param {Config} config - The wagmi configuration object.\n * @returns {Promise<void>} A promise that resolves when the wallet is on the correct chain.\n * It rejects if the user cancels the switch or if another error occurs.\n *\n * @throws {Error} Throws a specific error if the user rejects the chain switch or if the switch fails for other reasons.\n */\nexport async function checkAndSwitchChain(chainId: number, config: Config): Promise<void> {\n  const { connector, chainId: activeChainId } = getAccount(config);\n\n  // Proceed only if a wallet is connected and it is on a different chain than required.\n  if (connector && activeChainId !== chainId) {\n    try {\n      // Pause execution and wait for the user to confirm the chain switch in their wallet.\n      await switchChain(config, { chainId });\n    } catch (error) {\n      if ((error as any).cause?.name === 'UserRejectedRequestError') {\n        throw new Error('User rejected the request to switch network.');\n      }\n      console.error('Failed to switch network:', error);\n      throw new Error('An error occurred while switching the network.');\n    }\n  }\n}\n","/**\n * @file This file contains a utility function for creating a viem Public Client.\n */\n\nimport { createPublicClient, http, PublicClient } from 'viem';\nimport { Chain } from 'viem/chains';\n\nconst viemClientCache = new Map<number, PublicClient>();\n\n// -------------------\n\n/**\n * Creates or retrieves a cached viem Public Client for a specific chain.\n *\n * This client is used for read-only interactions with the blockchain, such as fetching\n * transaction receipts or reading contract state, without needing a wallet connection.\n *\n * @param {number} chainId - The ID of the chain for which to create the client.\n * @param {Chain[]} chains - An array of supported viem Chain objects.\n *\n * @returns {import('viem').PublicClient | undefined} A viem PublicClient instance if a matching chain is found, otherwise undefined.\n * It will also log a warning to the console if the chain is not configured.\n */\nexport function createViemClient(chainId: number, chains: readonly [Chain, ...Chain[]]): PublicClient | undefined {\n  const cachedClient = viemClientCache.get(chainId);\n  if (cachedClient) {\n    return cachedClient;\n  }\n\n  const chain = chains.find((c) => c.id === chainId);\n\n  if (chain) {\n    const newClient = createPublicClient({\n      chain: chain,\n      transport: http(),\n    });\n    viemClientCache.set(chainId, newClient);\n    return newClient;\n  }\n\n  // Log a warning for easier debugging if a chain configuration is missing.\n  console.warn(`createViemClient: No chain configuration found for chainId ${chainId}. A client could not be created.`);\n\n  return undefined;\n}\n","/**\n * @file This file contains utility functions for interacting with the Ethereum Name Service (ENS).\n * It provides methods for resolving names to addresses, addresses to names, and fetching avatars,\n * all specifically targeting the Ethereum Mainnet where ENS is deployed.\n */\n\nimport { Address, Hex, isAddress } from 'viem';\nimport { mainnet } from 'viem/chains';\nimport { getEnsAddress, getEnsAvatar, getEnsName, normalize } from 'viem/ens';\n\nimport { createViemClient } from './createViemClient';\n\nconst nameCache = new Map<Hex, string | null>();\nconst avatarCache = new Map<string, string | null>();\nconst addressCache = new Map<string, Address | null>();\n\n// -------------------\n\n// A single, shared viem client for all ENS lookups.\n// ENS lookups are always performed against Ethereum Mainnet, regardless of the app's connected chain.\nconst ensClient = createViemClient(mainnet.id, [mainnet]);\n\n/**\n * Fetches the primary ENS name for a given Ethereum address from the Ethereum Mainnet.\n * Includes caching for performance.\n *\n * @param {Hex} address - The Ethereum address to look up.\n * @returns {Promise<string | null>} The ENS name if found, otherwise null.\n */\nexport const getName = async (address: Hex): Promise<string | null> => {\n  if (!ensClient) return null;\n\n  const cachedName = nameCache.get(address);\n  if (cachedName !== undefined) {\n    return cachedName;\n  }\n\n  try {\n    const name = await getEnsName(ensClient, { address });\n    nameCache.set(address, name);\n    return name;\n  } catch (error) {\n    console.error(`ENS name lookup failed for address ${address}:`, error);\n    return null;\n  }\n};\n\n/**\n * Fetches the avatar URL for a given ENS name from the Ethereum Mainnet.\n * Includes caching for performance.\n *\n * @param {string} name - The ENS name (e.g., 'vitalik.eth').\n * @returns {Promise<string | null>} The URL of the avatar image if found, otherwise null.\n */\nexport const getAvatar = async (name: string): Promise<string | null> => {\n  if (!ensClient) return null;\n  const normalizedName = normalize(name);\n\n  const cachedAvatar = avatarCache.get(normalizedName);\n  if (cachedAvatar !== undefined) {\n    return cachedAvatar;\n  }\n\n  try {\n    const avatarUrl = await getEnsAvatar(ensClient, { name: normalizedName });\n    avatarCache.set(normalizedName, avatarUrl);\n    return avatarUrl;\n  } catch (error) {\n    console.error(`ENS avatar lookup failed for name ${name}:`, error);\n    return null;\n  }\n};\n\n/**\n * Fetches the Ethereum address associated with a given ENS name from the Ethereum Mainnet.\n * Includes caching for performance.\n *\n * @param {string} name - The ENS name to resolve (e.g., 'vitalik.eth').\n * @returns {Promise<Address | null>} The associated Ethereum address (lowercase) or null if not found.\n */\nexport const getAddress = async (name: string): Promise<Address | null> => {\n  if (!ensClient) return null;\n  const normalizedName = normalize(name);\n\n  const cachedAddress = addressCache.get(normalizedName);\n  if (cachedAddress !== undefined) {\n    return cachedAddress;\n  }\n\n  try {\n    const address = await getEnsAddress(ensClient, { name: normalizedName });\n    const lowercasedAddress = address ? (address.toLowerCase() as Address) : null;\n    addressCache.set(normalizedName, lowercasedAddress);\n    return lowercasedAddress;\n  } catch (error) {\n    console.error(`ENS address lookup failed for name ${name}:`, error);\n    return null;\n  }\n};\n\n/**\n * A heuristic to check if a string is likely an ENS name.\n *\n * This is not a foolproof validation but a quick check. A valid ENS name\n * must contain at least one dot and should not be a valid Ethereum address.\n *\n * @param {string} nameOrAddress - The string to check.\n * @returns {boolean} True if the string is likely an ENS name.\n *\n * @example\n * isEnsName('vitalik.eth') // true\n * isEnsName('0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045') // false\n * isEnsName('notanaddress') // false (doesn't contain a dot)\n */\nexport const isEnsName = (nameOrAddress: string): boolean => {\n  return nameOrAddress.includes('.') && !isAddress(nameOrAddress);\n};\n"]}

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import {getAccount,switchChain}from'@wagmi/core';import {createPublicClient,http,isAddress}from'viem';import {mainnet}from'viem/chains';import {getEnsName,getEnsAvatar,normalize,getEnsAddress}from'viem/ens';async function x(r,e){let{connector:n,chainId:o}=getAccount(e);if(n&&o!==r)try{await switchChain(e,{chainId:r});}catch(i){throw i.cause?.name==="UserRejectedRequestError"?new Error("User rejected the request to switch network."):(console.error("Failed to switch network:",i),new Error("An error occurred while switching the network."))}}function a(r,e){let n=e.find(o=>o.id===r);if(n)return createPublicClient({chain:n,transport:http()});console.warn(`createViemClient: No chain configuration found for chainId ${r}. A client could not be created.`);}var t=a(mainnet.id,[mainnet]),V=async r=>{if(!t)return null;try{return await getEnsName(t,{address:r})}catch(e){return console.error(`ENS name lookup failed for address ${r}:`,e),null}},j=async r=>{if(!t)return null;try{return await getEnsAvatar(t,{name:normalize(r)})}catch(e){return console.error(`ENS avatar lookup failed for name ${r}:`,e),null}},q=async r=>{if(!t)return null;try{let e=await getEnsAddress(t,{name:normalize(r)});return e?e.toLowerCase():null}catch(e){return console.error(`ENS address lookup failed for name ${r}:`,e),null}},H=r=>r.includes(".")&&!isAddress(r);export{x as checkAndSwitchChain,a as createViemClient,q as getAddress,j as getAvatar,V as getName,H as isEnsName};//# sourceMappingURL=index.mjs.map
+import {getAccount,switchChain}from'@wagmi/core';import {createPublicClient,http,isAddress}from'viem';import {mainnet}from'viem/chains';import {getEnsName,normalize,getEnsAvatar,getEnsAddress}from'viem/ens';async function N(e,r){let{connector:n,chainId:t}=getAccount(r);if(n&&t!==e)try{await switchChain(r,{chainId:e});}catch(o){throw o.cause?.name==="UserRejectedRequestError"?new Error("User rejected the request to switch network."):(console.error("Failed to switch network:",o),new Error("An error occurred while switching the network."))}}var s=new Map;function a(e,r){let n=s.get(e);if(n)return n;let t=r.find(o=>o.id===e);if(t){let o=createPublicClient({chain:t,transport:http()});return s.set(e,o),o}console.warn(`createViemClient: No chain configuration found for chainId ${e}. A client could not be created.`);}var l=new Map,u=new Map,d=new Map,i=a(mainnet.id,[mainnet]),V=async e=>{if(!i)return null;let r=l.get(e);if(r!==void 0)return r;try{let n=await getEnsName(i,{address:e});return l.set(e,n),n}catch(n){return console.error(`ENS name lookup failed for address ${e}:`,n),null}},j=async e=>{if(!i)return null;let r=normalize(e),n=u.get(r);if(n!==void 0)return n;try{let t=await getEnsAvatar(i,{name:r});return u.set(r,t),t}catch(t){return console.error(`ENS avatar lookup failed for name ${e}:`,t),null}},q=async e=>{if(!i)return null;let r=normalize(e),n=d.get(r);if(n!==void 0)return n;try{let t=await getEnsAddress(i,{name:r}),o=t?t.toLowerCase():null;return d.set(r,o),o}catch(t){return console.error(`ENS address lookup failed for name ${e}:`,t),null}},R=e=>e.includes(".")&&!isAddress(e);export{N as checkAndSwitchChain,a as createViemClient,q as getAddress,j as getAvatar,V as getName,R as isEnsName};//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils/checkAndSwitchChain.ts","../src/utils/createViemClient.ts","../src/utils/ensUtils.ts"],"names":["checkAndSwitchChain","chainId","config","connector","activeChainId","getAccount","switchChain","error","createViemClient","chains","chain","c","createPublicClient","http","ensClient","mainnet","getName","address","getEnsName","getAvatar","name","getEnsAvatar","normalize","getAddress","getEnsAddress","isEnsName","nameOrAddress","isAddress"],"mappings":"+MAmBA,eAAsBA,CAAAA,CAAoBC,CAAAA,CAAiBC,CAAAA,CAA+B,CACxF,GAAM,CAAE,SAAA,CAAAC,EAAW,OAAA,CAASC,CAAc,CAAA,CAAIC,UAAAA,CAAWH,CAAM,CAAA,CAG/D,GAAIC,CAAAA,EAAaC,CAAAA,GAAkBH,CAAAA,CACjC,GAAI,CAEF,MAAMK,WAAAA,CAAYJ,EAAQ,CAAE,OAAA,CAAAD,CAAQ,CAAC,EACvC,CAAA,MAASM,CAAAA,CAAO,CACd,MAAKA,CAAAA,CAAc,KAAA,EAAO,IAAA,GAAS,0BAAA,CAC3B,IAAI,KAAA,CAAM,8CAA8C,CAAA,EAEhE,OAAA,CAAQ,KAAA,CAAM,2BAAA,CAA6BA,CAAK,CAAA,CAC1C,IAAI,KAAA,CAAM,gDAAgD,CAAA,CAClE,CAEJ,CChBO,SAASC,CAAAA,CAAiBP,CAAAA,CAAiBQ,CAAAA,CAAgE,CAChH,IAAMC,CAAAA,CAAQD,CAAAA,CAAO,IAAA,CAAME,CAAAA,EAAMA,CAAAA,CAAE,KAAOV,CAAO,CAAA,CAEjD,GAAIS,CAAAA,CACF,OAAOE,kBAAAA,CAAmB,CACxB,KAAA,CAAOF,CAAAA,CACP,SAAA,CAAWG,IAAAA,EACb,CAAC,CAAA,CAGH,QAAQ,IAAA,CAAK,CAAA,2DAAA,EAA8DZ,CAAO,CAAA,gCAAA,CAAkC,EAGtH,CClBA,IAAMa,CAAAA,CAAYN,CAAAA,CAAiBO,OAAAA,CAAQ,EAAA,CAAI,CAACA,OAAO,CAAC,CAAA,CAQ3CC,CAAAA,CAAU,MAAOC,CAAAA,EAAyC,CACrE,GAAI,CAACH,CAAAA,CAAW,OAAO,IAAA,CACvB,GAAI,CAEF,OAAO,MAAMI,UAAAA,CAAWJ,CAAAA,CAAW,CAAE,OAAA,CAAAG,CAAQ,CAAC,CAChD,CAAA,MAASV,CAAAA,CAAO,CACd,OAAA,OAAA,CAAQ,KAAA,CAAM,CAAA,mCAAA,EAAsCU,CAAO,IAAKV,CAAK,CAAA,CAC9D,IACT,CACF,CAAA,CAQaY,CAAAA,CAAY,MAAOC,CAAAA,EAAyC,CACvE,GAAI,CAACN,CAAAA,CAAW,OAAO,IAAA,CACvB,GAAI,CAEF,OAAO,MAAMO,YAAAA,CAAaP,CAAAA,CAAW,CAAE,IAAA,CAAMQ,SAAAA,CAAUF,CAAI,CAAE,CAAC,CAChE,CAAA,MAASb,CAAAA,CAAO,CACd,eAAQ,KAAA,CAAM,CAAA,kCAAA,EAAqCa,CAAI,CAAA,CAAA,CAAA,CAAKb,CAAK,CAAA,CAC1D,IACT,CACF,CAAA,CAQagB,CAAAA,CAAa,MAAOH,CAAAA,EAA0C,CACzE,GAAI,CAACN,CAAAA,CAAW,OAAO,IAAA,CACvB,GAAI,CACF,IAAMG,CAAAA,CAAU,MAAMO,aAAAA,CAAcV,CAAAA,CAAW,CAAE,IAAA,CAAMQ,SAAAA,CAAUF,CAAI,CAAE,CAAC,CAAA,CAExE,OAAOH,CAAAA,CAAWA,CAAAA,CAAQ,WAAA,EAAY,CAAgB,IACxD,CAAA,MAASV,CAAAA,CAAO,CACd,OAAA,OAAA,CAAQ,KAAA,CAAM,CAAA,mCAAA,EAAsCa,CAAI,CAAA,CAAA,CAAA,CAAKb,CAAK,CAAA,CAC3D,IACT,CACF,CAAA,CAgBakB,CAAAA,CAAaC,CAAAA,EACjBA,CAAAA,CAAc,QAAA,CAAS,GAAG,CAAA,EAAK,CAACC,SAAAA,CAAUD,CAAa","file":"index.mjs","sourcesContent":["/**\n * @file This file contains a utility to ensure the user's wallet is connected to the correct chain before proceeding with a transaction.\n */\n\nimport { Config, getAccount, switchChain } from '@wagmi/core';\n\n/**\n * Checks if the user's wallet is connected to the specified chain. If not, it prompts\n * the user to switch to the correct chain.\n *\n * This function is a crucial prerequisite for any action that requires a specific network.\n *\n * @param {number} chainId - The ID of the desired blockchain network.\n * @param {Config} config - The wagmi configuration object.\n * @returns {Promise<void>} A promise that resolves when the wallet is on the correct chain.\n * It rejects if the user cancels the switch or if another error occurs.\n *\n * @throws {Error} Throws a specific error if the user rejects the chain switch or if the switch fails for other reasons.\n */\nexport async function checkAndSwitchChain(chainId: number, config: Config): Promise<void> {\n  const { connector, chainId: activeChainId } = getAccount(config);\n\n  // Proceed only if a wallet is connected and it is on a different chain than required.\n  if (connector && activeChainId !== chainId) {\n    try {\n      // Pause execution and wait for the user to confirm the chain switch in their wallet.\n      await switchChain(config, { chainId });\n    } catch (error) {\n      if ((error as any).cause?.name === 'UserRejectedRequestError') {\n        throw new Error('User rejected the request to switch network.');\n      }\n      console.error('Failed to switch network:', error);\n      throw new Error('An error occurred while switching the network.');\n    }\n  }\n}\n","/**\n * @file This file contains a utility function for creating a viem Public Client.\n */\n\nimport { createPublicClient, http, PublicClient } from 'viem';\nimport { Chain } from 'viem/chains';\n\n/**\n * Creates a viem Public Client for a specific chain.\n *\n * This client is used for read-only interactions with the blockchain, such as fetching\n * transaction receipts or reading contract state, without needing a wallet connection.\n *\n * @param {number} chainId - The ID of the chain for which to create the client.\n * @param {Chain[]} chains - An array of supported viem Chain objects.\n *\n * @returns {import('viem').PublicClient | undefined} A viem PublicClient instance if a matching chain is found, otherwise undefined.\n * It will also log a warning to the console if the chain is not configured.\n */\nexport function createViemClient(chainId: number, chains: readonly [Chain, ...Chain[]]): PublicClient | undefined {\n  const chain = chains.find((c) => c.id === chainId);\n\n  if (chain) {\n    return createPublicClient({\n      chain: chain,\n      transport: http(),\n    });\n  }\n  // Log a warning for easier debugging if a chain configuration is missing.\n  console.warn(`createViemClient: No chain configuration found for chainId ${chainId}. A client could not be created.`);\n\n  return undefined;\n}\n","/**\n * @file This file contains utility functions for interacting with the Ethereum Name Service (ENS).\n * It provides methods for resolving names to addresses, addresses to names, and fetching avatars,\n * all specifically targeting the Ethereum Mainnet where ENS is deployed.\n */\n\nimport { Address, Hex, isAddress } from 'viem';\nimport { mainnet } from 'viem/chains';\nimport { getEnsAddress, getEnsAvatar, getEnsName, normalize } from 'viem/ens';\n\nimport { createViemClient } from './createViemClient';\n\n// A single, shared viem client for all ENS lookups.\n// ENS lookups are always performed against Ethereum Mainnet, regardless of the app's connected chain.\nconst ensClient = createViemClient(mainnet.id, [mainnet]);\n\n/**\n * Fetches the primary ENS name for a given Ethereum address from the Ethereum Mainnet.\n *\n * @param {Hex} address - The Ethereum address to look up.\n * @returns {Promise<string | null>} The ENS name if found, otherwise null.\n */\nexport const getName = async (address: Hex): Promise<string | null> => {\n  if (!ensClient) return null;\n  try {\n    // getEnsName returns the name or null if not found.\n    return await getEnsName(ensClient, { address });\n  } catch (error) {\n    console.error(`ENS name lookup failed for address ${address}:`, error);\n    return null;\n  }\n};\n\n/**\n * Fetches the avatar URL for a given ENS name from the Ethereum Mainnet.\n *\n * @param {string} name - The ENS name (e.g., 'vitalik.eth').\n * @returns {Promise<string | null>} The URL of the avatar image if found, otherwise null.\n */\nexport const getAvatar = async (name: string): Promise<string | null> => {\n  if (!ensClient) return null;\n  try {\n    // getEnsAvatar returns the URL or null if not found.\n    return await getEnsAvatar(ensClient, { name: normalize(name) });\n  } catch (error) {\n    console.error(`ENS avatar lookup failed for name ${name}:`, error);\n    return null;\n  }\n};\n\n/**\n * Fetches the Ethereum address associated with a given ENS name from the Ethereum Mainnet.\n *\n * @param {string} name - The ENS name to resolve (e.g., 'vitalik.eth').\n * @returns {Promise<Address | null>} The associated Ethereum address (lowercase) or null if not found.\n */\nexport const getAddress = async (name: string): Promise<Address | null> => {\n  if (!ensClient) return null;\n  try {\n    const address = await getEnsAddress(ensClient, { name: normalize(name) });\n    // viem returns the address or null. We ensure it's lowercase if it exists.\n    return address ? (address.toLowerCase() as Address) : null;\n  } catch (error) {\n    console.error(`ENS address lookup failed for name ${name}:`, error);\n    return null;\n  }\n};\n\n/**\n * A heuristic to check if a string is likely an ENS name.\n *\n * This is not a foolproof validation but a quick check. A valid ENS name\n * must contain at least one dot and should not be a valid Ethereum address.\n *\n * @param {string} nameOrAddress - The string to check.\n * @returns {boolean} True if the string is likely an ENS name.\n *\n * @example\n * isEnsName('vitalik.eth') // true\n * isEnsName('0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045') // false\n * isEnsName('notanaddress') // false (doesn't contain a dot)\n */\nexport const isEnsName = (nameOrAddress: string): boolean => {\n  return nameOrAddress.includes('.') && !isAddress(nameOrAddress);\n};\n"]}
+{"version":3,"sources":["../src/utils/checkAndSwitchChain.ts","../src/utils/createViemClient.ts","../src/utils/ensUtils.ts"],"names":["checkAndSwitchChain","chainId","config","connector","activeChainId","getAccount","switchChain","error","viemClientCache","createViemClient","chains","cachedClient","chain","c","newClient","createPublicClient","http","nameCache","avatarCache","addressCache","ensClient","mainnet","getName","address","cachedName","name","getEnsName","getAvatar","normalizedName","normalize","cachedAvatar","avatarUrl","getEnsAvatar","getAddress","cachedAddress","getEnsAddress","lowercasedAddress","isEnsName","nameOrAddress","isAddress"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * @file This file contains a utility to ensure the user's wallet is connected to the correct chain before proceeding with a transaction.\n */\n\nimport { Config, getAccount, switchChain } from '@wagmi/core';\n\n/**\n * Checks if the user's wallet is connected to the specified chain. If not, it prompts\n * the user to switch to the correct chain.\n *\n * This function is a crucial prerequisite for any action that requires a specific network.\n *\n * @param {number} chainId - The ID of the desired blockchain network.\n * @param {Config} config - The wagmi configuration object.\n * @returns {Promise<void>} A promise that resolves when the wallet is on the correct chain.\n * It rejects if the user cancels the switch or if another error occurs.\n *\n * @throws {Error} Throws a specific error if the user rejects the chain switch or if the switch fails for other reasons.\n */\nexport async function checkAndSwitchChain(chainId: number, config: Config): Promise<void> {\n  const { connector, chainId: activeChainId } = getAccount(config);\n\n  // Proceed only if a wallet is connected and it is on a different chain than required.\n  if (connector && activeChainId !== chainId) {\n    try {\n      // Pause execution and wait for the user to confirm the chain switch in their wallet.\n      await switchChain(config, { chainId });\n    } catch (error) {\n      if ((error as any).cause?.name === 'UserRejectedRequestError') {\n        throw new Error('User rejected the request to switch network.');\n      }\n      console.error('Failed to switch network:', error);\n      throw new Error('An error occurred while switching the network.');\n    }\n  }\n}\n","/**\n * @file This file contains a utility function for creating a viem Public Client.\n */\n\nimport { createPublicClient, http, PublicClient } from 'viem';\nimport { Chain } from 'viem/chains';\n\nconst viemClientCache = new Map<number, PublicClient>();\n\n// -------------------\n\n/**\n * Creates or retrieves a cached viem Public Client for a specific chain.\n *\n * This client is used for read-only interactions with the blockchain, such as fetching\n * transaction receipts or reading contract state, without needing a wallet connection.\n *\n * @param {number} chainId - The ID of the chain for which to create the client.\n * @param {Chain[]} chains - An array of supported viem Chain objects.\n *\n * @returns {import('viem').PublicClient | undefined} A viem PublicClient instance if a matching chain is found, otherwise undefined.\n * It will also log a warning to the console if the chain is not configured.\n */\nexport function createViemClient(chainId: number, chains: readonly [Chain, ...Chain[]]): PublicClient | undefined {\n  const cachedClient = viemClientCache.get(chainId);\n  if (cachedClient) {\n    return cachedClient;\n  }\n\n  const chain = chains.find((c) => c.id === chainId);\n\n  if (chain) {\n    const newClient = createPublicClient({\n      chain: chain,\n      transport: http(),\n    });\n    viemClientCache.set(chainId, newClient);\n    return newClient;\n  }\n\n  // Log a warning for easier debugging if a chain configuration is missing.\n  console.warn(`createViemClient: No chain configuration found for chainId ${chainId}. A client could not be created.`);\n\n  return undefined;\n}\n","/**\n * @file This file contains utility functions for interacting with the Ethereum Name Service (ENS).\n * It provides methods for resolving names to addresses, addresses to names, and fetching avatars,\n * all specifically targeting the Ethereum Mainnet where ENS is deployed.\n */\n\nimport { Address, Hex, isAddress } from 'viem';\nimport { mainnet } from 'viem/chains';\nimport { getEnsAddress, getEnsAvatar, getEnsName, normalize } from 'viem/ens';\n\nimport { createViemClient } from './createViemClient';\n\nconst nameCache = new Map<Hex, string | null>();\nconst avatarCache = new Map<string, string | null>();\nconst addressCache = new Map<string, Address | null>();\n\n// -------------------\n\n// A single, shared viem client for all ENS lookups.\n// ENS lookups are always performed against Ethereum Mainnet, regardless of the app's connected chain.\nconst ensClient = createViemClient(mainnet.id, [mainnet]);\n\n/**\n * Fetches the primary ENS name for a given Ethereum address from the Ethereum Mainnet.\n * Includes caching for performance.\n *\n * @param {Hex} address - The Ethereum address to look up.\n * @returns {Promise<string | null>} The ENS name if found, otherwise null.\n */\nexport const getName = async (address: Hex): Promise<string | null> => {\n  if (!ensClient) return null;\n\n  const cachedName = nameCache.get(address);\n  if (cachedName !== undefined) {\n    return cachedName;\n  }\n\n  try {\n    const name = await getEnsName(ensClient, { address });\n    nameCache.set(address, name);\n    return name;\n  } catch (error) {\n    console.error(`ENS name lookup failed for address ${address}:`, error);\n    return null;\n  }\n};\n\n/**\n * Fetches the avatar URL for a given ENS name from the Ethereum Mainnet.\n * Includes caching for performance.\n *\n * @param {string} name - The ENS name (e.g., 'vitalik.eth').\n * @returns {Promise<string | null>} The URL of the avatar image if found, otherwise null.\n */\nexport const getAvatar = async (name: string): Promise<string | null> => {\n  if (!ensClient) return null;\n  const normalizedName = normalize(name);\n\n  const cachedAvatar = avatarCache.get(normalizedName);\n  if (cachedAvatar !== undefined) {\n    return cachedAvatar;\n  }\n\n  try {\n    const avatarUrl = await getEnsAvatar(ensClient, { name: normalizedName });\n    avatarCache.set(normalizedName, avatarUrl);\n    return avatarUrl;\n  } catch (error) {\n    console.error(`ENS avatar lookup failed for name ${name}:`, error);\n    return null;\n  }\n};\n\n/**\n * Fetches the Ethereum address associated with a given ENS name from the Ethereum Mainnet.\n * Includes caching for performance.\n *\n * @param {string} name - The ENS name to resolve (e.g., 'vitalik.eth').\n * @returns {Promise<Address | null>} The associated Ethereum address (lowercase) or null if not found.\n */\nexport const getAddress = async (name: string): Promise<Address | null> => {\n  if (!ensClient) return null;\n  const normalizedName = normalize(name);\n\n  const cachedAddress = addressCache.get(normalizedName);\n  if (cachedAddress !== undefined) {\n    return cachedAddress;\n  }\n\n  try {\n    const address = await getEnsAddress(ensClient, { name: normalizedName });\n    const lowercasedAddress = address ? (address.toLowerCase() as Address) : null;\n    addressCache.set(normalizedName, lowercasedAddress);\n    return lowercasedAddress;\n  } catch (error) {\n    console.error(`ENS address lookup failed for name ${name}:`, error);\n    return null;\n  }\n};\n\n/**\n * A heuristic to check if a string is likely an ENS name.\n *\n * This is not a foolproof validation but a quick check. A valid ENS name\n * must contain at least one dot and should not be a valid Ethereum address.\n *\n * @param {string} nameOrAddress - The string to check.\n * @returns {boolean} True if the string is likely an ENS name.\n *\n * @example\n * isEnsName('vitalik.eth') // true\n * isEnsName('0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045') // false\n * isEnsName('notanaddress') // false (doesn't contain a dot)\n */\nexport const isEnsName = (nameOrAddress: string): boolean => {\n  return nameOrAddress.includes('.') && !isAddress(nameOrAddress);\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuwaio/orbit-evm",
-  "version": "0.0.3",
+  "version": "0.1.0",
   "private": false,
   "author": "Oleksandr Tkach",
   "license": "Apache-2.0",
@@ -22,12 +22,12 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/TuwaIO/satellite-connect.git",
+    "url": "git+https://github.com/TuwaIO/orbit.git",
     "directory": "packages/orbit-evm"
   },
-  "homepage": "https://github.com/TuwaIO/satellite-connect",
+  "homepage": "https://github.com/TuwaIO/orbit",
   "bugs": {
-    "url": "https://github.com/TuwaIO/satellite-connect/issues"
+    "url": "https://github.com/TuwaIO/orbit/issues"
   },
   "contributors": [
     {
@@ -36,14 +36,14 @@
     }
   ],
   "peerDependencies": {
-    "@wagmi/core": ">=2.2",
-    "viem": ">=2.3"
+    "@wagmi/core": "2.x.x",
+    "viem": "2.x.x"
   },
   "devDependencies": {
-    "@wagmi/core": "^2.20.3",
+    "@wagmi/core": "^2.22.1",
     "tsup": "^8.5.0",
-    "typescript": "^5.9.2",
-    "viem": "^2.37.4"
+    "typescript": "^5.9.3",
+    "viem": "^2.38.3"
   },
   "scripts": {
     "start": "tsup src/index.ts --watch",