@cowprotocol/sdk-bridging 0.1.0 → 0.2.0

package/dist/index.d.mts

@@ -5,6 +5,29 @@ import { QuoterParameters, TraderParameters, TradeOptionalParameters, QuoteAndPo
 import { AccountAddress, SignerLike, AbstractProviderAdapter } from '@cowprotocol/sdk-common';
 import { CowShedSdk, CowShedSdkOptions } from '@cowprotocol/sdk-cow-shed';
 
+declare enum BridgeQuoteErrors {
+    NO_INTERMEDIATE_TOKENS = "NO_INTERMEDIATE_TOKENS",
+    API_ERROR = "API_ERROR",
+    INVALID_API_JSON_RESPONSE = "INVALID_API_JSON_RESPONSE",
+    ONLY_SELL_ORDER_SUPPORTED = "ONLY_SELL_ORDER_SUPPORTED",
+    TX_BUILD_ERROR = "TX_BUILD_ERROR",
+    QUOTE_ERROR = "QUOTE_ERROR",
+    NO_ROUTES = "NO_ROUTES",
+    INVALID_BRIDGE = "INVALID_BRIDGE"
+}
+declare class BridgeProviderQuoteError extends Error {
+    readonly context?: unknown | undefined;
+    constructor(message: BridgeQuoteErrors, context?: unknown | undefined);
+}
+declare class BridgeProviderError extends Error {
+    readonly context: unknown;
+    constructor(message: string, context: unknown);
+}
+declare class BridgeOrderParsingError extends Error {
+    readonly context?: unknown | undefined;
+    constructor(message: string, context?: unknown | undefined);
+}
+
 interface BridgeProviderInfo {
     name: string;
     logoUrl: string;
@@ -327,28 +350,15 @@ interface CrossChainOrder {
     tradeTxHash: string;
     explorerUrl?: string;
 }
-
-declare enum BridgeQuoteErrors {
-    NO_INTERMEDIATE_TOKENS = "NO_INTERMEDIATE_TOKENS",
-    API_ERROR = "API_ERROR",
-    INVALID_API_JSON_RESPONSE = "INVALID_API_JSON_RESPONSE",
-    ONLY_SELL_ORDER_SUPPORTED = "ONLY_SELL_ORDER_SUPPORTED",
-    TX_BUILD_ERROR = "TX_BUILD_ERROR",
-    QUOTE_ERROR = "QUOTE_ERROR",
-    NO_ROUTES = "NO_ROUTES",
-    INVALID_BRIDGE = "INVALID_BRIDGE"
-}
-declare class BridgeProviderQuoteError extends Error {
-    readonly context?: unknown | undefined;
-    constructor(message: BridgeQuoteErrors, context?: unknown | undefined);
-}
-declare class BridgeProviderError extends Error {
-    readonly context: unknown;
-    constructor(message: string, context: unknown);
+interface MultiQuoteResult {
+    providerDappId: string;
+    quote: CrossChainQuoteAndPost | null;
+    error?: BridgeProviderError;
 }
-declare class BridgeOrderParsingError extends Error {
-    readonly context?: unknown | undefined;
-    constructor(message: string, context?: unknown | undefined);
+interface MultiQuoteRequest {
+    quoteBridgeRequest: QuoteBridgeRequest;
+    providerDappIds?: string[];
+    advancedSettings?: SwapAdvancedSettings;
 }
 
 declare function isBridgeQuoteAndPost(quote: CrossChainQuoteAndPost): quote is BridgeQuoteAndPost;
@@ -436,9 +446,20 @@ declare class BridgingSdk {
      * @throws Error if no path is found
      */
     getQuote(quoteBridgeRequest: QuoteBridgeRequest, advancedSettings?: SwapAdvancedSettings): Promise<CrossChainQuoteAndPost>;
+    /**
+     * Get quotes from multiple bridge providers in parallel.
+     *
+     * This method is specifically for cross-chain bridging quotes. For single-chain swaps, use getQuote() instead.
+     *
+     * @param request - The multi-quote request containing quote parameters and optional provider dappIds
+     * @returns Array of results, one for each provider (successful quotes or errors)
+     * @throws Error if the request is for a single-chain swap (sellTokenChainId === buyTokenChainId)
+     */
+    getMultiQuotes(request: MultiQuoteRequest): Promise<MultiQuoteResult[]>;
     getOrder(params: GetOrderParams): Promise<CrossChainOrder | null>;
     getOrderBridgingStatus(bridgingId: string, originChainId: SupportedChainId): Promise<BridgeStatusResult>;
     getProviderFromAppData(fullAppData: string): BridgeProvider<BridgeQuoteResult> | undefined;
+    getProviderByDappId(dappId: string): BridgeProvider<BridgeQuoteResult> | undefined;
 }
 
 declare const RAW_PROVIDERS_FILES_PATH = "https://raw.githubusercontent.com/cowprotocol/cow-sdk/refs/heads/main/src/bridging/providers";
@@ -1048,4 +1069,4 @@ declare class BungeeBridgeProvider implements BridgeProvider<BungeeQuoteResult>
     private isExtraGasRequired;
 }
 
-export { AcrossBridgeProvider, type AcrossBridgeProviderOptions, type AcrossQuoteResult, type BridgeCallDetails, type BridgeCosts, type BridgeDeposit, type BridgeHook, BridgeOrderParsingError, type BridgeProvider, BridgeProviderError, type BridgeProviderInfo, BridgeProviderQuoteError, type BridgeQuoteAmountsAndCosts, type BridgeQuoteAndPost, BridgeQuoteErrors, type BridgeQuoteResult, type BridgeQuoteResults, BridgeStatus, type BridgeStatusResult, type BridgingDepositParams, BridgingSdk, type BridgingSdkConfig, type BridgingSdkOptions, BungeeBridgeProvider, type BungeeBridgeProviderOptions, type BungeeQuoteResult, type BuyTokensParams, COW_SHED_PROXY_CREATION_GAS, type CrossChainOrder, type CrossChainQuoteAndPost, DEFAULT_EXTRA_GAS_FOR_HOOK_ESTIMATION, DEFAULT_EXTRA_GAS_PROXY_CREATION, DEFAULT_GAS_COST_FOR_HOOK_ESTIMATION, type GetOrderParams, type GetProviderBuyTokens, HOOK_DAPP_BRIDGE_PROVIDER_PREFIX, type QuoteBridgeRequest, type QuoteBridgeRequestWithoutAmount, RAW_PROVIDERS_FILES_PATH, assertIsBridgeQuoteAndPost, assertIsQuoteAndPost, getCrossChainOrder, getPostHooks, isAppDoc, isBridgeQuoteAndPost, isQuoteAndPost };
+export { AcrossBridgeProvider, type AcrossBridgeProviderOptions, type AcrossQuoteResult, type BridgeCallDetails, type BridgeCosts, type BridgeDeposit, type BridgeHook, BridgeOrderParsingError, type BridgeProvider, BridgeProviderError, type BridgeProviderInfo, BridgeProviderQuoteError, type BridgeQuoteAmountsAndCosts, type BridgeQuoteAndPost, BridgeQuoteErrors, type BridgeQuoteResult, type BridgeQuoteResults, BridgeStatus, type BridgeStatusResult, type BridgingDepositParams, BridgingSdk, type BridgingSdkConfig, type BridgingSdkOptions, BungeeBridgeProvider, type BungeeBridgeProviderOptions, type BungeeQuoteResult, type BuyTokensParams, COW_SHED_PROXY_CREATION_GAS, type CrossChainOrder, type CrossChainQuoteAndPost, DEFAULT_EXTRA_GAS_FOR_HOOK_ESTIMATION, DEFAULT_EXTRA_GAS_PROXY_CREATION, DEFAULT_GAS_COST_FOR_HOOK_ESTIMATION, type GetOrderParams, type GetProviderBuyTokens, HOOK_DAPP_BRIDGE_PROVIDER_PREFIX, type MultiQuoteRequest, type MultiQuoteResult, type QuoteBridgeRequest, type QuoteBridgeRequestWithoutAmount, RAW_PROVIDERS_FILES_PATH, assertIsBridgeQuoteAndPost, assertIsQuoteAndPost, getCrossChainOrder, getPostHooks, isAppDoc, isBridgeQuoteAndPost, isQuoteAndPost };

package/dist/index.d.ts

@@ -5,6 +5,29 @@ import { QuoterParameters, TraderParameters, TradeOptionalParameters, QuoteAndPo
 import { AccountAddress, SignerLike, AbstractProviderAdapter } from '@cowprotocol/sdk-common';
 import { CowShedSdk, CowShedSdkOptions } from '@cowprotocol/sdk-cow-shed';
 
+declare enum BridgeQuoteErrors {
+    NO_INTERMEDIATE_TOKENS = "NO_INTERMEDIATE_TOKENS",
+    API_ERROR = "API_ERROR",
+    INVALID_API_JSON_RESPONSE = "INVALID_API_JSON_RESPONSE",
+    ONLY_SELL_ORDER_SUPPORTED = "ONLY_SELL_ORDER_SUPPORTED",
+    TX_BUILD_ERROR = "TX_BUILD_ERROR",
+    QUOTE_ERROR = "QUOTE_ERROR",
+    NO_ROUTES = "NO_ROUTES",
+    INVALID_BRIDGE = "INVALID_BRIDGE"
+}
+declare class BridgeProviderQuoteError extends Error {
+    readonly context?: unknown | undefined;
+    constructor(message: BridgeQuoteErrors, context?: unknown | undefined);
+}
+declare class BridgeProviderError extends Error {
+    readonly context: unknown;
+    constructor(message: string, context: unknown);
+}
+declare class BridgeOrderParsingError extends Error {
+    readonly context?: unknown | undefined;
+    constructor(message: string, context?: unknown | undefined);
+}
+
 interface BridgeProviderInfo {
     name: string;
     logoUrl: string;
@@ -327,28 +350,15 @@ interface CrossChainOrder {
     tradeTxHash: string;
     explorerUrl?: string;
 }
-
-declare enum BridgeQuoteErrors {
-    NO_INTERMEDIATE_TOKENS = "NO_INTERMEDIATE_TOKENS",
-    API_ERROR = "API_ERROR",
-    INVALID_API_JSON_RESPONSE = "INVALID_API_JSON_RESPONSE",
-    ONLY_SELL_ORDER_SUPPORTED = "ONLY_SELL_ORDER_SUPPORTED",
-    TX_BUILD_ERROR = "TX_BUILD_ERROR",
-    QUOTE_ERROR = "QUOTE_ERROR",
-    NO_ROUTES = "NO_ROUTES",
-    INVALID_BRIDGE = "INVALID_BRIDGE"
-}
-declare class BridgeProviderQuoteError extends Error {
-    readonly context?: unknown | undefined;
-    constructor(message: BridgeQuoteErrors, context?: unknown | undefined);
-}
-declare class BridgeProviderError extends Error {
-    readonly context: unknown;
-    constructor(message: string, context: unknown);
+interface MultiQuoteResult {
+    providerDappId: string;
+    quote: CrossChainQuoteAndPost | null;
+    error?: BridgeProviderError;
 }
-declare class BridgeOrderParsingError extends Error {
-    readonly context?: unknown | undefined;
-    constructor(message: string, context?: unknown | undefined);
+interface MultiQuoteRequest {
+    quoteBridgeRequest: QuoteBridgeRequest;
+    providerDappIds?: string[];
+    advancedSettings?: SwapAdvancedSettings;
 }
 
 declare function isBridgeQuoteAndPost(quote: CrossChainQuoteAndPost): quote is BridgeQuoteAndPost;
@@ -436,9 +446,20 @@ declare class BridgingSdk {
      * @throws Error if no path is found
      */
     getQuote(quoteBridgeRequest: QuoteBridgeRequest, advancedSettings?: SwapAdvancedSettings): Promise<CrossChainQuoteAndPost>;
+    /**
+     * Get quotes from multiple bridge providers in parallel.
+     *
+     * This method is specifically for cross-chain bridging quotes. For single-chain swaps, use getQuote() instead.
+     *
+     * @param request - The multi-quote request containing quote parameters and optional provider dappIds
+     * @returns Array of results, one for each provider (successful quotes or errors)
+     * @throws Error if the request is for a single-chain swap (sellTokenChainId === buyTokenChainId)
+     */
+    getMultiQuotes(request: MultiQuoteRequest): Promise<MultiQuoteResult[]>;
     getOrder(params: GetOrderParams): Promise<CrossChainOrder | null>;
     getOrderBridgingStatus(bridgingId: string, originChainId: SupportedChainId): Promise<BridgeStatusResult>;
     getProviderFromAppData(fullAppData: string): BridgeProvider<BridgeQuoteResult> | undefined;
+    getProviderByDappId(dappId: string): BridgeProvider<BridgeQuoteResult> | undefined;
 }
 
 declare const RAW_PROVIDERS_FILES_PATH = "https://raw.githubusercontent.com/cowprotocol/cow-sdk/refs/heads/main/src/bridging/providers";
@@ -1048,4 +1069,4 @@ declare class BungeeBridgeProvider implements BridgeProvider<BungeeQuoteResult>
     private isExtraGasRequired;
 }
 
-export { AcrossBridgeProvider, type AcrossBridgeProviderOptions, type AcrossQuoteResult, type BridgeCallDetails, type BridgeCosts, type BridgeDeposit, type BridgeHook, BridgeOrderParsingError, type BridgeProvider, BridgeProviderError, type BridgeProviderInfo, BridgeProviderQuoteError, type BridgeQuoteAmountsAndCosts, type BridgeQuoteAndPost, BridgeQuoteErrors, type BridgeQuoteResult, type BridgeQuoteResults, BridgeStatus, type BridgeStatusResult, type BridgingDepositParams, BridgingSdk, type BridgingSdkConfig, type BridgingSdkOptions, BungeeBridgeProvider, type BungeeBridgeProviderOptions, type BungeeQuoteResult, type BuyTokensParams, COW_SHED_PROXY_CREATION_GAS, type CrossChainOrder, type CrossChainQuoteAndPost, DEFAULT_EXTRA_GAS_FOR_HOOK_ESTIMATION, DEFAULT_EXTRA_GAS_PROXY_CREATION, DEFAULT_GAS_COST_FOR_HOOK_ESTIMATION, type GetOrderParams, type GetProviderBuyTokens, HOOK_DAPP_BRIDGE_PROVIDER_PREFIX, type QuoteBridgeRequest, type QuoteBridgeRequestWithoutAmount, RAW_PROVIDERS_FILES_PATH, assertIsBridgeQuoteAndPost, assertIsQuoteAndPost, getCrossChainOrder, getPostHooks, isAppDoc, isBridgeQuoteAndPost, isQuoteAndPost };
+export { AcrossBridgeProvider, type AcrossBridgeProviderOptions, type AcrossQuoteResult, type BridgeCallDetails, type BridgeCosts, type BridgeDeposit, type BridgeHook, BridgeOrderParsingError, type BridgeProvider, BridgeProviderError, type BridgeProviderInfo, BridgeProviderQuoteError, type BridgeQuoteAmountsAndCosts, type BridgeQuoteAndPost, BridgeQuoteErrors, type BridgeQuoteResult, type BridgeQuoteResults, BridgeStatus, type BridgeStatusResult, type BridgingDepositParams, BridgingSdk, type BridgingSdkConfig, type BridgingSdkOptions, BungeeBridgeProvider, type BungeeBridgeProviderOptions, type BungeeQuoteResult, type BuyTokensParams, COW_SHED_PROXY_CREATION_GAS, type CrossChainOrder, type CrossChainQuoteAndPost, DEFAULT_EXTRA_GAS_FOR_HOOK_ESTIMATION, DEFAULT_EXTRA_GAS_PROXY_CREATION, DEFAULT_GAS_COST_FOR_HOOK_ESTIMATION, type GetOrderParams, type GetProviderBuyTokens, HOOK_DAPP_BRIDGE_PROVIDER_PREFIX, type MultiQuoteRequest, type MultiQuoteResult, type QuoteBridgeRequest, type QuoteBridgeRequestWithoutAmount, RAW_PROVIDERS_FILES_PATH, assertIsBridgeQuoteAndPost, assertIsQuoteAndPost, getCrossChainOrder, getPostHooks, isAppDoc, isBridgeQuoteAndPost, isQuoteAndPost };

package/dist/index.js

@@ -478,8 +478,8 @@ var BridgingSdk = class {
       (0, import_sdk_common4.setGlobalAdapter)(adapter);
     }
     const { providers, ...restOptions } = options;
-    if (!providers || providers.length !== 1) {
-      throw new Error("Current implementation only supports a single bridge provider");
+    if (!providers || providers.length === 0) {
+      throw new Error("At least one bridge provider is required");
     }
     if (options.enableLogging !== void 0) {
       (0, import_sdk_common4.enableLogging)(options.enableLogging);
@@ -561,6 +561,58 @@ var BridgingSdk = class {
       });
     }
   }
+  /**
+   * Get quotes from multiple bridge providers in parallel.
+   *
+   * This method is specifically for cross-chain bridging quotes. For single-chain swaps, use getQuote() instead.
+   *
+   * @param request - The multi-quote request containing quote parameters and optional provider dappIds
+   * @returns Array of results, one for each provider (successful quotes or errors)
+   * @throws Error if the request is for a single-chain swap (sellTokenChainId === buyTokenChainId)
+   */
+  async getMultiQuotes(request) {
+    const { quoteBridgeRequest, providerDappIds, advancedSettings } = request;
+    const { sellTokenChainId, buyTokenChainId } = quoteBridgeRequest;
+    if (sellTokenChainId === buyTokenChainId) {
+      throw new BridgeProviderError(
+        "getMultiQuotes() is only for cross-chain bridging. For single-chain swaps, use getQuote() instead.",
+        { config: this.config }
+      );
+    }
+    const providersToQuery = providerDappIds ? providerDappIds.map((dappId) => {
+      const provider = this.getProviderByDappId(dappId);
+      if (!provider) {
+        throw new BridgeProviderError(
+          `Provider with dappId '${dappId}' not found. Available providers: ${this.config.providers.map((p) => p.info.dappId).join(", ")}`,
+          { config: this.config }
+        );
+      }
+      return provider;
+    }) : this.config.providers;
+    const quotePromises = providersToQuery.map(async (provider) => {
+      try {
+        const quote = await getQuoteWithBridge({
+          swapAndBridgeRequest: quoteBridgeRequest,
+          advancedSettings,
+          tradingSdk: this.config.tradingSdk,
+          provider,
+          bridgeHookSigner: advancedSettings?.quoteSigner
+        });
+        return {
+          providerDappId: provider.info.dappId,
+          quote,
+          error: void 0
+        };
+      } catch (error) {
+        return {
+          providerDappId: provider.info.dappId,
+          quote: null,
+          error: error instanceof BridgeProviderError ? error : new BridgeProviderError(String(error), {})
+        };
+      }
+    });
+    return Promise.all(quotePromises);
+  }
   async getOrder(params) {
     const { orderBookApi } = this.config;
     const { chainId, orderId, env = orderBookApi.context.env } = params;
@@ -578,6 +630,9 @@ var BridgingSdk = class {
   getProviderFromAppData(fullAppData) {
     return findBridgeProviderFromHook(fullAppData, this.getProviders());
   }
+  getProviderByDappId(dappId) {
+    return this.config.providers.find((provider) => provider.info.dappId === dappId);
+  }
 };
 
 // src/providers/across/AcrossApi.ts

package/dist/index.mjs

@@ -436,8 +436,8 @@ var BridgingSdk = class {
       setGlobalAdapter(adapter);
     }
     const { providers, ...restOptions } = options;
-    if (!providers || providers.length !== 1) {
-      throw new Error("Current implementation only supports a single bridge provider");
+    if (!providers || providers.length === 0) {
+      throw new Error("At least one bridge provider is required");
     }
     if (options.enableLogging !== void 0) {
       enableLogging(options.enableLogging);
@@ -519,6 +519,58 @@ var BridgingSdk = class {
       });
     }
   }
+  /**
+   * Get quotes from multiple bridge providers in parallel.
+   *
+   * This method is specifically for cross-chain bridging quotes. For single-chain swaps, use getQuote() instead.
+   *
+   * @param request - The multi-quote request containing quote parameters and optional provider dappIds
+   * @returns Array of results, one for each provider (successful quotes or errors)
+   * @throws Error if the request is for a single-chain swap (sellTokenChainId === buyTokenChainId)
+   */
+  async getMultiQuotes(request) {
+    const { quoteBridgeRequest, providerDappIds, advancedSettings } = request;
+    const { sellTokenChainId, buyTokenChainId } = quoteBridgeRequest;
+    if (sellTokenChainId === buyTokenChainId) {
+      throw new BridgeProviderError(
+        "getMultiQuotes() is only for cross-chain bridging. For single-chain swaps, use getQuote() instead.",
+        { config: this.config }
+      );
+    }
+    const providersToQuery = providerDappIds ? providerDappIds.map((dappId) => {
+      const provider = this.getProviderByDappId(dappId);
+      if (!provider) {
+        throw new BridgeProviderError(
+          `Provider with dappId '${dappId}' not found. Available providers: ${this.config.providers.map((p) => p.info.dappId).join(", ")}`,
+          { config: this.config }
+        );
+      }
+      return provider;
+    }) : this.config.providers;
+    const quotePromises = providersToQuery.map(async (provider) => {
+      try {
+        const quote = await getQuoteWithBridge({
+          swapAndBridgeRequest: quoteBridgeRequest,
+          advancedSettings,
+          tradingSdk: this.config.tradingSdk,
+          provider,
+          bridgeHookSigner: advancedSettings?.quoteSigner
+        });
+        return {
+          providerDappId: provider.info.dappId,
+          quote,
+          error: void 0
+        };
+      } catch (error) {
+        return {
+          providerDappId: provider.info.dappId,
+          quote: null,
+          error: error instanceof BridgeProviderError ? error : new BridgeProviderError(String(error), {})
+        };
+      }
+    });
+    return Promise.all(quotePromises);
+  }
   async getOrder(params) {
     const { orderBookApi } = this.config;
     const { chainId, orderId, env = orderBookApi.context.env } = params;
@@ -536,6 +588,9 @@ var BridgingSdk = class {
   getProviderFromAppData(fullAppData) {
     return findBridgeProviderFromHook(fullAppData, this.getProviders());
   }
+  getProviderByDappId(dappId) {
+    return this.config.providers.find((provider) => provider.info.dappId === dappId);
+  }
 };
 
 // src/providers/across/AcrossApi.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cowprotocol/sdk-bridging",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Bridging for CoW Protocol",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -15,12 +15,12 @@
   },
   "dependencies": {
     "@cowprotocol/sdk-app-data": "4.0.0",
-    "@cowprotocol/sdk-common": "0.1.0",
     "@cowprotocol/sdk-config": "0.1.0",
-    "@cowprotocol/sdk-cow-shed": "0.1.0",
-    "@cowprotocol/sdk-contracts-ts": "0.1.0",
+    "@cowprotocol/sdk-cow-shed": "0.1.1",
+    "@cowprotocol/sdk-contracts-ts": "0.1.1",
     "@cowprotocol/sdk-order-book": "0.1.0",
-    "@cowprotocol/sdk-trading": "0.1.0",
+    "@cowprotocol/sdk-trading": "0.1.1",
+    "@cowprotocol/sdk-common": "0.1.0",
     "@cowprotocol/sdk-weiroll": "0.1.0"
   },
   "devDependencies": {
@@ -36,11 +36,11 @@
     "ts-jest": "^29.0.0",
     "ethers": "^5.7.2",
     "viem": "^2.28.4",
-    "@cowprotocol/sdk-order-signing": "0.1.0",
-    "@cowprotocol/sdk-ethers-v5-adapter": "0.1.0",
     "@cow-sdk/typescript-config": "0.0.0-beta.0",
+    "@cowprotocol/sdk-order-signing": "0.1.1",
+    "@cowprotocol/sdk-ethers-v6-adapter": "0.1.0",
     "@cowprotocol/sdk-viem-adapter": "0.1.0",
-    "@cowprotocol/sdk-ethers-v6-adapter": "0.1.0"
+    "@cowprotocol/sdk-ethers-v5-adapter": "0.1.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts",