@cowprotocol/sdk-bridging 0.6.1 → 0.8.0

package/README.md

@@ -132,7 +132,7 @@ const parameters: QuoteBridgeRequest = {
   appCode: 'YOUR_APP_CODE',
 }
 
-const quoteResult = await sdk.bridging.getQuote(parameters)
+const quoteResult = await bridgingSdk.getQuote(parameters)
 assertIsBridgeQuoteAndPost(quoteResult)
 const { swap, bridge, postSwapOrderFromQuote } = quoteResult
 
@@ -171,7 +171,7 @@ const multiQuoteRequest: MultiQuoteRequest = {
 }
 
 // Get quotes from all providers
-const results = await sdk.bridging.getMultiQuotes(multiQuoteRequest)
+const results = await bridgingSdk.getMultiQuotes(multiQuoteRequest)
 
 results.forEach((result) => {
   if (result.quote) {
@@ -210,7 +210,7 @@ const multiQuoteRequest: MultiQuoteRequest = {
 }
 
 // This will return all results once completed (or timed out)
-const finalResults = await sdk.bridging.getMultiQuotes(multiQuoteRequest)
+const finalResults = await bridgingSdk.getMultiQuotes(multiQuoteRequest)
 
 console.log(`Received ${finalResults.filter(r => r.quote).length} successful quotes out of ${finalResults.length} providers`)
 ```
@@ -227,7 +227,7 @@ const fetchQuotes = async () => {
   setQuotes([])
 
   try {
-    const results = await sdk.bridging.getMultiQuotes({
+    const results = await bridgingSdk.getMultiQuotes({
       quoteBridgeRequest: parameters,
       options: {
         onQuoteResult: (result) => {
@@ -280,7 +280,7 @@ const isBestQuote = (result: MultiQuoteResult): boolean => {
 The `getMultiQuotes()` method supports two types of timeouts for fine-grained control:
 
 ```typescript
-const results = await sdk.bridging.getMultiQuotes({
+const results = await bridgingSdk.getMultiQuotes({
   quoteBridgeRequest: parameters,
   options: {
     // Global timeout: Maximum time to wait for all providers to complete
@@ -312,7 +312,7 @@ The `getBestQuote()` method provides an optimized way to get only the best quote
 import { MultiQuoteRequest } from '@cowprotocol/sdk-bridging'
 
 // Get the best quote from all available providers
-const bestQuote = await sdk.bridging.getBestQuote({
+const bestQuote = await bridgingSdk.getBestQuote({
   quoteBridgeRequest: parameters, // Same parameters as above
   providerDappIds: ['provider1', 'provider2'], // Optional: specify which providers to query
   advancedSettings: {
@@ -342,7 +342,7 @@ For real-time updates, you can receive notifications each time a better quote is
 ```typescript
 let currentBest: MultiQuoteResult | null = null
 
-const bestQuote = await sdk.bridging.getBestQuote({
+const bestQuote = await bridgingSdk.getBestQuote({
   quoteBridgeRequest: parameters,
   options: {
     // Called whenever a better quote is found
@@ -371,7 +371,7 @@ console.log('Final best quote:', bestQuote)
 When all providers fail, `getBestQuote()` returns the first provider's error:
 
 ```typescript
-const bestQuote = await sdk.bridging.getBestQuote({
+const bestQuote = await bridgingSdk.getBestQuote({
   quoteBridgeRequest: parameters,
   options: {
     onQuoteResult: (result) => {
@@ -414,6 +414,75 @@ Choose `getMultiQuotes()` when:
 - You want to analyze all provider responses
 - You need to show provider-specific errors or statuses
 
+## Provider Management
+
+The BridgingSdk provides methods to manage which bridge providers are actively used for quotes and operations.
+
+### Getting Available Providers
+
+Use `getAvailableProviders()` to retrieve the list of currently active providers:
+
+```typescript
+// Get all active providers
+const providers = bridgingSdk.getAvailableProviders()
+
+providers.forEach((provider) => {
+  console.log(`Provider: ${provider.info.name}`)
+  console.log(`Dapp ID: ${provider.info.dappId}`)
+  console.log(`Networks: ${provider.info.supportedChains.join(', ')}`)
+})
+```
+
+### Filtering Active Providers
+
+Use `setAvailableProviders()` to dynamically filter which providers should be used for bridge operations:
+
+```typescript
+// Initially, all configured providers are available
+const allProviders = bridgingSdk.getAvailableProviders()
+console.log(`Total providers: ${allProviders.length}`)
+
+// Filter to use only specific providers
+bridgingSdk.setAvailableProviders(['across', 'hop-protocol'])
+
+// Now only the specified providers will be used
+const filteredProviders = bridgingSdk.getAvailableProviders()
+console.log(`Active providers: ${filteredProviders.length}`)
+
+// Reset to use all providers again
+bridgingSdk.setAvailableProviders([])
+const resetProviders = bridgingSdk.getAvailableProviders()
+console.log(`Reset to all providers: ${resetProviders.length}`)
+```
+
+### Dynamic Provider Selection Example
+
+```typescript
+// Example: Let users select their preferred bridge providers
+const [selectedProviders, setSelectedProviders] = useState<string[]>([])
+
+// Function to update active providers based on user selection
+const updateActiveProviders = (providerIds: string[]) => {
+  bridgingSdk.setAvailableProviders(providerIds)
+  setSelectedProviders(providerIds)
+
+  console.log(`Updated to use ${providerIds.length} provider(s)`)
+}
+
+// Get quotes only from selected providers
+const getQuotesFromSelectedProviders = async () => {
+  // The SDK will automatically use only the providers set via setAvailableProviders
+  const quote = await bridgingSdk.getQuote(parameters)
+  // Or for multi-provider quotes
+  const multiQuotes = await bridgingSdk.getMultiQuotes({
+    quoteBridgeRequest: parameters
+    // No need to specify providerDappIds, setAvailableProviders already filtered them
+  })
+
+  return quote
+}
+```
+
 ## Supported Bridge Providers
 
 - Additional bridge providers are being integrated

package/dist/index.d.mts

@@ -4,12 +4,16 @@ import { ChainInfo, TargetChainId, SupportedChainId, TokenInfo, ChainId, EvmCall
 import { QuoterParameters, TraderParameters, TradeOptionalParameters, QuoteAndPost, QuoteResults, SwapAdvancedSettings, SigningStepManager, OrderPostingResult, TradingSdk } from '@cowprotocol/sdk-trading';
 import { AccountAddress, SignerLike, TTLCache, AbstractProviderAdapter } from '@cowprotocol/sdk-common';
 import { CowShedSdk, CowShedSdkOptions } from '@cowprotocol/sdk-cow-shed';
+import { TokenResponse, QuoteRequest, QuoteResponse, GetExecutionStatusResponse } from '@defuse-protocol/one-click-sdk-typescript';
+import { Address as Address$1, Hex } from 'viem';
 
+type BridgeProviderType = 'ReceiverAccountBridgeProvider' | 'HookBridgeProvider';
 interface BridgeProviderInfo {
     name: string;
     logoUrl: string;
     dappId: string;
     website: string;
+    type: BridgeProviderType;
 }
 interface WithSellToken {
     sellTokenChainId: SupportedChainId;
@@ -33,6 +37,14 @@ type QuoteBridgeRequest = {
 } & WithSellToken & WithBuyToken & WithQuoter & WithTrader & TradeOptionalParameters;
 type QuoteBridgeRequestWithoutAmount = Omit<QuoteBridgeRequest, 'amount'>;
 interface BridgeQuoteResult {
+    /**
+     * Unique ID of a quote
+     */
+    id?: string;
+    /**
+     * Provider who implement ReceiverAccountBridgeProvider must return a signature of a quote than will be used to verify the quote deposit address validity
+     */
+    signature?: string;
     /**
      * Whether the quote is a sell or buy order.
      */
@@ -128,7 +140,7 @@ interface BridgeDeposit extends Omit<QuoteBridgeRequest, 'amount'> {
  * It contains the main information about the provider, and the methods to get the quote, the bridging params, the status, the cancelling and the refunding of the bridging.
  */
 interface BridgeProvider<Q extends BridgeQuoteResult> {
-    type: 'ReceiverAccountBridgeProvider' | 'HookBridgeProvider';
+    type: BridgeProviderType;
     info: BridgeProviderInfo;
     /**
      * Get basic supported chains
@@ -156,10 +168,10 @@ interface BridgeProvider<Q extends BridgeQuoteResult> {
     /**
      * Get the identifier of the bridging transaction from the settlement transaction.
      * @param chainId
-     * @param orderUid - The unique identifier of the order
+     * @param order - CoW Protocol order
      * @param txHash - The hash of the settlement transaction in which the bridging post-hook was executed
      */
-    getBridgingParams(chainId: ChainId, orderUid: string, txHash: string): Promise<{
+    getBridgingParams(chainId: ChainId, order: EnrichedOrder, txHash: string): Promise<{
         params: BridgingDepositParams;
         status: BridgeStatusResult;
     } | null>;
@@ -420,6 +432,7 @@ interface BestQuoteProviderContext extends MultiQuoteContext {
         current: MultiQuoteResult | null;
     };
 }
+type DefaultBridgeProvider = BridgeProvider<BridgeQuoteResult>;
 
 declare enum BridgeQuoteErrors {
     NO_INTERMEDIATE_TOKENS = "NO_INTERMEDIATE_TOKENS",
@@ -429,7 +442,8 @@ declare enum BridgeQuoteErrors {
     TX_BUILD_ERROR = "TX_BUILD_ERROR",
     QUOTE_ERROR = "QUOTE_ERROR",
     NO_ROUTES = "NO_ROUTES",
-    INVALID_BRIDGE = "INVALID_BRIDGE"
+    INVALID_BRIDGE = "INVALID_BRIDGE",
+    QUOTE_DOES_NOT_MATCH_DEPOSIT_ADDRESS = "QUOTE_DOES_NOT_MATCH_DEPOSIT_ADDRESS"
 }
 declare class BridgeProviderQuoteError extends Error {
     readonly context?: unknown | undefined;
@@ -448,7 +462,7 @@ declare function isBridgeQuoteAndPost(quote: CrossChainQuoteAndPost): quote is B
 declare function isQuoteAndPost(quote: CrossChainQuoteAndPost): quote is QuoteAndPost;
 declare function assertIsBridgeQuoteAndPost(quote: CrossChainQuoteAndPost): asserts quote is BridgeQuoteAndPost;
 declare function assertIsQuoteAndPost(quote: CrossChainQuoteAndPost): asserts quote is QuoteAndPost;
-declare function getPostHooks(fullAppData?: string): cowAppDataLatestScheme.CoWHook[];
+declare function getPostHooks(fullAppData?: string | object): cowAppDataLatestScheme.CoWHook[];
 declare function isAppDoc(appData: unknown): appData is cowAppDataLatestScheme.AppDataRootSchema;
 declare function isHookBridgeProvider<Q extends BridgeQuoteResult>(provider: BridgeProvider<Q>): provider is HookBridgeProvider<Q>;
 declare function isReceiverAccountBridgeProvider<Q extends BridgeQuoteResult>(provider: BridgeProvider<Q>): provider is ReceiverAccountBridgeProvider<Q>;
@@ -523,12 +537,13 @@ declare class BridgingSdk {
     private singleQuoteStrategy;
     private multiQuoteStrategy;
     private bestQuoteStrategy;
+    private availableProvidersIds;
     constructor(options: BridgingSdkOptions, adapter?: AbstractProviderAdapter);
-    private get provider();
+    setAvailableProviders(ids: string[]): void;
     /**
      * Get the providers for the bridging.
      */
-    getProviders(): BridgeProvider<BridgeQuoteResult>[];
+    getAvailableProviders(): DefaultBridgeProvider[];
     /**
      * Get the available sources networks for the bridging.
      */
@@ -592,8 +607,7 @@ declare class BridgingSdk {
      */
     getBestQuote(request: MultiQuoteRequest): Promise<MultiQuoteResult | null>;
     getOrder(params: GetOrderParams): Promise<CrossChainOrder | null>;
-    getOrderBridgingStatus(bridgingId: string, originChainId: SupportedChainId): Promise<BridgeStatusResult>;
-    getProviderFromAppData(fullAppData: string): BridgeProvider<BridgeQuoteResult> | undefined;
+    getProviderFromAppData(fullAppData: string): DefaultBridgeProvider | undefined;
     /**
      * Clear all caches. Useful for testing and debugging.
      */
@@ -609,7 +623,8 @@ declare class BridgingSdk {
         intermediateTokens: number;
         buyTokens: number;
     };
-    getProviderByDappId(dappId: string): BridgeProvider<BridgeQuoteResult> | undefined;
+    getProviderByDappId(dappId: string): DefaultBridgeProvider | undefined;
+    private getBuyTokensFromProvider;
 }
 
 declare const RAW_PROVIDERS_FILES_PATH = "https://raw.githubusercontent.com/cowprotocol/cow-sdk/refs/heads/main/src/bridging/providers";
@@ -900,7 +915,7 @@ declare class AcrossBridgeProvider implements HookBridgeProvider<AcrossQuoteResu
     getGasLimitEstimationForHook(request: QuoteBridgeRequest): Promise<number>;
     getSignedHook(chainId: SupportedChainId, unsignedCall: EvmCall, bridgeHookNonce: string, deadline: bigint, hookGasLimit: number, signer?: SignerLike): Promise<BridgeHook>;
     decodeBridgeHook(_hook: cowAppDataLatestScheme.CoWHook): Promise<BridgeDeposit>;
-    getBridgingParams(chainId: ChainId, orderUid: string, txHash: string): Promise<{
+    getBridgingParams(chainId: ChainId, order: EnrichedOrder, txHash: string): Promise<{
         params: BridgingDepositParams;
         status: BridgeStatusResult;
     } | null>;
@@ -1220,7 +1235,7 @@ declare class BungeeBridgeProvider implements HookBridgeProvider<BungeeQuoteResu
     getUnsignedBridgeCall(request: QuoteBridgeRequest, quote: BungeeQuoteResult): Promise<EvmCall>;
     getGasLimitEstimationForHook(request: QuoteBridgeRequest): Promise<number>;
     getSignedHook(chainId: SupportedChainId, unsignedCall: EvmCall, bridgeHookNonce: string, deadline: bigint, hookGasLimit: number, signer?: SignerLike): Promise<BridgeHook>;
-    getBridgingParams(_chainId: ChainId, orderId: string, _txHash: string): Promise<{
+    getBridgingParams(_chainId: ChainId, order: EnrichedOrder, _txHash: string): Promise<{
         params: BridgingDepositParams;
         status: BridgeStatusResult;
     } | null>;
@@ -1232,4 +1247,51 @@ declare class BungeeBridgeProvider implements HookBridgeProvider<BungeeQuoteResu
     private isExtraGasRequired;
 }
 
-export { AcrossBridgeProvider, type AcrossBridgeProviderOptions, type AcrossQuoteResult, type BestQuoteProgressCallback, type BestQuoteProviderContext, 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, 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 GetProviderBuyTokens, HOOK_DAPP_BRIDGE_PROVIDER_PREFIX, type HookBridgeProvider, type MultiQuoteOptions, type MultiQuoteProgressCallback, type MultiQuoteRequest, type MultiQuoteResult, type ProviderQuoteContext, type QuoteBridgeRequest, type QuoteBridgeRequestWithoutAmount, RAW_PROVIDERS_FILES_PATH, type ReceiverAccountBridgeProvider, assertIsBridgeQuoteAndPost, assertIsQuoteAndPost, getCrossChainOrder, getPostHooks, isAppDoc, isBridgeQuoteAndPost, isHookBridgeProvider, isQuoteAndPost, isReceiverAccountBridgeProvider };
+interface GetAttestationRequest {
+    depositAddress: Address$1;
+    quoteHash: Hex;
+}
+interface GetAttestationResponse {
+    signature: Hex;
+    version: number;
+}
+declare class NearIntentsApi {
+    private cachedTokens;
+    getTokens(): Promise<TokenResponse[]>;
+    getQuote(request: QuoteRequest): Promise<QuoteResponse>;
+    getStatus(depositAddress: string): Promise<GetExecutionStatusResponse>;
+    getAttestation(request: GetAttestationRequest): Promise<GetAttestationResponse>;
+}
+
+interface NearIntentsQuoteResult extends BridgeQuoteResult {
+    depositAddress: Hex;
+}
+interface NearIntentsBridgeProviderOptions {
+    cowShedOptions?: CowShedSdkOptions;
+}
+declare class NearIntentsBridgeProvider implements ReceiverAccountBridgeProvider<NearIntentsQuoteResult> {
+    type: "ReceiverAccountBridgeProvider";
+    protected api: NearIntentsApi;
+    protected cowShedSdk: CowShedSdk;
+    info: BridgeProviderInfo;
+    constructor(options?: NearIntentsBridgeProviderOptions, _adapter?: AbstractProviderAdapter);
+    getNetworks(): Promise<ChainInfo[]>;
+    getBuyTokens(params: BuyTokensParams): Promise<GetProviderBuyTokens>;
+    getIntermediateTokens(request: QuoteBridgeRequest): Promise<TokenInfo[]>;
+    getQuote(request: QuoteBridgeRequest): Promise<NearIntentsQuoteResult>;
+    getBridgeReceiverOverride(_request: QuoteBridgeRequest, quote: NearIntentsQuoteResult): Promise<string>;
+    getBridgingParams(_chainId: ChainId, order: EnrichedOrder, _txHash: string): Promise<{
+        params: BridgingDepositParams;
+        status: BridgeStatusResult;
+    } | null>;
+    getExplorerUrl(bridgingId: string): string;
+    getStatus(bridgingId: string, _originChainId: SupportedChainId): Promise<BridgeStatusResult>;
+    getCancelBridgingTx(_bridgingId: string): Promise<EvmCall>;
+    getRefundBridgingTx(_bridgingId: string): Promise<EvmCall>;
+    recoverDepositAddress({ quote, quoteRequest, timestamp, }: QuoteResponse): Promise<{
+        address: Address$1;
+        quoteHash: string;
+    } | null>;
+}
+
+export { AcrossBridgeProvider, type AcrossBridgeProviderOptions, type AcrossQuoteResult, type BestQuoteProgressCallback, type BestQuoteProviderContext, type BridgeCallDetails, type BridgeCosts, type BridgeDeposit, type BridgeHook, BridgeOrderParsingError, type BridgeProvider, BridgeProviderError, type BridgeProviderInfo, BridgeProviderQuoteError, type BridgeProviderType, type BridgeQuoteAmountsAndCosts, type BridgeQuoteAndPost, BridgeQuoteErrors, type BridgeQuoteResult, type BridgeQuoteResults, BridgeStatus, type BridgeStatusResult, type BridgingDepositParams, BridgingSdk, 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 DefaultBridgeProvider, type GetProviderBuyTokens, HOOK_DAPP_BRIDGE_PROVIDER_PREFIX, type HookBridgeProvider, type MultiQuoteOptions, type MultiQuoteProgressCallback, type MultiQuoteRequest, type MultiQuoteResult, NearIntentsBridgeProvider, type NearIntentsBridgeProviderOptions, type NearIntentsQuoteResult, type ProviderQuoteContext, type QuoteBridgeRequest, type QuoteBridgeRequestWithoutAmount, RAW_PROVIDERS_FILES_PATH, type ReceiverAccountBridgeProvider, assertIsBridgeQuoteAndPost, assertIsQuoteAndPost, getCrossChainOrder, getPostHooks, isAppDoc, isBridgeQuoteAndPost, isHookBridgeProvider, isQuoteAndPost, isReceiverAccountBridgeProvider };

package/dist/index.d.ts

@@ -4,12 +4,16 @@ import { ChainInfo, TargetChainId, SupportedChainId, TokenInfo, ChainId, EvmCall
 import { QuoterParameters, TraderParameters, TradeOptionalParameters, QuoteAndPost, QuoteResults, SwapAdvancedSettings, SigningStepManager, OrderPostingResult, TradingSdk } from '@cowprotocol/sdk-trading';
 import { AccountAddress, SignerLike, TTLCache, AbstractProviderAdapter } from '@cowprotocol/sdk-common';
 import { CowShedSdk, CowShedSdkOptions } from '@cowprotocol/sdk-cow-shed';
+import { TokenResponse, QuoteRequest, QuoteResponse, GetExecutionStatusResponse } from '@defuse-protocol/one-click-sdk-typescript';
+import { Address as Address$1, Hex } from 'viem';
 
+type BridgeProviderType = 'ReceiverAccountBridgeProvider' | 'HookBridgeProvider';
 interface BridgeProviderInfo {
     name: string;
     logoUrl: string;
     dappId: string;
     website: string;
+    type: BridgeProviderType;
 }
 interface WithSellToken {
     sellTokenChainId: SupportedChainId;
@@ -33,6 +37,14 @@ type QuoteBridgeRequest = {
 } & WithSellToken & WithBuyToken & WithQuoter & WithTrader & TradeOptionalParameters;
 type QuoteBridgeRequestWithoutAmount = Omit<QuoteBridgeRequest, 'amount'>;
 interface BridgeQuoteResult {
+    /**
+     * Unique ID of a quote
+     */
+    id?: string;
+    /**
+     * Provider who implement ReceiverAccountBridgeProvider must return a signature of a quote than will be used to verify the quote deposit address validity
+     */
+    signature?: string;
     /**
      * Whether the quote is a sell or buy order.
      */
@@ -128,7 +140,7 @@ interface BridgeDeposit extends Omit<QuoteBridgeRequest, 'amount'> {
  * It contains the main information about the provider, and the methods to get the quote, the bridging params, the status, the cancelling and the refunding of the bridging.
  */
 interface BridgeProvider<Q extends BridgeQuoteResult> {
-    type: 'ReceiverAccountBridgeProvider' | 'HookBridgeProvider';
+    type: BridgeProviderType;
     info: BridgeProviderInfo;
     /**
      * Get basic supported chains
@@ -156,10 +168,10 @@ interface BridgeProvider<Q extends BridgeQuoteResult> {
     /**
      * Get the identifier of the bridging transaction from the settlement transaction.
      * @param chainId
-     * @param orderUid - The unique identifier of the order
+     * @param order - CoW Protocol order
      * @param txHash - The hash of the settlement transaction in which the bridging post-hook was executed
      */
-    getBridgingParams(chainId: ChainId, orderUid: string, txHash: string): Promise<{
+    getBridgingParams(chainId: ChainId, order: EnrichedOrder, txHash: string): Promise<{
         params: BridgingDepositParams;
         status: BridgeStatusResult;
     } | null>;
@@ -420,6 +432,7 @@ interface BestQuoteProviderContext extends MultiQuoteContext {
         current: MultiQuoteResult | null;
     };
 }
+type DefaultBridgeProvider = BridgeProvider<BridgeQuoteResult>;
 
 declare enum BridgeQuoteErrors {
     NO_INTERMEDIATE_TOKENS = "NO_INTERMEDIATE_TOKENS",
@@ -429,7 +442,8 @@ declare enum BridgeQuoteErrors {
     TX_BUILD_ERROR = "TX_BUILD_ERROR",
     QUOTE_ERROR = "QUOTE_ERROR",
     NO_ROUTES = "NO_ROUTES",
-    INVALID_BRIDGE = "INVALID_BRIDGE"
+    INVALID_BRIDGE = "INVALID_BRIDGE",
+    QUOTE_DOES_NOT_MATCH_DEPOSIT_ADDRESS = "QUOTE_DOES_NOT_MATCH_DEPOSIT_ADDRESS"
 }
 declare class BridgeProviderQuoteError extends Error {
     readonly context?: unknown | undefined;
@@ -448,7 +462,7 @@ declare function isBridgeQuoteAndPost(quote: CrossChainQuoteAndPost): quote is B
 declare function isQuoteAndPost(quote: CrossChainQuoteAndPost): quote is QuoteAndPost;
 declare function assertIsBridgeQuoteAndPost(quote: CrossChainQuoteAndPost): asserts quote is BridgeQuoteAndPost;
 declare function assertIsQuoteAndPost(quote: CrossChainQuoteAndPost): asserts quote is QuoteAndPost;
-declare function getPostHooks(fullAppData?: string): cowAppDataLatestScheme.CoWHook[];
+declare function getPostHooks(fullAppData?: string | object): cowAppDataLatestScheme.CoWHook[];
 declare function isAppDoc(appData: unknown): appData is cowAppDataLatestScheme.AppDataRootSchema;
 declare function isHookBridgeProvider<Q extends BridgeQuoteResult>(provider: BridgeProvider<Q>): provider is HookBridgeProvider<Q>;
 declare function isReceiverAccountBridgeProvider<Q extends BridgeQuoteResult>(provider: BridgeProvider<Q>): provider is ReceiverAccountBridgeProvider<Q>;
@@ -523,12 +537,13 @@ declare class BridgingSdk {
     private singleQuoteStrategy;
     private multiQuoteStrategy;
     private bestQuoteStrategy;
+    private availableProvidersIds;
     constructor(options: BridgingSdkOptions, adapter?: AbstractProviderAdapter);
-    private get provider();
+    setAvailableProviders(ids: string[]): void;
     /**
      * Get the providers for the bridging.
      */
-    getProviders(): BridgeProvider<BridgeQuoteResult>[];
+    getAvailableProviders(): DefaultBridgeProvider[];
     /**
      * Get the available sources networks for the bridging.
      */
@@ -592,8 +607,7 @@ declare class BridgingSdk {
      */
     getBestQuote(request: MultiQuoteRequest): Promise<MultiQuoteResult | null>;
     getOrder(params: GetOrderParams): Promise<CrossChainOrder | null>;
-    getOrderBridgingStatus(bridgingId: string, originChainId: SupportedChainId): Promise<BridgeStatusResult>;
-    getProviderFromAppData(fullAppData: string): BridgeProvider<BridgeQuoteResult> | undefined;
+    getProviderFromAppData(fullAppData: string): DefaultBridgeProvider | undefined;
     /**
      * Clear all caches. Useful for testing and debugging.
      */
@@ -609,7 +623,8 @@ declare class BridgingSdk {
         intermediateTokens: number;
         buyTokens: number;
     };
-    getProviderByDappId(dappId: string): BridgeProvider<BridgeQuoteResult> | undefined;
+    getProviderByDappId(dappId: string): DefaultBridgeProvider | undefined;
+    private getBuyTokensFromProvider;
 }
 
 declare const RAW_PROVIDERS_FILES_PATH = "https://raw.githubusercontent.com/cowprotocol/cow-sdk/refs/heads/main/src/bridging/providers";
@@ -900,7 +915,7 @@ declare class AcrossBridgeProvider implements HookBridgeProvider<AcrossQuoteResu
     getGasLimitEstimationForHook(request: QuoteBridgeRequest): Promise<number>;
     getSignedHook(chainId: SupportedChainId, unsignedCall: EvmCall, bridgeHookNonce: string, deadline: bigint, hookGasLimit: number, signer?: SignerLike): Promise<BridgeHook>;
     decodeBridgeHook(_hook: cowAppDataLatestScheme.CoWHook): Promise<BridgeDeposit>;
-    getBridgingParams(chainId: ChainId, orderUid: string, txHash: string): Promise<{
+    getBridgingParams(chainId: ChainId, order: EnrichedOrder, txHash: string): Promise<{
         params: BridgingDepositParams;
         status: BridgeStatusResult;
     } | null>;
@@ -1220,7 +1235,7 @@ declare class BungeeBridgeProvider implements HookBridgeProvider<BungeeQuoteResu
     getUnsignedBridgeCall(request: QuoteBridgeRequest, quote: BungeeQuoteResult): Promise<EvmCall>;
     getGasLimitEstimationForHook(request: QuoteBridgeRequest): Promise<number>;
     getSignedHook(chainId: SupportedChainId, unsignedCall: EvmCall, bridgeHookNonce: string, deadline: bigint, hookGasLimit: number, signer?: SignerLike): Promise<BridgeHook>;
-    getBridgingParams(_chainId: ChainId, orderId: string, _txHash: string): Promise<{
+    getBridgingParams(_chainId: ChainId, order: EnrichedOrder, _txHash: string): Promise<{
         params: BridgingDepositParams;
         status: BridgeStatusResult;
     } | null>;
@@ -1232,4 +1247,51 @@ declare class BungeeBridgeProvider implements HookBridgeProvider<BungeeQuoteResu
     private isExtraGasRequired;
 }
 
-export { AcrossBridgeProvider, type AcrossBridgeProviderOptions, type AcrossQuoteResult, type BestQuoteProgressCallback, type BestQuoteProviderContext, 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, 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 GetProviderBuyTokens, HOOK_DAPP_BRIDGE_PROVIDER_PREFIX, type HookBridgeProvider, type MultiQuoteOptions, type MultiQuoteProgressCallback, type MultiQuoteRequest, type MultiQuoteResult, type ProviderQuoteContext, type QuoteBridgeRequest, type QuoteBridgeRequestWithoutAmount, RAW_PROVIDERS_FILES_PATH, type ReceiverAccountBridgeProvider, assertIsBridgeQuoteAndPost, assertIsQuoteAndPost, getCrossChainOrder, getPostHooks, isAppDoc, isBridgeQuoteAndPost, isHookBridgeProvider, isQuoteAndPost, isReceiverAccountBridgeProvider };
+interface GetAttestationRequest {
+    depositAddress: Address$1;
+    quoteHash: Hex;
+}
+interface GetAttestationResponse {
+    signature: Hex;
+    version: number;
+}
+declare class NearIntentsApi {
+    private cachedTokens;
+    getTokens(): Promise<TokenResponse[]>;
+    getQuote(request: QuoteRequest): Promise<QuoteResponse>;
+    getStatus(depositAddress: string): Promise<GetExecutionStatusResponse>;
+    getAttestation(request: GetAttestationRequest): Promise<GetAttestationResponse>;
+}
+
+interface NearIntentsQuoteResult extends BridgeQuoteResult {
+    depositAddress: Hex;
+}
+interface NearIntentsBridgeProviderOptions {
+    cowShedOptions?: CowShedSdkOptions;
+}
+declare class NearIntentsBridgeProvider implements ReceiverAccountBridgeProvider<NearIntentsQuoteResult> {
+    type: "ReceiverAccountBridgeProvider";
+    protected api: NearIntentsApi;
+    protected cowShedSdk: CowShedSdk;
+    info: BridgeProviderInfo;
+    constructor(options?: NearIntentsBridgeProviderOptions, _adapter?: AbstractProviderAdapter);
+    getNetworks(): Promise<ChainInfo[]>;
+    getBuyTokens(params: BuyTokensParams): Promise<GetProviderBuyTokens>;
+    getIntermediateTokens(request: QuoteBridgeRequest): Promise<TokenInfo[]>;
+    getQuote(request: QuoteBridgeRequest): Promise<NearIntentsQuoteResult>;
+    getBridgeReceiverOverride(_request: QuoteBridgeRequest, quote: NearIntentsQuoteResult): Promise<string>;
+    getBridgingParams(_chainId: ChainId, order: EnrichedOrder, _txHash: string): Promise<{
+        params: BridgingDepositParams;
+        status: BridgeStatusResult;
+    } | null>;
+    getExplorerUrl(bridgingId: string): string;
+    getStatus(bridgingId: string, _originChainId: SupportedChainId): Promise<BridgeStatusResult>;
+    getCancelBridgingTx(_bridgingId: string): Promise<EvmCall>;
+    getRefundBridgingTx(_bridgingId: string): Promise<EvmCall>;
+    recoverDepositAddress({ quote, quoteRequest, timestamp, }: QuoteResponse): Promise<{
+        address: Address$1;
+        quoteHash: string;
+    } | null>;
+}
+
+export { AcrossBridgeProvider, type AcrossBridgeProviderOptions, type AcrossQuoteResult, type BestQuoteProgressCallback, type BestQuoteProviderContext, type BridgeCallDetails, type BridgeCosts, type BridgeDeposit, type BridgeHook, BridgeOrderParsingError, type BridgeProvider, BridgeProviderError, type BridgeProviderInfo, BridgeProviderQuoteError, type BridgeProviderType, type BridgeQuoteAmountsAndCosts, type BridgeQuoteAndPost, BridgeQuoteErrors, type BridgeQuoteResult, type BridgeQuoteResults, BridgeStatus, type BridgeStatusResult, type BridgingDepositParams, BridgingSdk, 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 DefaultBridgeProvider, type GetProviderBuyTokens, HOOK_DAPP_BRIDGE_PROVIDER_PREFIX, type HookBridgeProvider, type MultiQuoteOptions, type MultiQuoteProgressCallback, type MultiQuoteRequest, type MultiQuoteResult, NearIntentsBridgeProvider, type NearIntentsBridgeProviderOptions, type NearIntentsQuoteResult, type ProviderQuoteContext, type QuoteBridgeRequest, type QuoteBridgeRequestWithoutAmount, RAW_PROVIDERS_FILES_PATH, type ReceiverAccountBridgeProvider, assertIsBridgeQuoteAndPost, assertIsQuoteAndPost, getCrossChainOrder, getPostHooks, isAppDoc, isBridgeQuoteAndPost, isHookBridgeProvider, isQuoteAndPost, isReceiverAccountBridgeProvider };