wagmi-extended 1.0.4 → 1.0.6

package/README.md

@@ -99,17 +99,24 @@ Example:
 ```bash
 function MyTransactionComponent() {
 const { writeContractAsync, isPending, errorMessage } = useContractWriteX({
-    onSuccess: (txHash) => console.log("Transaction successful:", txHash),
-    onError: (error) => console.error("Transaction error:", error),
     queriesToInvalidate: [["userBalance"], ["userActivity"]],
 });
 
 const handleWrite = async () => {
     try {
-    const txHash = await writeContractAsync({ transaction params here.. });
-    console.log("Received txHash:", txHash);
+      const txHash = await writeContractAsync({
+        address: "0xContractAddress",
+        abi: [], // Provide your contract ABI
+        functionName: "executeFunction",
+        args: [/* function arguments */],
+      }, {
+        // use calbacks here in writeContractAsync or in useContractWriteX
+        onSuccess: (txHash) => console.log("Transaction successful:", txHash),
+        onError: (error) => console.error("Transaction error:", error),
+      });
+      console.log("Received txHash:", txHash);
     } catch (err) {
-    console.error("Failed writing transaction:", err);`
+      console.error("Failed writing transaction:", err);`
     }
 };
 
@@ -135,6 +142,7 @@ 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"]],
@@ -143,12 +151,7 @@ function TransactionButton() {
   const handleTransaction = async () => {
     try {
       // Replace with actual transaction parameters
-      const txHash = await sendTransactionAsync({
-        address: "0xContractAddress",
-        abi: [], // Provide your contract ABI
-        functionName: "executeFunction",
-        args: [/* function arguments */],
-      });
+      const txHash = await sendTransactionAsync({ transaction params here.. });
       console.log("Transaction hash:", txHash);
     } catch (error) {
       console.error(error);

package/dist/hooks/useContractWriteX.d.ts

@@ -32,14 +32,16 @@ import { WriteExtendedAsyncParams } from "./useHandleTransactionMutationX.js";
  * // In your component:
  * function MyTransactionComponent() {
  *   const { writeContractAsync, isPending, errorMessage } = useContractWriteX({
- *     onSuccess: (txHash) => console.log("Transaction successful:", txHash),
- *     onError: (error) => console.error("Transaction error:", error),
  *     queriesToInvalidate: [["userBalance"], ["userActivity"]],
  *   });
  *
  *   const handleWrite = async () => {
  *     try {
- *       const txHash = await writeContractAsync({ transaction params here.. });
+ *       const txHash = await writeContractAsync({ transaction params here.. }, {
+ *          // use calbacks here in writeContractAsync or in useContractWriteX
+ *          onSuccess: (txHash) => console.log("Transaction successful:", txHash),
+ *          onError: (error) => console.error("Transaction error:", error),
+ *       });
  *       console.log("Received txHash:", txHash);
  *     } catch (err) {
  *       console.error("Failed writing transaction:", err);`

package/dist/hooks/useSendTransactionX.d.ts

@@ -20,6 +20,7 @@ import { WriteExtendedAsyncParams } from "./useHandleTransactionMutationX.js";
  * // In your component:
  * function MyTransactionComponent() {
  *   const { sendTransactionAsync, isPending, errorMessage } = useSendTransactionX({
+ *     // use calbacks here in useContractWriteX or in writeContractAsync
  *     onSuccess: (txHash) => console.log("Transaction successful:", txHash),
  *     onError: (error) => console.error("Transaction error:", error),
  *     queriesToInvalidate: [["userBalance"], ["userActivity"]],

package/dist/index.cjs.js

@@ -208,14 +208,16 @@ function useHandleTransactionMutationX({ settings, }) {
  * // In your component:
  * function MyTransactionComponent() {
  *   const { writeContractAsync, isPending, errorMessage } = useContractWriteX({
- *     onSuccess: (txHash) => console.log("Transaction successful:", txHash),
- *     onError: (error) => console.error("Transaction error:", error),
  *     queriesToInvalidate: [["userBalance"], ["userActivity"]],
  *   });
  *
  *   const handleWrite = async () => {
  *     try {
- *       const txHash = await writeContractAsync({ transaction params here.. });
+ *       const txHash = await writeContractAsync({ transaction params here.. }, {
+ *          // use calbacks here in writeContractAsync or in useContractWriteX
+ *          onSuccess: (txHash) => console.log("Transaction successful:", txHash),
+ *          onError: (error) => console.error("Transaction error:", error),
+ *       });
  *       console.log("Received txHash:", txHash);
  *     } catch (err) {
  *       console.error("Failed writing transaction:", err);`
@@ -271,6 +273,7 @@ function useContractWriteX(settings) {
  * // In your component:
  * function MyTransactionComponent() {
  *   const { sendTransactionAsync, isPending, errorMessage } = useSendTransactionX({
+ *     // use calbacks here in useContractWriteX or in writeContractAsync
  *     onSuccess: (txHash) => console.log("Transaction successful:", txHash),
  *     onError: (error) => console.error("Transaction error:", error),
  *     queriesToInvalidate: [["userBalance"], ["userActivity"]],

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 *     onSuccess: (txHash) => console.log(\"Transaction successful:\", txHash),\n *     onError: (error) => console.error(\"Transaction error:\", error),\n *     queriesToInvalidate: [[\"userBalance\"], [\"userActivity\"]],\n *   });\n *\n *   const handleWrite = async () => {\n *     try {\n *       const txHash = await writeContractAsync({ transaction params here.. });\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 *     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: any,\n  wagmiConfig: any\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 = { ...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: any,\n  wagmiConfig: any\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

@@ -206,14 +206,16 @@ function useHandleTransactionMutationX({ settings, }) {
  * // In your component:
  * function MyTransactionComponent() {
  *   const { writeContractAsync, isPending, errorMessage } = useContractWriteX({
- *     onSuccess: (txHash) => console.log("Transaction successful:", txHash),
- *     onError: (error) => console.error("Transaction error:", error),
  *     queriesToInvalidate: [["userBalance"], ["userActivity"]],
  *   });
  *
  *   const handleWrite = async () => {
  *     try {
- *       const txHash = await writeContractAsync({ transaction params here.. });
+ *       const txHash = await writeContractAsync({ transaction params here.. }, {
+ *          // use calbacks here in writeContractAsync or in useContractWriteX
+ *          onSuccess: (txHash) => console.log("Transaction successful:", txHash),
+ *          onError: (error) => console.error("Transaction error:", error),
+ *       });
  *       console.log("Received txHash:", txHash);
  *     } catch (err) {
  *       console.error("Failed writing transaction:", err);`
@@ -269,6 +271,7 @@ function useContractWriteX(settings) {
  * // In your component:
  * function MyTransactionComponent() {
  *   const { sendTransactionAsync, isPending, errorMessage } = useSendTransactionX({
+ *     // use calbacks here in useContractWriteX or in writeContractAsync
  *     onSuccess: (txHash) => console.log("Transaction successful:", txHash),
  *     onError: (error) => console.error("Transaction error:", error),
  *     queriesToInvalidate: [["userBalance"], ["userActivity"]],

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 *     onSuccess: (txHash) => console.log(\"Transaction successful:\", txHash),\n *     onError: (error) => console.error(\"Transaction error:\", error),\n *     queriesToInvalidate: [[\"userBalance\"], [\"userActivity\"]],\n *   });\n *\n *   const handleWrite = async () => {\n *     try {\n *       const txHash = await writeContractAsync({ transaction params here.. });\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 *     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: any,\n  wagmiConfig: any\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 = { ...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: any,\n  wagmiConfig: any\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.0.4",
+  "version": "1.0.6",
   "type": "module",
   "description": "A library providing extended hooks on top of Wagmi with additional features.",
   "main": "dist/index.cjs.js",

package/src/hooks/useContractWriteX.ts

@@ -37,14 +37,16 @@ import {
  * // In your component:
  * function MyTransactionComponent() {
  *   const { writeContractAsync, isPending, errorMessage } = useContractWriteX({
- *     onSuccess: (txHash) => console.log("Transaction successful:", txHash),
- *     onError: (error) => console.error("Transaction error:", error),
  *     queriesToInvalidate: [["userBalance"], ["userActivity"]],
  *   });
  *
  *   const handleWrite = async () => {
  *     try {
- *       const txHash = await writeContractAsync({ transaction params here.. });
+ *       const txHash = await writeContractAsync({ transaction params here.. }, {
+ *          // use calbacks here in writeContractAsync or in useContractWriteX
+ *          onSuccess: (txHash) => console.log("Transaction successful:", txHash),
+ *          onError: (error) => console.error("Transaction error:", error),
+ *       });
  *       console.log("Received txHash:", txHash);
  *     } catch (err) {
  *       console.error("Failed writing transaction:", err);`

package/src/hooks/useSendTransactionX.ts

@@ -25,6 +25,7 @@ import {
  * // In your component:
  * function MyTransactionComponent() {
  *   const { sendTransactionAsync, isPending, errorMessage } = useSendTransactionX({
+ *     // use calbacks here in useContractWriteX or in writeContractAsync
  *     onSuccess: (txHash) => console.log("Transaction successful:", txHash),
  *     onError: (error) => console.error("Transaction error:", error),
  *     queriesToInvalidate: [["userBalance"], ["userActivity"]],