wagmi-extended 1.1.2 → 1.1.4

package/README.md

@@ -2,7 +2,7 @@
 
 `wagmi-extended` is a powerful library that builds on [Wagmi](https://wagmi.sh/), [Viem](https://viem.sh/), and [TanStack Query](https://tanstack.com/query/v5) to deliver extended hooks and helper functions for Ethereum and blockchain development with React.
 <br /><br />
-It simplifies tasks like fetching token metadata, handling ERC20 approvals, sending transactions, writing contracts and getting user friendly error message.
+It simplifies tasks like fetching token metadata, handling ERC20 approvals, sending transactions, writing contracts and getting user friendly error message from ABIs.
 <br /><br />
 Our library adheres to one core principle: **always wait for a transaction receipt**. This guarantees that your dApps capture transaction outcomes reliably—no manual state management or race conditions required.
 <br /><br />
@@ -20,11 +20,13 @@ Whether you're building a DeFi platform, a governance system, or any blockchain
   - [useSendTransactionX Hook](#usesendtransactionx-hook)
   - [useTokenX Hook](#usetokenx-hook)
 - [Non-hook functions setup](#non-hook-functions-setup)
+  - [Error handling](#error-handling)
+  - [fetchTokenX](#fetchTokenX)
 - [Contributing](#contributing)
 - [Donations](#support--donations)
 - [License](#license)
 
-### Installation
+## Installation
 
 Install via npm:
 
@@ -38,7 +40,7 @@ Or with Yarn:
 yarn add wagmi-extended
 ```
 
-### Requirements
+## Requirements
 
 Your project must include the following peer dependencies:
 
@@ -47,7 +49,7 @@ Your project must include the following peer dependencies:
 - **Viem**: ^2.0.0
 - **@tanstack/react-query**: ^5.0.0
 
-Note: You must wrap your application with necessary providers (e.g. QueryClientProvider from TanStack Query and WagmiProvider).
+> **Note:** : You must wrap your application with necessary providers (e.g. QueryClientProvider from TanStack Query and WagmiProvider).
 
 ## Playground
 
@@ -144,37 +146,7 @@ return (
 
 The `useSendTransactionX` hook wraps the transaction-sending functionality from Wagmi with additional features like `receipt` waiting, `logging` control, and `query invalidation` after receipt is successfully fetched.
 
-Example:
-
-```bash
-import { useSendTransactionX } from "wagmi-extended";
-
-function TransactionButton() {
-  const { sendTransactionAsync, isPending, errorMessage } = useSendTransactionX({
-    // use calbacks here in useSendTransactionX or in sendTransactionAsync
-    onSuccess: (txHash) => console.log("Transaction successful:", txHash),
-    onError: (error) => console.error("Transaction failed:", error),
-    queriesToInvalidate: [["someQueryKey"]],
-  });
-
-  const handleTransaction = async () => {
-    try {
-      // Replace with actual transaction parameters
-      const txHash = await sendTransactionAsync({ transaction params here.. });
-      console.log("Transaction hash:", txHash);
-    } catch (error) {
-      console.error(error);
-    }
-  };
-
-  return (
-    <button onClick={handleTransaction} disabled={isPending}>
-      {isPending ? "Processing..." : "Send Transaction"}
-      {errorMessage && <span>Error: {errorMessage}</span>}
-    </button>
-  );
-}
-```
+Very similar to useContractWriteX, see [playground](https://codesandbox.io/p/sandbox/5jr3lg) for example.
 
 ### useTokenX Hook
 
@@ -200,7 +172,7 @@ function TokenDisplay({ tokenAddress }: { tokenAddress: Address }) {
 }
 ```
 
-### Non-hook functions setup
+## Non-hook functions setup
 
 **Feel free to skip Setup-section if using only hooks - no fetch methods directly**
 <br />
@@ -234,6 +206,57 @@ ReactDOM.createRoot(document.getElementById("root")!).render(
 );
 ```
 
+### Error Handling
+
+The library provides a built-in error mapping mechanism to transform raw errors into user-friendly messages. This is especially useful when working with smart contracts that may revert with different kinds of errors.
+
+> **Note:** : mapper is just a `fallback` if error message can't be understood from ABIs.
+
+Example: Override the default allowance error message and add a new custom error. Provide error type (name), signature or reason and string as a message.
+
+```bash
+setErrorMapping({
+  ErrorNotEnoughAllowance: "Custom message: Please approve tokens first!",
+  NewCustomError: "A custom error occurred.",
+  "0xea8d7f02":
+    "Action exceeded safe slippage parameters, please try again later",
+});
+```
+
+> **Note:** : this `EXPANDS` the current object, it doesn't override.
+
+This is default error mapper, feel free to create PR to extend it as well:
+
+```bash
+const defaultErrorMapping: Record<string, string> = {
+  EnforcedPause: "Temporary pause in effect, please check Discord for updates.",
+  ErrorNotEnoughAllowance:
+    "Not enough allowance, did you approve your tokens first?",
+  "0xc2139725": "Not enough allowance, did you approve your tokens first?",
+  SharesReceivedBelowMinimum:
+    "Action exceeded safe slippage parameters, please try again later",
+  "0xea8d7f02":
+    "Action exceeded safe slippage parameters, please try again later",
+  MaxSlippageExceeded:
+    "Action exceeded safe slippage parameters, please try again later",
+  "51": "Supply cap exceeded",
+};
+```
+
+> **Note:** : if you don't like initial error mapping and messages, you can call `resetErrorMapping()` which will reset the mapping to `{}`.
+
+### fetchTokenX
+
+Example:
+
+```bash
+const tokensData = await Promise.all(tokenAddresses.map((token) =>
+  fetchTokenX(token);
+));
+```
+
+> **Note:** : if you did not setup defaults (queryClient and wagmi config) you can call by passing client and config as params: `fetchTokenX(token, queryClient, wagmiConfig)`.
+
 ## Contributing
 
 This project is open source and we welcome contributions from the community! If you have ideas, improvements, or bug fixes, please feel free to open pull requests or file issues. Your help makes this project better for everyone.

package/dist/index.cjs.js

@@ -46,7 +46,7 @@ const setErrorMapping = (customMapping) => {
  * resetErrorMapping();
  */
 const resetErrorMapping = () => {
-    currentErrorMapping = { ...defaultErrorMapping };
+    currentErrorMapping = {};
 };
 /**
  * Retrieves the current error mapping.

package/dist/index.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs.js","sources":["../src/utils/errorParserX.ts","../src/hooks/useInvalidateQueries.ts","../src/hooks/useHandleTransactionMutationX.ts","../src/hooks/useContractWriteX.ts","../src/hooks/useSendTransactionX.ts","../src/query-config/index.ts","../src/fetch-functions/fetchAllowanceX.ts","../src/hooks/useFetchAssetAllowanceX.ts","../src/hooks/useERC20ApproveX.ts","../src/config/defaults.ts","../src/fetch-functions/fetchTokenX.ts","../src/hooks/useTokenX.ts"],"sourcesContent":["import { BaseError, ContractFunctionRevertedError } from \"viem\";\n\n/**\n * Default error mapping that contains a set of error identifiers mapped to user-friendly error messages.\n */\nconst defaultErrorMapping: Record<string, string> = {\n  EnforcedPause: \"Temporary pause in effect, please check Discord for updates.\",\n  ErrorNotEnoughAllowance:\n    \"Not enough allowance, did you approve your tokens first?\",\n  \"0xc2139725\": \"Not enough allowance, did you approve your tokens first?\",\n  SharesReceivedBelowMinimum:\n    \"Action exceeded safe slippage parameters, please try again later\",\n  \"0xea8d7f02\":\n    \"Action exceeded safe slippage parameters, please try again later\",\n  MaxSlippageExceeded:\n    \"Action exceeded safe slippage parameters, please try again later\",\n  \"51\": \"Supply cap exceeded\",\n};\n\n/**\n * A mutable copy of the default error mapping that can be extended or overridden by users.\n */\nlet currentErrorMapping: Record<string, string> = { ...defaultErrorMapping };\n\n/**\n * Merges a custom error mapping into the current error mapping.\n * Custom values override any existing keys.\n *\n * @param customMapping - An object containing error keys and the corresponding custom messages.\n *\n * @example\n * setErrorMapping({\n *   ErrorNotEnoughAllowance: \"Custom message: Please approve tokens first!\",\n *   NewCustomError: \"A custom error occurred.\"\n * });\n */\nexport const setErrorMapping = (\n  customMapping: Record<string, string>\n): void => {\n  currentErrorMapping = { ...currentErrorMapping, ...customMapping };\n};\n\n/**\n * Resets the current error mapping to the default error mapping.\n *\n * @example\n * resetErrorMapping();\n */\nexport const resetErrorMapping = (): void => {\n  currentErrorMapping = { ...defaultErrorMapping };\n};\n\n/**\n * Retrieves the current error mapping.\n *\n * @returns The current error mapping object.\n *\n * @example\n * const mapping = getErrorMapping();\n * console.log(mapping);\n */\nexport const getErrorMapping = (): Record<string, string> =>\n  currentErrorMapping;\n\n/**\n * Parses an error object and returns a user-friendly error message.\n *\n * The function checks if the error is a ContractFunctionRevertedError by attempting to walk through\n * the error using its `walk` method. If a matching error is found and its error key exists in the\n * current error mapping, the corresponding custom message will be returned. Otherwise, it falls back\n * to the error's own message properties.\n *\n * @param error - The error object, potentially including additional error details.\n * @returns A user-friendly error message.\n *\n * @example\n * const message = getParsedError(someError);\n * console.log(message); // Outputs a custom error message or a default error message.\n */\nexport const getParsedErrorX = (error: any | BaseError): string => {\n  const defaultMessage = \"An unknown error occurred. Please contact support.\";\n  let message = defaultMessage;\n  let errorKey = \"\";\n\n  const revertedError = error?.walk\n    ? error.walk((err: unknown) => err instanceof ContractFunctionRevertedError)\n    : null;\n  if (revertedError instanceof ContractFunctionRevertedError) {\n    errorKey =\n      revertedError.data?.errorName ??\n      revertedError.signature ??\n      revertedError.reason ??\n      \"\";\n    if (currentErrorMapping[errorKey]) return currentErrorMapping[errorKey];\n  }\n\n  message = error.shortMessage || error.details || error.message || message;\n  return message;\n};\n","import { QueryKey, useQueryClient } from \"@tanstack/react-query\";\n\n/**\n * Hook to invalidate multiple queries in the React Query cache.\n *\n * @returns An object with the invalidateMany function.\n */\nexport function useInvalidateQueries() {\n  const queryClient = useQueryClient();\n\n  const invalidateMany = async (queries: (QueryKey | undefined)[]) => {\n    const promises = queries.map((queryKey) =>\n      queryClient.invalidateQueries({ queryKey })\n    );\n    await Promise.all(promises);\n  };\n\n  return { invalidateMany };\n}\n","import { waitForTransactionReceipt } from \"wagmi/actions\";\nimport { useConfig } from \"wagmi\";\nimport { QueryKey } from \"@tanstack/query-core\";\nimport { Address } from \"viem\";\nimport { useState } from \"react\";\nimport { getParsedErrorX } from \"../utils/errorParserX.js\";\nimport { useInvalidateQueries } from \"./useInvalidateQueries.js\";\n\nexport type WriteExtendedAsyncParams = {\n  onSuccess?: (txHash: Address) => void;\n  onError?: (e: any) => void;\n  onSettled?: () => void;\n  queriesToInvalidate?: (QueryKey | undefined)[];\n  disableLogging?: boolean;\n  disableWaitingForReceipt?: boolean;\n};\n\n/**\n * Custom hook to handle transaction mutations.\n *\n * @returns {Function} A shared `onSettled` callback for transaction mutations.\n */\nexport function useHandleTransactionMutationX({\n  settings,\n}: {\n  settings?: WriteExtendedAsyncParams;\n}) {\n  const wagmiConfig = useConfig();\n\n  const { invalidateMany } = useInvalidateQueries();\n  const [isPending, setIsPending] = useState(false);\n  const [errorMessage, setErrorMessage] = useState<string | undefined>(\n    undefined\n  );\n\n  const onMutate = () => {\n    setIsPending(true);\n    setErrorMessage(undefined);\n  };\n\n  const onSettled = async (\n    txHash: Address | undefined,\n    error: any,\n    args: any\n  ) => {\n    try {\n      if (error) throw error;\n\n      if (!settings?.disableWaitingForReceipt) {\n        // 1. wait for transaction receipt\n        const txReceipt = await waitForTransactionReceipt(wagmiConfig, {\n          hash: txHash!,\n        });\n\n        // 2. throw if receipt is not valid\n        if (txReceipt.status === \"reverted\")\n          throw new Error(\"Execution reverted.\");\n        if (txReceipt.status !== \"success\")\n          throw new Error(\"Execution reverted.\");\n      }\n\n      // 3. invalidate queries\n      if (settings?.queriesToInvalidate)\n        await invalidateMany(settings?.queriesToInvalidate);\n\n      // 4. call onSuccess callback\n      settings?.onSuccess?.(txHash!);\n\n      if (!settings?.disableLogging) {\n        // 5. log result\n        // eslint-disable-next-line no-console\n        console.info(\"Operation successful:\", txHash); // todo: add logging service\n      }\n      // 6. return result\n      return txHash;\n    } catch (error) {\n      const parsedError = getParsedErrorX(error);\n\n      if (!settings?.disableLogging) {\n        // 1. log error\n        console.error(\n          `ContractWriteExtended Operation failed with error(parsed): ${parsedError}`,\n          { error },\n          { args }\n        );\n        console.error({ error });\n      }\n      // 2. set error message\n      setErrorMessage(parsedError);\n\n      // 3. call callback\n      settings?.onError?.(error);\n    } finally {\n      setIsPending(false);\n      // 1. call callback\n      settings?.onSettled?.();\n    }\n    return undefined;\n  };\n\n  return {\n    onMutate,\n    onSettled,\n    isPending,\n    errorMessage,\n  };\n}\n","import { useWriteContract } from \"wagmi\";\nimport {\n  WriteExtendedAsyncParams,\n  useHandleTransactionMutationX,\n} from \"./useHandleTransactionMutationX.js\";\n\n/**\n * Custom hook for writing to a smart contract using Wagmi.\n *\n * This hook provides functionality for writing a contract using Wagmi, handling the asynchronous nature of the operation, waiting for the transaction receipt, and error handling.\n *\n * @param {WriteExtendedAsyncParams} [settings] - Optional settings for the write operation.\n * @param {boolean} [settings.disableWaitingForReceipt] - Disables waiting for the transaction receipt.\n * @param {boolean} [settings.disableLogging] - Disables logging the result of the transaction.\n * @param {Function} [settings.onSuccess] - Callback function to be called on successful transaction.\n * @param {Function} [settings.onError] - Callback function to be called on transaction error.\n * @param {Function} [settings.onSettled] - Callback function to be called after the transaction settles (whether success or failure).\n * @param {QueryKey[]} [settings.queriesToInvalidate] - Array of query keys to invalidate after the transaction receives a receipt.\n * @returns {Object} Object containing the following properties:\n * - {boolean} isPending - Indicates whether the transaction is pending.\n * - {string|undefined} errorMessage - The error message, if an error occurred during the transaction.\n * - {Function} writeContractAsync - Function to trigger the write operation.\n * \n/**\n * Custom hook for writing a contract using Wagmi with extended functionality.\n *\n * This hook wraps Wagmi’s `useContractWriteX` with additional handling for\n * waiting for a transaction receipt, logging control, and invalidation of specified queries.\n *\n * @param {WriteExtendedAsyncParams} [settings] - Optional settings for handling the transaction.\n * @returns {Object} An object containing:\n *   - `isPending`: {boolean} indicating if the transaction is in progress.\n *   - `errorMessage`: {string|undefined} a potential error message.\n *   - `writeContractAsync`: {Function} a function to trigger the transaction.\n *\n * @example\n * // In your component:\n * function MyTransactionComponent() {\n *   const { writeContractAsync, isPending, errorMessage } = useContractWriteX({\n *     queriesToInvalidate: [[\"userBalance\"], [\"userActivity\"]],\n *   });\n *\n *   const handleWrite = async () => {\n *     try {\n *       const txHash = await writeContractAsync({ transaction params here.. }, {\n *          // use calbacks here in writeContractAsync or in useContractWriteX\n *          onSuccess: (txHash) => console.log(\"Transaction successful:\", txHash),\n *          onError: (error) => console.error(\"Transaction error:\", error),\n *       });\n *       console.log(\"Received txHash:\", txHash);\n *     } catch (err) {\n *       console.error(\"Failed writing transaction:\", err);`\n *     }\n *   };\n *\n *   return (\n *     <div>\n *       <button onClick={handleWrite} disabled={isPending}>\n *         {isPending ? \"Processing...\" : \"Write Transaction\"}\n *       </button>\n *       {errorMessage && <p>Error: {errorMessage}</p>}\n *     </div>\n *   );\n * }\n */\n\nexport function useContractWriteX(settings?: WriteExtendedAsyncParams) {\n  const { isPending, errorMessage, onMutate, onSettled } =\n    useHandleTransactionMutationX({\n      settings,\n    });\n\n  const { writeContractAsync, ...rest } = useWriteContract({\n    mutation: {\n      onMutate,\n      onSettled,\n    },\n  });\n\n  return {\n    ...rest,\n    isPending,\n    errorMessage,\n    writeContractAsync,\n  };\n}\n","import { useSendTransaction } from \"wagmi\";\nimport {\n  useHandleTransactionMutationX,\n  WriteExtendedAsyncParams,\n} from \"./useHandleTransactionMutationX.js\";\n\n/**\n * Custom hook for sending a transaction using Wagmi.\n *\n * This hook provides functionality for sending a transaction using Wagmi, handling the asynchronous nature of the operation, waiting for the transaction receipt, and error handling.\n *\n * @param {WriteExtendedAsyncParams} [settings] - Optional settings for the write operation.\n * @param {boolean} [settings.disableWaitingForReceipt] - Disables waiting for the transaction receipt.\n * @param {boolean} [settings.disableLogging] - Disables logging the result of the transaction.\n * @param {Function} [settings.onSuccess] - Callback function to be called on successful transaction.\n * @param {Function} [settings.onError] - Callback function to be called on transaction error.\n * @param {Function} [settings.onSettled] - Callback function to be called after the transaction settles (whether success or failure).\n * @param {QueryKey[]} [settings.queriesToInvalidate] - Array of query keys to invalidate after the transaction receives a receipt.\n * @returns {Object} Object containing the following properties:\n * - {boolean} isPending - Indicates whether the transaction is pending.\n * - {string|undefined} errorMessage - The error message, if an error occurred during the transaction.\n * - {Function} sendTransactionAsync - Function to trigger the send transaction mutation.\n\n * @example\n * // In your component:\n * function MyTransactionComponent() {\n *   const { sendTransactionAsync, isPending, errorMessage } = useSendTransactionX({\n *     // use calbacks here in useContractWriteX or in writeContractAsync\n *     onSuccess: (txHash) => console.log(\"Transaction successful:\", txHash),\n *     onError: (error) => console.error(\"Transaction error:\", error),\n *     queriesToInvalidate: [[\"userBalance\"], [\"userActivity\"]],\n *   });\n *\n *   const handleSend = async () => {\n *     try {\n *       const txHash = await sendTransactionAsync({ transaction params here.. });\n *       console.log(\"Received txHash:\", txHash);\n *     } catch (err) {\n *       console.error(\"Failed sending transaction:\", err);`\n *     }\n *   };\n *\n *   return (\n *     <div>\n *       <button onClick={handleSend} disabled={isPending}>\n *         {isPending ? \"Processing...\" : \"Send Transaction\"}\n *       </button>\n *       {errorMessage && <p>Error: {errorMessage}</p>}\n *     </div>\n *   );\n * }\n */\n\nexport function useSendTransactionX(settings?: WriteExtendedAsyncParams) {\n  const { isPending, errorMessage, onMutate, onSettled } =\n    useHandleTransactionMutationX({\n      settings,\n    });\n\n  const { sendTransactionAsync, ...rest } = useSendTransaction({\n    mutation: {\n      onMutate,\n      onSettled,\n    },\n  });\n\n  return {\n    ...rest,\n    isPending,\n    errorMessage,\n    sendTransactionAsync,\n  };\n}\n","export const queryConfig = {\n  metadataQueryConfig: {\n    staleTime: Infinity,\n  },\n  sensitiveDataQueryConfig: {\n    staleTime: 60_000,\n  },\n};\n","import { Address, erc20Abi } from \"viem\";\nimport { readContract } from \"viem/actions\";\n\nexport const fetchAllowance = async (\n  asset: Address,\n  spender: Address,\n  userAddress: Address,\n  config: any\n) => {\n  const allowance = await readContract(config, {\n    address: asset,\n    abi: erc20Abi,\n    functionName: \"allowance\",\n    args: [userAddress, spender],\n  });\n\n  if (allowance == null) {\n    throw new Error(\"Failed to fetch token data or allowance\");\n  }\n\n  return allowance;\n};\n","import { useQuery, useQueryClient } from \"@tanstack/react-query\";\nimport { Address, erc20Abi } from \"viem\";\nimport { useAccount, useConfig } from \"wagmi\";\nimport { queryConfig } from \"../query-config/index.js\";\nimport { fetchAllowance } from \"../fetch-functions/fetchAllowanceX.js\";\n\nconst HookFetchAssetAllowanceQK = (\n  asset?: Address,\n  spender?: Address,\n  userAddress?: Address\n) => [\"HookFetchAllowance\", asset, spender, userAddress] as const;\n\n/**\n * Custom hook for fetching asset allowance.\n *\n * @param {Address} asset - The address of the ERC20 token contract.\n * @param {Address} spender - The address of the spender to check allowance for.\n *\n *\n * @example\n * // In your component:\n * function AllowanceDisplay() {\n *   const { data: allowance, isLoading, error } = useFetchAssetAllowanceX({\n *     asset: \"0xTokenAddressExample\",\n *     spender: \"0xSpenderAddressExample\",\n *   });\n *\n *   if (isLoading) return <div>Loading allowance...</div>;\n *   if (error) return <div>Error loading allowance</div>;\n *\n *   return (\n *     <div>\n *       Current Allowance: {allowance}\n *     </div>\n *   );\n * }\n */\nexport const useFetchAssetAllowanceX = ({\n  asset,\n  spender,\n}: {\n  asset?: Address;\n  spender?: Address;\n}) => {\n  const config = useConfig();\n  const { address: userAddress } = useAccount();\n\n  const { data, ...rest } = useQuery({\n    queryKey: HookFetchAssetAllowanceQK(asset, spender, userAddress),\n    queryFn: () => fetchAllowance(asset!, spender!, userAddress!, config),\n    enabled: Boolean(asset) && Boolean(spender) && Boolean(userAddress),\n    ...queryConfig.sensitiveDataQueryConfig,\n  });\n\n  return {\n    ...rest,\n    data,\n    queryKey: HookFetchAssetAllowanceQK(asset, spender, userAddress),\n  };\n};\n","import { useState, useEffect } from \"react\";\nimport { Address, maxUint256, erc20Abi } from \"viem\";\nimport { useFetchAssetAllowanceX } from \"./useFetchAssetAllowanceX.js\";\nimport { useContractWriteX } from \"./useContractWriteX.js\";\n\n/**\n * Custom hook for approving ERC20 token transfers.\n *\n * This hook provides functionality for approving ERC20 token transfers, checking the current allowance, and handling the approval transaction using Wagmi.\n *\n * @param {Address} tokenAddress - The address of the ERC20 token contract (the transfer from).\n * @param {Address} spenderAddress - The address of the spender to approve the transfer to.\n * @param {bigint} [amount=BigInt(0)] - The amount to approve for transfer. Defaults to undefined.\n * @param {boolean} [approveMax=false] - Indicates whether to approve the maximum amount or a specific amount.\n * @returns {Object} Object containing the following properties:\n * - {boolean} isApproved - Indicates whether the spender is already approved to transfer the specified amount of tokens.\n * - {boolean} isApproving - Indicates whether an approval transaction is currently pending.\n * - {Function} approveAsync - Function to trigger the approval transaction.\n *\n * @example\n * // In your component:\n * function ApproveTokenButton(amountToApprove) {\n *   const tokenAddress = \"0xTokenAddressExample\";\n *   const spenderAddress = \"0xSpenderAddressExample\";\n *\n *   const { isApproved, isApproving, justApproved, approveAsync } = useERC20ApproveX(\n *     tokenAddress,\n *     spenderAddress,\n *     parseUnits(amountToApprove.toString(), 18),\n *   );\n *\n *   return (\n *     <button onClick={approveAsync} disabled={isApproving || isApproved}>\n *       {isApproving ? \"Approving...\" : isApproved ? \"Approved\" : \"Approve Token\"}\n *     </button>\n *   );\n * }\n */\n\nexport const useERC20ApproveX = (\n  tokenAddress?: Address,\n  spenderAddress?: Address,\n  amount?: bigint,\n  approveMax?: boolean\n) => {\n  const [isApproved, setIsApproved] = useState(false);\n  const [justApproved, setJustApproved] = useState(false);\n\n  const { data: allowance, queryKey: allowanceKQ } = useFetchAssetAllowanceX({\n    asset: tokenAddress,\n    spender: spenderAddress,\n  });\n\n  const { writeContractAsync: approveTokenAsync, isPending } =\n    useContractWriteX({\n      queriesToInvalidate: [allowanceKQ],\n    });\n\n  useEffect(() => {\n    if (amount == null) {\n      setIsApproved(false);\n    } else if (allowance && allowance >= amount) {\n      setIsApproved(true);\n    } else {\n      setIsApproved(false);\n    }\n  }, [allowance, amount]);\n\n  const approveAsync = async () => {\n    const amountToApprove = approveMax ? maxUint256 : amount;\n\n    try {\n      if (!spenderAddress) {\n        throw new Error(\"spenderAddress is undefined!\");\n      }\n      if (!tokenAddress) {\n        throw new Error(\"tokenAddress is undefined!\");\n      }\n      if (amountToApprove == null) {\n        throw new Error(\"amountToApprove is undefined!\");\n      }\n\n      await approveTokenAsync(\n        {\n          address: tokenAddress,\n          abi: erc20Abi,\n          functionName: \"approve\",\n          args: [spenderAddress, amountToApprove],\n        },\n        {\n          onSuccess: () => {\n            setJustApproved(true);\n          },\n        }\n      );\n    } catch (e: any) {\n      console.error(\"Error approving token:\", e);\n      throw e;\n    }\n  };\n\n  return {\n    isApproved,\n    isApproving: isPending,\n    justApproved,\n    approveAsync,\n  };\n};\n","// src/config/defaults.ts\nimport { QueryClient } from \"@tanstack/react-query\";\nimport { Config } from \"wagmi\";\n\n// You can adjust the type for wagmiConfig to match your needs.\nlet defaultQueryClient: QueryClient | null = null;\nlet defaultWagmiConfig: any = null;\n\n/**\n * Sets the default configuration values.\n *\n * @param queryClient - The default QueryClient instance.\n * @param wagmiConfig - The default Wagmi configuration.\n * @example\n * //In your application initialization (e.g., index.tsx or App.tsx):\n * import { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\n * import { wagmiConfig } from \"/path/to/wagmi-config\";\n * import { setDefaults } from \"wagmi-extended\";\n *\n * const queryClient = new QueryClient();\n *\n * //Set defaults for the extended library functions.\n * setDefaults(queryClient, wagmiConfig);\n *\n * //Now helper functions like fetchTokenX can use these defaults if no explicit parameters are provided.\n */\nexport function setDefaults(\n  queryClient: QueryClient,\n  wagmiConfig: Config\n): void {\n  defaultQueryClient = queryClient;\n  defaultWagmiConfig = wagmiConfig;\n}\n\n/**\n * Retrieves the currently set default configurations.\n *\n * @throws Will throw an error if defaults are not initialized.\n * @returns An object containing the default queryClient and wagmiConfig.\n *\n * @example\n * // Usage in a helper function:\n * import { getDefaults } from \"wagmi-extended\";\n *\n * function exampleFunction() {\n *   const { queryClient, wagmiConfig } = getDefaults();\n *   // Use queryClient and wagmiConfig as needed...\n * }\n */\nexport function getDefaults(): {\n  queryClient: QueryClient;\n  wagmiConfig: Config;\n} {\n  if (!defaultQueryClient || !defaultWagmiConfig) {\n    throw new Error(\n      \"Default configuration not set. Please call setDefaults() first.\"\n    );\n  }\n  return { queryClient: defaultQueryClient, wagmiConfig: defaultWagmiConfig };\n}\n","import { QueryClient } from \"@tanstack/react-query\";\nimport { readContractQueryOptions } from \"wagmi/query\";\nimport { Address, zeroAddress, erc20Abi } from \"viem\";\nimport { Config } from \"wagmi\";\nimport { getDefaults } from \"../config/defaults.js\";\nimport { queryConfig } from \"../query-config/index.js\";\n\nexport interface Token {\n  symbol: string;\n  decimals: number;\n  name: string;\n}\n\nexport const EthTokenData: Token = {\n  symbol: \"ETH\",\n  decimals: 18,\n  name: \"Ethereum\",\n};\n\nexport async function fetchDecimalsX(\n  token: Address,\n  queryClient?: QueryClient,\n  wagmiConfig?: Config\n): Promise<number | undefined> {\n  if (!queryClient || !wagmiConfig) {\n    ({ queryClient, wagmiConfig } = getDefaults());\n  }\n  if (!queryClient || !wagmiConfig) {\n    throw new Error(\n      \"Could not find queryClient or wagmiConfig, either pass them as arguments or set them using setDefaults()\"\n    );\n  }\n\n  if (token === zeroAddress) return EthTokenData.decimals;\n\n  const decimals = await queryClient.fetchQuery({\n    ...readContractQueryOptions(wagmiConfig, {\n      address: token,\n      abi: erc20Abi,\n      functionName: \"decimals\",\n    }),\n    ...queryConfig.metadataQueryConfig,\n  });\n\n  return decimals;\n}\n\nexport async function fetchSymbolX(\n  token: Address,\n  queryClient?: QueryClient,\n  wagmiConfig?: Config\n): Promise<string> {\n  if (!queryClient || !wagmiConfig) {\n    ({ queryClient, wagmiConfig } = getDefaults());\n  }\n  if (!queryClient || !wagmiConfig) {\n    throw new Error(\n      \"Could not find queryClient or wagmiConfig, either pass them as arguments or set them using setDefaults()\"\n    );\n  }\n\n  if (token === zeroAddress) return EthTokenData.symbol;\n\n  const symbol = await queryClient.fetchQuery({\n    ...readContractQueryOptions(wagmiConfig, {\n      address: token,\n      abi: erc20Abi,\n      functionName: \"symbol\",\n    }),\n    ...queryConfig.metadataQueryConfig,\n  });\n\n  return symbol;\n}\n\nexport async function fetchNameX(\n  token: Address,\n  queryClient: any,\n  wagmiConfig: any\n): Promise<string> {\n  if (token === zeroAddress) return EthTokenData.name;\n\n  if (!queryClient || !wagmiConfig) {\n    ({ queryClient, wagmiConfig } = getDefaults());\n  }\n  if (!queryClient || !wagmiConfig) {\n    throw new Error(\n      \"Could not find queryClient or wagmiConfig, either pass them as arguments or set them using setDefaults()\"\n    );\n  }\n\n  const name = await queryClient.fetchQuery({\n    ...readContractQueryOptions(wagmiConfig, {\n      address: token,\n      abi: erc20Abi,\n      functionName: \"name\",\n    }),\n    ...queryConfig.metadataQueryConfig,\n  });\n\n  return name;\n}\n\n/**\n * Fetches the token metadata (symbol, decimals) for the given token address.\n * Internally calls:\n *  - `fetchSymbol(token)`   to retrieve the token symbol,\n *  - `fetchDecimals(token)` to retrieve the token decimals\n *  - `fetchName(token)`     to retrieve the token name\n *\n * @param token - The address of the token.\n * @returns A `Token` object containing the symbol, decimals.\n * @throws Will throw an error if symbol or decimals cannot be fetched.\n */\nexport async function fetchTokenX(\n  token: Address,\n  queryClient?: QueryClient,\n  wagmiConfig?: Config\n): Promise<Token> {\n  const [symbol, decimals, name] = await Promise.all([\n    fetchSymbolX(token, queryClient, wagmiConfig),\n    fetchDecimalsX(token, queryClient, wagmiConfig),\n    fetchNameX(token, queryClient, wagmiConfig),\n  ]);\n  if (!symbol || !decimals || !name) {\n    throw new Error(\"Failed to fetch token data\");\n  }\n\n  return {\n    symbol,\n    decimals,\n    name,\n  };\n}\n","import { useQueryClient, useQuery } from \"@tanstack/react-query\";\nimport { Address } from \"viem\";\nimport { useConfig } from \"wagmi\";\nimport { fetchTokenX } from \"../fetch-functions/fetchTokenX.js\";\n\n/**\n * Returns a query key for fetching token data.\n *\n * @param {Address | undefined} asset - The token address.\n * @returns {Array} A unique query key for the token fetch.\n *\n * @example\n * const queryKey = HookFetchTokenQK(\"0x123...\");\n */\nexport const HookFetchTokenQK = (asset?: Address): any[] => [\n  \"HookTokenWagmiExtended\",\n  asset,\n];\n\n/**\n * Custom hook for fetching token metadata using extended Wagmi functionality.\n *\n * This hook leverages React Query for data fetching and caching.\n * It retrieves token metadata (such as symbol, decimals, name, etc.) for a given token address.\n *\n * @param {Address} [asset] - The token address.\n * @returns {Object} An object with the following properties:\n *   - `data`: The token data (or undefined if not loaded).\n *   - `isLoading`: Boolean indicating if the data is loading.\n *   - `error`: Any error encountered during the fetch.\n *   - `queryKey`: The unique key used for the query.\n *\n * @example\n * // In your component:\n * function MyTokenComponent() {\n *   const { data, isLoading, error, queryKey } = useTokenX(\"0x123456...\");\n *\n *   if (isLoading) return <div>Loading token data...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *\n *   return (\n *     <div>\n *       <p>Token Symbol: {data.symbol}</p>\n *       <p>Decimals: {data.decimals}</p>\n *       <p>Name: {data.name}</p>\n *     </div>\n *   );\n * }\n */\nexport const useTokenX = (asset?: Address) => {\n  const queryClient = useQueryClient();\n  const config = useConfig();\n\n  const { data, ...rest } = useQuery({\n    queryKey: HookFetchTokenQK(asset),\n    queryFn: () => fetchTokenX(asset!, queryClient, config),\n    enabled: Boolean(asset),\n  });\n\n  return {\n    ...rest,\n    data,\n    queryKey: HookFetchTokenQK(asset),\n  };\n};\n"],"names":["ContractFunctionRevertedError","useQueryClient","useConfig","useState","waitForTransactionReceipt","useWriteContract","useSendTransaction","readContract","erc20Abi","useAccount","useQuery","useEffect","maxUint256","zeroAddress","readContractQueryOptions"],"mappings":"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"}
+{"version":3,"file":"index.cjs.js","sources":["../src/utils/errorParserX.ts","../src/hooks/useInvalidateQueries.ts","../src/hooks/useHandleTransactionMutationX.ts","../src/hooks/useContractWriteX.ts","../src/hooks/useSendTransactionX.ts","../src/query-config/index.ts","../src/fetch-functions/fetchAllowanceX.ts","../src/hooks/useFetchAssetAllowanceX.ts","../src/hooks/useERC20ApproveX.ts","../src/config/defaults.ts","../src/fetch-functions/fetchTokenX.ts","../src/hooks/useTokenX.ts"],"sourcesContent":["import { BaseError, ContractFunctionRevertedError } from \"viem\";\n\n/**\n * Default error mapping that contains a set of error identifiers mapped to user-friendly error messages.\n */\nconst defaultErrorMapping: Record<string, string> = {\n  EnforcedPause: \"Temporary pause in effect, please check Discord for updates.\",\n  ErrorNotEnoughAllowance:\n    \"Not enough allowance, did you approve your tokens first?\",\n  \"0xc2139725\": \"Not enough allowance, did you approve your tokens first?\",\n  SharesReceivedBelowMinimum:\n    \"Action exceeded safe slippage parameters, please try again later\",\n  \"0xea8d7f02\":\n    \"Action exceeded safe slippage parameters, please try again later\",\n  MaxSlippageExceeded:\n    \"Action exceeded safe slippage parameters, please try again later\",\n  \"51\": \"Supply cap exceeded\",\n};\n\n/**\n * A mutable copy of the default error mapping that can be extended or overridden by users.\n */\nlet currentErrorMapping: Record<string, string> = { ...defaultErrorMapping };\n\n/**\n * Merges a custom error mapping into the current error mapping.\n * Custom values override any existing keys.\n *\n * @param customMapping - An object containing error keys and the corresponding custom messages.\n *\n * @example\n * setErrorMapping({\n *   ErrorNotEnoughAllowance: \"Custom message: Please approve tokens first!\",\n *   NewCustomError: \"A custom error occurred.\"\n * });\n */\nexport const setErrorMapping = (\n  customMapping: Record<string, string>\n): void => {\n  currentErrorMapping = { ...currentErrorMapping, ...customMapping };\n};\n\n/**\n * Resets the current error mapping to the default error mapping.\n *\n * @example\n * resetErrorMapping();\n */\nexport const resetErrorMapping = (): void => {\n  currentErrorMapping = {};\n};\n\n/**\n * Retrieves the current error mapping.\n *\n * @returns The current error mapping object.\n *\n * @example\n * const mapping = getErrorMapping();\n * console.log(mapping);\n */\nexport const getErrorMapping = (): Record<string, string> =>\n  currentErrorMapping;\n\n/**\n * Parses an error object and returns a user-friendly error message.\n *\n * The function checks if the error is a ContractFunctionRevertedError by attempting to walk through\n * the error using its `walk` method. If a matching error is found and its error key exists in the\n * current error mapping, the corresponding custom message will be returned. Otherwise, it falls back\n * to the error's own message properties.\n *\n * @param error - The error object, potentially including additional error details.\n * @returns A user-friendly error message.\n *\n * @example\n * const message = getParsedError(someError);\n * console.log(message); // Outputs a custom error message or a default error message.\n */\nexport const getParsedErrorX = (error: any | BaseError): string => {\n  const defaultMessage = \"An unknown error occurred. Please contact support.\";\n  let message = defaultMessage;\n  let errorKey = \"\";\n\n  const revertedError = error?.walk\n    ? error.walk((err: unknown) => err instanceof ContractFunctionRevertedError)\n    : null;\n  if (revertedError instanceof ContractFunctionRevertedError) {\n    errorKey =\n      revertedError.data?.errorName ??\n      revertedError.signature ??\n      revertedError.reason ??\n      \"\";\n    if (currentErrorMapping[errorKey]) return currentErrorMapping[errorKey];\n  }\n\n  message = error.shortMessage || error.details || error.message || message;\n  return message;\n};\n","import { QueryKey, useQueryClient } from \"@tanstack/react-query\";\n\n/**\n * Hook to invalidate multiple queries in the React Query cache.\n *\n * @returns An object with the invalidateMany function.\n */\nexport function useInvalidateQueries() {\n  const queryClient = useQueryClient();\n\n  const invalidateMany = async (queries: (QueryKey | undefined)[]) => {\n    const promises = queries.map((queryKey) =>\n      queryClient.invalidateQueries({ queryKey })\n    );\n    await Promise.all(promises);\n  };\n\n  return { invalidateMany };\n}\n","import { waitForTransactionReceipt } from \"wagmi/actions\";\nimport { useConfig } from \"wagmi\";\nimport { QueryKey } from \"@tanstack/query-core\";\nimport { Address } from \"viem\";\nimport { useState } from \"react\";\nimport { getParsedErrorX } from \"../utils/errorParserX.js\";\nimport { useInvalidateQueries } from \"./useInvalidateQueries.js\";\n\nexport type WriteExtendedAsyncParams = {\n  onSuccess?: (txHash: Address) => void;\n  onError?: (e: any) => void;\n  onSettled?: () => void;\n  queriesToInvalidate?: (QueryKey | undefined)[];\n  disableLogging?: boolean;\n  disableWaitingForReceipt?: boolean;\n};\n\n/**\n * Custom hook to handle transaction mutations.\n *\n * @returns {Function} A shared `onSettled` callback for transaction mutations.\n */\nexport function useHandleTransactionMutationX({\n  settings,\n}: {\n  settings?: WriteExtendedAsyncParams;\n}) {\n  const wagmiConfig = useConfig();\n\n  const { invalidateMany } = useInvalidateQueries();\n  const [isPending, setIsPending] = useState(false);\n  const [errorMessage, setErrorMessage] = useState<string | undefined>(\n    undefined\n  );\n\n  const onMutate = () => {\n    setIsPending(true);\n    setErrorMessage(undefined);\n  };\n\n  const onSettled = async (\n    txHash: Address | undefined,\n    error: any,\n    args: any\n  ) => {\n    try {\n      if (error) throw error;\n\n      if (!settings?.disableWaitingForReceipt) {\n        // 1. wait for transaction receipt\n        const txReceipt = await waitForTransactionReceipt(wagmiConfig, {\n          hash: txHash!,\n        });\n\n        // 2. throw if receipt is not valid\n        if (txReceipt.status === \"reverted\")\n          throw new Error(\"Execution reverted.\");\n        if (txReceipt.status !== \"success\")\n          throw new Error(\"Execution reverted.\");\n      }\n\n      // 3. invalidate queries\n      if (settings?.queriesToInvalidate)\n        await invalidateMany(settings?.queriesToInvalidate);\n\n      // 4. call onSuccess callback\n      settings?.onSuccess?.(txHash!);\n\n      if (!settings?.disableLogging) {\n        // 5. log result\n        // eslint-disable-next-line no-console\n        console.info(\"Operation successful:\", txHash); // todo: add logging service\n      }\n      // 6. return result\n      return txHash;\n    } catch (error) {\n      const parsedError = getParsedErrorX(error);\n\n      if (!settings?.disableLogging) {\n        // 1. log error\n        console.error(\n          `ContractWriteExtended Operation failed with error(parsed): ${parsedError}`,\n          { error },\n          { args }\n        );\n        console.error({ error });\n      }\n      // 2. set error message\n      setErrorMessage(parsedError);\n\n      // 3. call callback\n      settings?.onError?.(error);\n    } finally {\n      setIsPending(false);\n      // 1. call callback\n      settings?.onSettled?.();\n    }\n    return undefined;\n  };\n\n  return {\n    onMutate,\n    onSettled,\n    isPending,\n    errorMessage,\n  };\n}\n","import { useWriteContract } from \"wagmi\";\nimport {\n  WriteExtendedAsyncParams,\n  useHandleTransactionMutationX,\n} from \"./useHandleTransactionMutationX.js\";\n\n/**\n * Custom hook for writing to a smart contract using Wagmi.\n *\n * This hook provides functionality for writing a contract using Wagmi, handling the asynchronous nature of the operation, waiting for the transaction receipt, and error handling.\n *\n * @param {WriteExtendedAsyncParams} [settings] - Optional settings for the write operation.\n * @param {boolean} [settings.disableWaitingForReceipt] - Disables waiting for the transaction receipt.\n * @param {boolean} [settings.disableLogging] - Disables logging the result of the transaction.\n * @param {Function} [settings.onSuccess] - Callback function to be called on successful transaction.\n * @param {Function} [settings.onError] - Callback function to be called on transaction error.\n * @param {Function} [settings.onSettled] - Callback function to be called after the transaction settles (whether success or failure).\n * @param {QueryKey[]} [settings.queriesToInvalidate] - Array of query keys to invalidate after the transaction receives a receipt.\n * @returns {Object} Object containing the following properties:\n * - {boolean} isPending - Indicates whether the transaction is pending.\n * - {string|undefined} errorMessage - The error message, if an error occurred during the transaction.\n * - {Function} writeContractAsync - Function to trigger the write operation.\n * \n/**\n * Custom hook for writing a contract using Wagmi with extended functionality.\n *\n * This hook wraps Wagmi’s `useContractWriteX` with additional handling for\n * waiting for a transaction receipt, logging control, and invalidation of specified queries.\n *\n * @param {WriteExtendedAsyncParams} [settings] - Optional settings for handling the transaction.\n * @returns {Object} An object containing:\n *   - `isPending`: {boolean} indicating if the transaction is in progress.\n *   - `errorMessage`: {string|undefined} a potential error message.\n *   - `writeContractAsync`: {Function} a function to trigger the transaction.\n *\n * @example\n * // In your component:\n * function MyTransactionComponent() {\n *   const { writeContractAsync, isPending, errorMessage } = useContractWriteX({\n *     queriesToInvalidate: [[\"userBalance\"], [\"userActivity\"]],\n *   });\n *\n *   const handleWrite = async () => {\n *     try {\n *       const txHash = await writeContractAsync({ transaction params here.. }, {\n *          // use calbacks here in writeContractAsync or in useContractWriteX\n *          onSuccess: (txHash) => console.log(\"Transaction successful:\", txHash),\n *          onError: (error) => console.error(\"Transaction error:\", error),\n *       });\n *       console.log(\"Received txHash:\", txHash);\n *     } catch (err) {\n *       console.error(\"Failed writing transaction:\", err);`\n *     }\n *   };\n *\n *   return (\n *     <div>\n *       <button onClick={handleWrite} disabled={isPending}>\n *         {isPending ? \"Processing...\" : \"Write Transaction\"}\n *       </button>\n *       {errorMessage && <p>Error: {errorMessage}</p>}\n *     </div>\n *   );\n * }\n */\n\nexport function useContractWriteX(settings?: WriteExtendedAsyncParams) {\n  const { isPending, errorMessage, onMutate, onSettled } =\n    useHandleTransactionMutationX({\n      settings,\n    });\n\n  const { writeContractAsync, ...rest } = useWriteContract({\n    mutation: {\n      onMutate,\n      onSettled,\n    },\n  });\n\n  return {\n    ...rest,\n    isPending,\n    errorMessage,\n    writeContractAsync,\n  };\n}\n","import { useSendTransaction } from \"wagmi\";\nimport {\n  useHandleTransactionMutationX,\n  WriteExtendedAsyncParams,\n} from \"./useHandleTransactionMutationX.js\";\n\n/**\n * Custom hook for sending a transaction using Wagmi.\n *\n * This hook provides functionality for sending a transaction using Wagmi, handling the asynchronous nature of the operation, waiting for the transaction receipt, and error handling.\n *\n * @param {WriteExtendedAsyncParams} [settings] - Optional settings for the write operation.\n * @param {boolean} [settings.disableWaitingForReceipt] - Disables waiting for the transaction receipt.\n * @param {boolean} [settings.disableLogging] - Disables logging the result of the transaction.\n * @param {Function} [settings.onSuccess] - Callback function to be called on successful transaction.\n * @param {Function} [settings.onError] - Callback function to be called on transaction error.\n * @param {Function} [settings.onSettled] - Callback function to be called after the transaction settles (whether success or failure).\n * @param {QueryKey[]} [settings.queriesToInvalidate] - Array of query keys to invalidate after the transaction receives a receipt.\n * @returns {Object} Object containing the following properties:\n * - {boolean} isPending - Indicates whether the transaction is pending.\n * - {string|undefined} errorMessage - The error message, if an error occurred during the transaction.\n * - {Function} sendTransactionAsync - Function to trigger the send transaction mutation.\n\n * @example\n * // In your component:\n * function MyTransactionComponent() {\n *   const { sendTransactionAsync, isPending, errorMessage } = useSendTransactionX({\n *     // use calbacks here in useContractWriteX or in writeContractAsync\n *     onSuccess: (txHash) => console.log(\"Transaction successful:\", txHash),\n *     onError: (error) => console.error(\"Transaction error:\", error),\n *     queriesToInvalidate: [[\"userBalance\"], [\"userActivity\"]],\n *   });\n *\n *   const handleSend = async () => {\n *     try {\n *       const txHash = await sendTransactionAsync({ transaction params here.. });\n *       console.log(\"Received txHash:\", txHash);\n *     } catch (err) {\n *       console.error(\"Failed sending transaction:\", err);`\n *     }\n *   };\n *\n *   return (\n *     <div>\n *       <button onClick={handleSend} disabled={isPending}>\n *         {isPending ? \"Processing...\" : \"Send Transaction\"}\n *       </button>\n *       {errorMessage && <p>Error: {errorMessage}</p>}\n *     </div>\n *   );\n * }\n */\n\nexport function useSendTransactionX(settings?: WriteExtendedAsyncParams) {\n  const { isPending, errorMessage, onMutate, onSettled } =\n    useHandleTransactionMutationX({\n      settings,\n    });\n\n  const { sendTransactionAsync, ...rest } = useSendTransaction({\n    mutation: {\n      onMutate,\n      onSettled,\n    },\n  });\n\n  return {\n    ...rest,\n    isPending,\n    errorMessage,\n    sendTransactionAsync,\n  };\n}\n","export const queryConfig = {\n  metadataQueryConfig: {\n    staleTime: Infinity,\n  },\n  sensitiveDataQueryConfig: {\n    staleTime: 60_000,\n  },\n};\n","import { Address, erc20Abi } from \"viem\";\nimport { readContract } from \"viem/actions\";\n\nexport const fetchAllowance = async (\n  asset: Address,\n  spender: Address,\n  userAddress: Address,\n  config: any\n) => {\n  const allowance = await readContract(config, {\n    address: asset,\n    abi: erc20Abi,\n    functionName: \"allowance\",\n    args: [userAddress, spender],\n  });\n\n  if (allowance == null) {\n    throw new Error(\"Failed to fetch token data or allowance\");\n  }\n\n  return allowance;\n};\n","import { useQuery, useQueryClient } from \"@tanstack/react-query\";\nimport { Address, erc20Abi } from \"viem\";\nimport { useAccount, useConfig } from \"wagmi\";\nimport { queryConfig } from \"../query-config/index.js\";\nimport { fetchAllowance } from \"../fetch-functions/fetchAllowanceX.js\";\n\nconst HookFetchAssetAllowanceQK = (\n  asset?: Address,\n  spender?: Address,\n  userAddress?: Address\n) => [\"HookFetchAllowance\", asset, spender, userAddress] as const;\n\n/**\n * Custom hook for fetching asset allowance.\n *\n * @param {Address} asset - The address of the ERC20 token contract.\n * @param {Address} spender - The address of the spender to check allowance for.\n *\n *\n * @example\n * // In your component:\n * function AllowanceDisplay() {\n *   const { data: allowance, isLoading, error } = useFetchAssetAllowanceX({\n *     asset: \"0xTokenAddressExample\",\n *     spender: \"0xSpenderAddressExample\",\n *   });\n *\n *   if (isLoading) return <div>Loading allowance...</div>;\n *   if (error) return <div>Error loading allowance</div>;\n *\n *   return (\n *     <div>\n *       Current Allowance: {allowance}\n *     </div>\n *   );\n * }\n */\nexport const useFetchAssetAllowanceX = ({\n  asset,\n  spender,\n}: {\n  asset?: Address;\n  spender?: Address;\n}) => {\n  const config = useConfig();\n  const { address: userAddress } = useAccount();\n\n  const { data, ...rest } = useQuery({\n    queryKey: HookFetchAssetAllowanceQK(asset, spender, userAddress),\n    queryFn: () => fetchAllowance(asset!, spender!, userAddress!, config),\n    enabled: Boolean(asset) && Boolean(spender) && Boolean(userAddress),\n    ...queryConfig.sensitiveDataQueryConfig,\n  });\n\n  return {\n    ...rest,\n    data,\n    queryKey: HookFetchAssetAllowanceQK(asset, spender, userAddress),\n  };\n};\n","import { useState, useEffect } from \"react\";\nimport { Address, maxUint256, erc20Abi } from \"viem\";\nimport { useFetchAssetAllowanceX } from \"./useFetchAssetAllowanceX.js\";\nimport { useContractWriteX } from \"./useContractWriteX.js\";\n\n/**\n * Custom hook for approving ERC20 token transfers.\n *\n * This hook provides functionality for approving ERC20 token transfers, checking the current allowance, and handling the approval transaction using Wagmi.\n *\n * @param {Address} tokenAddress - The address of the ERC20 token contract (the transfer from).\n * @param {Address} spenderAddress - The address of the spender to approve the transfer to.\n * @param {bigint} [amount=BigInt(0)] - The amount to approve for transfer. Defaults to undefined.\n * @param {boolean} [approveMax=false] - Indicates whether to approve the maximum amount or a specific amount.\n * @returns {Object} Object containing the following properties:\n * - {boolean} isApproved - Indicates whether the spender is already approved to transfer the specified amount of tokens.\n * - {boolean} isApproving - Indicates whether an approval transaction is currently pending.\n * - {Function} approveAsync - Function to trigger the approval transaction.\n *\n * @example\n * // In your component:\n * function ApproveTokenButton(amountToApprove) {\n *   const tokenAddress = \"0xTokenAddressExample\";\n *   const spenderAddress = \"0xSpenderAddressExample\";\n *\n *   const { isApproved, isApproving, justApproved, approveAsync } = useERC20ApproveX(\n *     tokenAddress,\n *     spenderAddress,\n *     parseUnits(amountToApprove.toString(), 18),\n *   );\n *\n *   return (\n *     <button onClick={approveAsync} disabled={isApproving || isApproved}>\n *       {isApproving ? \"Approving...\" : isApproved ? \"Approved\" : \"Approve Token\"}\n *     </button>\n *   );\n * }\n */\n\nexport const useERC20ApproveX = (\n  tokenAddress?: Address,\n  spenderAddress?: Address,\n  amount?: bigint,\n  approveMax?: boolean\n) => {\n  const [isApproved, setIsApproved] = useState(false);\n  const [justApproved, setJustApproved] = useState(false);\n\n  const { data: allowance, queryKey: allowanceKQ } = useFetchAssetAllowanceX({\n    asset: tokenAddress,\n    spender: spenderAddress,\n  });\n\n  const { writeContractAsync: approveTokenAsync, isPending } =\n    useContractWriteX({\n      queriesToInvalidate: [allowanceKQ],\n    });\n\n  useEffect(() => {\n    if (amount == null) {\n      setIsApproved(false);\n    } else if (allowance && allowance >= amount) {\n      setIsApproved(true);\n    } else {\n      setIsApproved(false);\n    }\n  }, [allowance, amount]);\n\n  const approveAsync = async () => {\n    const amountToApprove = approveMax ? maxUint256 : amount;\n\n    try {\n      if (!spenderAddress) {\n        throw new Error(\"spenderAddress is undefined!\");\n      }\n      if (!tokenAddress) {\n        throw new Error(\"tokenAddress is undefined!\");\n      }\n      if (amountToApprove == null) {\n        throw new Error(\"amountToApprove is undefined!\");\n      }\n\n      await approveTokenAsync(\n        {\n          address: tokenAddress,\n          abi: erc20Abi,\n          functionName: \"approve\",\n          args: [spenderAddress, amountToApprove],\n        },\n        {\n          onSuccess: () => {\n            setJustApproved(true);\n          },\n        }\n      );\n    } catch (e: any) {\n      console.error(\"Error approving token:\", e);\n      throw e;\n    }\n  };\n\n  return {\n    isApproved,\n    isApproving: isPending,\n    justApproved,\n    approveAsync,\n  };\n};\n","// src/config/defaults.ts\nimport { QueryClient } from \"@tanstack/react-query\";\nimport { Config } from \"wagmi\";\n\n// You can adjust the type for wagmiConfig to match your needs.\nlet defaultQueryClient: QueryClient | null = null;\nlet defaultWagmiConfig: any = null;\n\n/**\n * Sets the default configuration values.\n *\n * @param queryClient - The default QueryClient instance.\n * @param wagmiConfig - The default Wagmi configuration.\n * @example\n * //In your application initialization (e.g., index.tsx or App.tsx):\n * import { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\n * import { wagmiConfig } from \"/path/to/wagmi-config\";\n * import { setDefaults } from \"wagmi-extended\";\n *\n * const queryClient = new QueryClient();\n *\n * //Set defaults for the extended library functions.\n * setDefaults(queryClient, wagmiConfig);\n *\n * //Now helper functions like fetchTokenX can use these defaults if no explicit parameters are provided.\n */\nexport function setDefaults(\n  queryClient: QueryClient,\n  wagmiConfig: Config\n): void {\n  defaultQueryClient = queryClient;\n  defaultWagmiConfig = wagmiConfig;\n}\n\n/**\n * Retrieves the currently set default configurations.\n *\n * @throws Will throw an error if defaults are not initialized.\n * @returns An object containing the default queryClient and wagmiConfig.\n *\n * @example\n * // Usage in a helper function:\n * import { getDefaults } from \"wagmi-extended\";\n *\n * function exampleFunction() {\n *   const { queryClient, wagmiConfig } = getDefaults();\n *   // Use queryClient and wagmiConfig as needed...\n * }\n */\nexport function getDefaults(): {\n  queryClient: QueryClient;\n  wagmiConfig: Config;\n} {\n  if (!defaultQueryClient || !defaultWagmiConfig) {\n    throw new Error(\n      \"Default configuration not set. Please call setDefaults() first.\"\n    );\n  }\n  return { queryClient: defaultQueryClient, wagmiConfig: defaultWagmiConfig };\n}\n","import { QueryClient } from \"@tanstack/react-query\";\nimport { readContractQueryOptions } from \"wagmi/query\";\nimport { Address, zeroAddress, erc20Abi } from \"viem\";\nimport { Config } from \"wagmi\";\nimport { getDefaults } from \"../config/defaults.js\";\nimport { queryConfig } from \"../query-config/index.js\";\n\nexport interface Token {\n  symbol: string;\n  decimals: number;\n  name: string;\n}\n\nexport const EthTokenData: Token = {\n  symbol: \"ETH\",\n  decimals: 18,\n  name: \"Ethereum\",\n};\n\nexport async function fetchDecimalsX(\n  token: Address,\n  queryClient?: QueryClient,\n  wagmiConfig?: Config\n): Promise<number | undefined> {\n  if (!queryClient || !wagmiConfig) {\n    ({ queryClient, wagmiConfig } = getDefaults());\n  }\n  if (!queryClient || !wagmiConfig) {\n    throw new Error(\n      \"Could not find queryClient or wagmiConfig, either pass them as arguments or set them using setDefaults()\"\n    );\n  }\n\n  if (token === zeroAddress) return EthTokenData.decimals;\n\n  const decimals = await queryClient.fetchQuery({\n    ...readContractQueryOptions(wagmiConfig, {\n      address: token,\n      abi: erc20Abi,\n      functionName: \"decimals\",\n    }),\n    ...queryConfig.metadataQueryConfig,\n  });\n\n  return decimals;\n}\n\nexport async function fetchSymbolX(\n  token: Address,\n  queryClient?: QueryClient,\n  wagmiConfig?: Config\n): Promise<string> {\n  if (!queryClient || !wagmiConfig) {\n    ({ queryClient, wagmiConfig } = getDefaults());\n  }\n  if (!queryClient || !wagmiConfig) {\n    throw new Error(\n      \"Could not find queryClient or wagmiConfig, either pass them as arguments or set them using setDefaults()\"\n    );\n  }\n\n  if (token === zeroAddress) return EthTokenData.symbol;\n\n  const symbol = await queryClient.fetchQuery({\n    ...readContractQueryOptions(wagmiConfig, {\n      address: token,\n      abi: erc20Abi,\n      functionName: \"symbol\",\n    }),\n    ...queryConfig.metadataQueryConfig,\n  });\n\n  return symbol;\n}\n\nexport async function fetchNameX(\n  token: Address,\n  queryClient: any,\n  wagmiConfig: any\n): Promise<string> {\n  if (token === zeroAddress) return EthTokenData.name;\n\n  if (!queryClient || !wagmiConfig) {\n    ({ queryClient, wagmiConfig } = getDefaults());\n  }\n  if (!queryClient || !wagmiConfig) {\n    throw new Error(\n      \"Could not find queryClient or wagmiConfig, either pass them as arguments or set them using setDefaults()\"\n    );\n  }\n\n  const name = await queryClient.fetchQuery({\n    ...readContractQueryOptions(wagmiConfig, {\n      address: token,\n      abi: erc20Abi,\n      functionName: \"name\",\n    }),\n    ...queryConfig.metadataQueryConfig,\n  });\n\n  return name;\n}\n\n/**\n * Fetches the token metadata (symbol, decimals) for the given token address.\n * Internally calls:\n *  - `fetchSymbol(token)`   to retrieve the token symbol,\n *  - `fetchDecimals(token)` to retrieve the token decimals\n *  - `fetchName(token)`     to retrieve the token name\n *\n * @param token - The address of the token.\n * @returns A `Token` object containing the symbol, decimals.\n * @throws Will throw an error if symbol or decimals cannot be fetched.\n */\nexport async function fetchTokenX(\n  token: Address,\n  queryClient?: QueryClient,\n  wagmiConfig?: Config\n): Promise<Token> {\n  const [symbol, decimals, name] = await Promise.all([\n    fetchSymbolX(token, queryClient, wagmiConfig),\n    fetchDecimalsX(token, queryClient, wagmiConfig),\n    fetchNameX(token, queryClient, wagmiConfig),\n  ]);\n  if (!symbol || !decimals || !name) {\n    throw new Error(\"Failed to fetch token data\");\n  }\n\n  return {\n    symbol,\n    decimals,\n    name,\n  };\n}\n","import { useQueryClient, useQuery } from \"@tanstack/react-query\";\nimport { Address } from \"viem\";\nimport { useConfig } from \"wagmi\";\nimport { fetchTokenX } from \"../fetch-functions/fetchTokenX.js\";\n\n/**\n * Returns a query key for fetching token data.\n *\n * @param {Address | undefined} asset - The token address.\n * @returns {Array} A unique query key for the token fetch.\n *\n * @example\n * const queryKey = HookFetchTokenQK(\"0x123...\");\n */\nexport const HookFetchTokenQK = (asset?: Address): any[] => [\n  \"HookTokenWagmiExtended\",\n  asset,\n];\n\n/**\n * Custom hook for fetching token metadata using extended Wagmi functionality.\n *\n * This hook leverages React Query for data fetching and caching.\n * It retrieves token metadata (such as symbol, decimals, name, etc.) for a given token address.\n *\n * @param {Address} [asset] - The token address.\n * @returns {Object} An object with the following properties:\n *   - `data`: The token data (or undefined if not loaded).\n *   - `isLoading`: Boolean indicating if the data is loading.\n *   - `error`: Any error encountered during the fetch.\n *   - `queryKey`: The unique key used for the query.\n *\n * @example\n * // In your component:\n * function MyTokenComponent() {\n *   const { data, isLoading, error, queryKey } = useTokenX(\"0x123456...\");\n *\n *   if (isLoading) return <div>Loading token data...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *\n *   return (\n *     <div>\n *       <p>Token Symbol: {data.symbol}</p>\n *       <p>Decimals: {data.decimals}</p>\n *       <p>Name: {data.name}</p>\n *     </div>\n *   );\n * }\n */\nexport const useTokenX = (asset?: Address) => {\n  const queryClient = useQueryClient();\n  const config = useConfig();\n\n  const { data, ...rest } = useQuery({\n    queryKey: HookFetchTokenQK(asset),\n    queryFn: () => fetchTokenX(asset!, queryClient, config),\n    enabled: Boolean(asset),\n  });\n\n  return {\n    ...rest,\n    data,\n    queryKey: HookFetchTokenQK(asset),\n  };\n};\n"],"names":["ContractFunctionRevertedError","useQueryClient","useConfig","useState","waitForTransactionReceipt","useWriteContract","useSendTransaction","readContract","erc20Abi","useAccount","useQuery","useEffect","maxUint256","zeroAddress","readContractQueryOptions"],"mappings":"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"}

package/dist/index.esm.js

@@ -44,7 +44,7 @@ const setErrorMapping = (customMapping) => {
  * resetErrorMapping();
  */
 const resetErrorMapping = () => {
-    currentErrorMapping = { ...defaultErrorMapping };
+    currentErrorMapping = {};
 };
 /**
  * Retrieves the current error mapping.

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","sources":["../src/utils/errorParserX.ts","../src/hooks/useInvalidateQueries.ts","../src/hooks/useHandleTransactionMutationX.ts","../src/hooks/useContractWriteX.ts","../src/hooks/useSendTransactionX.ts","../src/query-config/index.ts","../src/fetch-functions/fetchAllowanceX.ts","../src/hooks/useFetchAssetAllowanceX.ts","../src/hooks/useERC20ApproveX.ts","../src/config/defaults.ts","../src/fetch-functions/fetchTokenX.ts","../src/hooks/useTokenX.ts"],"sourcesContent":["import { BaseError, ContractFunctionRevertedError } from \"viem\";\n\n/**\n * Default error mapping that contains a set of error identifiers mapped to user-friendly error messages.\n */\nconst defaultErrorMapping: Record<string, string> = {\n  EnforcedPause: \"Temporary pause in effect, please check Discord for updates.\",\n  ErrorNotEnoughAllowance:\n    \"Not enough allowance, did you approve your tokens first?\",\n  \"0xc2139725\": \"Not enough allowance, did you approve your tokens first?\",\n  SharesReceivedBelowMinimum:\n    \"Action exceeded safe slippage parameters, please try again later\",\n  \"0xea8d7f02\":\n    \"Action exceeded safe slippage parameters, please try again later\",\n  MaxSlippageExceeded:\n    \"Action exceeded safe slippage parameters, please try again later\",\n  \"51\": \"Supply cap exceeded\",\n};\n\n/**\n * A mutable copy of the default error mapping that can be extended or overridden by users.\n */\nlet currentErrorMapping: Record<string, string> = { ...defaultErrorMapping };\n\n/**\n * Merges a custom error mapping into the current error mapping.\n * Custom values override any existing keys.\n *\n * @param customMapping - An object containing error keys and the corresponding custom messages.\n *\n * @example\n * setErrorMapping({\n *   ErrorNotEnoughAllowance: \"Custom message: Please approve tokens first!\",\n *   NewCustomError: \"A custom error occurred.\"\n * });\n */\nexport const setErrorMapping = (\n  customMapping: Record<string, string>\n): void => {\n  currentErrorMapping = { ...currentErrorMapping, ...customMapping };\n};\n\n/**\n * Resets the current error mapping to the default error mapping.\n *\n * @example\n * resetErrorMapping();\n */\nexport const resetErrorMapping = (): void => {\n  currentErrorMapping = { ...defaultErrorMapping };\n};\n\n/**\n * Retrieves the current error mapping.\n *\n * @returns The current error mapping object.\n *\n * @example\n * const mapping = getErrorMapping();\n * console.log(mapping);\n */\nexport const getErrorMapping = (): Record<string, string> =>\n  currentErrorMapping;\n\n/**\n * Parses an error object and returns a user-friendly error message.\n *\n * The function checks if the error is a ContractFunctionRevertedError by attempting to walk through\n * the error using its `walk` method. If a matching error is found and its error key exists in the\n * current error mapping, the corresponding custom message will be returned. Otherwise, it falls back\n * to the error's own message properties.\n *\n * @param error - The error object, potentially including additional error details.\n * @returns A user-friendly error message.\n *\n * @example\n * const message = getParsedError(someError);\n * console.log(message); // Outputs a custom error message or a default error message.\n */\nexport const getParsedErrorX = (error: any | BaseError): string => {\n  const defaultMessage = \"An unknown error occurred. Please contact support.\";\n  let message = defaultMessage;\n  let errorKey = \"\";\n\n  const revertedError = error?.walk\n    ? error.walk((err: unknown) => err instanceof ContractFunctionRevertedError)\n    : null;\n  if (revertedError instanceof ContractFunctionRevertedError) {\n    errorKey =\n      revertedError.data?.errorName ??\n      revertedError.signature ??\n      revertedError.reason ??\n      \"\";\n    if (currentErrorMapping[errorKey]) return currentErrorMapping[errorKey];\n  }\n\n  message = error.shortMessage || error.details || error.message || message;\n  return message;\n};\n","import { QueryKey, useQueryClient } from \"@tanstack/react-query\";\n\n/**\n * Hook to invalidate multiple queries in the React Query cache.\n *\n * @returns An object with the invalidateMany function.\n */\nexport function useInvalidateQueries() {\n  const queryClient = useQueryClient();\n\n  const invalidateMany = async (queries: (QueryKey | undefined)[]) => {\n    const promises = queries.map((queryKey) =>\n      queryClient.invalidateQueries({ queryKey })\n    );\n    await Promise.all(promises);\n  };\n\n  return { invalidateMany };\n}\n","import { waitForTransactionReceipt } from \"wagmi/actions\";\nimport { useConfig } from \"wagmi\";\nimport { QueryKey } from \"@tanstack/query-core\";\nimport { Address } from \"viem\";\nimport { useState } from \"react\";\nimport { getParsedErrorX } from \"../utils/errorParserX.js\";\nimport { useInvalidateQueries } from \"./useInvalidateQueries.js\";\n\nexport type WriteExtendedAsyncParams = {\n  onSuccess?: (txHash: Address) => void;\n  onError?: (e: any) => void;\n  onSettled?: () => void;\n  queriesToInvalidate?: (QueryKey | undefined)[];\n  disableLogging?: boolean;\n  disableWaitingForReceipt?: boolean;\n};\n\n/**\n * Custom hook to handle transaction mutations.\n *\n * @returns {Function} A shared `onSettled` callback for transaction mutations.\n */\nexport function useHandleTransactionMutationX({\n  settings,\n}: {\n  settings?: WriteExtendedAsyncParams;\n}) {\n  const wagmiConfig = useConfig();\n\n  const { invalidateMany } = useInvalidateQueries();\n  const [isPending, setIsPending] = useState(false);\n  const [errorMessage, setErrorMessage] = useState<string | undefined>(\n    undefined\n  );\n\n  const onMutate = () => {\n    setIsPending(true);\n    setErrorMessage(undefined);\n  };\n\n  const onSettled = async (\n    txHash: Address | undefined,\n    error: any,\n    args: any\n  ) => {\n    try {\n      if (error) throw error;\n\n      if (!settings?.disableWaitingForReceipt) {\n        // 1. wait for transaction receipt\n        const txReceipt = await waitForTransactionReceipt(wagmiConfig, {\n          hash: txHash!,\n        });\n\n        // 2. throw if receipt is not valid\n        if (txReceipt.status === \"reverted\")\n          throw new Error(\"Execution reverted.\");\n        if (txReceipt.status !== \"success\")\n          throw new Error(\"Execution reverted.\");\n      }\n\n      // 3. invalidate queries\n      if (settings?.queriesToInvalidate)\n        await invalidateMany(settings?.queriesToInvalidate);\n\n      // 4. call onSuccess callback\n      settings?.onSuccess?.(txHash!);\n\n      if (!settings?.disableLogging) {\n        // 5. log result\n        // eslint-disable-next-line no-console\n        console.info(\"Operation successful:\", txHash); // todo: add logging service\n      }\n      // 6. return result\n      return txHash;\n    } catch (error) {\n      const parsedError = getParsedErrorX(error);\n\n      if (!settings?.disableLogging) {\n        // 1. log error\n        console.error(\n          `ContractWriteExtended Operation failed with error(parsed): ${parsedError}`,\n          { error },\n          { args }\n        );\n        console.error({ error });\n      }\n      // 2. set error message\n      setErrorMessage(parsedError);\n\n      // 3. call callback\n      settings?.onError?.(error);\n    } finally {\n      setIsPending(false);\n      // 1. call callback\n      settings?.onSettled?.();\n    }\n    return undefined;\n  };\n\n  return {\n    onMutate,\n    onSettled,\n    isPending,\n    errorMessage,\n  };\n}\n","import { useWriteContract } from \"wagmi\";\nimport {\n  WriteExtendedAsyncParams,\n  useHandleTransactionMutationX,\n} from \"./useHandleTransactionMutationX.js\";\n\n/**\n * Custom hook for writing to a smart contract using Wagmi.\n *\n * This hook provides functionality for writing a contract using Wagmi, handling the asynchronous nature of the operation, waiting for the transaction receipt, and error handling.\n *\n * @param {WriteExtendedAsyncParams} [settings] - Optional settings for the write operation.\n * @param {boolean} [settings.disableWaitingForReceipt] - Disables waiting for the transaction receipt.\n * @param {boolean} [settings.disableLogging] - Disables logging the result of the transaction.\n * @param {Function} [settings.onSuccess] - Callback function to be called on successful transaction.\n * @param {Function} [settings.onError] - Callback function to be called on transaction error.\n * @param {Function} [settings.onSettled] - Callback function to be called after the transaction settles (whether success or failure).\n * @param {QueryKey[]} [settings.queriesToInvalidate] - Array of query keys to invalidate after the transaction receives a receipt.\n * @returns {Object} Object containing the following properties:\n * - {boolean} isPending - Indicates whether the transaction is pending.\n * - {string|undefined} errorMessage - The error message, if an error occurred during the transaction.\n * - {Function} writeContractAsync - Function to trigger the write operation.\n * \n/**\n * Custom hook for writing a contract using Wagmi with extended functionality.\n *\n * This hook wraps Wagmi’s `useContractWriteX` with additional handling for\n * waiting for a transaction receipt, logging control, and invalidation of specified queries.\n *\n * @param {WriteExtendedAsyncParams} [settings] - Optional settings for handling the transaction.\n * @returns {Object} An object containing:\n *   - `isPending`: {boolean} indicating if the transaction is in progress.\n *   - `errorMessage`: {string|undefined} a potential error message.\n *   - `writeContractAsync`: {Function} a function to trigger the transaction.\n *\n * @example\n * // In your component:\n * function MyTransactionComponent() {\n *   const { writeContractAsync, isPending, errorMessage } = useContractWriteX({\n *     queriesToInvalidate: [[\"userBalance\"], [\"userActivity\"]],\n *   });\n *\n *   const handleWrite = async () => {\n *     try {\n *       const txHash = await writeContractAsync({ transaction params here.. }, {\n *          // use calbacks here in writeContractAsync or in useContractWriteX\n *          onSuccess: (txHash) => console.log(\"Transaction successful:\", txHash),\n *          onError: (error) => console.error(\"Transaction error:\", error),\n *       });\n *       console.log(\"Received txHash:\", txHash);\n *     } catch (err) {\n *       console.error(\"Failed writing transaction:\", err);`\n *     }\n *   };\n *\n *   return (\n *     <div>\n *       <button onClick={handleWrite} disabled={isPending}>\n *         {isPending ? \"Processing...\" : \"Write Transaction\"}\n *       </button>\n *       {errorMessage && <p>Error: {errorMessage}</p>}\n *     </div>\n *   );\n * }\n */\n\nexport function useContractWriteX(settings?: WriteExtendedAsyncParams) {\n  const { isPending, errorMessage, onMutate, onSettled } =\n    useHandleTransactionMutationX({\n      settings,\n    });\n\n  const { writeContractAsync, ...rest } = useWriteContract({\n    mutation: {\n      onMutate,\n      onSettled,\n    },\n  });\n\n  return {\n    ...rest,\n    isPending,\n    errorMessage,\n    writeContractAsync,\n  };\n}\n","import { useSendTransaction } from \"wagmi\";\nimport {\n  useHandleTransactionMutationX,\n  WriteExtendedAsyncParams,\n} from \"./useHandleTransactionMutationX.js\";\n\n/**\n * Custom hook for sending a transaction using Wagmi.\n *\n * This hook provides functionality for sending a transaction using Wagmi, handling the asynchronous nature of the operation, waiting for the transaction receipt, and error handling.\n *\n * @param {WriteExtendedAsyncParams} [settings] - Optional settings for the write operation.\n * @param {boolean} [settings.disableWaitingForReceipt] - Disables waiting for the transaction receipt.\n * @param {boolean} [settings.disableLogging] - Disables logging the result of the transaction.\n * @param {Function} [settings.onSuccess] - Callback function to be called on successful transaction.\n * @param {Function} [settings.onError] - Callback function to be called on transaction error.\n * @param {Function} [settings.onSettled] - Callback function to be called after the transaction settles (whether success or failure).\n * @param {QueryKey[]} [settings.queriesToInvalidate] - Array of query keys to invalidate after the transaction receives a receipt.\n * @returns {Object} Object containing the following properties:\n * - {boolean} isPending - Indicates whether the transaction is pending.\n * - {string|undefined} errorMessage - The error message, if an error occurred during the transaction.\n * - {Function} sendTransactionAsync - Function to trigger the send transaction mutation.\n\n * @example\n * // In your component:\n * function MyTransactionComponent() {\n *   const { sendTransactionAsync, isPending, errorMessage } = useSendTransactionX({\n *     // use calbacks here in useContractWriteX or in writeContractAsync\n *     onSuccess: (txHash) => console.log(\"Transaction successful:\", txHash),\n *     onError: (error) => console.error(\"Transaction error:\", error),\n *     queriesToInvalidate: [[\"userBalance\"], [\"userActivity\"]],\n *   });\n *\n *   const handleSend = async () => {\n *     try {\n *       const txHash = await sendTransactionAsync({ transaction params here.. });\n *       console.log(\"Received txHash:\", txHash);\n *     } catch (err) {\n *       console.error(\"Failed sending transaction:\", err);`\n *     }\n *   };\n *\n *   return (\n *     <div>\n *       <button onClick={handleSend} disabled={isPending}>\n *         {isPending ? \"Processing...\" : \"Send Transaction\"}\n *       </button>\n *       {errorMessage && <p>Error: {errorMessage}</p>}\n *     </div>\n *   );\n * }\n */\n\nexport function useSendTransactionX(settings?: WriteExtendedAsyncParams) {\n  const { isPending, errorMessage, onMutate, onSettled } =\n    useHandleTransactionMutationX({\n      settings,\n    });\n\n  const { sendTransactionAsync, ...rest } = useSendTransaction({\n    mutation: {\n      onMutate,\n      onSettled,\n    },\n  });\n\n  return {\n    ...rest,\n    isPending,\n    errorMessage,\n    sendTransactionAsync,\n  };\n}\n","export const queryConfig = {\n  metadataQueryConfig: {\n    staleTime: Infinity,\n  },\n  sensitiveDataQueryConfig: {\n    staleTime: 60_000,\n  },\n};\n","import { Address, erc20Abi } from \"viem\";\nimport { readContract } from \"viem/actions\";\n\nexport const fetchAllowance = async (\n  asset: Address,\n  spender: Address,\n  userAddress: Address,\n  config: any\n) => {\n  const allowance = await readContract(config, {\n    address: asset,\n    abi: erc20Abi,\n    functionName: \"allowance\",\n    args: [userAddress, spender],\n  });\n\n  if (allowance == null) {\n    throw new Error(\"Failed to fetch token data or allowance\");\n  }\n\n  return allowance;\n};\n","import { useQuery, useQueryClient } from \"@tanstack/react-query\";\nimport { Address, erc20Abi } from \"viem\";\nimport { useAccount, useConfig } from \"wagmi\";\nimport { queryConfig } from \"../query-config/index.js\";\nimport { fetchAllowance } from \"../fetch-functions/fetchAllowanceX.js\";\n\nconst HookFetchAssetAllowanceQK = (\n  asset?: Address,\n  spender?: Address,\n  userAddress?: Address\n) => [\"HookFetchAllowance\", asset, spender, userAddress] as const;\n\n/**\n * Custom hook for fetching asset allowance.\n *\n * @param {Address} asset - The address of the ERC20 token contract.\n * @param {Address} spender - The address of the spender to check allowance for.\n *\n *\n * @example\n * // In your component:\n * function AllowanceDisplay() {\n *   const { data: allowance, isLoading, error } = useFetchAssetAllowanceX({\n *     asset: \"0xTokenAddressExample\",\n *     spender: \"0xSpenderAddressExample\",\n *   });\n *\n *   if (isLoading) return <div>Loading allowance...</div>;\n *   if (error) return <div>Error loading allowance</div>;\n *\n *   return (\n *     <div>\n *       Current Allowance: {allowance}\n *     </div>\n *   );\n * }\n */\nexport const useFetchAssetAllowanceX = ({\n  asset,\n  spender,\n}: {\n  asset?: Address;\n  spender?: Address;\n}) => {\n  const config = useConfig();\n  const { address: userAddress } = useAccount();\n\n  const { data, ...rest } = useQuery({\n    queryKey: HookFetchAssetAllowanceQK(asset, spender, userAddress),\n    queryFn: () => fetchAllowance(asset!, spender!, userAddress!, config),\n    enabled: Boolean(asset) && Boolean(spender) && Boolean(userAddress),\n    ...queryConfig.sensitiveDataQueryConfig,\n  });\n\n  return {\n    ...rest,\n    data,\n    queryKey: HookFetchAssetAllowanceQK(asset, spender, userAddress),\n  };\n};\n","import { useState, useEffect } from \"react\";\nimport { Address, maxUint256, erc20Abi } from \"viem\";\nimport { useFetchAssetAllowanceX } from \"./useFetchAssetAllowanceX.js\";\nimport { useContractWriteX } from \"./useContractWriteX.js\";\n\n/**\n * Custom hook for approving ERC20 token transfers.\n *\n * This hook provides functionality for approving ERC20 token transfers, checking the current allowance, and handling the approval transaction using Wagmi.\n *\n * @param {Address} tokenAddress - The address of the ERC20 token contract (the transfer from).\n * @param {Address} spenderAddress - The address of the spender to approve the transfer to.\n * @param {bigint} [amount=BigInt(0)] - The amount to approve for transfer. Defaults to undefined.\n * @param {boolean} [approveMax=false] - Indicates whether to approve the maximum amount or a specific amount.\n * @returns {Object} Object containing the following properties:\n * - {boolean} isApproved - Indicates whether the spender is already approved to transfer the specified amount of tokens.\n * - {boolean} isApproving - Indicates whether an approval transaction is currently pending.\n * - {Function} approveAsync - Function to trigger the approval transaction.\n *\n * @example\n * // In your component:\n * function ApproveTokenButton(amountToApprove) {\n *   const tokenAddress = \"0xTokenAddressExample\";\n *   const spenderAddress = \"0xSpenderAddressExample\";\n *\n *   const { isApproved, isApproving, justApproved, approveAsync } = useERC20ApproveX(\n *     tokenAddress,\n *     spenderAddress,\n *     parseUnits(amountToApprove.toString(), 18),\n *   );\n *\n *   return (\n *     <button onClick={approveAsync} disabled={isApproving || isApproved}>\n *       {isApproving ? \"Approving...\" : isApproved ? \"Approved\" : \"Approve Token\"}\n *     </button>\n *   );\n * }\n */\n\nexport const useERC20ApproveX = (\n  tokenAddress?: Address,\n  spenderAddress?: Address,\n  amount?: bigint,\n  approveMax?: boolean\n) => {\n  const [isApproved, setIsApproved] = useState(false);\n  const [justApproved, setJustApproved] = useState(false);\n\n  const { data: allowance, queryKey: allowanceKQ } = useFetchAssetAllowanceX({\n    asset: tokenAddress,\n    spender: spenderAddress,\n  });\n\n  const { writeContractAsync: approveTokenAsync, isPending } =\n    useContractWriteX({\n      queriesToInvalidate: [allowanceKQ],\n    });\n\n  useEffect(() => {\n    if (amount == null) {\n      setIsApproved(false);\n    } else if (allowance && allowance >= amount) {\n      setIsApproved(true);\n    } else {\n      setIsApproved(false);\n    }\n  }, [allowance, amount]);\n\n  const approveAsync = async () => {\n    const amountToApprove = approveMax ? maxUint256 : amount;\n\n    try {\n      if (!spenderAddress) {\n        throw new Error(\"spenderAddress is undefined!\");\n      }\n      if (!tokenAddress) {\n        throw new Error(\"tokenAddress is undefined!\");\n      }\n      if (amountToApprove == null) {\n        throw new Error(\"amountToApprove is undefined!\");\n      }\n\n      await approveTokenAsync(\n        {\n          address: tokenAddress,\n          abi: erc20Abi,\n          functionName: \"approve\",\n          args: [spenderAddress, amountToApprove],\n        },\n        {\n          onSuccess: () => {\n            setJustApproved(true);\n          },\n        }\n      );\n    } catch (e: any) {\n      console.error(\"Error approving token:\", e);\n      throw e;\n    }\n  };\n\n  return {\n    isApproved,\n    isApproving: isPending,\n    justApproved,\n    approveAsync,\n  };\n};\n","// src/config/defaults.ts\nimport { QueryClient } from \"@tanstack/react-query\";\nimport { Config } from \"wagmi\";\n\n// You can adjust the type for wagmiConfig to match your needs.\nlet defaultQueryClient: QueryClient | null = null;\nlet defaultWagmiConfig: any = null;\n\n/**\n * Sets the default configuration values.\n *\n * @param queryClient - The default QueryClient instance.\n * @param wagmiConfig - The default Wagmi configuration.\n * @example\n * //In your application initialization (e.g., index.tsx or App.tsx):\n * import { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\n * import { wagmiConfig } from \"/path/to/wagmi-config\";\n * import { setDefaults } from \"wagmi-extended\";\n *\n * const queryClient = new QueryClient();\n *\n * //Set defaults for the extended library functions.\n * setDefaults(queryClient, wagmiConfig);\n *\n * //Now helper functions like fetchTokenX can use these defaults if no explicit parameters are provided.\n */\nexport function setDefaults(\n  queryClient: QueryClient,\n  wagmiConfig: Config\n): void {\n  defaultQueryClient = queryClient;\n  defaultWagmiConfig = wagmiConfig;\n}\n\n/**\n * Retrieves the currently set default configurations.\n *\n * @throws Will throw an error if defaults are not initialized.\n * @returns An object containing the default queryClient and wagmiConfig.\n *\n * @example\n * // Usage in a helper function:\n * import { getDefaults } from \"wagmi-extended\";\n *\n * function exampleFunction() {\n *   const { queryClient, wagmiConfig } = getDefaults();\n *   // Use queryClient and wagmiConfig as needed...\n * }\n */\nexport function getDefaults(): {\n  queryClient: QueryClient;\n  wagmiConfig: Config;\n} {\n  if (!defaultQueryClient || !defaultWagmiConfig) {\n    throw new Error(\n      \"Default configuration not set. Please call setDefaults() first.\"\n    );\n  }\n  return { queryClient: defaultQueryClient, wagmiConfig: defaultWagmiConfig };\n}\n","import { QueryClient } from \"@tanstack/react-query\";\nimport { readContractQueryOptions } from \"wagmi/query\";\nimport { Address, zeroAddress, erc20Abi } from \"viem\";\nimport { Config } from \"wagmi\";\nimport { getDefaults } from \"../config/defaults.js\";\nimport { queryConfig } from \"../query-config/index.js\";\n\nexport interface Token {\n  symbol: string;\n  decimals: number;\n  name: string;\n}\n\nexport const EthTokenData: Token = {\n  symbol: \"ETH\",\n  decimals: 18,\n  name: \"Ethereum\",\n};\n\nexport async function fetchDecimalsX(\n  token: Address,\n  queryClient?: QueryClient,\n  wagmiConfig?: Config\n): Promise<number | undefined> {\n  if (!queryClient || !wagmiConfig) {\n    ({ queryClient, wagmiConfig } = getDefaults());\n  }\n  if (!queryClient || !wagmiConfig) {\n    throw new Error(\n      \"Could not find queryClient or wagmiConfig, either pass them as arguments or set them using setDefaults()\"\n    );\n  }\n\n  if (token === zeroAddress) return EthTokenData.decimals;\n\n  const decimals = await queryClient.fetchQuery({\n    ...readContractQueryOptions(wagmiConfig, {\n      address: token,\n      abi: erc20Abi,\n      functionName: \"decimals\",\n    }),\n    ...queryConfig.metadataQueryConfig,\n  });\n\n  return decimals;\n}\n\nexport async function fetchSymbolX(\n  token: Address,\n  queryClient?: QueryClient,\n  wagmiConfig?: Config\n): Promise<string> {\n  if (!queryClient || !wagmiConfig) {\n    ({ queryClient, wagmiConfig } = getDefaults());\n  }\n  if (!queryClient || !wagmiConfig) {\n    throw new Error(\n      \"Could not find queryClient or wagmiConfig, either pass them as arguments or set them using setDefaults()\"\n    );\n  }\n\n  if (token === zeroAddress) return EthTokenData.symbol;\n\n  const symbol = await queryClient.fetchQuery({\n    ...readContractQueryOptions(wagmiConfig, {\n      address: token,\n      abi: erc20Abi,\n      functionName: \"symbol\",\n    }),\n    ...queryConfig.metadataQueryConfig,\n  });\n\n  return symbol;\n}\n\nexport async function fetchNameX(\n  token: Address,\n  queryClient: any,\n  wagmiConfig: any\n): Promise<string> {\n  if (token === zeroAddress) return EthTokenData.name;\n\n  if (!queryClient || !wagmiConfig) {\n    ({ queryClient, wagmiConfig } = getDefaults());\n  }\n  if (!queryClient || !wagmiConfig) {\n    throw new Error(\n      \"Could not find queryClient or wagmiConfig, either pass them as arguments or set them using setDefaults()\"\n    );\n  }\n\n  const name = await queryClient.fetchQuery({\n    ...readContractQueryOptions(wagmiConfig, {\n      address: token,\n      abi: erc20Abi,\n      functionName: \"name\",\n    }),\n    ...queryConfig.metadataQueryConfig,\n  });\n\n  return name;\n}\n\n/**\n * Fetches the token metadata (symbol, decimals) for the given token address.\n * Internally calls:\n *  - `fetchSymbol(token)`   to retrieve the token symbol,\n *  - `fetchDecimals(token)` to retrieve the token decimals\n *  - `fetchName(token)`     to retrieve the token name\n *\n * @param token - The address of the token.\n * @returns A `Token` object containing the symbol, decimals.\n * @throws Will throw an error if symbol or decimals cannot be fetched.\n */\nexport async function fetchTokenX(\n  token: Address,\n  queryClient?: QueryClient,\n  wagmiConfig?: Config\n): Promise<Token> {\n  const [symbol, decimals, name] = await Promise.all([\n    fetchSymbolX(token, queryClient, wagmiConfig),\n    fetchDecimalsX(token, queryClient, wagmiConfig),\n    fetchNameX(token, queryClient, wagmiConfig),\n  ]);\n  if (!symbol || !decimals || !name) {\n    throw new Error(\"Failed to fetch token data\");\n  }\n\n  return {\n    symbol,\n    decimals,\n    name,\n  };\n}\n","import { useQueryClient, useQuery } from \"@tanstack/react-query\";\nimport { Address } from \"viem\";\nimport { useConfig } from \"wagmi\";\nimport { fetchTokenX } from \"../fetch-functions/fetchTokenX.js\";\n\n/**\n * Returns a query key for fetching token data.\n *\n * @param {Address | undefined} asset - The token address.\n * @returns {Array} A unique query key for the token fetch.\n *\n * @example\n * const queryKey = HookFetchTokenQK(\"0x123...\");\n */\nexport const HookFetchTokenQK = (asset?: Address): any[] => [\n  \"HookTokenWagmiExtended\",\n  asset,\n];\n\n/**\n * Custom hook for fetching token metadata using extended Wagmi functionality.\n *\n * This hook leverages React Query for data fetching and caching.\n * It retrieves token metadata (such as symbol, decimals, name, etc.) for a given token address.\n *\n * @param {Address} [asset] - The token address.\n * @returns {Object} An object with the following properties:\n *   - `data`: The token data (or undefined if not loaded).\n *   - `isLoading`: Boolean indicating if the data is loading.\n *   - `error`: Any error encountered during the fetch.\n *   - `queryKey`: The unique key used for the query.\n *\n * @example\n * // In your component:\n * function MyTokenComponent() {\n *   const { data, isLoading, error, queryKey } = useTokenX(\"0x123456...\");\n *\n *   if (isLoading) return <div>Loading token data...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *\n *   return (\n *     <div>\n *       <p>Token Symbol: {data.symbol}</p>\n *       <p>Decimals: {data.decimals}</p>\n *       <p>Name: {data.name}</p>\n *     </div>\n *   );\n * }\n */\nexport const useTokenX = (asset?: Address) => {\n  const queryClient = useQueryClient();\n  const config = useConfig();\n\n  const { data, ...rest } = useQuery({\n    queryKey: HookFetchTokenQK(asset),\n    queryFn: () => fetchTokenX(asset!, queryClient, config),\n    enabled: Boolean(asset),\n  });\n\n  return {\n    ...rest,\n    data,\n    queryKey: HookFetchTokenQK(asset),\n  };\n};\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.esm.js","sources":["../src/utils/errorParserX.ts","../src/hooks/useInvalidateQueries.ts","../src/hooks/useHandleTransactionMutationX.ts","../src/hooks/useContractWriteX.ts","../src/hooks/useSendTransactionX.ts","../src/query-config/index.ts","../src/fetch-functions/fetchAllowanceX.ts","../src/hooks/useFetchAssetAllowanceX.ts","../src/hooks/useERC20ApproveX.ts","../src/config/defaults.ts","../src/fetch-functions/fetchTokenX.ts","../src/hooks/useTokenX.ts"],"sourcesContent":["import { BaseError, ContractFunctionRevertedError } from \"viem\";\n\n/**\n * Default error mapping that contains a set of error identifiers mapped to user-friendly error messages.\n */\nconst defaultErrorMapping: Record<string, string> = {\n  EnforcedPause: \"Temporary pause in effect, please check Discord for updates.\",\n  ErrorNotEnoughAllowance:\n    \"Not enough allowance, did you approve your tokens first?\",\n  \"0xc2139725\": \"Not enough allowance, did you approve your tokens first?\",\n  SharesReceivedBelowMinimum:\n    \"Action exceeded safe slippage parameters, please try again later\",\n  \"0xea8d7f02\":\n    \"Action exceeded safe slippage parameters, please try again later\",\n  MaxSlippageExceeded:\n    \"Action exceeded safe slippage parameters, please try again later\",\n  \"51\": \"Supply cap exceeded\",\n};\n\n/**\n * A mutable copy of the default error mapping that can be extended or overridden by users.\n */\nlet currentErrorMapping: Record<string, string> = { ...defaultErrorMapping };\n\n/**\n * Merges a custom error mapping into the current error mapping.\n * Custom values override any existing keys.\n *\n * @param customMapping - An object containing error keys and the corresponding custom messages.\n *\n * @example\n * setErrorMapping({\n *   ErrorNotEnoughAllowance: \"Custom message: Please approve tokens first!\",\n *   NewCustomError: \"A custom error occurred.\"\n * });\n */\nexport const setErrorMapping = (\n  customMapping: Record<string, string>\n): void => {\n  currentErrorMapping = { ...currentErrorMapping, ...customMapping };\n};\n\n/**\n * Resets the current error mapping to the default error mapping.\n *\n * @example\n * resetErrorMapping();\n */\nexport const resetErrorMapping = (): void => {\n  currentErrorMapping = {};\n};\n\n/**\n * Retrieves the current error mapping.\n *\n * @returns The current error mapping object.\n *\n * @example\n * const mapping = getErrorMapping();\n * console.log(mapping);\n */\nexport const getErrorMapping = (): Record<string, string> =>\n  currentErrorMapping;\n\n/**\n * Parses an error object and returns a user-friendly error message.\n *\n * The function checks if the error is a ContractFunctionRevertedError by attempting to walk through\n * the error using its `walk` method. If a matching error is found and its error key exists in the\n * current error mapping, the corresponding custom message will be returned. Otherwise, it falls back\n * to the error's own message properties.\n *\n * @param error - The error object, potentially including additional error details.\n * @returns A user-friendly error message.\n *\n * @example\n * const message = getParsedError(someError);\n * console.log(message); // Outputs a custom error message or a default error message.\n */\nexport const getParsedErrorX = (error: any | BaseError): string => {\n  const defaultMessage = \"An unknown error occurred. Please contact support.\";\n  let message = defaultMessage;\n  let errorKey = \"\";\n\n  const revertedError = error?.walk\n    ? error.walk((err: unknown) => err instanceof ContractFunctionRevertedError)\n    : null;\n  if (revertedError instanceof ContractFunctionRevertedError) {\n    errorKey =\n      revertedError.data?.errorName ??\n      revertedError.signature ??\n      revertedError.reason ??\n      \"\";\n    if (currentErrorMapping[errorKey]) return currentErrorMapping[errorKey];\n  }\n\n  message = error.shortMessage || error.details || error.message || message;\n  return message;\n};\n","import { QueryKey, useQueryClient } from \"@tanstack/react-query\";\n\n/**\n * Hook to invalidate multiple queries in the React Query cache.\n *\n * @returns An object with the invalidateMany function.\n */\nexport function useInvalidateQueries() {\n  const queryClient = useQueryClient();\n\n  const invalidateMany = async (queries: (QueryKey | undefined)[]) => {\n    const promises = queries.map((queryKey) =>\n      queryClient.invalidateQueries({ queryKey })\n    );\n    await Promise.all(promises);\n  };\n\n  return { invalidateMany };\n}\n","import { waitForTransactionReceipt } from \"wagmi/actions\";\nimport { useConfig } from \"wagmi\";\nimport { QueryKey } from \"@tanstack/query-core\";\nimport { Address } from \"viem\";\nimport { useState } from \"react\";\nimport { getParsedErrorX } from \"../utils/errorParserX.js\";\nimport { useInvalidateQueries } from \"./useInvalidateQueries.js\";\n\nexport type WriteExtendedAsyncParams = {\n  onSuccess?: (txHash: Address) => void;\n  onError?: (e: any) => void;\n  onSettled?: () => void;\n  queriesToInvalidate?: (QueryKey | undefined)[];\n  disableLogging?: boolean;\n  disableWaitingForReceipt?: boolean;\n};\n\n/**\n * Custom hook to handle transaction mutations.\n *\n * @returns {Function} A shared `onSettled` callback for transaction mutations.\n */\nexport function useHandleTransactionMutationX({\n  settings,\n}: {\n  settings?: WriteExtendedAsyncParams;\n}) {\n  const wagmiConfig = useConfig();\n\n  const { invalidateMany } = useInvalidateQueries();\n  const [isPending, setIsPending] = useState(false);\n  const [errorMessage, setErrorMessage] = useState<string | undefined>(\n    undefined\n  );\n\n  const onMutate = () => {\n    setIsPending(true);\n    setErrorMessage(undefined);\n  };\n\n  const onSettled = async (\n    txHash: Address | undefined,\n    error: any,\n    args: any\n  ) => {\n    try {\n      if (error) throw error;\n\n      if (!settings?.disableWaitingForReceipt) {\n        // 1. wait for transaction receipt\n        const txReceipt = await waitForTransactionReceipt(wagmiConfig, {\n          hash: txHash!,\n        });\n\n        // 2. throw if receipt is not valid\n        if (txReceipt.status === \"reverted\")\n          throw new Error(\"Execution reverted.\");\n        if (txReceipt.status !== \"success\")\n          throw new Error(\"Execution reverted.\");\n      }\n\n      // 3. invalidate queries\n      if (settings?.queriesToInvalidate)\n        await invalidateMany(settings?.queriesToInvalidate);\n\n      // 4. call onSuccess callback\n      settings?.onSuccess?.(txHash!);\n\n      if (!settings?.disableLogging) {\n        // 5. log result\n        // eslint-disable-next-line no-console\n        console.info(\"Operation successful:\", txHash); // todo: add logging service\n      }\n      // 6. return result\n      return txHash;\n    } catch (error) {\n      const parsedError = getParsedErrorX(error);\n\n      if (!settings?.disableLogging) {\n        // 1. log error\n        console.error(\n          `ContractWriteExtended Operation failed with error(parsed): ${parsedError}`,\n          { error },\n          { args }\n        );\n        console.error({ error });\n      }\n      // 2. set error message\n      setErrorMessage(parsedError);\n\n      // 3. call callback\n      settings?.onError?.(error);\n    } finally {\n      setIsPending(false);\n      // 1. call callback\n      settings?.onSettled?.();\n    }\n    return undefined;\n  };\n\n  return {\n    onMutate,\n    onSettled,\n    isPending,\n    errorMessage,\n  };\n}\n","import { useWriteContract } from \"wagmi\";\nimport {\n  WriteExtendedAsyncParams,\n  useHandleTransactionMutationX,\n} from \"./useHandleTransactionMutationX.js\";\n\n/**\n * Custom hook for writing to a smart contract using Wagmi.\n *\n * This hook provides functionality for writing a contract using Wagmi, handling the asynchronous nature of the operation, waiting for the transaction receipt, and error handling.\n *\n * @param {WriteExtendedAsyncParams} [settings] - Optional settings for the write operation.\n * @param {boolean} [settings.disableWaitingForReceipt] - Disables waiting for the transaction receipt.\n * @param {boolean} [settings.disableLogging] - Disables logging the result of the transaction.\n * @param {Function} [settings.onSuccess] - Callback function to be called on successful transaction.\n * @param {Function} [settings.onError] - Callback function to be called on transaction error.\n * @param {Function} [settings.onSettled] - Callback function to be called after the transaction settles (whether success or failure).\n * @param {QueryKey[]} [settings.queriesToInvalidate] - Array of query keys to invalidate after the transaction receives a receipt.\n * @returns {Object} Object containing the following properties:\n * - {boolean} isPending - Indicates whether the transaction is pending.\n * - {string|undefined} errorMessage - The error message, if an error occurred during the transaction.\n * - {Function} writeContractAsync - Function to trigger the write operation.\n * \n/**\n * Custom hook for writing a contract using Wagmi with extended functionality.\n *\n * This hook wraps Wagmi’s `useContractWriteX` with additional handling for\n * waiting for a transaction receipt, logging control, and invalidation of specified queries.\n *\n * @param {WriteExtendedAsyncParams} [settings] - Optional settings for handling the transaction.\n * @returns {Object} An object containing:\n *   - `isPending`: {boolean} indicating if the transaction is in progress.\n *   - `errorMessage`: {string|undefined} a potential error message.\n *   - `writeContractAsync`: {Function} a function to trigger the transaction.\n *\n * @example\n * // In your component:\n * function MyTransactionComponent() {\n *   const { writeContractAsync, isPending, errorMessage } = useContractWriteX({\n *     queriesToInvalidate: [[\"userBalance\"], [\"userActivity\"]],\n *   });\n *\n *   const handleWrite = async () => {\n *     try {\n *       const txHash = await writeContractAsync({ transaction params here.. }, {\n *          // use calbacks here in writeContractAsync or in useContractWriteX\n *          onSuccess: (txHash) => console.log(\"Transaction successful:\", txHash),\n *          onError: (error) => console.error(\"Transaction error:\", error),\n *       });\n *       console.log(\"Received txHash:\", txHash);\n *     } catch (err) {\n *       console.error(\"Failed writing transaction:\", err);`\n *     }\n *   };\n *\n *   return (\n *     <div>\n *       <button onClick={handleWrite} disabled={isPending}>\n *         {isPending ? \"Processing...\" : \"Write Transaction\"}\n *       </button>\n *       {errorMessage && <p>Error: {errorMessage}</p>}\n *     </div>\n *   );\n * }\n */\n\nexport function useContractWriteX(settings?: WriteExtendedAsyncParams) {\n  const { isPending, errorMessage, onMutate, onSettled } =\n    useHandleTransactionMutationX({\n      settings,\n    });\n\n  const { writeContractAsync, ...rest } = useWriteContract({\n    mutation: {\n      onMutate,\n      onSettled,\n    },\n  });\n\n  return {\n    ...rest,\n    isPending,\n    errorMessage,\n    writeContractAsync,\n  };\n}\n","import { useSendTransaction } from \"wagmi\";\nimport {\n  useHandleTransactionMutationX,\n  WriteExtendedAsyncParams,\n} from \"./useHandleTransactionMutationX.js\";\n\n/**\n * Custom hook for sending a transaction using Wagmi.\n *\n * This hook provides functionality for sending a transaction using Wagmi, handling the asynchronous nature of the operation, waiting for the transaction receipt, and error handling.\n *\n * @param {WriteExtendedAsyncParams} [settings] - Optional settings for the write operation.\n * @param {boolean} [settings.disableWaitingForReceipt] - Disables waiting for the transaction receipt.\n * @param {boolean} [settings.disableLogging] - Disables logging the result of the transaction.\n * @param {Function} [settings.onSuccess] - Callback function to be called on successful transaction.\n * @param {Function} [settings.onError] - Callback function to be called on transaction error.\n * @param {Function} [settings.onSettled] - Callback function to be called after the transaction settles (whether success or failure).\n * @param {QueryKey[]} [settings.queriesToInvalidate] - Array of query keys to invalidate after the transaction receives a receipt.\n * @returns {Object} Object containing the following properties:\n * - {boolean} isPending - Indicates whether the transaction is pending.\n * - {string|undefined} errorMessage - The error message, if an error occurred during the transaction.\n * - {Function} sendTransactionAsync - Function to trigger the send transaction mutation.\n\n * @example\n * // In your component:\n * function MyTransactionComponent() {\n *   const { sendTransactionAsync, isPending, errorMessage } = useSendTransactionX({\n *     // use calbacks here in useContractWriteX or in writeContractAsync\n *     onSuccess: (txHash) => console.log(\"Transaction successful:\", txHash),\n *     onError: (error) => console.error(\"Transaction error:\", error),\n *     queriesToInvalidate: [[\"userBalance\"], [\"userActivity\"]],\n *   });\n *\n *   const handleSend = async () => {\n *     try {\n *       const txHash = await sendTransactionAsync({ transaction params here.. });\n *       console.log(\"Received txHash:\", txHash);\n *     } catch (err) {\n *       console.error(\"Failed sending transaction:\", err);`\n *     }\n *   };\n *\n *   return (\n *     <div>\n *       <button onClick={handleSend} disabled={isPending}>\n *         {isPending ? \"Processing...\" : \"Send Transaction\"}\n *       </button>\n *       {errorMessage && <p>Error: {errorMessage}</p>}\n *     </div>\n *   );\n * }\n */\n\nexport function useSendTransactionX(settings?: WriteExtendedAsyncParams) {\n  const { isPending, errorMessage, onMutate, onSettled } =\n    useHandleTransactionMutationX({\n      settings,\n    });\n\n  const { sendTransactionAsync, ...rest } = useSendTransaction({\n    mutation: {\n      onMutate,\n      onSettled,\n    },\n  });\n\n  return {\n    ...rest,\n    isPending,\n    errorMessage,\n    sendTransactionAsync,\n  };\n}\n","export const queryConfig = {\n  metadataQueryConfig: {\n    staleTime: Infinity,\n  },\n  sensitiveDataQueryConfig: {\n    staleTime: 60_000,\n  },\n};\n","import { Address, erc20Abi } from \"viem\";\nimport { readContract } from \"viem/actions\";\n\nexport const fetchAllowance = async (\n  asset: Address,\n  spender: Address,\n  userAddress: Address,\n  config: any\n) => {\n  const allowance = await readContract(config, {\n    address: asset,\n    abi: erc20Abi,\n    functionName: \"allowance\",\n    args: [userAddress, spender],\n  });\n\n  if (allowance == null) {\n    throw new Error(\"Failed to fetch token data or allowance\");\n  }\n\n  return allowance;\n};\n","import { useQuery, useQueryClient } from \"@tanstack/react-query\";\nimport { Address, erc20Abi } from \"viem\";\nimport { useAccount, useConfig } from \"wagmi\";\nimport { queryConfig } from \"../query-config/index.js\";\nimport { fetchAllowance } from \"../fetch-functions/fetchAllowanceX.js\";\n\nconst HookFetchAssetAllowanceQK = (\n  asset?: Address,\n  spender?: Address,\n  userAddress?: Address\n) => [\"HookFetchAllowance\", asset, spender, userAddress] as const;\n\n/**\n * Custom hook for fetching asset allowance.\n *\n * @param {Address} asset - The address of the ERC20 token contract.\n * @param {Address} spender - The address of the spender to check allowance for.\n *\n *\n * @example\n * // In your component:\n * function AllowanceDisplay() {\n *   const { data: allowance, isLoading, error } = useFetchAssetAllowanceX({\n *     asset: \"0xTokenAddressExample\",\n *     spender: \"0xSpenderAddressExample\",\n *   });\n *\n *   if (isLoading) return <div>Loading allowance...</div>;\n *   if (error) return <div>Error loading allowance</div>;\n *\n *   return (\n *     <div>\n *       Current Allowance: {allowance}\n *     </div>\n *   );\n * }\n */\nexport const useFetchAssetAllowanceX = ({\n  asset,\n  spender,\n}: {\n  asset?: Address;\n  spender?: Address;\n}) => {\n  const config = useConfig();\n  const { address: userAddress } = useAccount();\n\n  const { data, ...rest } = useQuery({\n    queryKey: HookFetchAssetAllowanceQK(asset, spender, userAddress),\n    queryFn: () => fetchAllowance(asset!, spender!, userAddress!, config),\n    enabled: Boolean(asset) && Boolean(spender) && Boolean(userAddress),\n    ...queryConfig.sensitiveDataQueryConfig,\n  });\n\n  return {\n    ...rest,\n    data,\n    queryKey: HookFetchAssetAllowanceQK(asset, spender, userAddress),\n  };\n};\n","import { useState, useEffect } from \"react\";\nimport { Address, maxUint256, erc20Abi } from \"viem\";\nimport { useFetchAssetAllowanceX } from \"./useFetchAssetAllowanceX.js\";\nimport { useContractWriteX } from \"./useContractWriteX.js\";\n\n/**\n * Custom hook for approving ERC20 token transfers.\n *\n * This hook provides functionality for approving ERC20 token transfers, checking the current allowance, and handling the approval transaction using Wagmi.\n *\n * @param {Address} tokenAddress - The address of the ERC20 token contract (the transfer from).\n * @param {Address} spenderAddress - The address of the spender to approve the transfer to.\n * @param {bigint} [amount=BigInt(0)] - The amount to approve for transfer. Defaults to undefined.\n * @param {boolean} [approveMax=false] - Indicates whether to approve the maximum amount or a specific amount.\n * @returns {Object} Object containing the following properties:\n * - {boolean} isApproved - Indicates whether the spender is already approved to transfer the specified amount of tokens.\n * - {boolean} isApproving - Indicates whether an approval transaction is currently pending.\n * - {Function} approveAsync - Function to trigger the approval transaction.\n *\n * @example\n * // In your component:\n * function ApproveTokenButton(amountToApprove) {\n *   const tokenAddress = \"0xTokenAddressExample\";\n *   const spenderAddress = \"0xSpenderAddressExample\";\n *\n *   const { isApproved, isApproving, justApproved, approveAsync } = useERC20ApproveX(\n *     tokenAddress,\n *     spenderAddress,\n *     parseUnits(amountToApprove.toString(), 18),\n *   );\n *\n *   return (\n *     <button onClick={approveAsync} disabled={isApproving || isApproved}>\n *       {isApproving ? \"Approving...\" : isApproved ? \"Approved\" : \"Approve Token\"}\n *     </button>\n *   );\n * }\n */\n\nexport const useERC20ApproveX = (\n  tokenAddress?: Address,\n  spenderAddress?: Address,\n  amount?: bigint,\n  approveMax?: boolean\n) => {\n  const [isApproved, setIsApproved] = useState(false);\n  const [justApproved, setJustApproved] = useState(false);\n\n  const { data: allowance, queryKey: allowanceKQ } = useFetchAssetAllowanceX({\n    asset: tokenAddress,\n    spender: spenderAddress,\n  });\n\n  const { writeContractAsync: approveTokenAsync, isPending } =\n    useContractWriteX({\n      queriesToInvalidate: [allowanceKQ],\n    });\n\n  useEffect(() => {\n    if (amount == null) {\n      setIsApproved(false);\n    } else if (allowance && allowance >= amount) {\n      setIsApproved(true);\n    } else {\n      setIsApproved(false);\n    }\n  }, [allowance, amount]);\n\n  const approveAsync = async () => {\n    const amountToApprove = approveMax ? maxUint256 : amount;\n\n    try {\n      if (!spenderAddress) {\n        throw new Error(\"spenderAddress is undefined!\");\n      }\n      if (!tokenAddress) {\n        throw new Error(\"tokenAddress is undefined!\");\n      }\n      if (amountToApprove == null) {\n        throw new Error(\"amountToApprove is undefined!\");\n      }\n\n      await approveTokenAsync(\n        {\n          address: tokenAddress,\n          abi: erc20Abi,\n          functionName: \"approve\",\n          args: [spenderAddress, amountToApprove],\n        },\n        {\n          onSuccess: () => {\n            setJustApproved(true);\n          },\n        }\n      );\n    } catch (e: any) {\n      console.error(\"Error approving token:\", e);\n      throw e;\n    }\n  };\n\n  return {\n    isApproved,\n    isApproving: isPending,\n    justApproved,\n    approveAsync,\n  };\n};\n","// src/config/defaults.ts\nimport { QueryClient } from \"@tanstack/react-query\";\nimport { Config } from \"wagmi\";\n\n// You can adjust the type for wagmiConfig to match your needs.\nlet defaultQueryClient: QueryClient | null = null;\nlet defaultWagmiConfig: any = null;\n\n/**\n * Sets the default configuration values.\n *\n * @param queryClient - The default QueryClient instance.\n * @param wagmiConfig - The default Wagmi configuration.\n * @example\n * //In your application initialization (e.g., index.tsx or App.tsx):\n * import { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\n * import { wagmiConfig } from \"/path/to/wagmi-config\";\n * import { setDefaults } from \"wagmi-extended\";\n *\n * const queryClient = new QueryClient();\n *\n * //Set defaults for the extended library functions.\n * setDefaults(queryClient, wagmiConfig);\n *\n * //Now helper functions like fetchTokenX can use these defaults if no explicit parameters are provided.\n */\nexport function setDefaults(\n  queryClient: QueryClient,\n  wagmiConfig: Config\n): void {\n  defaultQueryClient = queryClient;\n  defaultWagmiConfig = wagmiConfig;\n}\n\n/**\n * Retrieves the currently set default configurations.\n *\n * @throws Will throw an error if defaults are not initialized.\n * @returns An object containing the default queryClient and wagmiConfig.\n *\n * @example\n * // Usage in a helper function:\n * import { getDefaults } from \"wagmi-extended\";\n *\n * function exampleFunction() {\n *   const { queryClient, wagmiConfig } = getDefaults();\n *   // Use queryClient and wagmiConfig as needed...\n * }\n */\nexport function getDefaults(): {\n  queryClient: QueryClient;\n  wagmiConfig: Config;\n} {\n  if (!defaultQueryClient || !defaultWagmiConfig) {\n    throw new Error(\n      \"Default configuration not set. Please call setDefaults() first.\"\n    );\n  }\n  return { queryClient: defaultQueryClient, wagmiConfig: defaultWagmiConfig };\n}\n","import { QueryClient } from \"@tanstack/react-query\";\nimport { readContractQueryOptions } from \"wagmi/query\";\nimport { Address, zeroAddress, erc20Abi } from \"viem\";\nimport { Config } from \"wagmi\";\nimport { getDefaults } from \"../config/defaults.js\";\nimport { queryConfig } from \"../query-config/index.js\";\n\nexport interface Token {\n  symbol: string;\n  decimals: number;\n  name: string;\n}\n\nexport const EthTokenData: Token = {\n  symbol: \"ETH\",\n  decimals: 18,\n  name: \"Ethereum\",\n};\n\nexport async function fetchDecimalsX(\n  token: Address,\n  queryClient?: QueryClient,\n  wagmiConfig?: Config\n): Promise<number | undefined> {\n  if (!queryClient || !wagmiConfig) {\n    ({ queryClient, wagmiConfig } = getDefaults());\n  }\n  if (!queryClient || !wagmiConfig) {\n    throw new Error(\n      \"Could not find queryClient or wagmiConfig, either pass them as arguments or set them using setDefaults()\"\n    );\n  }\n\n  if (token === zeroAddress) return EthTokenData.decimals;\n\n  const decimals = await queryClient.fetchQuery({\n    ...readContractQueryOptions(wagmiConfig, {\n      address: token,\n      abi: erc20Abi,\n      functionName: \"decimals\",\n    }),\n    ...queryConfig.metadataQueryConfig,\n  });\n\n  return decimals;\n}\n\nexport async function fetchSymbolX(\n  token: Address,\n  queryClient?: QueryClient,\n  wagmiConfig?: Config\n): Promise<string> {\n  if (!queryClient || !wagmiConfig) {\n    ({ queryClient, wagmiConfig } = getDefaults());\n  }\n  if (!queryClient || !wagmiConfig) {\n    throw new Error(\n      \"Could not find queryClient or wagmiConfig, either pass them as arguments or set them using setDefaults()\"\n    );\n  }\n\n  if (token === zeroAddress) return EthTokenData.symbol;\n\n  const symbol = await queryClient.fetchQuery({\n    ...readContractQueryOptions(wagmiConfig, {\n      address: token,\n      abi: erc20Abi,\n      functionName: \"symbol\",\n    }),\n    ...queryConfig.metadataQueryConfig,\n  });\n\n  return symbol;\n}\n\nexport async function fetchNameX(\n  token: Address,\n  queryClient: any,\n  wagmiConfig: any\n): Promise<string> {\n  if (token === zeroAddress) return EthTokenData.name;\n\n  if (!queryClient || !wagmiConfig) {\n    ({ queryClient, wagmiConfig } = getDefaults());\n  }\n  if (!queryClient || !wagmiConfig) {\n    throw new Error(\n      \"Could not find queryClient or wagmiConfig, either pass them as arguments or set them using setDefaults()\"\n    );\n  }\n\n  const name = await queryClient.fetchQuery({\n    ...readContractQueryOptions(wagmiConfig, {\n      address: token,\n      abi: erc20Abi,\n      functionName: \"name\",\n    }),\n    ...queryConfig.metadataQueryConfig,\n  });\n\n  return name;\n}\n\n/**\n * Fetches the token metadata (symbol, decimals) for the given token address.\n * Internally calls:\n *  - `fetchSymbol(token)`   to retrieve the token symbol,\n *  - `fetchDecimals(token)` to retrieve the token decimals\n *  - `fetchName(token)`     to retrieve the token name\n *\n * @param token - The address of the token.\n * @returns A `Token` object containing the symbol, decimals.\n * @throws Will throw an error if symbol or decimals cannot be fetched.\n */\nexport async function fetchTokenX(\n  token: Address,\n  queryClient?: QueryClient,\n  wagmiConfig?: Config\n): Promise<Token> {\n  const [symbol, decimals, name] = await Promise.all([\n    fetchSymbolX(token, queryClient, wagmiConfig),\n    fetchDecimalsX(token, queryClient, wagmiConfig),\n    fetchNameX(token, queryClient, wagmiConfig),\n  ]);\n  if (!symbol || !decimals || !name) {\n    throw new Error(\"Failed to fetch token data\");\n  }\n\n  return {\n    symbol,\n    decimals,\n    name,\n  };\n}\n","import { useQueryClient, useQuery } from \"@tanstack/react-query\";\nimport { Address } from \"viem\";\nimport { useConfig } from \"wagmi\";\nimport { fetchTokenX } from \"../fetch-functions/fetchTokenX.js\";\n\n/**\n * Returns a query key for fetching token data.\n *\n * @param {Address | undefined} asset - The token address.\n * @returns {Array} A unique query key for the token fetch.\n *\n * @example\n * const queryKey = HookFetchTokenQK(\"0x123...\");\n */\nexport const HookFetchTokenQK = (asset?: Address): any[] => [\n  \"HookTokenWagmiExtended\",\n  asset,\n];\n\n/**\n * Custom hook for fetching token metadata using extended Wagmi functionality.\n *\n * This hook leverages React Query for data fetching and caching.\n * It retrieves token metadata (such as symbol, decimals, name, etc.) for a given token address.\n *\n * @param {Address} [asset] - The token address.\n * @returns {Object} An object with the following properties:\n *   - `data`: The token data (or undefined if not loaded).\n *   - `isLoading`: Boolean indicating if the data is loading.\n *   - `error`: Any error encountered during the fetch.\n *   - `queryKey`: The unique key used for the query.\n *\n * @example\n * // In your component:\n * function MyTokenComponent() {\n *   const { data, isLoading, error, queryKey } = useTokenX(\"0x123456...\");\n *\n *   if (isLoading) return <div>Loading token data...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *\n *   return (\n *     <div>\n *       <p>Token Symbol: {data.symbol}</p>\n *       <p>Decimals: {data.decimals}</p>\n *       <p>Name: {data.name}</p>\n *     </div>\n *   );\n * }\n */\nexport const useTokenX = (asset?: Address) => {\n  const queryClient = useQueryClient();\n  const config = useConfig();\n\n  const { data, ...rest } = useQuery({\n    queryKey: HookFetchTokenQK(asset),\n    queryFn: () => fetchTokenX(asset!, queryClient, config),\n    enabled: Boolean(asset),\n  });\n\n  return {\n    ...rest,\n    data,\n    queryKey: HookFetchTokenQK(asset),\n  };\n};\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wagmi-extended",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "type": "module",
   "description": "A library providing extended hooks on top of Wagmi with additional features.",
   "main": "dist/index.cjs.js",

package/src/utils/errorParserX.ts

@@ -47,7 +47,7 @@ export const setErrorMapping = (
  * resetErrorMapping();
  */
 export const resetErrorMapping = (): void => {
-  currentErrorMapping = { ...defaultErrorMapping };
+  currentErrorMapping = {};
 };
 
 /**