@defuse-protocol/intents-sdk 0.43.3 → 0.44.0

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

@@ -5,7 +5,7 @@ import { IntentHash, IntentPayloadFactory, IntentPrimitive, IntentRelayParamsFac
 import { IIntentSigner } from "./intents/interfaces/intent-signer.js";
 import { OnBeforePublishIntentHook } from "./intents/intent-executer-impl/intent-executer.js";
 import { Chain, Chains } from "./lib/caip2.js";
-import { ILogger, RetryOptions, solverRelay } from "@defuse-protocol/internal-utils";
+import { ILogger, solverRelay } from "@defuse-protocol/internal-utils";
 
 //#region src/shared-types.d.ts
 interface IntentPublishResult {
@@ -106,7 +106,6 @@ type ProcessWithdrawalArgs<T extends WithdrawalParams | WithdrawalParams[]> = {
     signedIntents?: SignedIntentsComposition;
   };
   referral?: string;
-  retryOptions?: RetryOptions;
   logger?: ILogger;
 };
 interface IIntentsSDK {
@@ -114,6 +113,8 @@ interface IIntentsSDK {
   signAndSendIntent(args: SignAndSendArgs): Promise<IntentPublishResult>;
   waitForIntentSettlement(args: {
     intentHash: IntentHash;
+    /** AbortSignal for cancellation/timeout. Use AbortSignal.timeout(ms) for timeout. */
+    signal?: AbortSignal;
     logger?: ILogger;
   }): Promise<NearTxInfo>;
   getIntentStatus(args: {
@@ -140,16 +141,15 @@ interface IIntentsSDK {
     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>>;
+  createWithdrawalCompletionPromises(params: CreateWithdrawalCompletionPromisesParams): Array<Promise<TxInfo | TxNoInfo>>;
   createWithdrawalIntents(args: {
     withdrawalParams: WithdrawalParams;
     feeEstimation: FeeEstimation;
@@ -176,6 +176,12 @@ interface TxInfo {
 interface TxNoInfo {
   hash: null;
 }
+interface CreateWithdrawalCompletionPromisesParams {
+  withdrawalParams: WithdrawalParams[];
+  intentTx: NearTxInfo;
+  signal?: AbortSignal;
+  logger?: ILogger;
+}
 interface WithdrawalParams {
   assetId: string;
   amount: bigint;
@@ -201,7 +207,6 @@ type VirtualChainRouteConfig = {
 };
 type PoaBridgeRouteConfig = {
   route: RouteEnum["PoaBridge"];
-  chain: Chain;
 };
 type HotBridgeRouteConfig = {
   route: RouteEnum["HotBridge"];
@@ -266,7 +271,7 @@ interface FeeEstimation {
   underlyingFees: UnderlyingFees;
 }
 interface Bridge {
-  is(routeConfig: RouteConfig): boolean;
+  readonly route: RouteEnumValues;
   supports(params: Pick<WithdrawalParams, "assetId" | "routeConfig">): Promise<boolean>;
   parseAssetId(assetId: string): ParsedAssetInfo | null;
   /**
@@ -295,22 +300,51 @@ interface Bridge {
     feeEstimation: FeeEstimation;
     referral?: string;
   }): Promise<IntentPrimitive[]>;
-  waitForWithdrawalCompletion(args: {
-    tx: NearTxInfo;
-    index: number;
+  /**
+   * Creates a complete withdrawal identifier with all required info.
+   * Derives landingChain from withdrawalParams.routeConfig.chain if available, otherwise from assetId.
+   */
+  createWithdrawalIdentifier(args: {
     withdrawalParams: WithdrawalParams;
-    routeConfig: RouteConfig;
-    signal?: AbortSignal;
-    retryOptions?: RetryOptions;
+    index: number;
+    tx: NearTxInfo;
+  }): WithdrawalIdentifier;
+  /**
+   * One-shot status check for a withdrawal.
+   * Returns the current status without polling.
+   */
+  describeWithdrawal(args: WithdrawalIdentifier & {
     logger?: ILogger;
-  }): Promise<TxInfo | TxNoInfo>;
+  }): Promise<WithdrawalStatus>;
 }
 interface WithdrawalIdentifier {
-  routeConfig: RouteConfig;
+  /** Actual chain where funds arrive; Near for virtual/internal routes */
+  landingChain: Chain;
+  /** Per-bridge withdrawal sequence number */
   index: number;
   withdrawalParams: WithdrawalParams;
   tx: NearTxInfo;
 }
+/**
+ * Represents the current state of a withdrawal as returned by bridge adapters.
+ *
+ * Error handling follows AWS SDK "describe" API patterns:
+ * - **Thrown errors**: Infrastructure failures (network, auth, service unavailable).
+ *   Meaning: "I couldn't check the status."
+ * - **`failed` status**: Job-level failure reported by the bridge.
+ *   Meaning: "I checked, and the withdrawal failed."
+ *
+ * @see https://docs.aws.amazon.com/AmazonS3/latest/userguide/batch-ops-job-status.html
+ */
+type WithdrawalStatus = {
+  status: "pending";
+} | {
+  status: "completed";
+  txHash: string | null;
+} | {
+  status: "failed";
+  reason: string;
+};
 type ParsedAssetInfo = ({
   blockchain: Chain;
   bridgeName: BridgeNameEnumValues;
@@ -334,4 +368,4 @@ type RPCEndpointMap = Record<typeof Chains.Near | HotBridgeEVMChain, string[]> &
 type DeepPartial<T> = T extends object ? T extends Array<infer U> ? Array<DeepPartial<U>> : T extends Function ? T : { [P in keyof T]?: DeepPartial<T[P]> } : T;
 type PartialRPCEndpointMap = DeepPartial<RPCEndpointMap>;
 //#endregion
-export { BatchWithdrawalResult, Bridge, FeeEstimation, HotBridgeRouteConfig, IIntentsSDK, IntentPublishResult, IntentSettlementStatus, InternalTransferRouteConfig, NearTxInfo, NearWithdrawalRouteConfig, OmniBridgeRouteConfig, ParsedAssetInfo, PartialRPCEndpointMap, PoaBridgeRouteConfig, ProcessWithdrawalArgs, QuoteOptions, RouteConfig, SignAndSendArgs, SignAndSendWithdrawalArgs, SignedIntentsComposition, TxInfo, TxNoInfo, VirtualChainRouteConfig, WithdrawalIdentifier, WithdrawalParams, WithdrawalResult };
+export { BatchWithdrawalResult, Bridge, CreateWithdrawalCompletionPromisesParams, FeeEstimation, HotBridgeRouteConfig, IIntentsSDK, IntentPublishResult, IntentSettlementStatus, InternalTransferRouteConfig, NearTxInfo, NearWithdrawalRouteConfig, OmniBridgeRouteConfig, ParsedAssetInfo, PartialRPCEndpointMap, PoaBridgeRouteConfig, ProcessWithdrawalArgs, QuoteOptions, RouteConfig, SignAndSendArgs, SignAndSendWithdrawalArgs, SignedIntentsComposition, TxInfo, TxNoInfo, VirtualChainRouteConfig, WithdrawalIdentifier, WithdrawalParams, WithdrawalResult };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defuse-protocol/intents-sdk",
-  "version": "0.43.3",
+  "version": "0.44.0",
   "private": false,
   "type": "module",
   "repository": {
@@ -47,15 +47,13 @@
     "ripple-address-codec": "^5.0.0",
     "valibot": "^1.0.0",
     "viem": "^2.0.0",
-    "@defuse-protocol/contract-types": "0.4.3",
-    "@defuse-protocol/internal-utils": "0.21.1"
+    "@defuse-protocol/internal-utils": "0.22.0",
+    "@defuse-protocol/contract-types": "0.4.3"
   },
   "devDependencies": {
-    "tsdown": "0.15.5",
-    "vitest": "2.1.2"
+    "tsdown": "0.15.5"
   },
   "scripts": {
-    "test": "vitest --passWithNoTests",
     "build": "tsdown",
     "dev": "tsdown --watch",
     "lint": "biome check .",

package/dist/src/lib/route-config.cjs

@@ -1,19 +0,0 @@
-const require_bridge_name_enum = require('../constants/bridge-name-enum.cjs');
-const require_route_config_factory = require('./route-config-factory.cjs');
-
-//#region src/lib/route-config.ts
-function determineRouteConfig(sdk, withdrawalParams) {
-	if (withdrawalParams.routeConfig != null) return withdrawalParams.routeConfig;
-	const parseAssetId = sdk.parseAssetId(withdrawalParams.assetId);
-	const bridgeName = parseAssetId.bridgeName;
-	switch (bridgeName) {
-		case require_bridge_name_enum.BridgeNameEnum.Hot: return require_route_config_factory.createHotBridgeRoute(parseAssetId.blockchain);
-		case require_bridge_name_enum.BridgeNameEnum.Poa: return require_route_config_factory.createPoaBridgeRoute(parseAssetId.blockchain);
-		case require_bridge_name_enum.BridgeNameEnum.Omni: return require_route_config_factory.createOmniBridgeRoute(parseAssetId.blockchain);
-		case require_bridge_name_enum.BridgeNameEnum.None: return require_route_config_factory.createNearWithdrawalRoute();
-		default: throw new Error(`Unexpected bridge = ${bridgeName}`);
-	}
-}
-
-//#endregion
-exports.determineRouteConfig = determineRouteConfig;

package/dist/src/lib/route-config.js

@@ -1,19 +0,0 @@
-import { BridgeNameEnum } from "../constants/bridge-name-enum.js";
-import { createHotBridgeRoute, createNearWithdrawalRoute, createOmniBridgeRoute, createPoaBridgeRoute } from "./route-config-factory.js";
-
-//#region src/lib/route-config.ts
-function determineRouteConfig(sdk, withdrawalParams) {
-	if (withdrawalParams.routeConfig != null) return withdrawalParams.routeConfig;
-	const parseAssetId = sdk.parseAssetId(withdrawalParams.assetId);
-	const bridgeName = parseAssetId.bridgeName;
-	switch (bridgeName) {
-		case BridgeNameEnum.Hot: return createHotBridgeRoute(parseAssetId.blockchain);
-		case BridgeNameEnum.Poa: return createPoaBridgeRoute(parseAssetId.blockchain);
-		case BridgeNameEnum.Omni: return createOmniBridgeRoute(parseAssetId.blockchain);
-		case BridgeNameEnum.None: return createNearWithdrawalRoute();
-		default: throw new Error(`Unexpected bridge = ${bridgeName}`);
-	}
-}
-
-//#endregion
-export { determineRouteConfig };