@rhea-finance/cross-chain-aggregation-dex 0.1.9 → 0.2.0

package/dist/index.js

@@ -15,6 +15,76 @@ function requiresRecipientInExecute(params) {
   return "sender" in params && "receiveUser" in params;
 }
 
+// src/utils/errorMessages.ts
+var ErrorMessages = {
+  // Parameter validation errors
+  MISSING_PARAMS: "Required parameters missing",
+  MISSING_TOKEN_ADDRESS: "Token address required",
+  INVALID_TOKEN_ADDRESS: "Invalid token address",
+  MISSING_USER_ADDRESS: "User address required",
+  INVALID_USER_ADDRESS: "Invalid user address",
+  // Quote errors
+  QUOTE_FAILED: "Failed to get quote",
+  QUOTE_INVALID: "Invalid quote",
+  QUOTE_NO_ROUTE: "No route found",
+  QUOTE_EXPIRED: "Quote expired, please refresh",
+  // Execution errors
+  EXECUTE_FAILED: "Transaction failed",
+  EXECUTE_INVALID_QUOTE: "Invalid quote, please refresh",
+  EXECUTE_INSUFFICIENT_BALANCE: "Insufficient balance",
+  EXECUTE_INSUFFICIENT_LIQUIDITY: "Insufficient liquidity",
+  EXECUTE_SLIPPAGE_TOO_HIGH: "Price changed, please refresh",
+  // Network/API errors
+  NETWORK_ERROR: "Network error, please try again",
+  API_ERROR: "Service temporarily unavailable",
+  // Gas/Transaction errors
+  GAS_ESTIMATE_FAILED: "Unable to estimate transaction fee",
+  GAS_PRICE_FAILED: "Failed to get transaction fee",
+  TRANSACTION_REVERTED: "Transaction would fail, please refresh"
+};
+function getErrorMessage(error, fallback = ErrorMessages.EXECUTE_FAILED) {
+  if (!error) return fallback;
+  if (error && error.length > 0) {
+    return error;
+  }
+  return fallback;
+}
+function normalizeError(error) {
+  if (!error) return ErrorMessages.EXECUTE_FAILED;
+  const errorLower = error.toLowerCase();
+  if (errorLower.includes("missing") || errorLower.includes("required")) {
+    if (errorLower.includes("token")) return ErrorMessages.MISSING_TOKEN_ADDRESS;
+    if (errorLower.includes("address") || errorLower.includes("user") || errorLower.includes("sender") || errorLower.includes("recipient")) {
+      return ErrorMessages.MISSING_USER_ADDRESS;
+    }
+    return ErrorMessages.MISSING_PARAMS;
+  }
+  if (errorLower.includes("invalid")) {
+    if (errorLower.includes("token")) return ErrorMessages.INVALID_TOKEN_ADDRESS;
+    if (errorLower.includes("address") || errorLower.includes("user")) {
+      return ErrorMessages.INVALID_USER_ADDRESS;
+    }
+    if (errorLower.includes("quote")) return ErrorMessages.QUOTE_INVALID;
+  }
+  if (errorLower.includes("quote") && (errorLower.includes("fail") || errorLower.includes("error"))) {
+    return ErrorMessages.QUOTE_FAILED;
+  }
+  if (errorLower.includes("route") || errorLower.includes("no path")) {
+    return ErrorMessages.QUOTE_NO_ROUTE;
+  }
+  if (errorLower.includes("balance") && errorLower.includes("insufficient")) {
+    return ErrorMessages.EXECUTE_INSUFFICIENT_BALANCE;
+  }
+  if (errorLower.includes("liquidity") || errorLower.includes("slippage")) {
+    return ErrorMessages.EXECUTE_SLIPPAGE_TOO_HIGH;
+  }
+  if (errorLower.includes("gas")) {
+    if (errorLower.includes("price")) return ErrorMessages.GAS_PRICE_FAILED;
+    return ErrorMessages.GAS_ESTIMATE_FAILED;
+  }
+  return error;
+}
+
 // src/utils/logger.ts
 var LOG_LEVELS = {
   silent: 0,
@@ -155,7 +225,7 @@ function findBestEvmBluechipToken(bluechipTokens, nativeTokenAddress) {
     };
   }
   if (preferredTokens.length === 0) {
-    throw new Error("No EVM bluechip token configured");
+    throw new Error(ErrorMessages.QUOTE_FAILED);
   }
   return preferredTokens[0];
 }
@@ -336,7 +406,7 @@ var NearSmartRouter = class {
           amountOut: "0",
           minAmountOut: "0",
           routes: [],
-          error: "Missing token address"
+          error: ErrorMessages.MISSING_TOKEN_ADDRESS
         };
       }
       const normalizedTokenIn = normalizeTokenId(
@@ -356,7 +426,7 @@ var NearSmartRouter = class {
           amountOut: "0",
           minAmountOut: "0",
           routes: [],
-          error: "Invalid token address"
+          error: ErrorMessages.INVALID_TOKEN_ADDRESS
         };
       }
       const slippageBps = convertSlippageToBasisPoints(slippage);
@@ -377,7 +447,7 @@ var NearSmartRouter = class {
           amountOut: "0",
           minAmountOut: "0",
           routes: [],
-          error: response?.result_msg || response?.result_message || "No route found"
+          error: normalizeError(response?.result_msg || response?.result_message) || ErrorMessages.QUOTE_NO_ROUTE
         };
       }
       const { routes: serverRoutes, amount_out } = response.result_data;
@@ -416,7 +486,7 @@ var NearSmartRouter = class {
         amountOut: "0",
         minAmountOut: "0",
         routes: [],
-        error: error?.message || "Quote failed"
+        error: normalizeError(error?.message) || ErrorMessages.QUOTE_FAILED
       };
     }
   }
@@ -429,7 +499,7 @@ var NearSmartRouter = class {
       if (!quote.success || !quote.routes.length) {
         return {
           success: false,
-          error: "Invalid quote"
+          error: ErrorMessages.EXECUTE_INVALID_QUOTE
         };
       }
       const swapActions = [];
@@ -448,7 +518,7 @@ var NearSmartRouter = class {
       if (!swapActions.length) {
         return {
           success: false,
-          error: "No swap actions"
+          error: ErrorMessages.QUOTE_INVALID
         };
       }
       const finalRecipient = depositAddress || recipient;
@@ -549,13 +619,13 @@ var NearSmartRouter = class {
       } else {
         return {
           success: false,
-          error: result.message || "Execute swap failed"
+          error: normalizeError(result.message) || ErrorMessages.EXECUTE_FAILED
         };
       }
     } catch (error) {
       return {
         success: false,
-        error: error?.message || "Execute swap failed"
+        error: normalizeError(error?.message) || ErrorMessages.EXECUTE_FAILED
       };
     }
   }
@@ -617,7 +687,7 @@ var AggregateDexRouter = class {
           amountOut: "0",
           minAmountOut: "0",
           routes: [],
-          error: "Missing sender or recipient"
+          error: ErrorMessages.MISSING_USER_ADDRESS
         };
       }
       const { tokenIn, tokenOut, amountIn, slippage, sender, recipient } = params;
@@ -630,7 +700,7 @@ var AggregateDexRouter = class {
           amountOut: "0",
           minAmountOut: "0",
           routes: [],
-          error: "Missing sender or recipient"
+          error: ErrorMessages.MISSING_USER_ADDRESS
         };
       }
       if (!tokenIn?.address || !tokenOut?.address) {
@@ -642,7 +712,7 @@ var AggregateDexRouter = class {
           amountOut: "0",
           minAmountOut: "0",
           routes: [],
-          error: "Missing token address"
+          error: ErrorMessages.MISSING_TOKEN_ADDRESS
         };
       }
       const normalizedTokenIn = normalizeTokenId(
@@ -662,7 +732,7 @@ var AggregateDexRouter = class {
           amountOut: "0",
           minAmountOut: "0",
           routes: [],
-          error: "Invalid token address"
+          error: ErrorMessages.INVALID_TOKEN_ADDRESS
         };
       }
       const slippageBps = convertSlippageToBasisPoints(slippage);
@@ -685,7 +755,7 @@ var AggregateDexRouter = class {
           amountOut: "0",
           minAmountOut: "0",
           routes: [],
-          error: "Failed to get quote"
+          error: ErrorMessages.QUOTE_FAILED
         };
       }
       const {
@@ -721,7 +791,7 @@ var AggregateDexRouter = class {
         amountOut: "0",
         minAmountOut: "0",
         routes: [],
-        error: "Failed to get quote"
+        error: normalizeError(error?.message) || ErrorMessages.QUOTE_FAILED
       };
     }
   }
@@ -730,7 +800,7 @@ var AggregateDexRouter = class {
    */
   async finalizeQuote(params, depositAddress) {
     if (!requiresRecipient(params)) {
-      throw new Error("V2 Router requires recipient parameters");
+      throw new Error(ErrorMessages.MISSING_USER_ADDRESS);
     }
     return await this.quote({
       ...params,
@@ -747,7 +817,7 @@ var AggregateDexRouter = class {
     if (adjustedQuote.success && adjustedQuote.routerMsg && adjustedQuote.signature) {
       return adjustedQuote;
     } else {
-      throw new Error("Failed to get quote");
+      throw new Error(ErrorMessages.QUOTE_FAILED);
     }
   }
   async ensureQuoteAmountWithinBalance(quoteParams, actualBalance, context) {
@@ -779,7 +849,7 @@ var AggregateDexRouter = class {
     }
     const quote = await this.quote(quoteParams);
     if (!quote.success) {
-      throw new Error("Failed to get quote");
+      throw new Error(ErrorMessages.QUOTE_FAILED);
     }
     if (quote.amountIn !== quoteParams.amountIn) {
       const apiAmountBig = new Big3__default.default(quote.amountIn);
@@ -802,26 +872,26 @@ var AggregateDexRouter = class {
       if (!requiresRecipientInExecute(params)) {
         return {
           success: false,
-          error: "Missing sender or receiveUser"
+          error: ErrorMessages.MISSING_USER_ADDRESS
         };
       }
       const { quote, sender, receiveUser } = params;
       if (!quote.success) {
         return {
           success: false,
-          error: "Invalid quote"
+          error: ErrorMessages.EXECUTE_INVALID_QUOTE
         };
       }
       if (!receiveUser || receiveUser.trim() === "") {
         return {
           success: false,
-          error: "Missing receiveUser"
+          error: ErrorMessages.MISSING_USER_ADDRESS
         };
       }
       if (receiveUser.startsWith("0x") && receiveUser.length === 42) {
         return {
           success: false,
-          error: "Invalid receiveUser address"
+          error: ErrorMessages.INVALID_USER_ADDRESS
         };
       }
       const slippage = quote.slippage || 5e-3;
@@ -853,7 +923,7 @@ var AggregateDexRouter = class {
       } catch (error) {
         return {
           success: false,
-          error: "Failed to get quote"
+          error: normalizeError(error?.message) || ErrorMessages.QUOTE_FAILED
         };
       }
       const routerMsg = finalQuote.routerMsg;
@@ -861,7 +931,7 @@ var AggregateDexRouter = class {
       if (!routerMsg || !signature) {
         return {
           success: false,
-          error: "Failed to get quote"
+          error: ErrorMessages.QUOTE_FAILED
         };
       }
       const tokens = finalQuote.tokens || [];
@@ -1056,7 +1126,7 @@ var AggregateDexRouter = class {
       } catch (error) {
         return {
           success: false,
-          error: "Failed to get quote"
+          error: normalizeError(error?.message) || ErrorMessages.QUOTE_FAILED
         };
       }
       const finalAmountToTransfer = finalQuoteForExecution.amountIn;
@@ -1087,13 +1157,13 @@ var AggregateDexRouter = class {
       } else {
         return {
           success: false,
-          error: "Execute swap failed"
+          error: normalizeError(result.message) || ErrorMessages.EXECUTE_FAILED
         };
       }
     } catch (error) {
       return {
         success: false,
-        error: "Execute swap failed"
+        error: normalizeError(error?.message) || ErrorMessages.EXECUTE_FAILED
       };
     }
   }
@@ -1320,7 +1390,7 @@ var BitgetRouter = class {
           amountOut: "0",
           minAmountOut: "0",
           routes: [],
-          error: "Missing sender or recipient"
+          error: ErrorMessages.MISSING_USER_ADDRESS
         };
       }
       const { tokenIn, tokenOut, amountIn, slippage, sender, recipient } = params;
@@ -1333,7 +1403,7 @@ var BitgetRouter = class {
           amountOut: "0",
           minAmountOut: "0",
           routes: [],
-          error: "Missing sender or recipient"
+          error: ErrorMessages.MISSING_USER_ADDRESS
         };
       }
       if (tokenIn?.address === void 0 || tokenOut?.address === void 0) {
@@ -1345,7 +1415,7 @@ var BitgetRouter = class {
           amountOut: "0",
           minAmountOut: "0",
           routes: [],
-          error: "Missing token address"
+          error: ErrorMessages.MISSING_TOKEN_ADDRESS
         };
       }
       const normalizedTokenIn = tokenIn.address === "" ? "" : this.normalizeEvmAddress(tokenIn.address);
@@ -1367,7 +1437,7 @@ var BitgetRouter = class {
       if (!isBitgetResponseSuccess(response) || !response.data) {
         return createQuoteError(
           params,
-          response.msg || "Failed to get quote"
+          normalizeError(response.msg) || ErrorMessages.QUOTE_FAILED
         );
       }
       const {
@@ -1433,21 +1503,21 @@ var BitgetRouter = class {
     } catch (error) {
       return createQuoteError(
         params,
-        error?.message || "Failed to get quote"
+        normalizeError(error?.message) || ErrorMessages.QUOTE_FAILED
       );
     }
   }
   async executeSwap(params) {
     try {
       if (!requiresRecipientInExecute(params)) {
-        return createExecuteError("Missing sender or receiveUser");
+        return createExecuteError(ErrorMessages.MISSING_USER_ADDRESS);
       }
       const { quote, sender, receiveUser } = params;
       if (!quote.success) {
-        return createExecuteError("Invalid quote");
+        return createExecuteError(ErrorMessages.EXECUTE_INVALID_QUOTE);
       }
       if (!receiveUser || receiveUser.trim() === "") {
-        return createExecuteError("Missing receiveUser");
+        return createExecuteError(ErrorMessages.MISSING_USER_ADDRESS);
       }
       let market;
       try {
@@ -1455,13 +1525,13 @@ var BitgetRouter = class {
           const routerMsg = JSON.parse(quote.routerMsg);
           market = routerMsg.market || "";
         } else {
-          return createExecuteError("Missing market from quote, please re-fetch quote");
+          return createExecuteError(ErrorMessages.QUOTE_EXPIRED);
         }
       } catch (error) {
-        return createExecuteError("Invalid quote format: missing market");
+        return createExecuteError(ErrorMessages.QUOTE_INVALID);
       }
       if (!market) {
-        return createExecuteError("Missing market from quote response");
+        return createExecuteError(ErrorMessages.QUOTE_INVALID);
       }
       const normalizedTokenIn = this.normalizeEvmAddress(
         quote.tokenIn.address
@@ -1485,7 +1555,7 @@ var BitgetRouter = class {
       });
       if (!isBitgetResponseSuccess(reQuoteResponse) || !reQuoteResponse.data) {
         return createExecuteError(
-          `Re-quote failed: ${reQuoteResponse.msg || "Please refresh quote and try again"}`
+          normalizeError(reQuoteResponse.msg) || ErrorMessages.QUOTE_EXPIRED
         );
       }
       market = reQuoteResponse.data?.market || market;
@@ -1505,13 +1575,11 @@ var BitgetRouter = class {
       });
       if (!isBitgetResponseSuccess(swapResponse) || !swapResponse.data) {
         return createExecuteError(
-          swapResponse.msg || "Failed to get swap calldata"
+          normalizeError(swapResponse.msg) || ErrorMessages.QUOTE_FAILED
         );
       }
       if (swapResponse.data?.estimateRevert === true) {
-        return createExecuteError(
-          "Transaction will fail on-chain (slippage too high or price changed). Please refresh quote."
-        );
+        return createExecuteError(ErrorMessages.EXECUTE_SLIPPAGE_TOO_HIGH);
       }
       let transactionData = swapResponse.data?.calldata || swapResponse.data?.data;
       const to = swapResponse.data?.contract || swapResponse.data?.to;
@@ -1525,14 +1593,14 @@ var BitgetRouter = class {
       }
       const gas = swapResponse.data?.gas || (swapResponse.data?.computeUnits !== void 0 ? String(swapResponse.data.computeUnits) : void 0);
       if (!to || !transactionData) {
-        return createExecuteError("Invalid swap response: missing to or data");
+        return createExecuteError(ErrorMessages.QUOTE_INVALID);
       }
       if (transactionData.length < 10 || !/^0x[0-9a-fA-F]+$/.test(transactionData)) {
-        return createExecuteError("Invalid calldata format: must be hex string starting with 0x");
+        return createExecuteError(ErrorMessages.QUOTE_INVALID);
       }
       if (normalizedTokenIn && normalizedTokenIn !== "") {
         if (!this.evmChainAdapter.getBalance) {
-          return createExecuteError("getBalance method not available on evmChainAdapter");
+          return createExecuteError(ErrorMessages.NETWORK_ERROR);
         }
         const tokenBalanceFormatted = await this.evmChainAdapter.getBalance({
           address: sender,
@@ -1542,9 +1610,7 @@ var BitgetRouter = class {
         const balanceBN = ethers.ethers.utils.parseUnits(tokenBalanceFormatted || "0", tokenDecimals);
         const amountInBN = ethers.ethers.BigNumber.from(quote.amountIn);
         if (balanceBN.lt(amountInBN)) {
-          return createExecuteError(
-            `Insufficient token balance: have ${tokenBalanceFormatted}, need ${ethers.ethers.utils.formatUnits(amountInBN, tokenDecimals)}`
-          );
+          return createExecuteError(ErrorMessages.EXECUTE_INSUFFICIENT_BALANCE);
         }
         const currentAllowance = await this.evmChainAdapter.getAllowance({
           tokenAddress: normalizedTokenIn,
@@ -1554,7 +1620,7 @@ var BitgetRouter = class {
         const allowanceBN = ethers.ethers.BigNumber.from(currentAllowance);
         if (allowanceBN.lt(amountInBN)) {
           try {
-            const approveResult = await this.evmChainAdapter.approve({
+            await this.evmChainAdapter.approve({
               tokenAddress: normalizedTokenIn,
               spender: to,
               amount: ethers.ethers.constants.MaxUint256.toString()
@@ -1577,19 +1643,17 @@ var BitgetRouter = class {
               retryCount++;
             }
             if (newAllowanceBN.lt(amountInBN)) {
-              return createExecuteError(
-                `Token approval insufficient after ${MAX_APPROVAL_RETRIES} retries. Approval tx: ${approveResult.txHash}`
-              );
+              return createExecuteError(ErrorMessages.NETWORK_ERROR);
             }
           } catch (error) {
             return createExecuteError(
-              `Token approval failed: ${error?.message || "Unknown error"}`
+              normalizeError(error?.message) || ErrorMessages.NETWORK_ERROR
             );
           }
         }
       } else {
         if (!this.evmChainAdapter.getBalance) {
-          return createExecuteError("getBalance method not available on evmChainAdapter");
+          return createExecuteError(ErrorMessages.NETWORK_ERROR);
         }
         const nativeBalanceFormatted = await this.evmChainAdapter.getBalance({
           address: sender,
@@ -1613,9 +1677,7 @@ var BitgetRouter = class {
         const gasCostEstimate = estimatedGasLimitForBalance.mul(gasPriceEstimate2);
         const totalRequired = amountInBN.add(gasCostEstimate);
         if (balanceBN.lt(totalRequired)) {
-          return createExecuteError(
-            `Insufficient native token balance: have ${nativeBalanceFormatted} ETH, need ${ethers.ethers.utils.formatEther(totalRequired)} ETH`
-          );
+          return createExecuteError(ErrorMessages.EXECUTE_INSUFFICIENT_BALANCE);
         }
       }
       if (normalizedTokenIn && normalizedTokenIn !== "") {
@@ -1627,9 +1689,7 @@ var BitgetRouter = class {
         const finalAllowanceBN = ethers.ethers.BigNumber.from(finalAllowanceCheck);
         const amountInBN = ethers.ethers.BigNumber.from(quote.amountIn);
         if (finalAllowanceBN.lt(amountInBN)) {
-          return createExecuteError(
-            `Insufficient allowance: current ${finalAllowanceBN.toString()}, required ${amountInBN.toString()}`
-          );
+          return createExecuteError(ErrorMessages.NETWORK_ERROR);
         }
       }
       const [estimatedGasLimit, hasReliableEstimate, rpcEstimateError] = await estimateGasLimit(
@@ -1650,14 +1710,10 @@ var BitgetRouter = class {
             tokenOut: quote.tokenOut.symbol,
             rpcError: rpcEstimateError
           });
-          return createExecuteError(
-            "Insufficient liquidity, transaction may fail. Please refresh quote and try again."
-          );
+          return createExecuteError(ErrorMessages.EXECUTE_INSUFFICIENT_LIQUIDITY);
         }
         if (!gas || gas === "0") {
-          return createExecuteError(
-            "Unable to estimate gas fee, possibly due to insufficient liquidity. Please refresh quote and try again."
-          );
+          return createExecuteError(ErrorMessages.GAS_ESTIMATE_FAILED);
         }
         logger.warn("RPC gas estimation failed, using Bitget estimate", {
           chainId: this.chainId,
@@ -1690,7 +1746,7 @@ var BitgetRouter = class {
         if (!feeData.maxFeePerGas || !feeData.maxPriorityFeePerGas || feeData.maxFeePerGas.lte(0) || feeData.maxPriorityFeePerGas.lte(0)) {
           const cachedGasPrice = await getCachedGasPrice();
           if (!cachedGasPrice || cachedGasPrice.lte(0)) {
-            return createExecuteError("Failed to get valid gas price. Please try again.");
+            return createExecuteError(ErrorMessages.GAS_PRICE_FAILED);
           }
           feeData.maxFeePerGas = cachedGasPrice;
           feeData.maxPriorityFeePerGas = cachedGasPrice.div(10);
@@ -1723,27 +1779,27 @@ var BitgetRouter = class {
         } catch (error) {
           const cachedGasPrice = await getCachedGasPrice();
           if (!cachedGasPrice || cachedGasPrice.lte(0)) {
-            return createExecuteError("Failed to get valid gas price. Please try again.");
+            return createExecuteError(ErrorMessages.GAS_PRICE_FAILED);
           }
           feeData.gasPrice = cachedGasPrice;
         }
       }
       if (!to || !ethers.ethers.utils.isAddress(to)) {
-        return createExecuteError(`Invalid contract address: ${to}`);
+        return createExecuteError(ErrorMessages.QUOTE_INVALID);
       }
       if (!transactionData || transactionData.length < 10) {
-        return createExecuteError(`Invalid calldata: length ${transactionData?.length || 0}`);
+        return createExecuteError(ErrorMessages.QUOTE_INVALID);
       }
       if (!estimatedGasLimit || estimatedGasLimit.lte(0)) {
-        return createExecuteError("Invalid gas limit estimate. Please refresh quote and try again.");
+        return createExecuteError(ErrorMessages.GAS_ESTIMATE_FAILED);
       }
       if (supportsEip1559) {
         if (!feeData.maxFeePerGas || !feeData.maxPriorityFeePerGas || feeData.maxFeePerGas.lte(0) || feeData.maxPriorityFeePerGas.lte(0)) {
-          return createExecuteError("Invalid gas fee data. Please try again.");
+          return createExecuteError(ErrorMessages.GAS_PRICE_FAILED);
         }
       } else {
         if (!feeData.gasPrice || feeData.gasPrice.lte(0)) {
-          return createExecuteError("Invalid gas price. Please try again.");
+          return createExecuteError(ErrorMessages.GAS_PRICE_FAILED);
         }
       }
       const txParams = {
@@ -1767,10 +1823,10 @@ var BitgetRouter = class {
           txHashArray: result.txHash ? [result.txHash] : []
         };
       } else {
-        return createExecuteError(result.message || "Execute swap failed");
+        return createExecuteError(normalizeError(result.message) || ErrorMessages.EXECUTE_FAILED);
       }
     } catch (error) {
-      return createExecuteError(error?.message || "Execute swap failed");
+      return createExecuteError(normalizeError(error?.message) || ErrorMessages.EXECUTE_FAILED);
     }
   }
   normalizeEvmAddress(address) {
@@ -1811,13 +1867,13 @@ async function completeQuote(params, config) {
   const routers = dexRouters || (dexRouter ? [dexRouter] : []);
   const userAddress = currentUserAddress || recipient;
   if (!userAddress) {
-    throw new Error("currentUserAddress or recipient is required for routers that require recipient");
+    throw new Error(ErrorMessages.MISSING_USER_ADDRESS);
   }
   if (sourceToken?.address === void 0) {
-    throw new Error("Source token address is required");
+    throw new Error(ErrorMessages.MISSING_TOKEN_ADDRESS);
   }
   if (targetToken?.address === void 0) {
-    throw new Error("Target token address is required");
+    throw new Error(ErrorMessages.MISSING_TOKEN_ADDRESS);
   }
   const isEvmChain = evmChainId !== void 0 || sourceChain === "evm" || sourceChain === "ethereum" || sourceChain === "bsc" || sourceChain === "polygon" || sourceChain === "base" || sourceChain === "monad" || sourceToken.chain === "evm";
   const isTokenIntentsSupported = customIsIntentsSupportedToken ? customIsIntentsSupportedToken(sourceToken) : isEvmChain ? isEvmIntentsSupportedToken(sourceToken, bluechipTokens) : isNearIntentsSupportedToken(sourceToken, bluechipTokens);
@@ -1826,7 +1882,7 @@ async function completeQuote(params, config) {
     configAdapter.getEvmNativeWrappedTokenAddress?.()
   ) : findBestBluechipToken(bluechipTokens, wrapNearContractId);
   if (!bluechipToken?.address) {
-    throw new Error("Failed to find bluechip token address");
+    throw new Error(ErrorMessages.QUOTE_FAILED);
   }
   const quotePaths = [];
   routers.forEach((router, index) => {
@@ -1860,7 +1916,7 @@ async function completeQuote(params, config) {
       promise: (async () => {
         const preSwapQuote = await router.quote(quoteParams);
         if (!preSwapQuote.success) {
-          throw new Error(`Pre-swap quote failed: ${preSwapQuote.error || "Unknown error"}`);
+          throw new Error(ErrorMessages.QUOTE_FAILED);
         }
         let normalizedSourceAsset;
         if (isEvmChain) {
@@ -1888,11 +1944,11 @@ async function completeQuote(params, config) {
           try {
             const amountBN = new Big3__default.default(preSwapQuote.amountOut);
             if (amountBN.lte(0)) {
-              throw new Error(`Invalid amountOut: ${preSwapQuote.amountOut}`);
+              throw new Error(ErrorMessages.QUOTE_INVALID);
             }
             formattedAmountOut = amountBN.toFixed(0, Big3__default.default.roundDown);
           } catch (error) {
-            throw new Error(`Failed to process amountOut: ${error?.message || String(error)}`);
+            throw new Error(ErrorMessages.QUOTE_FAILED);
           }
         }
         try {
@@ -1908,7 +1964,7 @@ async function completeQuote(params, config) {
             ...appFees ? { appFees } : {}
           });
           if (intentsQuote.quoteStatus !== "success") {
-            throw new Error(`Intents quote failed: ${intentsQuote.message || "Unknown error"}`);
+            throw new Error(ErrorMessages.QUOTE_FAILED);
           }
           return {
             intentsQuote,
@@ -1971,7 +2027,7 @@ async function completeQuote(params, config) {
           ...customRecipientMsg ? { customRecipientMsg } : {}
         });
         if (intentsQuote.quoteStatus !== "success") {
-          throw new Error("Failed to get quote");
+          throw new Error(ErrorMessages.QUOTE_FAILED);
         }
         return {
           intentsQuote,
@@ -1994,7 +2050,7 @@ async function completeQuote(params, config) {
     }
   });
   if (validPaths.length === 0) {
-    throw new Error("Failed to get quote");
+    throw new Error(ErrorMessages.QUOTE_FAILED);
   }
   const bestPath = validPaths.reduce((best, current) => {
     const bestAmount = new Big3__default.default(best.finalAmountOut);
@@ -2003,7 +2059,7 @@ async function completeQuote(params, config) {
   });
   const depositAddress = bestPath.intentsQuote.quoteSuccessResult?.quote?.depositAddress || "";
   if (!depositAddress) {
-    throw new Error("Deposit address not found in intents quote");
+    throw new Error(ErrorMessages.QUOTE_INVALID);
   }
   return {
     intents: {
@@ -2070,13 +2126,15 @@ async function quoteSameChainSwap(params, dexRouters) {
       }
       return null;
     }).filter(Boolean);
-    throw new Error(`All router quotes failed: ${errors.join("; ")}`);
+    const errorMessage = errors.length > 0 ? `${ErrorMessages.QUOTE_FAILED}: ${errors.join("; ")}` : ErrorMessages.QUOTE_FAILED;
+    throw new Error(errorMessage);
   }
   return selectBestQuote(validQuotes);
 }
 
 exports.AggregateDexRouter = AggregateDexRouter;
 exports.BitgetRouter = BitgetRouter;
+exports.ErrorMessages = ErrorMessages;
 exports.NearSmartRouter = NearSmartRouter;
 exports.completeQuote = completeQuote;
 exports.convertSlippageToBasisPoints = convertSlippageToBasisPoints;
@@ -2085,10 +2143,12 @@ exports.findBestEvmBluechipToken = findBestEvmBluechipToken;
 exports.formatGasString = formatGasString;
 exports.formatGasToTgas = formatGasToTgas;
 exports.getBluechipTokensConfig = getBluechipTokensConfig;
+exports.getErrorMessage = getErrorMessage;
 exports.isEvmIntentsSupportedToken = isEvmIntentsSupportedToken;
 exports.isNearIntentsSupportedToken = isNearIntentsSupportedToken;
 exports.logger = logger;
 exports.normalizeDestinationAsset = normalizeDestinationAsset;
+exports.normalizeError = normalizeError;
 exports.normalizeEvmAddress = normalizeEvmAddress;
 exports.normalizeTokenId = normalizeTokenId;
 exports.quoteSameChainSwap = quoteSameChainSwap;