@defuse-protocol/intents-sdk 0.59.0 → 0.60.0

package/README.md

@@ -342,6 +342,8 @@ console.log('Batch fees:', batchFees); // Array of FeeEstimation objects
 
 > **Note:** `estimateWithdrawalFee` also runs `validateWithdrawal` internally. If the withdrawal parameters are invalid (e.g. invalid destination address, amount below minimum, insufficient UTXOs), the bridge's `validateWithdrawal` will throw and the error will propagate from `estimateWithdrawalFee`.
 
+> **Note:** When `amount` is `0n` and `feeInclusive` is `false`, minimum amount validation is skipped. This is useful when the exact withdrawal amount is not yet known and you only need a fee estimate.
+
 ## Advanced Usage
 
 ### Custom RPC URLs

package/dist/src/bridges/omni-bridge/omni-bridge.cjs

@@ -164,7 +164,9 @@ var OmniBridge = class {
 		const decimals = await this.getCachedTokenDecimals(destTokenAddress);
 		(0, _defuse_protocol_internal_utils.assert)(decimals !== null, `Failed to retrieve token decimals for address ${destTokenAddress} via OmniBridge contract. 
   Ensure the token is supported and the address is correct.`);
-		if ((0, _omni_bridge_core.verifyTransferAmount)(args.amount, 0n, decimals.origin_decimals, decimals.decimals) === false) throw new require_errors.MinWithdrawalAmountError((0, _omni_bridge_core.getMinimumTransferableAmount)(decimals.origin_decimals, decimals.decimals), args.amount, args.assetId);
+		if (!args.skipMinAmountValidation) {
+			if ((0, _omni_bridge_core.verifyTransferAmount)(args.amount, 0n, decimals.origin_decimals, decimals.decimals) === false) throw new require_errors.MinWithdrawalAmountError((0, _omni_bridge_core.getMinimumTransferableAmount)(decimals.origin_decimals, decimals.decimals), args.amount, args.assetId);
+		}
 		const intentsStorageBalance = await this.getCachedIntentsStorageBalance();
 		if (intentsStorageBalance <= require_omni_bridge_constants.MIN_STORAGE_BALANCE_FOR_INTENTS_NEAR) throw new require_error.IntentsNearOmniAvailableBalanceTooLowError(intentsStorageBalance.toString());
 		const utxoChainWithdrawal = require_omni_bridge_utils.isUtxoChain(omniChainKind);
@@ -184,8 +186,10 @@ var OmniBridge = class {
 			const utxoProtocolFee = require_estimate_fee.getUnderlyingFee(args.feeEstimation, require_route_enum.RouteEnum.OmniBridge, "utxoProtocolFee");
 			(0, _defuse_protocol_internal_utils.assert)(utxoMaxGasFee !== void 0 && utxoMaxGasFee > 0n, `Invalid Omni Bridge utxo max gas fee: expected > 0, got ${utxoMaxGasFee}`);
 			(0, _defuse_protocol_internal_utils.assert)(utxoProtocolFee !== void 0 && utxoProtocolFee > 0n, `Invalid Omni Bridge utxo protocol fee: expected > 0, got ${utxoProtocolFee}`);
-			const actualAmountWithFee = args.amount + utxoMaxGasFee + utxoProtocolFee;
-			if (actualAmountWithFee < minAmount) throw new require_errors.MinWithdrawalAmountError(minAmount, actualAmountWithFee, args.assetId);
+			if (!args.skipMinAmountValidation) {
+				const actualAmountWithFee = args.amount + utxoMaxGasFee + utxoProtocolFee;
+				if (actualAmountWithFee < minAmount) throw new require_errors.MinWithdrawalAmountError(minAmount, actualAmountWithFee, args.assetId);
+			}
 		}
 	}
 	async estimateWithdrawalFee(args) {

package/dist/src/bridges/omni-bridge/omni-bridge.js

@@ -162,7 +162,9 @@ var OmniBridge = class {
 		const decimals = await this.getCachedTokenDecimals(destTokenAddress);
 		assert(decimals !== null, `Failed to retrieve token decimals for address ${destTokenAddress} via OmniBridge contract. 
   Ensure the token is supported and the address is correct.`);
-		if (verifyTransferAmount(args.amount, 0n, decimals.origin_decimals, decimals.decimals) === false) throw new MinWithdrawalAmountError(getMinimumTransferableAmount(decimals.origin_decimals, decimals.decimals), args.amount, args.assetId);
+		if (!args.skipMinAmountValidation) {
+			if (verifyTransferAmount(args.amount, 0n, decimals.origin_decimals, decimals.decimals) === false) throw new MinWithdrawalAmountError(getMinimumTransferableAmount(decimals.origin_decimals, decimals.decimals), args.amount, args.assetId);
+		}
 		const intentsStorageBalance = await this.getCachedIntentsStorageBalance();
 		if (intentsStorageBalance <= MIN_STORAGE_BALANCE_FOR_INTENTS_NEAR) throw new IntentsNearOmniAvailableBalanceTooLowError(intentsStorageBalance.toString());
 		const utxoChainWithdrawal = isUtxoChain(omniChainKind);
@@ -182,8 +184,10 @@ var OmniBridge = class {
 			const utxoProtocolFee = getUnderlyingFee(args.feeEstimation, RouteEnum.OmniBridge, "utxoProtocolFee");
 			assert(utxoMaxGasFee !== void 0 && utxoMaxGasFee > 0n, `Invalid Omni Bridge utxo max gas fee: expected > 0, got ${utxoMaxGasFee}`);
 			assert(utxoProtocolFee !== void 0 && utxoProtocolFee > 0n, `Invalid Omni Bridge utxo protocol fee: expected > 0, got ${utxoProtocolFee}`);
-			const actualAmountWithFee = args.amount + utxoMaxGasFee + utxoProtocolFee;
-			if (actualAmountWithFee < minAmount) throw new MinWithdrawalAmountError(minAmount, actualAmountWithFee, args.assetId);
+			if (!args.skipMinAmountValidation) {
+				const actualAmountWithFee = args.amount + utxoMaxGasFee + utxoProtocolFee;
+				if (actualAmountWithFee < minAmount) throw new MinWithdrawalAmountError(minAmount, actualAmountWithFee, args.assetId);
+			}
 		}
 	}
 	async estimateWithdrawalFee(args) {

package/dist/src/bridges/poa-bridge/poa-bridge.cjs

@@ -76,8 +76,10 @@ var PoaBridge = class {
 		const { tokens } = await this.getCachedSupportedTokens([require_poa_bridge_utils.toPoaNetwork(assetInfo.blockchain)], args.logger);
 		const tokenInfo = tokens.find((token) => token.intents_token_id === args.assetId);
 		if (tokenInfo == null) throw new require_errors.UnsupportedAssetIdError(args.assetId, "`assetId` is not supported in PoA bridge.");
-		const minWithdrawalAmount = BigInt(tokenInfo.min_withdrawal_amount);
-		if (args.amount < minWithdrawalAmount) throw new require_errors.MinWithdrawalAmountError(minWithdrawalAmount, args.amount, args.assetId);
+		if (!args.skipMinAmountValidation) {
+			const minWithdrawalAmount = BigInt(tokenInfo.min_withdrawal_amount);
+			if (args.amount < minWithdrawalAmount) throw new require_errors.MinWithdrawalAmountError(minWithdrawalAmount, args.amount, args.assetId);
+		}
 		if (assetInfo.blockchain === require_caip2.Chains.XRPL) {
 			const xrplRpcUrl = this.xrplRpcUrls[0];
 			(0, _defuse_protocol_internal_utils.assert)(xrplRpcUrl, "No XRPL RPC URL configured");

package/dist/src/bridges/poa-bridge/poa-bridge.js

@@ -74,8 +74,10 @@ var PoaBridge = class {
 		const { tokens } = await this.getCachedSupportedTokens([toPoaNetwork(assetInfo.blockchain)], args.logger);
 		const tokenInfo = tokens.find((token) => token.intents_token_id === args.assetId);
 		if (tokenInfo == null) throw new UnsupportedAssetIdError(args.assetId, "`assetId` is not supported in PoA bridge.");
-		const minWithdrawalAmount = BigInt(tokenInfo.min_withdrawal_amount);
-		if (args.amount < minWithdrawalAmount) throw new MinWithdrawalAmountError(minWithdrawalAmount, args.amount, args.assetId);
+		if (!args.skipMinAmountValidation) {
+			const minWithdrawalAmount = BigInt(tokenInfo.min_withdrawal_amount);
+			if (args.amount < minWithdrawalAmount) throw new MinWithdrawalAmountError(minWithdrawalAmount, args.amount, args.assetId);
+		}
 		if (assetInfo.blockchain === Chains.XRPL) {
 			const xrplRpcUrl = this.xrplRpcUrls[0];
 			assert(xrplRpcUrl, "No XRPL RPC URL configured");

package/dist/src/sdk.cjs

@@ -220,7 +220,8 @@ var IntentsSDK = class {
 				destinationAddress: args.withdrawalParams.destinationAddress,
 				feeEstimation: fee,
 				routeConfig: args.withdrawalParams.routeConfig,
-				logger: args.logger
+				logger: args.logger,
+				skipMinAmountValidation: args.withdrawalParams.amount === 0n && args.withdrawalParams.feeInclusive === false
 			});
 			return fee;
 		}

package/dist/src/sdk.js

@@ -218,7 +218,8 @@ var IntentsSDK = class {
 				destinationAddress: args.withdrawalParams.destinationAddress,
 				feeEstimation: fee,
 				routeConfig: args.withdrawalParams.routeConfig,
-				logger: args.logger
+				logger: args.logger,
+				skipMinAmountValidation: args.withdrawalParams.amount === 0n && args.withdrawalParams.feeInclusive === false
 			});
 			return fee;
 		}

package/dist/src/shared-types.d.cts

@@ -299,6 +299,7 @@ interface Bridge {
     feeEstimation: FeeEstimation;
     routeConfig?: RouteConfig;
     logger?: ILogger;
+    skipMinAmountValidation?: boolean;
   }): Promise<void>;
   estimateWithdrawalFee<T extends Pick<WithdrawalParams, "assetId" | "destinationAddress" | "routeConfig" | "amount">>(args: {
     withdrawalParams: T;

package/dist/src/shared-types.d.ts

@@ -299,6 +299,7 @@ interface Bridge {
     feeEstimation: FeeEstimation;
     routeConfig?: RouteConfig;
     logger?: ILogger;
+    skipMinAmountValidation?: boolean;
   }): Promise<void>;
   estimateWithdrawalFee<T extends Pick<WithdrawalParams, "assetId" | "destinationAddress" | "routeConfig" | "amount">>(args: {
     withdrawalParams: T;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defuse-protocol/intents-sdk",
-  "version": "0.59.0",
+  "version": "0.60.0",
   "private": false,
   "type": "module",
   "repository": {
@@ -45,8 +45,8 @@
     "ripple-address-codec": "^5.0.0",
     "valibot": "^1.0.0",
     "viem": "^2.0.0",
-    "@defuse-protocol/contract-types": "0.6.2",
-    "@defuse-protocol/internal-utils": "0.31.0"
+    "@defuse-protocol/contract-types": "0.6.3",
+    "@defuse-protocol/internal-utils": "0.31.1"
   },
   "devDependencies": {
     "tsdown": "0.19.0"