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

package/dist/index.d.mts

@@ -433,6 +433,41 @@ declare const logger: {
     error: (...args: any[]) => void;
 };
 
+/**
+ * Unified error messages for the SDK
+ * All error messages should be defined here for consistency
+ */
+declare const ErrorMessages: {
+    readonly MISSING_PARAMS: "Required parameters missing";
+    readonly MISSING_TOKEN_ADDRESS: "Token address required";
+    readonly INVALID_TOKEN_ADDRESS: "Invalid token address";
+    readonly MISSING_USER_ADDRESS: "User address required";
+    readonly INVALID_USER_ADDRESS: "Invalid user address";
+    readonly QUOTE_FAILED: "Failed to get quote";
+    readonly QUOTE_INVALID: "Invalid quote";
+    readonly QUOTE_NO_ROUTE: "No route found";
+    readonly QUOTE_EXPIRED: "Quote expired, please refresh";
+    readonly EXECUTE_FAILED: "Transaction failed";
+    readonly EXECUTE_INVALID_QUOTE: "Invalid quote, please refresh";
+    readonly EXECUTE_INSUFFICIENT_BALANCE: "Insufficient balance";
+    readonly EXECUTE_INSUFFICIENT_LIQUIDITY: "Insufficient liquidity";
+    readonly EXECUTE_SLIPPAGE_TOO_HIGH: "Price changed, please refresh";
+    readonly NETWORK_ERROR: "Network error, please try again";
+    readonly API_ERROR: "Service temporarily unavailable";
+    readonly GAS_ESTIMATE_FAILED: "Unable to estimate transaction fee";
+    readonly GAS_PRICE_FAILED: "Failed to get transaction fee";
+    readonly TRANSACTION_REVERTED: "Transaction would fail, please refresh";
+};
+/**
+ * Get user-friendly error message
+ * Prioritizes API error messages, falls back to standardized messages
+ */
+declare function getErrorMessage(error: string | undefined | null, fallback?: string): string;
+/**
+ * Normalize common error patterns
+ */
+declare function normalizeError(error: string | undefined | null): string;
+
 /** Set the SDK-wide bluechip token config used for NearIntents compatibility and intermediate routing. */
 declare function setBluechipTokensConfig(config: BluechipTokensConfig): void;
 /** Get the bluechip token config; returns an empty object if unset. */
@@ -664,4 +699,4 @@ interface QuoteSameChainSwapResult {
  */
 declare function quoteSameChainSwap(params: QuoteSameChainSwapParams, dexRouters: DexRouter[]): Promise<QuoteSameChainSwapResult>;
 
-export { AggregateDexRouter, type AggregateDexRouterConfig, type BaseExecuteParams, type BaseQuoteParams, type BitgetAdapter, type BitgetQuoteResponse, BitgetRouter, type BitgetRouterConfig, type BitgetSwapResponse, type BluechipTokenConfig, type BluechipTokensConfig, type CompleteQuoteConfig, type CompleteQuoteParams, type CompleteQuoteResult, type ConfigAdapter, type DexRouter, type EvmChainAdapter, type ExecuteParams, type ExecuteResult, type FindPathAdapter, type FindPathResponse, type IntentsQuotationAdapter, type IntentsQuoteResult, type NearChainAdapter, NearSmartRouter, type NearSmartRouterConfig, type PoolInfo, type QuoteParams, type QuoteResult, type QuoteSameChainSwapParams, type QuoteSameChainSwapResult, type RecipientExecuteParams, type RecipientQuoteParams, type Route, type RouterCapabilities, type SimpleQuoteParams, type SupportedChain, type SwapMultiDexPathAdapter, type SwapMultiDexPathResponse, type TokenInfo, completeQuote, convertSlippageToBasisPoints, findBestBluechipToken, findBestEvmBluechipToken, formatGasString, formatGasToTgas, getBluechipTokensConfig, isEvmIntentsSupportedToken, isNearIntentsSupportedToken, logger, normalizeDestinationAsset, normalizeEvmAddress, normalizeTokenId, quoteSameChainSwap, requiresRecipient, requiresRecipientInExecute, selectBestQuote, setBluechipTokensConfig };
+export { AggregateDexRouter, type AggregateDexRouterConfig, type BaseExecuteParams, type BaseQuoteParams, type BitgetAdapter, type BitgetQuoteResponse, BitgetRouter, type BitgetRouterConfig, type BitgetSwapResponse, type BluechipTokenConfig, type BluechipTokensConfig, type CompleteQuoteConfig, type CompleteQuoteParams, type CompleteQuoteResult, type ConfigAdapter, type DexRouter, ErrorMessages, type EvmChainAdapter, type ExecuteParams, type ExecuteResult, type FindPathAdapter, type FindPathResponse, type IntentsQuotationAdapter, type IntentsQuoteResult, type NearChainAdapter, NearSmartRouter, type NearSmartRouterConfig, type PoolInfo, type QuoteParams, type QuoteResult, type QuoteSameChainSwapParams, type QuoteSameChainSwapResult, type RecipientExecuteParams, type RecipientQuoteParams, type Route, type RouterCapabilities, type SimpleQuoteParams, type SupportedChain, type SwapMultiDexPathAdapter, type SwapMultiDexPathResponse, type TokenInfo, completeQuote, convertSlippageToBasisPoints, findBestBluechipToken, findBestEvmBluechipToken, formatGasString, formatGasToTgas, getBluechipTokensConfig, getErrorMessage, isEvmIntentsSupportedToken, isNearIntentsSupportedToken, logger, normalizeDestinationAsset, normalizeError, normalizeEvmAddress, normalizeTokenId, quoteSameChainSwap, requiresRecipient, requiresRecipientInExecute, selectBestQuote, setBluechipTokensConfig };

package/dist/index.d.ts

@@ -433,6 +433,41 @@ declare const logger: {
     error: (...args: any[]) => void;
 };
 
+/**
+ * Unified error messages for the SDK
+ * All error messages should be defined here for consistency
+ */
+declare const ErrorMessages: {
+    readonly MISSING_PARAMS: "Required parameters missing";
+    readonly MISSING_TOKEN_ADDRESS: "Token address required";
+    readonly INVALID_TOKEN_ADDRESS: "Invalid token address";
+    readonly MISSING_USER_ADDRESS: "User address required";
+    readonly INVALID_USER_ADDRESS: "Invalid user address";
+    readonly QUOTE_FAILED: "Failed to get quote";
+    readonly QUOTE_INVALID: "Invalid quote";
+    readonly QUOTE_NO_ROUTE: "No route found";
+    readonly QUOTE_EXPIRED: "Quote expired, please refresh";
+    readonly EXECUTE_FAILED: "Transaction failed";
+    readonly EXECUTE_INVALID_QUOTE: "Invalid quote, please refresh";
+    readonly EXECUTE_INSUFFICIENT_BALANCE: "Insufficient balance";
+    readonly EXECUTE_INSUFFICIENT_LIQUIDITY: "Insufficient liquidity";
+    readonly EXECUTE_SLIPPAGE_TOO_HIGH: "Price changed, please refresh";
+    readonly NETWORK_ERROR: "Network error, please try again";
+    readonly API_ERROR: "Service temporarily unavailable";
+    readonly GAS_ESTIMATE_FAILED: "Unable to estimate transaction fee";
+    readonly GAS_PRICE_FAILED: "Failed to get transaction fee";
+    readonly TRANSACTION_REVERTED: "Transaction would fail, please refresh";
+};
+/**
+ * Get user-friendly error message
+ * Prioritizes API error messages, falls back to standardized messages
+ */
+declare function getErrorMessage(error: string | undefined | null, fallback?: string): string;
+/**
+ * Normalize common error patterns
+ */
+declare function normalizeError(error: string | undefined | null): string;
+
 /** Set the SDK-wide bluechip token config used for NearIntents compatibility and intermediate routing. */
 declare function setBluechipTokensConfig(config: BluechipTokensConfig): void;
 /** Get the bluechip token config; returns an empty object if unset. */
@@ -664,4 +699,4 @@ interface QuoteSameChainSwapResult {
  */
 declare function quoteSameChainSwap(params: QuoteSameChainSwapParams, dexRouters: DexRouter[]): Promise<QuoteSameChainSwapResult>;
 
-export { AggregateDexRouter, type AggregateDexRouterConfig, type BaseExecuteParams, type BaseQuoteParams, type BitgetAdapter, type BitgetQuoteResponse, BitgetRouter, type BitgetRouterConfig, type BitgetSwapResponse, type BluechipTokenConfig, type BluechipTokensConfig, type CompleteQuoteConfig, type CompleteQuoteParams, type CompleteQuoteResult, type ConfigAdapter, type DexRouter, type EvmChainAdapter, type ExecuteParams, type ExecuteResult, type FindPathAdapter, type FindPathResponse, type IntentsQuotationAdapter, type IntentsQuoteResult, type NearChainAdapter, NearSmartRouter, type NearSmartRouterConfig, type PoolInfo, type QuoteParams, type QuoteResult, type QuoteSameChainSwapParams, type QuoteSameChainSwapResult, type RecipientExecuteParams, type RecipientQuoteParams, type Route, type RouterCapabilities, type SimpleQuoteParams, type SupportedChain, type SwapMultiDexPathAdapter, type SwapMultiDexPathResponse, type TokenInfo, completeQuote, convertSlippageToBasisPoints, findBestBluechipToken, findBestEvmBluechipToken, formatGasString, formatGasToTgas, getBluechipTokensConfig, isEvmIntentsSupportedToken, isNearIntentsSupportedToken, logger, normalizeDestinationAsset, normalizeEvmAddress, normalizeTokenId, quoteSameChainSwap, requiresRecipient, requiresRecipientInExecute, selectBestQuote, setBluechipTokensConfig };
+export { AggregateDexRouter, type AggregateDexRouterConfig, type BaseExecuteParams, type BaseQuoteParams, type BitgetAdapter, type BitgetQuoteResponse, BitgetRouter, type BitgetRouterConfig, type BitgetSwapResponse, type BluechipTokenConfig, type BluechipTokensConfig, type CompleteQuoteConfig, type CompleteQuoteParams, type CompleteQuoteResult, type ConfigAdapter, type DexRouter, ErrorMessages, type EvmChainAdapter, type ExecuteParams, type ExecuteResult, type FindPathAdapter, type FindPathResponse, type IntentsQuotationAdapter, type IntentsQuoteResult, type NearChainAdapter, NearSmartRouter, type NearSmartRouterConfig, type PoolInfo, type QuoteParams, type QuoteResult, type QuoteSameChainSwapParams, type QuoteSameChainSwapResult, type RecipientExecuteParams, type RecipientQuoteParams, type Route, type RouterCapabilities, type SimpleQuoteParams, type SupportedChain, type SwapMultiDexPathAdapter, type SwapMultiDexPathResponse, type TokenInfo, completeQuote, convertSlippageToBasisPoints, findBestBluechipToken, findBestEvmBluechipToken, formatGasString, formatGasToTgas, getBluechipTokensConfig, getErrorMessage, isEvmIntentsSupportedToken, isNearIntentsSupportedToken, logger, normalizeDestinationAsset, normalizeError, normalizeEvmAddress, normalizeTokenId, quoteSameChainSwap, requiresRecipient, requiresRecipientInExecute, selectBestQuote, setBluechipTokensConfig };