@defuse-protocol/intents-sdk 0.43.3 → 0.45.0

package/dist/src/lib/validateAddress.cjs

@@ -1,10 +1,10 @@
 const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
 const require_caip2 = require('./caip2.cjs');
-let __defuse_protocol_internal_utils = require("@defuse-protocol/internal-utils");
+let _defuse_protocol_internal_utils = require("@defuse-protocol/internal-utils");
 let viem = require("viem");
-let __noble_hashes_sha2 = require("@noble/hashes/sha2");
-let __scure_base = require("@scure/base");
-let __solana_web3_js = require("@solana/web3.js");
+let _noble_hashes_sha2 = require("@noble/hashes/sha2");
+let _scure_base = require("@scure/base");
+let _solana_web3_js = require("@solana/web3.js");
 let ripple_address_codec = require("ripple-address-codec");
 
 //#region src/lib/validateAddress.ts
@@ -17,7 +17,7 @@ let ripple_address_codec = require("ripple-address-codec");
 */
 function validateAddress(address, blockchain) {
 	switch (blockchain) {
-		case require_caip2.Chains.Near: return __defuse_protocol_internal_utils.utils.validateNearAddress(address);
+		case require_caip2.Chains.Near: return _defuse_protocol_internal_utils.utils.validateNearAddress(address);
 		case require_caip2.Chains.Bitcoin: return validateBtcAddress(address);
 		case require_caip2.Chains.BitcoinCash: return validateBchAddress(address);
 		case require_caip2.Chains.Solana: return validateSolAddress(address);
@@ -43,7 +43,9 @@ function validateAddress(address, blockchain) {
 		case require_caip2.Chains.Base:
 		case require_caip2.Chains.Arbitrum:
 		case require_caip2.Chains.Avalanche:
-		case require_caip2.Chains.Berachain: return validateEthAddress(address);
+		case require_caip2.Chains.Berachain:
+		case require_caip2.Chains.Plasma:
+		case require_caip2.Chains.Scroll: return validateEthAddress(address);
 		default: return false;
 	}
 }
@@ -111,7 +113,7 @@ function verifyBchChecksum(address) {
 }
 function validateSolAddress(address) {
 	try {
-		return __solana_web3_js.PublicKey.isOnCurve(address);
+		return _solana_web3_js.PublicKey.isOnCurve(address);
 	} catch {
 		return false;
 	}
@@ -132,7 +134,7 @@ function validateZcashAddress(address) {
 	if (address.startsWith("t1") || address.startsWith("t3")) return /^t[13][a-km-zA-HJ-NP-Z1-9]{33}$/.test(address);
 	const expectedHrp = "tex";
 	if (address.startsWith(`${expectedHrp}1`)) try {
-		const decoded = __scure_base.bech32m.decodeToBytes(address);
+		const decoded = _scure_base.bech32m.decodeToBytes(address);
 		if (decoded.prefix !== expectedHrp) return false;
 		return decoded.bytes.length === 20;
 	} catch {
@@ -140,7 +142,7 @@ function validateZcashAddress(address) {
 	}
 	const uaHrp = "u";
 	if (address.startsWith(`${uaHrp}1`)) try {
-		return __scure_base.bech32m.decodeToBytes(address).prefix === uaHrp;
+		return _scure_base.bech32m.decodeToBytes(address).prefix === uaHrp;
 	} catch {
 		return false;
 	}
@@ -158,11 +160,11 @@ function validateTronAddress(address) {
 }
 function validateTronBase58Address(address) {
 	try {
-		const decoded = __scure_base.base58.decode(address);
+		const decoded = _scure_base.base58.decode(address);
 		if (decoded.length !== 25) return false;
 		const data = decoded.slice(0, 21);
 		const checksum = decoded.slice(21);
-		const expectedChecksum = (0, __noble_hashes_sha2.sha256)((0, __noble_hashes_sha2.sha256)(data)).slice(0, 4);
+		const expectedChecksum = (0, _noble_hashes_sha2.sha256)((0, _noble_hashes_sha2.sha256)(data)).slice(0, 4);
 		for (let i = 0; i < 4; i++) if (checksum[i] !== expectedChecksum[i]) return false;
 		return data[0] === 65;
 	} catch {
@@ -171,7 +173,7 @@ function validateTronBase58Address(address) {
 }
 function validateTronHexAddress(address) {
 	try {
-		const decoded = __scure_base.hex.decode(address);
+		const decoded = _scure_base.hex.decode(address);
 		return decoded.length === 21 && decoded[0] === 65;
 	} catch {
 		return false;
@@ -195,9 +197,9 @@ function validateAptosAddress(address) {
 */
 function validateCardanoAddress(address) {
 	try {
-		const { prefix, words } = __scure_base.bech32.decode(address, 120);
+		const { prefix, words } = _scure_base.bech32.decode(address, 120);
 		if (prefix !== "addr") return false;
-		const addrType = __scure_base.bech32.fromWords(words)[0] >> 4;
+		const addrType = _scure_base.bech32.fromWords(words)[0] >> 4;
 		return addrType >= 0 && addrType <= 7;
 	} catch {
 		return false;
@@ -222,7 +224,7 @@ function validateLitecoinAddress(address) {
 function validateLitecoinBase58Address(address, expectedVersion) {
 	let decoded;
 	try {
-		decoded = __scure_base.base58.decode(address);
+		decoded = _scure_base.base58.decode(address);
 	} catch {
 		return false;
 	}
@@ -230,7 +232,7 @@ function validateLitecoinBase58Address(address, expectedVersion) {
 	if (decoded[0] !== expectedVersion) return false;
 	const payload = decoded.subarray(0, 21);
 	const checksum = decoded.subarray(21, 25);
-	const expectedChecksum = (0, __noble_hashes_sha2.sha256)((0, __noble_hashes_sha2.sha256)(payload)).subarray(0, 4);
+	const expectedChecksum = (0, _noble_hashes_sha2.sha256)((0, _noble_hashes_sha2.sha256)(payload)).subarray(0, 4);
 	for (let i = 0; i < 4; i++) if (checksum[i] !== expectedChecksum[i]) return false;
 	return true;
 }
@@ -238,10 +240,10 @@ function validateLitecoinBech32Address(address) {
 	let decoded;
 	let isBech32m = false;
 	try {
-		decoded = __scure_base.bech32.decode(address);
+		decoded = _scure_base.bech32.decode(address);
 	} catch {
 		try {
-			decoded = __scure_base.bech32m.decode(address);
+			decoded = _scure_base.bech32m.decode(address);
 			isBech32m = true;
 		} catch {
 			return false;
@@ -252,7 +254,7 @@ function validateLitecoinBech32Address(address) {
 	if (!words || words.length < 1) return false;
 	const version = words[0];
 	if (version == null || version < 0 || version > 16) return false;
-	const progLen = __scure_base.bech32.fromWords(words.slice(1)).length;
+	const progLen = _scure_base.bech32.fromWords(words.slice(1)).length;
 	if (progLen < 2 || progLen > 40) return false;
 	if (version === 0) {
 		if (isBech32m) return false;

package/dist/src/lib/validateAddress.js

@@ -42,7 +42,9 @@ function validateAddress(address, blockchain) {
 		case Chains.Base:
 		case Chains.Arbitrum:
 		case Chains.Avalanche:
-		case Chains.Berachain: return validateEthAddress(address);
+		case Chains.Berachain:
+		case Chains.Plasma:
+		case Chains.Scroll: return validateEthAddress(address);
 		default: return false;
 	}
 }

package/dist/src/sdk.cjs

@@ -1,5 +1,6 @@
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
 const require_errors = require('./classes/errors.cjs');
+const require_route_enum = require('./constants/route-enum.cjs');
 const require_caip2 = require('./lib/caip2.cjs');
 const require_aurora_engine_bridge = require('./bridges/aurora-engine-bridge/aurora-engine-bridge.cjs');
 const require_direct_bridge = require('./bridges/direct-bridge/direct-bridge.cjs');
@@ -16,11 +17,11 @@ const require_intent_relayer_public = require('./intents/intent-relayer-impl/int
 const require_intent_signer_noop = require('./intents/intent-signer-impl/intent-signer-noop.cjs');
 const require_array = require('./lib/array.cjs');
 const require_configure_rpc_config = require('./lib/configure-rpc-config.cjs');
-const require_route_config = require('./lib/route-config.cjs');
+const require_withdrawal_watcher = require('./core/withdrawal-watcher.cjs');
 const require_salt_manager = require('./intents/salt-manager.cjs');
 const require_intent_payload_builder = require('./intents/intent-payload-builder.cjs');
-let __defuse_protocol_internal_utils = require("@defuse-protocol/internal-utils");
-let __hot_labs_omni_sdk = require("@hot-labs/omni-sdk");
+let _defuse_protocol_internal_utils = require("@defuse-protocol/internal-utils");
+let _hot_labs_omni_sdk = require("@hot-labs/omni-sdk");
 let viem = require("viem");
 let valibot = require("valibot");
 valibot = require_rolldown_runtime.__toESM(valibot);
@@ -31,9 +32,9 @@ var IntentsSDK = class {
 		this.env = args.env ?? "production";
 		this.referral = args.referral;
 		this.solverRelayApiKey = args.solverRelayApiKey;
-		const nearRpcUrls = args.rpc?.[require_caip2.Chains.Near] ?? __defuse_protocol_internal_utils.PUBLIC_NEAR_RPC_URLS;
-		(0, __defuse_protocol_internal_utils.assert)(nearRpcUrls.length > 0, "NEAR RPC URLs are not provided");
-		const nearProvider = (0, __defuse_protocol_internal_utils.nearFailoverRpcProvider)({ urls: nearRpcUrls });
+		const nearRpcUrls = args.rpc?.[require_caip2.Chains.Near] ?? _defuse_protocol_internal_utils.PUBLIC_NEAR_RPC_URLS;
+		(0, _defuse_protocol_internal_utils.assert)(nearRpcUrls.length > 0, "NEAR RPC URLs are not provided");
+		const nearProvider = (0, _defuse_protocol_internal_utils.nearFailoverRpcProvider)({ urls: nearRpcUrls });
 		const stellarRpcUrls = require_configure_rpc_config.configureStellarRpcUrls(require_public_rpc_urls.PUBLIC_STELLAR_RPC_URLS, args.rpc);
 		const evmRpcUrls = require_configure_rpc_config.configureEvmRpcUrls(require_public_rpc_urls.PUBLIC_EVM_RPC_URLS, args.rpc, require_hot_bridge_chains.HotBridgeEVMChains);
 		/**
@@ -47,11 +48,14 @@ var IntentsSDK = class {
 				nearProvider,
 				solverRelayApiKey: this.solverRelayApiKey
 			}),
-			new require_poa_bridge.PoaBridge({ env: this.env }),
+			new require_poa_bridge.PoaBridge({
+				env: this.env,
+				routeMigratedPoaTokensThroughOmniBridge: args.features?.routeMigratedPoaTokensThroughOmniBridge
+			}),
 			new require_hot_bridge.HotBridge({
 				env: this.env,
 				solverRelayApiKey: this.solverRelayApiKey,
-				hotSdk: new __hot_labs_omni_sdk.HotBridge({
+				hotSdk: new _hot_labs_omni_sdk.HotBridge({
 					logger: console,
 					evmRpc: evmRpcUrls,
 					nearRpc: nearRpcUrls,
@@ -65,7 +69,8 @@ var IntentsSDK = class {
 			new require_omni_bridge.OmniBridge({
 				env: this.env,
 				nearProvider,
-				solverRelayApiKey: this.solverRelayApiKey
+				solverRelayApiKey: this.solverRelayApiKey,
+				routeMigratedPoaTokensThroughOmniBridge: args.features?.routeMigratedPoaTokensThroughOmniBridge
 			}),
 			new require_direct_bridge.DirectBridge({
 				env: this.env,
@@ -140,7 +145,7 @@ var IntentsSDK = class {
 	async invalidateNonces(args) {
 		if (args.nonces.length === 0) return;
 		const intentSigner = args.signer ?? this.intentSigner;
-		(0, __defuse_protocol_internal_utils.assert)(intentSigner != null, "Intent signer is not provided");
+		(0, _defuse_protocol_internal_utils.assert)(intentSigner != null, "Intent signer is not provided");
 		const signedIntents = await Promise.all(args.nonces.map(async (nonce) => {
 			const builder = this.intentBuilder().setNonce(nonce);
 			try {
@@ -207,42 +212,87 @@ var IntentsSDK = class {
 		}
 		throw new Error(`Cannot determine bridge for withdrawal = ${(0, viem.stringify)(args.withdrawalParams)}`);
 	}
-	getWithdrawalsIdentifiers({ withdrawalParams, intentTx }) {
-		const indexes = /* @__PURE__ */ new Map();
-		return withdrawalParams.map((w) => {
-			const routeConfig = require_route_config.determineRouteConfig(this, w);
-			const route = routeConfig.route;
-			const currentIndex = indexes.get(route) ?? 0;
-			indexes.set(route, currentIndex + 1);
-			return {
-				routeConfig,
-				index: currentIndex,
-				withdrawalParams: w,
-				tx: intentTx
-			};
-		});
-	}
 	async waitForWithdrawalCompletion(args) {
-		const wids = this.getWithdrawalsIdentifiers({
-			withdrawalParams: Array.isArray(args.withdrawalParams) ? args.withdrawalParams : [args.withdrawalParams],
-			intentTx: args.intentTx
+		const withdrawalParamsArray = Array.isArray(args.withdrawalParams) ? args.withdrawalParams : [args.withdrawalParams];
+		const promises = this.createWithdrawalCompletionPromises({
+			withdrawalParams: withdrawalParamsArray,
+			intentTx: args.intentTx,
+			signal: args.signal,
+			logger: args.logger
 		});
-		const result = await Promise.all(wids.map((wid) => {
-			for (const bridge of this.bridges) if (bridge.is(wid.routeConfig)) return bridge.waitForWithdrawalCompletion({
-				tx: args.intentTx,
-				index: wid.index,
-				withdrawalParams: wid.withdrawalParams,
-				routeConfig: wid.routeConfig,
-				signal: args.signal,
-				retryOptions: args.retryOptions,
-				logger: args.logger
-			});
-			throw new Error(`Unsupported route = ${(0, viem.stringify)(wid.routeConfig)}`);
-		}));
+		const result = await Promise.all(promises);
 		if (Array.isArray(args.withdrawalParams)) return result;
-		(0, __defuse_protocol_internal_utils.assert)(result.length === 1, "Unexpected result length");
+		(0, _defuse_protocol_internal_utils.assert)(result.length === 1, "Unexpected result length");
 		return result[0];
 	}
+	/**
+	* Create promises that resolve when each withdrawal completes on the destination chain.
+	* Use this for granular control over handling individual withdrawals as they complete,
+	* rather than waiting for all to finish.
+	*
+	* **Important:** Each promise waits until the withdrawal completes, fails, or the
+	* chain-specific p99 timeout is exceeded. Use `AbortSignal.timeout()` to set a
+	* shorter timeout budget.
+	*
+	* @throws {WithdrawalWatchError} When status polling fails (timeout or consecutive errors).
+	*   Inspect `error.cause` to determine the reason.
+	* @throws {WithdrawalFailedError} When the withdrawal fails on the destination chain.
+	* @throws {DOMException} When the provided AbortSignal is aborted (name: "AbortError").
+	*
+	* @param params.withdrawalParams - Array of withdrawal parameters
+	* @param params.intentTx - The NEAR transaction info from the published intent
+	* @param params.signal - Optional AbortSignal for cancellation/timeout
+	* @param params.logger - Optional logger for debugging
+	* @returns Array of promises, one per withdrawal, that resolve with transaction info
+	*
+	* @example
+	* ```typescript
+	* const promises = sdk.createWithdrawalCompletionPromises({
+	*   withdrawalParams: [withdrawal1, withdrawal2],
+	*   intentTx,
+	*   signal: AbortSignal.timeout(5 * 60 * 1000), // 5 minute timeout
+	* });
+	*
+	* // Handle each withdrawal as it completes
+	* for (const promise of promises) {
+	*   promise.then((result) => console.log('Withdrawal completed:', result));
+	* }
+	* ```
+	*/
+	createWithdrawalCompletionPromises(params) {
+		const { withdrawalParams, intentTx, signal, logger } = params;
+		const widsPromise = require_withdrawal_watcher.createWithdrawalIdentifiers({
+			bridges: this.bridges,
+			withdrawalParams,
+			intentTx
+		});
+		const hotChainLastPromise = /* @__PURE__ */ new Map();
+		return withdrawalParams.map(async (_, index) => {
+			const entry = (await widsPromise)[index];
+			(0, _defuse_protocol_internal_utils.assert)(entry != null, `Missing wid for index ${index}`);
+			if (entry.bridge.route === require_route_enum.RouteEnum.HotBridge) {
+				const landingChain = entry.wid.landingChain;
+				const previousPromise = hotChainLastPromise.get(landingChain);
+				const sequentialPromise = (async () => {
+					if (previousPromise) await Promise.allSettled([previousPromise]);
+					return require_withdrawal_watcher.watchWithdrawal({
+						bridge: entry.bridge,
+						wid: entry.wid,
+						signal,
+						logger
+					});
+				})();
+				hotChainLastPromise.set(landingChain, sequentialPromise);
+				return sequentialPromise;
+			}
+			return require_withdrawal_watcher.watchWithdrawal({
+				bridge: entry.bridge,
+				wid: entry.wid,
+				signal,
+				logger
+			});
+		});
+	}
 	parseAssetId(assetId) {
 		for (const bridge of this.bridges) {
 			const parsed = bridge.parseAssetId(assetId);
@@ -252,7 +302,7 @@ var IntentsSDK = class {
 	}
 	async signAndSendIntent(args) {
 		const intentSigner = args.signer ?? this.intentSigner;
-		(0, __defuse_protocol_internal_utils.assert)(intentSigner != null, "Intent signer is not provided");
+		(0, _defuse_protocol_internal_utils.assert)(intentSigner != null, "Intent signer is not provided");
 		const intentExecuter = new require_intent_executer.IntentExecuter({
 			env: this.env,
 			logger: args.logger,
@@ -273,7 +323,7 @@ var IntentsSDK = class {
 		try {
 			return await fn(await this.saltManager.getCachedSalt());
 		} catch (err) {
-			if (!(err instanceof __defuse_protocol_internal_utils.RelayPublishError && err.code === "INVALID_SALT")) throw err;
+			if (!(err instanceof _defuse_protocol_internal_utils.RelayPublishError && err.code === "INVALID_SALT")) throw err;
 			args.logger?.warn?.("Salt error detected. Refreshing salt and retrying");
 			return fn(await this.saltManager.refresh());
 		}
@@ -322,12 +372,12 @@ var IntentsSDK = class {
 			logger: args.logger,
 			intentSigner: require_intent_signer_noop.noopIntentSigner,
 			intentRelayer: this.intentRelayer
-		}).waitForSettlement(args.intentHash);
+		}).waitForSettlement(args.intentHash, { signal: args.signal });
 		return tx;
 	}
 	async getIntentStatus({ intentHash, logger }) {
-		return __defuse_protocol_internal_utils.solverRelay.getStatus({ intent_hash: intentHash }, {
-			baseURL: __defuse_protocol_internal_utils.configsByEnvironment[this.env].solverRelayBaseURL,
+		return _defuse_protocol_internal_utils.solverRelay.getStatus({ intent_hash: intentHash }, {
+			baseURL: _defuse_protocol_internal_utils.configsByEnvironment[this.env].solverRelayBaseURL,
 			logger,
 			solverRelayApiKey: this.solverRelayApiKey
 		});
@@ -355,7 +405,6 @@ var IntentsSDK = class {
 		const destinationTx = await this.waitForWithdrawalCompletion({
 			withdrawalParams,
 			intentTx,
-			retryOptions: args.retryOptions ?? __defuse_protocol_internal_utils.RETRY_CONFIGS.FIVE_MINS_STEADY,
 			logger: args.logger
 		});
 		if (!Array.isArray(args.withdrawalParams)) return {

package/dist/src/sdk.d.cts

@@ -1,10 +1,10 @@
 import { IntentHash, IntentPrimitive } from "./intents/shared-types.cjs";
 import { IIntentSigner } from "./intents/interfaces/intent-signer.cjs";
-import { BatchWithdrawalResult, Bridge, FeeEstimation, IIntentsSDK, IntentPublishResult, IntentSettlementStatus, NearTxInfo, ParsedAssetInfo, PartialRPCEndpointMap, ProcessWithdrawalArgs, QuoteOptions, SignAndSendArgs, SignAndSendWithdrawalArgs, TxInfo, TxNoInfo, WithdrawalIdentifier, WithdrawalParams, WithdrawalResult } from "./shared-types.cjs";
+import { BatchWithdrawalResult, Bridge, CreateWithdrawalCompletionPromisesParams, FeeEstimation, IIntentsSDK, IntentPublishResult, IntentSettlementStatus, NearTxInfo, ParsedAssetInfo, PartialRPCEndpointMap, ProcessWithdrawalArgs, QuoteOptions, SignAndSendArgs, SignAndSendWithdrawalArgs, TxInfo, TxNoInfo, WithdrawalParams, WithdrawalResult } from "./shared-types.cjs";
 import { IIntentRelayer } from "./intents/interfaces/intent-relayer.cjs";
 import { ISaltManager } from "./intents/interfaces/salt-manager.cjs";
 import { IntentPayloadBuilder } from "./intents/intent-payload-builder.cjs";
-import { ILogger, NearIntentsEnv, RetryOptions } from "@defuse-protocol/internal-utils";
+import { ILogger, NearIntentsEnv } from "@defuse-protocol/internal-utils";
 
 //#region src/sdk.d.ts
 interface IntentsSDKConfig {
@@ -13,6 +13,13 @@ interface IntentsSDKConfig {
   rpc?: PartialRPCEndpointMap;
   referral: string;
   solverRelayApiKey?: string;
+  features?: {
+    /**
+     * Route migrated POA tokens (*.omft.near) through Omni Bridge.
+     * Enable this to use Omni Bridge for POA tokens that have been migrated to the Omni infrastructure.
+     */
+    routeMigratedPoaTokensThroughOmniBridge?: boolean;
+  };
 }
 declare class IntentsSDK implements IIntentsSDK {
   protected env: NearIntentsEnv;
@@ -96,33 +103,87 @@ declare class IntentsSDK implements IIntentsSDK {
     quoteOptions?: QuoteOptions;
     logger?: ILogger;
   }): Promise<FeeEstimation>;
-  protected getWithdrawalsIdentifiers({
-    withdrawalParams,
-    intentTx
-  }: {
-    withdrawalParams: WithdrawalParams[];
-    intentTx: NearTxInfo;
-  }): WithdrawalIdentifier[];
+  /**
+   * Wait for withdrawal(s) to complete on the destination chain.
+   *
+   * **Important:** Waits until the withdrawal completes, fails, or the chain-specific
+   * p99 timeout is exceeded. Use `AbortSignal.timeout()` to set a shorter timeout budget.
+   *
+   * @throws {WithdrawalWatchError} When status polling fails (timeout or consecutive errors).
+   *   Inspect `error.cause` to determine the reason.
+   * @throws {WithdrawalFailedError} When the withdrawal fails on the destination chain.
+   * @throws {DOMException} When the provided AbortSignal is aborted (name: "AbortError").
+   *
+   * @param args.withdrawalParams - Single withdrawal or array of withdrawals
+   * @param args.intentTx - The NEAR transaction info from the published intent
+   * @param args.signal - Optional AbortSignal for cancellation/timeout
+   * @param args.logger - Optional logger for debugging
+   *
+   * @example
+   * ```typescript
+   * // With timeout
+   * const result = await sdk.waitForWithdrawalCompletion({
+   *   withdrawalParams,
+   *   intentTx,
+   *   signal: AbortSignal.timeout(5 * 60 * 1000), // 5 minute timeout
+   * });
+   * ```
+   */
   waitForWithdrawalCompletion(args: {
     withdrawalParams: WithdrawalParams;
     intentTx: NearTxInfo;
     signal?: AbortSignal;
-    retryOptions?: RetryOptions;
     logger?: ILogger;
   }): Promise<TxInfo | TxNoInfo>;
   waitForWithdrawalCompletion(args: {
     withdrawalParams: WithdrawalParams[];
     intentTx: NearTxInfo;
     signal?: AbortSignal;
-    retryOptions?: RetryOptions;
     logger?: ILogger;
   }): Promise<Array<TxInfo | TxNoInfo>>;
+  /**
+   * Create promises that resolve when each withdrawal completes on the destination chain.
+   * Use this for granular control over handling individual withdrawals as they complete,
+   * rather than waiting for all to finish.
+   *
+   * **Important:** Each promise waits until the withdrawal completes, fails, or the
+   * chain-specific p99 timeout is exceeded. Use `AbortSignal.timeout()` to set a
+   * shorter timeout budget.
+   *
+   * @throws {WithdrawalWatchError} When status polling fails (timeout or consecutive errors).
+   *   Inspect `error.cause` to determine the reason.
+   * @throws {WithdrawalFailedError} When the withdrawal fails on the destination chain.
+   * @throws {DOMException} When the provided AbortSignal is aborted (name: "AbortError").
+   *
+   * @param params.withdrawalParams - Array of withdrawal parameters
+   * @param params.intentTx - The NEAR transaction info from the published intent
+   * @param params.signal - Optional AbortSignal for cancellation/timeout
+   * @param params.logger - Optional logger for debugging
+   * @returns Array of promises, one per withdrawal, that resolve with transaction info
+   *
+   * @example
+   * ```typescript
+   * const promises = sdk.createWithdrawalCompletionPromises({
+   *   withdrawalParams: [withdrawal1, withdrawal2],
+   *   intentTx,
+   *   signal: AbortSignal.timeout(5 * 60 * 1000), // 5 minute timeout
+   * });
+   *
+   * // Handle each withdrawal as it completes
+   * for (const promise of promises) {
+   *   promise.then((result) => console.log('Withdrawal completed:', result));
+   * }
+   * ```
+   */
+  createWithdrawalCompletionPromises(params: CreateWithdrawalCompletionPromisesParams): Array<Promise<TxInfo | TxNoInfo>>;
   parseAssetId(assetId: string): ParsedAssetInfo;
   signAndSendIntent(args: SignAndSendArgs): Promise<IntentPublishResult>;
   private withSaltRetry;
   signAndSendWithdrawalIntent(args: SignAndSendWithdrawalArgs<WithdrawalParams> | SignAndSendWithdrawalArgs<WithdrawalParams[]>): Promise<IntentPublishResult>;
   waitForIntentSettlement(args: {
     intentHash: IntentHash;
+    /** AbortSignal for cancellation/timeout. Use AbortSignal.timeout(ms) for timeout. */
+    signal?: AbortSignal;
     logger?: ILogger;
   }): Promise<NearTxInfo>;
   getIntentStatus({

package/dist/src/sdk.d.ts

@@ -1,10 +1,10 @@
 import { IntentHash, IntentPrimitive } from "./intents/shared-types.js";
 import { IIntentSigner } from "./intents/interfaces/intent-signer.js";
-import { BatchWithdrawalResult, Bridge, FeeEstimation, IIntentsSDK, IntentPublishResult, IntentSettlementStatus, NearTxInfo, ParsedAssetInfo, PartialRPCEndpointMap, ProcessWithdrawalArgs, QuoteOptions, SignAndSendArgs, SignAndSendWithdrawalArgs, TxInfo, TxNoInfo, WithdrawalIdentifier, WithdrawalParams, WithdrawalResult } from "./shared-types.js";
+import { BatchWithdrawalResult, Bridge, CreateWithdrawalCompletionPromisesParams, FeeEstimation, IIntentsSDK, IntentPublishResult, IntentSettlementStatus, NearTxInfo, ParsedAssetInfo, PartialRPCEndpointMap, ProcessWithdrawalArgs, QuoteOptions, SignAndSendArgs, SignAndSendWithdrawalArgs, TxInfo, TxNoInfo, WithdrawalParams, WithdrawalResult } from "./shared-types.js";
 import { IIntentRelayer } from "./intents/interfaces/intent-relayer.js";
 import { ISaltManager } from "./intents/interfaces/salt-manager.js";
 import { IntentPayloadBuilder } from "./intents/intent-payload-builder.js";
-import { ILogger, NearIntentsEnv, RetryOptions } from "@defuse-protocol/internal-utils";
+import { ILogger, NearIntentsEnv } from "@defuse-protocol/internal-utils";
 
 //#region src/sdk.d.ts
 interface IntentsSDKConfig {
@@ -13,6 +13,13 @@ interface IntentsSDKConfig {
   rpc?: PartialRPCEndpointMap;
   referral: string;
   solverRelayApiKey?: string;
+  features?: {
+    /**
+     * Route migrated POA tokens (*.omft.near) through Omni Bridge.
+     * Enable this to use Omni Bridge for POA tokens that have been migrated to the Omni infrastructure.
+     */
+    routeMigratedPoaTokensThroughOmniBridge?: boolean;
+  };
 }
 declare class IntentsSDK implements IIntentsSDK {
   protected env: NearIntentsEnv;
@@ -96,33 +103,87 @@ declare class IntentsSDK implements IIntentsSDK {
     quoteOptions?: QuoteOptions;
     logger?: ILogger;
   }): Promise<FeeEstimation>;
-  protected getWithdrawalsIdentifiers({
-    withdrawalParams,
-    intentTx
-  }: {
-    withdrawalParams: WithdrawalParams[];
-    intentTx: NearTxInfo;
-  }): WithdrawalIdentifier[];
+  /**
+   * Wait for withdrawal(s) to complete on the destination chain.
+   *
+   * **Important:** Waits until the withdrawal completes, fails, or the chain-specific
+   * p99 timeout is exceeded. Use `AbortSignal.timeout()` to set a shorter timeout budget.
+   *
+   * @throws {WithdrawalWatchError} When status polling fails (timeout or consecutive errors).
+   *   Inspect `error.cause` to determine the reason.
+   * @throws {WithdrawalFailedError} When the withdrawal fails on the destination chain.
+   * @throws {DOMException} When the provided AbortSignal is aborted (name: "AbortError").
+   *
+   * @param args.withdrawalParams - Single withdrawal or array of withdrawals
+   * @param args.intentTx - The NEAR transaction info from the published intent
+   * @param args.signal - Optional AbortSignal for cancellation/timeout
+   * @param args.logger - Optional logger for debugging
+   *
+   * @example
+   * ```typescript
+   * // With timeout
+   * const result = await sdk.waitForWithdrawalCompletion({
+   *   withdrawalParams,
+   *   intentTx,
+   *   signal: AbortSignal.timeout(5 * 60 * 1000), // 5 minute timeout
+   * });
+   * ```
+   */
   waitForWithdrawalCompletion(args: {
     withdrawalParams: WithdrawalParams;
     intentTx: NearTxInfo;
     signal?: AbortSignal;
-    retryOptions?: RetryOptions;
     logger?: ILogger;
   }): Promise<TxInfo | TxNoInfo>;
   waitForWithdrawalCompletion(args: {
     withdrawalParams: WithdrawalParams[];
     intentTx: NearTxInfo;
     signal?: AbortSignal;
-    retryOptions?: RetryOptions;
     logger?: ILogger;
   }): Promise<Array<TxInfo | TxNoInfo>>;
+  /**
+   * Create promises that resolve when each withdrawal completes on the destination chain.
+   * Use this for granular control over handling individual withdrawals as they complete,
+   * rather than waiting for all to finish.
+   *
+   * **Important:** Each promise waits until the withdrawal completes, fails, or the
+   * chain-specific p99 timeout is exceeded. Use `AbortSignal.timeout()` to set a
+   * shorter timeout budget.
+   *
+   * @throws {WithdrawalWatchError} When status polling fails (timeout or consecutive errors).
+   *   Inspect `error.cause` to determine the reason.
+   * @throws {WithdrawalFailedError} When the withdrawal fails on the destination chain.
+   * @throws {DOMException} When the provided AbortSignal is aborted (name: "AbortError").
+   *
+   * @param params.withdrawalParams - Array of withdrawal parameters
+   * @param params.intentTx - The NEAR transaction info from the published intent
+   * @param params.signal - Optional AbortSignal for cancellation/timeout
+   * @param params.logger - Optional logger for debugging
+   * @returns Array of promises, one per withdrawal, that resolve with transaction info
+   *
+   * @example
+   * ```typescript
+   * const promises = sdk.createWithdrawalCompletionPromises({
+   *   withdrawalParams: [withdrawal1, withdrawal2],
+   *   intentTx,
+   *   signal: AbortSignal.timeout(5 * 60 * 1000), // 5 minute timeout
+   * });
+   *
+   * // Handle each withdrawal as it completes
+   * for (const promise of promises) {
+   *   promise.then((result) => console.log('Withdrawal completed:', result));
+   * }
+   * ```
+   */
+  createWithdrawalCompletionPromises(params: CreateWithdrawalCompletionPromisesParams): Array<Promise<TxInfo | TxNoInfo>>;
   parseAssetId(assetId: string): ParsedAssetInfo;
   signAndSendIntent(args: SignAndSendArgs): Promise<IntentPublishResult>;
   private withSaltRetry;
   signAndSendWithdrawalIntent(args: SignAndSendWithdrawalArgs<WithdrawalParams> | SignAndSendWithdrawalArgs<WithdrawalParams[]>): Promise<IntentPublishResult>;
   waitForIntentSettlement(args: {
     intentHash: IntentHash;
+    /** AbortSignal for cancellation/timeout. Use AbortSignal.timeout(ms) for timeout. */
+    signal?: AbortSignal;
     logger?: ILogger;
   }): Promise<NearTxInfo>;
   getIntentStatus({