@rhea-finance/cross-chain-aggregation-dex 0.1.1 → 0.1.3

package/dist/index.d.mts

@@ -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). */
 
@@ -396,20 +408,12 @@ declare class AggregateDexRouter implements DexRouter {
      */
     quote(params: QuoteParams): Promise<QuoteResult>;
     /**
-     * Finalize quote with depositAddress (deprecated)
-     *
-     * @deprecated No longer needed. executeSwap automatically fetches final quote using receiveUser (depositAddress).
-     * Kept for interface compatibility only.
+     * @deprecated No longer needed. Kept for interface compatibility only.
      */
     finalizeQuote(params: QuoteParams, depositAddress: string): Promise<QuoteResult>;
-    /**
-     * Execute swap with V2 Router
-     * Automatically fetches final quote using receiveUser (depositAddress) to ensure correct routerMsg and signature.
-     */
+    private reFetchQuoteWithBalance;
+    private ensureQuoteAmountWithinBalance;
     executeSwap(params: ExecuteParams): Promise<ExecuteResult>;
-    /**
-     * Query user token registration status in AGGREGATE_DEX contract
-     */
     private queryUserTokensRegistered;
 }
 
@@ -436,10 +440,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;
@@ -450,6 +456,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":
@@ -462,4 +470,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

@@ -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). */
 
@@ -396,20 +408,12 @@ declare class AggregateDexRouter implements DexRouter {
      */
     quote(params: QuoteParams): Promise<QuoteResult>;
     /**
-     * Finalize quote with depositAddress (deprecated)
-     *
-     * @deprecated No longer needed. executeSwap automatically fetches final quote using receiveUser (depositAddress).
-     * Kept for interface compatibility only.
+     * @deprecated No longer needed. Kept for interface compatibility only.
      */
     finalizeQuote(params: QuoteParams, depositAddress: string): Promise<QuoteResult>;
-    /**
-     * Execute swap with V2 Router
-     * Automatically fetches final quote using receiveUser (depositAddress) to ensure correct routerMsg and signature.
-     */
+    private reFetchQuoteWithBalance;
+    private ensureQuoteAmountWithinBalance;
     executeSwap(params: ExecuteParams): Promise<ExecuteResult>;
-    /**
-     * Query user token registration status in AGGREGATE_DEX contract
-     */
     private queryUserTokensRegistered;
 }
 
@@ -436,10 +440,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;
@@ -450,6 +456,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":
@@ -462,4 +470,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 };