@rhea-finance/cross-chain-aggregation-dex 2.0.3 → 2.0.4

package/README.md

@@ -239,7 +239,29 @@ const quoteRequest: QuoteRequest = {
 const quote = await client.quote(quoteRequest);
 ```
 
-`quote()` calls `POST /api/swap/quote`. `quoteWaitingTimeMs` is a quote API request parameter used by routes such as Near Intents to wait for a quote. It is not an on-chain RPC timeout. The SDK sends `3000` when the field is omitted.
+`quote()` calls `POST /api/swap/quote`. The frontend can set `quoteWaitingTimeMs` on every `QuoteRequest` to control how long the quote service may wait for Near Intents and similar intent-based routes. The SDK sends `3000` when the field is omitted.
+
+#### 3.3.1 Configure the Near Intents quote wait
+
+`quoteWaitingTimeMs` is a first-class SDK parameter. Pass it directly to `client.quote()`; do not put it in `extensions` or an executor configuration.
+
+```ts
+// Frontend: allow Near Intents up to 5 seconds to return a route quote.
+const quote = await client.quote({
+  ...quoteRequest,
+  quoteWaitingTimeMs: 5000,
+});
+```
+
+| Rule | Detail |
+| --- | --- |
+| Who sets it | The frontend or any other SDK caller, on each `client.quote(request)` call. |
+| Unit and range | Milliseconds; must be a non-negative integer. |
+| Default | `3000` (3 seconds) when omitted. Pass it explicitly when the product needs to control the Near Intents latency/route-availability tradeoff. |
+| Typical use | Increase it, for example to `5000`–`10000`, when Near Intents needs more time to return a quote. Decrease it, for example to `0`–`1000`, when a faster response is more important than waiting for that route. |
+| Scope | Quote aggregation for intent-based routes such as `nearintents` and `preswap-nearintents`. It also applies to MCA deposit/withdraw quote requests whose Near Intents previews are produced by the same quote call. |
+
+This value limits the server-side route-quote wait only. It does **not** control the SDK HTTP request timeout, wallet signing, source-chain confirmation, bridge settlement, or `waitFor: "completed"` order polling. If the frontend configures a value close to or above the client's `timeoutMs`, increase `timeoutMs` enough to include the quote wait plus network overhead; otherwise the HTTP request may time out first.
 
 ### 3.4 Execute the swap directly
 
@@ -350,7 +372,7 @@ Terminal statuses are `completed`, `failed`, `refunded`, and `expired`.
 | `tokenOut` | `AssetRef` | Yes | Asset being received. |
 | `amountIn` | `string` | Yes | A non-negative base-unit decimal integer string. Do not pass `"1.5"` or scientific notation. |
 | `slippageBps` | `number` | Yes | Slippage in basis points. `50` means 0.5%; `100` means 1%. |
-| `quoteWaitingTimeMs` | `number` | No | Time the quote API may wait for route quotes, in milliseconds. Must be a non-negative integer. Default: `3000`. |
+| `quoteWaitingTimeMs` | `number` | No | **Frontend-configurable Near Intents quote wait.** Milliseconds; must be a non-negative integer. Default: `3000`. See [Configure the Near Intents quote wait](#331-configure-the-near-intents-quote-wait). |
 | `sender` | `string` | Yes | Sender address on the source chain. |
 | `recipient` | `string` | No | Recipient address on the destination chain. Cross-chain requests should normally provide it explicitly. |
 | `extensions` | `Record<string,unknown>` | No | Additional fields forwarded to the API. Regular applications should not use this to replace standard fields. |

package/dist/executors/aptos.d.mts

@@ -1,4 +1,4 @@
-import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-BEZXY_BM.mjs';
+import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-D0_DbMT2.mjs';
 
 interface AptosWalletAdapter extends ExecutorErrorAdapter {
     getChain(): ChainRef | Promise<ChainRef>;

package/dist/executors/aptos.d.ts

@@ -1,4 +1,4 @@
-import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-BEZXY_BM.js';
+import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-D0_DbMT2.js';
 
 interface AptosWalletAdapter extends ExecutorErrorAdapter {
     getChain(): ChainRef | Promise<ChainRef>;

package/dist/executors/bitcoin.d.mts

@@ -1,4 +1,4 @@
-import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-BEZXY_BM.mjs';
+import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-D0_DbMT2.mjs';
 
 interface BitcoinWalletAdapter extends ExecutorErrorAdapter {
     getChain(): ChainRef | Promise<ChainRef>;

package/dist/executors/bitcoin.d.ts

@@ -1,4 +1,4 @@
-import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-BEZXY_BM.js';
+import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-D0_DbMT2.js';
 
 interface BitcoinWalletAdapter extends ExecutorErrorAdapter {
     getChain(): ChainRef | Promise<ChainRef>;

package/dist/executors/evm.d.mts

@@ -1,4 +1,4 @@
-import { a4 as ExecutorErrorAdapter, V as EvmTx, a5 as TransactionSubmission, Y as EvmSigningRequest, X as EvmApproval, T as TransactionConfirmation, q as ChainExecutor } from '../shared-BEZXY_BM.mjs';
+import { a4 as ExecutorErrorAdapter, V as EvmTx, a5 as TransactionSubmission, Y as EvmSigningRequest, X as EvmApproval, T as TransactionConfirmation, q as ChainExecutor } from '../shared-D0_DbMT2.mjs';
 
 interface EvmWalletAdapter extends ExecutorErrorAdapter {
     sendTransaction(tx: EvmTx, options: {

package/dist/executors/evm.d.ts

@@ -1,4 +1,4 @@
-import { a4 as ExecutorErrorAdapter, V as EvmTx, a5 as TransactionSubmission, Y as EvmSigningRequest, X as EvmApproval, T as TransactionConfirmation, q as ChainExecutor } from '../shared-BEZXY_BM.js';
+import { a4 as ExecutorErrorAdapter, V as EvmTx, a5 as TransactionSubmission, Y as EvmSigningRequest, X as EvmApproval, T as TransactionConfirmation, q as ChainExecutor } from '../shared-D0_DbMT2.js';
 
 interface EvmWalletAdapter extends ExecutorErrorAdapter {
     sendTransaction(tx: EvmTx, options: {

package/dist/executors/near.d.mts

@@ -1,4 +1,4 @@
-import { a4 as ExecutorErrorAdapter, C as ChainRef, N as NearTransaction, T as TransactionConfirmation, q as ChainExecutor } from '../shared-BEZXY_BM.mjs';
+import { a4 as ExecutorErrorAdapter, C as ChainRef, N as NearTransaction, T as TransactionConfirmation, q as ChainExecutor } from '../shared-D0_DbMT2.mjs';
 
 interface NearWalletAdapter extends ExecutorErrorAdapter {
     getChain(): ChainRef | Promise<ChainRef>;

package/dist/executors/near.d.ts

@@ -1,4 +1,4 @@
-import { a4 as ExecutorErrorAdapter, C as ChainRef, N as NearTransaction, T as TransactionConfirmation, q as ChainExecutor } from '../shared-BEZXY_BM.js';
+import { a4 as ExecutorErrorAdapter, C as ChainRef, N as NearTransaction, T as TransactionConfirmation, q as ChainExecutor } from '../shared-D0_DbMT2.js';
 
 interface NearWalletAdapter extends ExecutorErrorAdapter {
     getChain(): ChainRef | Promise<ChainRef>;

package/dist/executors/solana.d.mts

@@ -1,4 +1,4 @@
-import { a4 as ExecutorErrorAdapter, C as ChainRef, Z as SolanaMetadata, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-BEZXY_BM.mjs';
+import { a4 as ExecutorErrorAdapter, C as ChainRef, Z as SolanaMetadata, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-D0_DbMT2.mjs';
 
 interface SolanaWalletAdapter extends ExecutorErrorAdapter {
     getChain(): ChainRef | Promise<ChainRef>;

package/dist/executors/solana.d.ts

@@ -1,4 +1,4 @@
-import { a4 as ExecutorErrorAdapter, C as ChainRef, Z as SolanaMetadata, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-BEZXY_BM.js';
+import { a4 as ExecutorErrorAdapter, C as ChainRef, Z as SolanaMetadata, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-D0_DbMT2.js';
 
 interface SolanaWalletAdapter extends ExecutorErrorAdapter {
     getChain(): ChainRef | Promise<ChainRef>;

package/dist/executors/sui.d.mts

@@ -1,4 +1,4 @@
-import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-BEZXY_BM.mjs';
+import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-D0_DbMT2.mjs';
 
 interface SuiWalletAdapter extends ExecutorErrorAdapter {
     getChain(): ChainRef | Promise<ChainRef>;

package/dist/executors/sui.d.ts

@@ -1,4 +1,4 @@
-import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-BEZXY_BM.js';
+import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-D0_DbMT2.js';
 
 interface SuiWalletAdapter extends ExecutorErrorAdapter {
     getChain(): ChainRef | Promise<ChainRef>;

package/dist/executors/tron.d.mts

@@ -1,4 +1,4 @@
-import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-BEZXY_BM.mjs';
+import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-D0_DbMT2.mjs';
 
 interface TronWalletAdapter extends ExecutorErrorAdapter {
     getChain(): ChainRef | Promise<ChainRef>;

package/dist/executors/tron.d.ts

@@ -1,4 +1,4 @@
-import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-BEZXY_BM.js';
+import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-D0_DbMT2.js';
 
 interface TronWalletAdapter extends ExecutorErrorAdapter {
     getChain(): ChainRef | Promise<ChainRef>;

package/dist/executors/zcash.d.mts

@@ -1,4 +1,4 @@
-import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-BEZXY_BM.mjs';
+import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-D0_DbMT2.mjs';
 
 interface ZcashWalletAdapter extends ExecutorErrorAdapter {
     getChain(): ChainRef | Promise<ChainRef>;

package/dist/executors/zcash.d.ts

@@ -1,4 +1,4 @@
-import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-BEZXY_BM.js';
+import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-D0_DbMT2.js';
 
 interface ZcashWalletAdapter extends ExecutorErrorAdapter {
     getChain(): ChainRef | Promise<ChainRef>;

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { S as SwapQuoteRequestRaw, a as SwapQuoteDataRaw, b as SwapBuildRequestRaw, c as SwapBuildDataRaw, d as SwapOrderSubmitRequestRaw, e as SwapOrderSubmitDataRaw, f as SwapOrderStatusParamsRaw, g as SwapOrderStatusDataRaw, h as SwapReportRequestRaw, i as SwapReportDataRaw, j as SwapHistoryParamsRaw, k as SwapHistoryDataRaw, Q as QuoteRequest, l as Quote, m as SwapMcaPayloadRaw, W as WaitMode, O as OrderPollingOptions, n as SwapLifecycleEvent, o as SwapExecutionResult, C as ChainRef, A as AssetRef, B as BaseUnitAmount, p as SwapHistoryRecordRaw, q as ChainExecutor, E as ExecutorRegistry, r as SwapBuild, s as ExecuteSwapInput, t as SwapInput, u as OrderStatusResult, v as WaitForOrderInput, N as NearTransaction, w as SwapMcaRelayerRequestRaw } from './shared-BEZXY_BM.mjs';
-export { a3 as BuildContext, K as ChainExecutionResult, $ as DepositInfo, X as EvmApproval, Y as EvmSigningRequest, V as EvmTx, L as ExecutionContext, P as ExecutorIdentityProvider, R as ExecutorMessageSigner, M as MessageSignOptions, _ as OrderReference, I as OrderStatus, a2 as RouteSummary, H as SignRequestPreview, Z as SolanaMetadata, x as SwapApiResponse, y as SwapApiTokenMetaRaw, F as SwapBuildApproveRaw, a1 as SwapExecution, z as SwapMcaSignerPayloadRaw, a0 as SwapReportContext, D as SwapSigningRequestRaw, G as SwapWarning, T as TransactionConfirmation, U as assertBaseUnitAmount, J as normalizeOrderStatus } from './shared-BEZXY_BM.mjs';
+import { S as SwapQuoteRequestRaw, a as SwapQuoteDataRaw, b as SwapBuildRequestRaw, c as SwapBuildDataRaw, d as SwapOrderSubmitRequestRaw, e as SwapOrderSubmitDataRaw, f as SwapOrderStatusParamsRaw, g as SwapOrderStatusDataRaw, h as SwapReportRequestRaw, i as SwapReportDataRaw, j as SwapHistoryParamsRaw, k as SwapHistoryDataRaw, Q as QuoteRequest, l as Quote, m as SwapMcaPayloadRaw, W as WaitMode, O as OrderPollingOptions, n as SwapLifecycleEvent, o as SwapExecutionResult, C as ChainRef, A as AssetRef, B as BaseUnitAmount, p as SwapHistoryRecordRaw, q as ChainExecutor, E as ExecutorRegistry, r as SwapBuild, s as ExecuteSwapInput, t as SwapInput, u as OrderStatusResult, v as WaitForOrderInput, N as NearTransaction, w as SwapMcaRelayerRequestRaw } from './shared-D0_DbMT2.mjs';
+export { a3 as BuildContext, K as ChainExecutionResult, $ as DepositInfo, X as EvmApproval, Y as EvmSigningRequest, V as EvmTx, L as ExecutionContext, P as ExecutorIdentityProvider, R as ExecutorMessageSigner, M as MessageSignOptions, _ as OrderReference, I as OrderStatus, a2 as RouteSummary, H as SignRequestPreview, Z as SolanaMetadata, x as SwapApiResponse, y as SwapApiTokenMetaRaw, F as SwapBuildApproveRaw, a1 as SwapExecution, z as SwapMcaSignerPayloadRaw, a0 as SwapReportContext, D as SwapSigningRequestRaw, G as SwapWarning, T as TransactionConfirmation, U as assertBaseUnitAmount, J as normalizeOrderStatus } from './shared-D0_DbMT2.mjs';
 
 type SwapErrorCode = "HTTP_ERROR" | "API_ERROR" | "RATE_LIMITED" | "AUTH_FAILED" | "REQUEST_ABORTED" | "REQUEST_TIMEOUT" | "INVALID_REQUEST" | "INVALID_API_RESPONSE" | "QUOTE_EXPIRED" | "ROUTE_NOT_FOUND" | "EXECUTOR_NOT_FOUND" | "UNSUPPORTED_CHAIN" | "CHAIN_MISMATCH" | "INVALID_TRANSACTION" | "USER_REJECTED" | "INSUFFICIENT_BALANCE" | "APPROVAL_FAILED" | "SIGNING_FAILED" | "BROADCAST_FAILED" | "ORDER_SUBMIT_FAILED" | "ORDER_TIMEOUT" | "REPORT_FAILED";
 type SwapErrorStage = "quote" | "build" | "approve" | "sign" | "broadcast" | "submit" | "report" | "status" | "history";

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { S as SwapQuoteRequestRaw, a as SwapQuoteDataRaw, b as SwapBuildRequestRaw, c as SwapBuildDataRaw, d as SwapOrderSubmitRequestRaw, e as SwapOrderSubmitDataRaw, f as SwapOrderStatusParamsRaw, g as SwapOrderStatusDataRaw, h as SwapReportRequestRaw, i as SwapReportDataRaw, j as SwapHistoryParamsRaw, k as SwapHistoryDataRaw, Q as QuoteRequest, l as Quote, m as SwapMcaPayloadRaw, W as WaitMode, O as OrderPollingOptions, n as SwapLifecycleEvent, o as SwapExecutionResult, C as ChainRef, A as AssetRef, B as BaseUnitAmount, p as SwapHistoryRecordRaw, q as ChainExecutor, E as ExecutorRegistry, r as SwapBuild, s as ExecuteSwapInput, t as SwapInput, u as OrderStatusResult, v as WaitForOrderInput, N as NearTransaction, w as SwapMcaRelayerRequestRaw } from './shared-BEZXY_BM.js';
-export { a3 as BuildContext, K as ChainExecutionResult, $ as DepositInfo, X as EvmApproval, Y as EvmSigningRequest, V as EvmTx, L as ExecutionContext, P as ExecutorIdentityProvider, R as ExecutorMessageSigner, M as MessageSignOptions, _ as OrderReference, I as OrderStatus, a2 as RouteSummary, H as SignRequestPreview, Z as SolanaMetadata, x as SwapApiResponse, y as SwapApiTokenMetaRaw, F as SwapBuildApproveRaw, a1 as SwapExecution, z as SwapMcaSignerPayloadRaw, a0 as SwapReportContext, D as SwapSigningRequestRaw, G as SwapWarning, T as TransactionConfirmation, U as assertBaseUnitAmount, J as normalizeOrderStatus } from './shared-BEZXY_BM.js';
+import { S as SwapQuoteRequestRaw, a as SwapQuoteDataRaw, b as SwapBuildRequestRaw, c as SwapBuildDataRaw, d as SwapOrderSubmitRequestRaw, e as SwapOrderSubmitDataRaw, f as SwapOrderStatusParamsRaw, g as SwapOrderStatusDataRaw, h as SwapReportRequestRaw, i as SwapReportDataRaw, j as SwapHistoryParamsRaw, k as SwapHistoryDataRaw, Q as QuoteRequest, l as Quote, m as SwapMcaPayloadRaw, W as WaitMode, O as OrderPollingOptions, n as SwapLifecycleEvent, o as SwapExecutionResult, C as ChainRef, A as AssetRef, B as BaseUnitAmount, p as SwapHistoryRecordRaw, q as ChainExecutor, E as ExecutorRegistry, r as SwapBuild, s as ExecuteSwapInput, t as SwapInput, u as OrderStatusResult, v as WaitForOrderInput, N as NearTransaction, w as SwapMcaRelayerRequestRaw } from './shared-D0_DbMT2.js';
+export { a3 as BuildContext, K as ChainExecutionResult, $ as DepositInfo, X as EvmApproval, Y as EvmSigningRequest, V as EvmTx, L as ExecutionContext, P as ExecutorIdentityProvider, R as ExecutorMessageSigner, M as MessageSignOptions, _ as OrderReference, I as OrderStatus, a2 as RouteSummary, H as SignRequestPreview, Z as SolanaMetadata, x as SwapApiResponse, y as SwapApiTokenMetaRaw, F as SwapBuildApproveRaw, a1 as SwapExecution, z as SwapMcaSignerPayloadRaw, a0 as SwapReportContext, D as SwapSigningRequestRaw, G as SwapWarning, T as TransactionConfirmation, U as assertBaseUnitAmount, J as normalizeOrderStatus } from './shared-D0_DbMT2.js';
 
 type SwapErrorCode = "HTTP_ERROR" | "API_ERROR" | "RATE_LIMITED" | "AUTH_FAILED" | "REQUEST_ABORTED" | "REQUEST_TIMEOUT" | "INVALID_REQUEST" | "INVALID_API_RESPONSE" | "QUOTE_EXPIRED" | "ROUTE_NOT_FOUND" | "EXECUTOR_NOT_FOUND" | "UNSUPPORTED_CHAIN" | "CHAIN_MISMATCH" | "INVALID_TRANSACTION" | "USER_REJECTED" | "INSUFFICIENT_BALANCE" | "APPROVAL_FAILED" | "SIGNING_FAILED" | "BROADCAST_FAILED" | "ORDER_SUBMIT_FAILED" | "ORDER_TIMEOUT" | "REPORT_FAILED";
 type SwapErrorStage = "quote" | "build" | "approve" | "sign" | "broadcast" | "submit" | "report" | "status" | "history";

package/dist/index.js

@@ -977,7 +977,7 @@ function normalizeQuote(request, raw, receivedAt = Date.now()) {
     estimatedOut: bestRoute.amountOut,
     minAmountOut: bestRoute.minAmountOut,
     route: bestRoute,
-    alternatives: raw.allQuotes.flatMap((route) => {
+    alternatives: readQuoteAlternatives(raw.allQuotes).flatMap((route) => {
       try {
         const normalized = normalizeRoute(route, false);
         return normalized ? [normalized] : [];
@@ -991,6 +991,13 @@ function normalizeQuote(request, raw, receivedAt = Date.now()) {
     raw
   };
 }
+function readQuoteAlternatives(value) {
+  if (!Array.isArray(value)) return [];
+  return value.filter(isRecord);
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 function validateQuoteRequest(request) {
   assertBaseUnitAmount(request.amountIn);
   if (!Number.isInteger(request.slippageBps) || request.slippageBps < 0) {