@rhea-finance/cross-chain-aggregation-dex 0.1.2 → 0.1.4

package/dist/index.d.mts

@@ -298,7 +298,7 @@ declare const logger: {
 
 /** 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 (and warns) if unset. */
+/** Get the bluechip token config; returns an empty object if unset. */
 declare function getBluechipTokensConfig(): BluechipTokensConfig;
 /**
  * Normalize a NEAR asset id:
@@ -332,6 +332,18 @@ declare function formatGasToTgas(gasInYoctoNEAR: string | number): string;
  * @returns Formatted gas string in yoctoNEAR
  */
 declare function formatGasString(gas: string | number | bigint): string;
+/**
+ * Select the best quote from multiple quotes based on maximum amountOut
+ */
+declare function selectBestQuote<T extends {
+    amountOut: string;
+}, R = any>(quotes: Array<{
+    quote: T;
+    router: R;
+}>): {
+    quote: T;
+    router: R;
+};
 
 /** NEAR DEX router implementation (FindPath for routing + REF for execution). */
 
@@ -416,6 +428,7 @@ interface CompleteQuoteParams {
     slippage: number;
     recipient: string;
     refundTo?: string;
+    customRecipientMsg?: string;
 }
 interface CompleteQuoteResult {
     intents: {
@@ -428,10 +441,12 @@ interface CompleteQuoteResult {
         tokenIn: TokenInfo;
         tokenOut: TokenInfo;
         executor: DexRouter;
+        routeType?: "v1" | "v2";
     };
     finalAmountOut: string;
     totalPriceImpact?: number;
     totalFee?: number;
+    routeType?: "v1" | "v2" | "intents";
 }
 interface CompleteQuoteConfig {
     intentsQuotationAdapter: IntentsQuotationAdapter;
@@ -442,6 +457,8 @@ interface CompleteQuoteConfig {
         getWrapNearContractId(): string;
     };
     currentUserAddress?: string;
+    /** Optional function to check if token supports Intents (beyond bluechip tokens) */
+    isIntentsSupportedToken?: (token: TokenInfo) => boolean;
 }
 /**
  * Build a "complete quote":
@@ -454,4 +471,27 @@ interface CompleteQuoteConfig {
  */
 declare function completeQuote(params: CompleteQuoteParams, config: CompleteQuoteConfig): Promise<CompleteQuoteResult>;
 
-export { AggregateDexRouter, type AggregateDexRouterConfig, type BaseExecuteParams, type BaseQuoteParams, type BluechipTokenConfig, type BluechipTokensConfig, type CompleteQuoteConfig, type CompleteQuoteParams, type CompleteQuoteResult, type ConfigAdapter, type DexRouter, type ExecuteParams, type ExecuteResult, type FindPathAdapter, type FindPathResponse, type IntentsQuotationAdapter, type IntentsQuoteResult, type NearChainAdapter, NearSmartRouter, type NearSmartRouterConfig, type PoolInfo, type QuoteParams, type QuoteResult, type RecipientExecuteParams, type RecipientQuoteParams, type Route, type RouterCapabilities, type SimpleQuoteParams, type SupportedChain, type SwapMultiDexPathAdapter, type SwapMultiDexPathResponse, type TokenInfo, completeQuote, convertSlippageToBasisPoints, findBestBluechipToken, formatGasString, formatGasToTgas, getBluechipTokensConfig, isNearIntentsSupportedToken, logger, normalizeDestinationAsset, normalizeTokenId, requiresRecipient, requiresRecipientInExecute, setBluechipTokensConfig };
+/**
+ * Same-chain swap quote (NEAR -> NEAR)
+ * Queries V1 and V2 routers in parallel and selects the best route based on maximum amountOut
+ */
+
+interface QuoteSameChainSwapParams {
+    tokenIn: TokenInfo;
+    tokenOut: TokenInfo;
+    amountIn: string;
+    slippage: number;
+    recipient: string;
+    currentUserAddress: string;
+}
+interface QuoteSameChainSwapResult {
+    quote: QuoteResult;
+    router: DexRouter;
+}
+/**
+ * Quote same-chain swap (NEAR -> NEAR) by querying V1 and V2 routers in parallel
+ * and selecting the best route based on maximum amountOut
+ */
+declare function quoteSameChainSwap(params: QuoteSameChainSwapParams, dexRouters: DexRouter[]): Promise<QuoteSameChainSwapResult>;
+
+export { AggregateDexRouter, type AggregateDexRouterConfig, type BaseExecuteParams, type BaseQuoteParams, type BluechipTokenConfig, type BluechipTokensConfig, type CompleteQuoteConfig, type CompleteQuoteParams, type CompleteQuoteResult, type ConfigAdapter, type DexRouter, 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, formatGasString, formatGasToTgas, getBluechipTokensConfig, isNearIntentsSupportedToken, logger, normalizeDestinationAsset, normalizeTokenId, quoteSameChainSwap, requiresRecipient, requiresRecipientInExecute, selectBestQuote, setBluechipTokensConfig };

package/dist/index.d.ts

@@ -298,7 +298,7 @@ declare const logger: {
 
 /** 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 (and warns) if unset. */
+/** Get the bluechip token config; returns an empty object if unset. */
 declare function getBluechipTokensConfig(): BluechipTokensConfig;
 /**
  * Normalize a NEAR asset id:
@@ -332,6 +332,18 @@ declare function formatGasToTgas(gasInYoctoNEAR: string | number): string;
  * @returns Formatted gas string in yoctoNEAR
  */
 declare function formatGasString(gas: string | number | bigint): string;
+/**
+ * Select the best quote from multiple quotes based on maximum amountOut
+ */
+declare function selectBestQuote<T extends {
+    amountOut: string;
+}, R = any>(quotes: Array<{
+    quote: T;
+    router: R;
+}>): {
+    quote: T;
+    router: R;
+};
 
 /** NEAR DEX router implementation (FindPath for routing + REF for execution). */
 
@@ -416,6 +428,7 @@ interface CompleteQuoteParams {
     slippage: number;
     recipient: string;
     refundTo?: string;
+    customRecipientMsg?: string;
 }
 interface CompleteQuoteResult {
     intents: {
@@ -428,10 +441,12 @@ interface CompleteQuoteResult {
         tokenIn: TokenInfo;
         tokenOut: TokenInfo;
         executor: DexRouter;
+        routeType?: "v1" | "v2";
     };
     finalAmountOut: string;
     totalPriceImpact?: number;
     totalFee?: number;
+    routeType?: "v1" | "v2" | "intents";
 }
 interface CompleteQuoteConfig {
     intentsQuotationAdapter: IntentsQuotationAdapter;
@@ -442,6 +457,8 @@ interface CompleteQuoteConfig {
         getWrapNearContractId(): string;
     };
     currentUserAddress?: string;
+    /** Optional function to check if token supports Intents (beyond bluechip tokens) */
+    isIntentsSupportedToken?: (token: TokenInfo) => boolean;
 }
 /**
  * Build a "complete quote":
@@ -454,4 +471,27 @@ interface CompleteQuoteConfig {
  */
 declare function completeQuote(params: CompleteQuoteParams, config: CompleteQuoteConfig): Promise<CompleteQuoteResult>;
 
-export { AggregateDexRouter, type AggregateDexRouterConfig, type BaseExecuteParams, type BaseQuoteParams, type BluechipTokenConfig, type BluechipTokensConfig, type CompleteQuoteConfig, type CompleteQuoteParams, type CompleteQuoteResult, type ConfigAdapter, type DexRouter, type ExecuteParams, type ExecuteResult, type FindPathAdapter, type FindPathResponse, type IntentsQuotationAdapter, type IntentsQuoteResult, type NearChainAdapter, NearSmartRouter, type NearSmartRouterConfig, type PoolInfo, type QuoteParams, type QuoteResult, type RecipientExecuteParams, type RecipientQuoteParams, type Route, type RouterCapabilities, type SimpleQuoteParams, type SupportedChain, type SwapMultiDexPathAdapter, type SwapMultiDexPathResponse, type TokenInfo, completeQuote, convertSlippageToBasisPoints, findBestBluechipToken, formatGasString, formatGasToTgas, getBluechipTokensConfig, isNearIntentsSupportedToken, logger, normalizeDestinationAsset, normalizeTokenId, requiresRecipient, requiresRecipientInExecute, setBluechipTokensConfig };
+/**
+ * Same-chain swap quote (NEAR -> NEAR)
+ * Queries V1 and V2 routers in parallel and selects the best route based on maximum amountOut
+ */
+
+interface QuoteSameChainSwapParams {
+    tokenIn: TokenInfo;
+    tokenOut: TokenInfo;
+    amountIn: string;
+    slippage: number;
+    recipient: string;
+    currentUserAddress: string;
+}
+interface QuoteSameChainSwapResult {
+    quote: QuoteResult;
+    router: DexRouter;
+}
+/**
+ * Quote same-chain swap (NEAR -> NEAR) by querying V1 and V2 routers in parallel
+ * and selecting the best route based on maximum amountOut
+ */
+declare function quoteSameChainSwap(params: QuoteSameChainSwapParams, dexRouters: DexRouter[]): Promise<QuoteSameChainSwapResult>;
+
+export { AggregateDexRouter, type AggregateDexRouterConfig, type BaseExecuteParams, type BaseQuoteParams, type BluechipTokenConfig, type BluechipTokensConfig, type CompleteQuoteConfig, type CompleteQuoteParams, type CompleteQuoteResult, type ConfigAdapter, type DexRouter, 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, formatGasString, formatGasToTgas, getBluechipTokensConfig, isNearIntentsSupportedToken, logger, normalizeDestinationAsset, normalizeTokenId, quoteSameChainSwap, requiresRecipient, requiresRecipientInExecute, selectBestQuote, setBluechipTokensConfig };