@defuse-protocol/intents-sdk 0.26.4 → 0.28.0

package/README.md

@@ -26,6 +26,7 @@ interacting with various bridge implementations across multiple blockchains.
     - [Asset Information Parsing](#asset-information-parsing)
     - [Waiting for Completion](#waiting-for-completion)
     - [Error Handling](#error-handling)
+    - [Atomic Multi-Intent Publishing](#atomic-multi-intent-publishing)
 - [Supported Networks](#supported-networks)
 - [Development](#development)
 
@@ -808,6 +809,39 @@ try {
 }
 ```
 
+### Atomic Multi-Intent Publishing
+
+Include pre-signed intents (from other users or prior operations) to be published atomically with your new intent. 
+Useful for multi-user coordination and batch operations.
+
+```typescript
+import type { MultiPayload } from '@defuse-protocol/intents-sdk';
+
+// Include pre-signed intents before/after your new intent
+await sdk.signAndSendIntent({
+    intents: [{ intent: "transfer", receiver_id: "alice.near", tokens: {...} }],
+    signedIntents: {
+        before: [preSigned1],  // Execute before new intent
+        after: [preSigned2]    // Execute after new intent
+    }
+});
+
+// Also works with withdrawals
+await sdk.processWithdrawal({
+    withdrawalParams: {...},
+    intent: {
+        signedIntents: {
+            before: [preSigned1],
+            after: [preSigned2]
+        }
+    }
+});
+```
+
+**Key Points:**
+- All intents execute atomically in order: `before` → new intent → `after`
+- Returned `intentHash` is for your newly created intent, not the included ones
+
 ## Supported Networks
 
 For a list of supported chains, see

package/dist/index.cjs

@@ -3,8 +3,9 @@ const require_route_enum = require('./src/constants/route-enum.cjs');
 const require_errors = require('./src/classes/errors.cjs');
 const require_caip2 = require('./src/lib/caip2.cjs');
 const require_bridge_name_enum = require('./src/constants/bridge-name-enum.cjs');
-const require_error = require('./src/bridges/hot-bridge/error.cjs');
-const require_error$1 = require('./src/bridges/omni-bridge/error.cjs');
+const require_error = require('./src/bridges/direct-bridge/error.cjs');
+const require_error$1 = require('./src/bridges/hot-bridge/error.cjs');
+const require_error$2 = require('./src/bridges/omni-bridge/error.cjs');
 const require_route_config_factory = require('./src/lib/route-config-factory.cjs');
 const require_sdk = require('./src/sdk.cjs');
 const require_factories = require('./src/intents/intent-signer-impl/factories.cjs');
@@ -25,11 +26,12 @@ Object.defineProperty(exports, 'BaseError', {
 });
 exports.BridgeNameEnum = require_bridge_name_enum.BridgeNameEnum;
 exports.Chains = require_caip2.Chains;
-exports.FailedToFetchFeeError = require_error$1.FailedToFetchFeeError;
+exports.DestinationExplicitNearAccountDoesntExistError = require_error.DestinationExplicitNearAccountDoesntExistError;
+exports.FailedToFetchFeeError = require_error$2.FailedToFetchFeeError;
 exports.FeeExceedsAmountError = require_errors.FeeExceedsAmountError;
-exports.HotWithdrawalCancelledError = require_error.HotWithdrawalCancelledError;
-exports.HotWithdrawalNotFoundError = require_error.HotWithdrawalNotFoundError;
-exports.HotWithdrawalPendingError = require_error.HotWithdrawalPendingError;
+exports.HotWithdrawalCancelledError = require_error$1.HotWithdrawalCancelledError;
+exports.HotWithdrawalNotFoundError = require_error$1.HotWithdrawalNotFoundError;
+exports.HotWithdrawalPendingError = require_error$1.HotWithdrawalPendingError;
 Object.defineProperty(exports, 'HttpRequestError', {
   enumerable: true,
   get: function () {
@@ -42,12 +44,12 @@ Object.defineProperty(exports, 'IntentSettlementError', {
     return __defuse_protocol_internal_utils.IntentSettlementError;
   }
 });
-exports.IntentsNearOmniAvailableBalanceTooLowError = require_error$1.IntentsNearOmniAvailableBalanceTooLowError;
+exports.IntentsNearOmniAvailableBalanceTooLowError = require_error$2.IntentsNearOmniAvailableBalanceTooLowError;
 exports.IntentsSDK = require_sdk.IntentsSDK;
 exports.MinWithdrawalAmountError = require_errors.MinWithdrawalAmountError;
-exports.OmniTokenNormalisationCheckError = require_error$1.OmniTokenNormalisationCheckError;
-exports.OmniTransferDestinationChainHashNotFoundError = require_error$1.OmniTransferDestinationChainHashNotFoundError;
-exports.OmniTransferNotFoundError = require_error$1.OmniTransferNotFoundError;
+exports.OmniTokenNormalisationCheckError = require_error$2.OmniTokenNormalisationCheckError;
+exports.OmniTransferDestinationChainHashNotFoundError = require_error$2.OmniTransferDestinationChainHashNotFoundError;
+exports.OmniTransferNotFoundError = require_error$2.OmniTransferNotFoundError;
 Object.defineProperty(exports, 'PoaWithdrawalInvariantError', {
   enumerable: true,
   get: function () {
@@ -91,7 +93,7 @@ Object.defineProperty(exports, 'TimeoutError', {
     return __defuse_protocol_internal_utils.TimeoutError;
   }
 });
-exports.TokenNotFoundInDestinationChainError = require_error$1.TokenNotFoundInDestinationChainError;
+exports.TokenNotFoundInDestinationChainError = require_error$2.TokenNotFoundInDestinationChainError;
 exports.TrustlineNotFoundError = require_errors.TrustlineNotFoundError;
 exports.UnsupportedAssetIdError = require_errors.UnsupportedAssetIdError;
 exports.UnsupportedDestinationMemoError = require_errors.UnsupportedDestinationMemoError;

package/dist/index.d.cts

@@ -4,12 +4,13 @@ import { IntentPayload, IntentPayloadFactory, IntentPrimitive, IntentRelayParams
 import { IIntentSigner } from "./src/intents/interfaces/intent-signer.cjs";
 import { OnBeforePublishIntentHook } from "./src/intents/intent-executer-impl/intent-executer.cjs";
 import { Chain, Chains } from "./src/lib/caip2.cjs";
-import { BatchWithdrawalResult, FeeEstimation, HotBridgeRouteConfig, IntentPublishResult, IntentSettlementStatus, InternalTransferRouteConfig, NearTxInfo, NearWithdrawalRouteConfig, OmniBridgeRouteConfig, ParsedAssetInfo, PoaBridgeRouteConfig, ProcessWithdrawalArgs, RouteConfig, SignAndSendWithdrawalArgs, TxInfo, TxNoInfo, VirtualChainRouteConfig, WithdrawalIdentifier, WithdrawalParams, WithdrawalResult } from "./src/shared-types.cjs";
+import { BatchWithdrawalResult, FeeEstimation, HotBridgeRouteConfig, IntentPublishResult, IntentSettlementStatus, InternalTransferRouteConfig, NearTxInfo, NearWithdrawalRouteConfig, OmniBridgeRouteConfig, ParsedAssetInfo, PoaBridgeRouteConfig, ProcessWithdrawalArgs, RouteConfig, SignAndSendArgs, SignAndSendWithdrawalArgs, SignedIntentsComposition, TxInfo, TxNoInfo, VirtualChainRouteConfig, WithdrawalIdentifier, WithdrawalParams, WithdrawalResult } from "./src/shared-types.cjs";
 import { IntentsSDK, IntentsSDKConfig } from "./src/sdk.cjs";
 import { createIntentSignerNEP413, createIntentSignerNearKeyPair, createIntentSignerViem } from "./src/intents/intent-signer-impl/factories.cjs";
 import { createDefaultRoute, createHotBridgeRoute, createInternalTransferRoute, createNearWithdrawalRoute, createOmniBridgeRoute, createPoaBridgeRoute, createVirtualChainRoute } from "./src/lib/route-config-factory.cjs";
 import { FeeExceedsAmountError, FeeExceedsAmountErrorType, MinWithdrawalAmountError, MinWithdrawalAmountErrorType, TrustlineNotFoundError, TrustlineNotFoundErrorType, UnsupportedAssetIdError, UnsupportedAssetIdErrorType, UnsupportedDestinationMemoError, UnsupportedDestinationMemoErrorType } from "./src/classes/errors.cjs";
+import { DestinationExplicitNearAccountDoesntExistError, DestinationExplicitNearAccountDoesntExistErrorType } from "./src/bridges/direct-bridge/error.cjs";
 import { HotWithdrawalCancelledError, HotWithdrawalCancelledErrorType, HotWithdrawalNotFoundError, HotWithdrawalNotFoundErrorType, HotWithdrawalPendingError, HotWithdrawalPendingErrorType } from "./src/bridges/hot-bridge/error.cjs";
 import { FailedToFetchFeeError, FailedToFetchFeeErrorType, IntentsNearOmniAvailableBalanceTooLowError, IntentsNearOmniAvailableBalanceTooLowErrorType, OmniTokenNormalisationCheckError, OmniTokenNormalisationCheckErrorType, OmniTransferDestinationChainHashNotFoundError, OmniTransferDestinationChainHashNotFoundErrorType, OmniTransferNotFoundError, OmniTransferNotFoundErrorType, TokenNotFoundInDestinationChainError, TokenNotFoundInDestinationChainErrorType } from "./src/bridges/omni-bridge/error.cjs";
 import { AssertionError, AssertionErrorType, BaseError, BaseErrorType, HttpRequestError, HttpRequestErrorType, ILogger, IntentSettlementError, IntentSettlementErrorType, NearIntentsEnv, PoaWithdrawalInvariantError, PoaWithdrawalInvariantErrorType, PoaWithdrawalNotFoundError, PoaWithdrawalNotFoundErrorType, PoaWithdrawalPendingError, PoaWithdrawalPendingErrorType, QuoteError, QuoteErrorType, RelayPublishError, RelayPublishErrorType, RetryOptions, RpcRequestError, RpcRequestErrorType, TimeoutError, TimeoutErrorType } from "@defuse-protocol/internal-utils";
-export { AssertionError, type AssertionErrorType, BaseError, type BaseErrorType, type BatchWithdrawalResult, BridgeNameEnum, type BridgeNameEnumValues, type Chain, Chains, FailedToFetchFeeError, type FailedToFetchFeeErrorType, type FeeEstimation, FeeExceedsAmountError, type FeeExceedsAmountErrorType, type HotBridgeRouteConfig, HotWithdrawalCancelledError, type HotWithdrawalCancelledErrorType, HotWithdrawalNotFoundError, type HotWithdrawalNotFoundErrorType, HotWithdrawalPendingError, type HotWithdrawalPendingErrorType, HttpRequestError, type HttpRequestErrorType, type IIntentSigner, type ILogger, type IntentPayload, type IntentPayloadFactory, type IntentPrimitive, type IntentPublishResult, type IntentRelayParamsFactory, IntentSettlementError, type IntentSettlementErrorType, type IntentSettlementStatus, IntentsNearOmniAvailableBalanceTooLowError, type IntentsNearOmniAvailableBalanceTooLowErrorType, IntentsSDK, type IntentsSDKConfig, type InternalTransferRouteConfig, MinWithdrawalAmountError, type MinWithdrawalAmountErrorType, type MultiPayload, type NearIntentsEnv, type NearTxInfo, type NearWithdrawalRouteConfig, type OmniBridgeRouteConfig, OmniTokenNormalisationCheckError, type OmniTokenNormalisationCheckErrorType, OmniTransferDestinationChainHashNotFoundError, type OmniTransferDestinationChainHashNotFoundErrorType, OmniTransferNotFoundError, type OmniTransferNotFoundErrorType, type OnBeforePublishIntentHook, type ParsedAssetInfo, type PoaBridgeRouteConfig, PoaWithdrawalInvariantError, type PoaWithdrawalInvariantErrorType, PoaWithdrawalNotFoundError, type PoaWithdrawalNotFoundErrorType, PoaWithdrawalPendingError, type PoaWithdrawalPendingErrorType, type ProcessWithdrawalArgs, QuoteError, type QuoteErrorType, RelayPublishError, type RelayPublishErrorType, type RetryOptions, type RouteConfig, RouteEnum, type RouteEnumValues, RpcRequestError, type RpcRequestErrorType, type SignAndSendWithdrawalArgs, TimeoutError, type TimeoutErrorType, TokenNotFoundInDestinationChainError, type TokenNotFoundInDestinationChainErrorType, TrustlineNotFoundError, type TrustlineNotFoundErrorType, type TxInfo, type TxNoInfo, UnsupportedAssetIdError, type UnsupportedAssetIdErrorType, UnsupportedDestinationMemoError, type UnsupportedDestinationMemoErrorType, type VirtualChainRouteConfig, type WithdrawalIdentifier, type WithdrawalParams, type WithdrawalResult, createDefaultRoute, createHotBridgeRoute, createIntentSignerNEP413, createIntentSignerNearKeyPair, createIntentSignerViem, createInternalTransferRoute, createNearWithdrawalRoute, createOmniBridgeRoute, createPoaBridgeRoute, createVirtualChainRoute };
+export { AssertionError, type AssertionErrorType, BaseError, type BaseErrorType, type BatchWithdrawalResult, BridgeNameEnum, type BridgeNameEnumValues, type Chain, Chains, DestinationExplicitNearAccountDoesntExistError, type DestinationExplicitNearAccountDoesntExistErrorType, FailedToFetchFeeError, type FailedToFetchFeeErrorType, type FeeEstimation, FeeExceedsAmountError, type FeeExceedsAmountErrorType, type HotBridgeRouteConfig, HotWithdrawalCancelledError, type HotWithdrawalCancelledErrorType, HotWithdrawalNotFoundError, type HotWithdrawalNotFoundErrorType, HotWithdrawalPendingError, type HotWithdrawalPendingErrorType, HttpRequestError, type HttpRequestErrorType, type IIntentSigner, type ILogger, type IntentPayload, type IntentPayloadFactory, type IntentPrimitive, type IntentPublishResult, type IntentRelayParamsFactory, IntentSettlementError, type IntentSettlementErrorType, type IntentSettlementStatus, IntentsNearOmniAvailableBalanceTooLowError, type IntentsNearOmniAvailableBalanceTooLowErrorType, IntentsSDK, type IntentsSDKConfig, type InternalTransferRouteConfig, MinWithdrawalAmountError, type MinWithdrawalAmountErrorType, type MultiPayload, type NearIntentsEnv, type NearTxInfo, type NearWithdrawalRouteConfig, type OmniBridgeRouteConfig, OmniTokenNormalisationCheckError, type OmniTokenNormalisationCheckErrorType, OmniTransferDestinationChainHashNotFoundError, type OmniTransferDestinationChainHashNotFoundErrorType, OmniTransferNotFoundError, type OmniTransferNotFoundErrorType, type OnBeforePublishIntentHook, type ParsedAssetInfo, type PoaBridgeRouteConfig, PoaWithdrawalInvariantError, type PoaWithdrawalInvariantErrorType, PoaWithdrawalNotFoundError, type PoaWithdrawalNotFoundErrorType, PoaWithdrawalPendingError, type PoaWithdrawalPendingErrorType, type ProcessWithdrawalArgs, QuoteError, type QuoteErrorType, RelayPublishError, type RelayPublishErrorType, type RetryOptions, type RouteConfig, RouteEnum, type RouteEnumValues, RpcRequestError, type RpcRequestErrorType, type SignAndSendArgs, type SignAndSendWithdrawalArgs, type SignedIntentsComposition, TimeoutError, type TimeoutErrorType, TokenNotFoundInDestinationChainError, type TokenNotFoundInDestinationChainErrorType, TrustlineNotFoundError, type TrustlineNotFoundErrorType, type TxInfo, type TxNoInfo, UnsupportedAssetIdError, type UnsupportedAssetIdErrorType, UnsupportedDestinationMemoError, type UnsupportedDestinationMemoErrorType, type VirtualChainRouteConfig, type WithdrawalIdentifier, type WithdrawalParams, type WithdrawalResult, createDefaultRoute, createHotBridgeRoute, createIntentSignerNEP413, createIntentSignerNearKeyPair, createIntentSignerViem, createInternalTransferRoute, createNearWithdrawalRoute, createOmniBridgeRoute, createPoaBridgeRoute, createVirtualChainRoute };

package/dist/index.d.ts

@@ -4,12 +4,13 @@ import { IntentPayload, IntentPayloadFactory, IntentPrimitive, IntentRelayParams
 import { IIntentSigner } from "./src/intents/interfaces/intent-signer.js";
 import { OnBeforePublishIntentHook } from "./src/intents/intent-executer-impl/intent-executer.js";
 import { Chain, Chains } from "./src/lib/caip2.js";
-import { BatchWithdrawalResult, FeeEstimation, HotBridgeRouteConfig, IntentPublishResult, IntentSettlementStatus, InternalTransferRouteConfig, NearTxInfo, NearWithdrawalRouteConfig, OmniBridgeRouteConfig, ParsedAssetInfo, PoaBridgeRouteConfig, ProcessWithdrawalArgs, RouteConfig, SignAndSendWithdrawalArgs, TxInfo, TxNoInfo, VirtualChainRouteConfig, WithdrawalIdentifier, WithdrawalParams, WithdrawalResult } from "./src/shared-types.js";
+import { BatchWithdrawalResult, FeeEstimation, HotBridgeRouteConfig, IntentPublishResult, IntentSettlementStatus, InternalTransferRouteConfig, NearTxInfo, NearWithdrawalRouteConfig, OmniBridgeRouteConfig, ParsedAssetInfo, PoaBridgeRouteConfig, ProcessWithdrawalArgs, RouteConfig, SignAndSendArgs, SignAndSendWithdrawalArgs, SignedIntentsComposition, TxInfo, TxNoInfo, VirtualChainRouteConfig, WithdrawalIdentifier, WithdrawalParams, WithdrawalResult } from "./src/shared-types.js";
 import { IntentsSDK, IntentsSDKConfig } from "./src/sdk.js";
 import { createIntentSignerNEP413, createIntentSignerNearKeyPair, createIntentSignerViem } from "./src/intents/intent-signer-impl/factories.js";
 import { createDefaultRoute, createHotBridgeRoute, createInternalTransferRoute, createNearWithdrawalRoute, createOmniBridgeRoute, createPoaBridgeRoute, createVirtualChainRoute } from "./src/lib/route-config-factory.js";
 import { FeeExceedsAmountError, FeeExceedsAmountErrorType, MinWithdrawalAmountError, MinWithdrawalAmountErrorType, TrustlineNotFoundError, TrustlineNotFoundErrorType, UnsupportedAssetIdError, UnsupportedAssetIdErrorType, UnsupportedDestinationMemoError, UnsupportedDestinationMemoErrorType } from "./src/classes/errors.js";
+import { DestinationExplicitNearAccountDoesntExistError, DestinationExplicitNearAccountDoesntExistErrorType } from "./src/bridges/direct-bridge/error.js";
 import { HotWithdrawalCancelledError, HotWithdrawalCancelledErrorType, HotWithdrawalNotFoundError, HotWithdrawalNotFoundErrorType, HotWithdrawalPendingError, HotWithdrawalPendingErrorType } from "./src/bridges/hot-bridge/error.js";
 import { FailedToFetchFeeError, FailedToFetchFeeErrorType, IntentsNearOmniAvailableBalanceTooLowError, IntentsNearOmniAvailableBalanceTooLowErrorType, OmniTokenNormalisationCheckError, OmniTokenNormalisationCheckErrorType, OmniTransferDestinationChainHashNotFoundError, OmniTransferDestinationChainHashNotFoundErrorType, OmniTransferNotFoundError, OmniTransferNotFoundErrorType, TokenNotFoundInDestinationChainError, TokenNotFoundInDestinationChainErrorType } from "./src/bridges/omni-bridge/error.js";
 import { AssertionError, AssertionErrorType, BaseError, BaseErrorType, HttpRequestError, HttpRequestErrorType, ILogger, IntentSettlementError, IntentSettlementErrorType, NearIntentsEnv, PoaWithdrawalInvariantError, PoaWithdrawalInvariantErrorType, PoaWithdrawalNotFoundError, PoaWithdrawalNotFoundErrorType, PoaWithdrawalPendingError, PoaWithdrawalPendingErrorType, QuoteError, QuoteErrorType, RelayPublishError, RelayPublishErrorType, RetryOptions, RpcRequestError, RpcRequestErrorType, TimeoutError, TimeoutErrorType } from "@defuse-protocol/internal-utils";
-export { AssertionError, type AssertionErrorType, BaseError, type BaseErrorType, type BatchWithdrawalResult, BridgeNameEnum, type BridgeNameEnumValues, type Chain, Chains, FailedToFetchFeeError, type FailedToFetchFeeErrorType, type FeeEstimation, FeeExceedsAmountError, type FeeExceedsAmountErrorType, type HotBridgeRouteConfig, HotWithdrawalCancelledError, type HotWithdrawalCancelledErrorType, HotWithdrawalNotFoundError, type HotWithdrawalNotFoundErrorType, HotWithdrawalPendingError, type HotWithdrawalPendingErrorType, HttpRequestError, type HttpRequestErrorType, type IIntentSigner, type ILogger, type IntentPayload, type IntentPayloadFactory, type IntentPrimitive, type IntentPublishResult, type IntentRelayParamsFactory, IntentSettlementError, type IntentSettlementErrorType, type IntentSettlementStatus, IntentsNearOmniAvailableBalanceTooLowError, type IntentsNearOmniAvailableBalanceTooLowErrorType, IntentsSDK, type IntentsSDKConfig, type InternalTransferRouteConfig, MinWithdrawalAmountError, type MinWithdrawalAmountErrorType, type MultiPayload, type NearIntentsEnv, type NearTxInfo, type NearWithdrawalRouteConfig, type OmniBridgeRouteConfig, OmniTokenNormalisationCheckError, type OmniTokenNormalisationCheckErrorType, OmniTransferDestinationChainHashNotFoundError, type OmniTransferDestinationChainHashNotFoundErrorType, OmniTransferNotFoundError, type OmniTransferNotFoundErrorType, type OnBeforePublishIntentHook, type ParsedAssetInfo, type PoaBridgeRouteConfig, PoaWithdrawalInvariantError, type PoaWithdrawalInvariantErrorType, PoaWithdrawalNotFoundError, type PoaWithdrawalNotFoundErrorType, PoaWithdrawalPendingError, type PoaWithdrawalPendingErrorType, type ProcessWithdrawalArgs, QuoteError, type QuoteErrorType, RelayPublishError, type RelayPublishErrorType, type RetryOptions, type RouteConfig, RouteEnum, type RouteEnumValues, RpcRequestError, type RpcRequestErrorType, type SignAndSendWithdrawalArgs, TimeoutError, type TimeoutErrorType, TokenNotFoundInDestinationChainError, type TokenNotFoundInDestinationChainErrorType, TrustlineNotFoundError, type TrustlineNotFoundErrorType, type TxInfo, type TxNoInfo, UnsupportedAssetIdError, type UnsupportedAssetIdErrorType, UnsupportedDestinationMemoError, type UnsupportedDestinationMemoErrorType, type VirtualChainRouteConfig, type WithdrawalIdentifier, type WithdrawalParams, type WithdrawalResult, createDefaultRoute, createHotBridgeRoute, createIntentSignerNEP413, createIntentSignerNearKeyPair, createIntentSignerViem, createInternalTransferRoute, createNearWithdrawalRoute, createOmniBridgeRoute, createPoaBridgeRoute, createVirtualChainRoute };
+export { AssertionError, type AssertionErrorType, BaseError, type BaseErrorType, type BatchWithdrawalResult, BridgeNameEnum, type BridgeNameEnumValues, type Chain, Chains, DestinationExplicitNearAccountDoesntExistError, type DestinationExplicitNearAccountDoesntExistErrorType, FailedToFetchFeeError, type FailedToFetchFeeErrorType, type FeeEstimation, FeeExceedsAmountError, type FeeExceedsAmountErrorType, type HotBridgeRouteConfig, HotWithdrawalCancelledError, type HotWithdrawalCancelledErrorType, HotWithdrawalNotFoundError, type HotWithdrawalNotFoundErrorType, HotWithdrawalPendingError, type HotWithdrawalPendingErrorType, HttpRequestError, type HttpRequestErrorType, type IIntentSigner, type ILogger, type IntentPayload, type IntentPayloadFactory, type IntentPrimitive, type IntentPublishResult, type IntentRelayParamsFactory, IntentSettlementError, type IntentSettlementErrorType, type IntentSettlementStatus, IntentsNearOmniAvailableBalanceTooLowError, type IntentsNearOmniAvailableBalanceTooLowErrorType, IntentsSDK, type IntentsSDKConfig, type InternalTransferRouteConfig, MinWithdrawalAmountError, type MinWithdrawalAmountErrorType, type MultiPayload, type NearIntentsEnv, type NearTxInfo, type NearWithdrawalRouteConfig, type OmniBridgeRouteConfig, OmniTokenNormalisationCheckError, type OmniTokenNormalisationCheckErrorType, OmniTransferDestinationChainHashNotFoundError, type OmniTransferDestinationChainHashNotFoundErrorType, OmniTransferNotFoundError, type OmniTransferNotFoundErrorType, type OnBeforePublishIntentHook, type ParsedAssetInfo, type PoaBridgeRouteConfig, PoaWithdrawalInvariantError, type PoaWithdrawalInvariantErrorType, PoaWithdrawalNotFoundError, type PoaWithdrawalNotFoundErrorType, PoaWithdrawalPendingError, type PoaWithdrawalPendingErrorType, type ProcessWithdrawalArgs, QuoteError, type QuoteErrorType, RelayPublishError, type RelayPublishErrorType, type RetryOptions, type RouteConfig, RouteEnum, type RouteEnumValues, RpcRequestError, type RpcRequestErrorType, type SignAndSendArgs, type SignAndSendWithdrawalArgs, type SignedIntentsComposition, TimeoutError, type TimeoutErrorType, TokenNotFoundInDestinationChainError, type TokenNotFoundInDestinationChainErrorType, TrustlineNotFoundError, type TrustlineNotFoundErrorType, type TxInfo, type TxNoInfo, UnsupportedAssetIdError, type UnsupportedAssetIdErrorType, UnsupportedDestinationMemoError, type UnsupportedDestinationMemoErrorType, type VirtualChainRouteConfig, type WithdrawalIdentifier, type WithdrawalParams, type WithdrawalResult, createDefaultRoute, createHotBridgeRoute, createIntentSignerNEP413, createIntentSignerNearKeyPair, createIntentSignerViem, createInternalTransferRoute, createNearWithdrawalRoute, createOmniBridgeRoute, createPoaBridgeRoute, createVirtualChainRoute };

package/dist/index.js

@@ -2,6 +2,7 @@ import { RouteEnum } from "./src/constants/route-enum.js";
 import { FeeExceedsAmountError, MinWithdrawalAmountError, TrustlineNotFoundError, UnsupportedAssetIdError, UnsupportedDestinationMemoError } from "./src/classes/errors.js";
 import { Chains } from "./src/lib/caip2.js";
 import { BridgeNameEnum } from "./src/constants/bridge-name-enum.js";
+import { DestinationExplicitNearAccountDoesntExistError } from "./src/bridges/direct-bridge/error.js";
 import { HotWithdrawalCancelledError, HotWithdrawalNotFoundError, HotWithdrawalPendingError } from "./src/bridges/hot-bridge/error.js";
 import { FailedToFetchFeeError, IntentsNearOmniAvailableBalanceTooLowError, OmniTokenNormalisationCheckError, OmniTransferDestinationChainHashNotFoundError, OmniTransferNotFoundError, TokenNotFoundInDestinationChainError } from "./src/bridges/omni-bridge/error.js";
 import { createDefaultRoute, createHotBridgeRoute, createInternalTransferRoute, createNearWithdrawalRoute, createOmniBridgeRoute, createPoaBridgeRoute, createVirtualChainRoute } from "./src/lib/route-config-factory.js";
@@ -9,4 +10,4 @@ import { IntentsSDK } from "./src/sdk.js";
 import { createIntentSignerNEP413, createIntentSignerNearKeyPair, createIntentSignerViem } from "./src/intents/intent-signer-impl/factories.js";
 import { AssertionError, BaseError, HttpRequestError, IntentSettlementError, PoaWithdrawalInvariantError, PoaWithdrawalNotFoundError, PoaWithdrawalPendingError, QuoteError, RelayPublishError, RpcRequestError, TimeoutError } from "@defuse-protocol/internal-utils";
 
-export { AssertionError, BaseError, BridgeNameEnum, Chains, FailedToFetchFeeError, FeeExceedsAmountError, HotWithdrawalCancelledError, HotWithdrawalNotFoundError, HotWithdrawalPendingError, HttpRequestError, IntentSettlementError, IntentsNearOmniAvailableBalanceTooLowError, IntentsSDK, MinWithdrawalAmountError, OmniTokenNormalisationCheckError, OmniTransferDestinationChainHashNotFoundError, OmniTransferNotFoundError, PoaWithdrawalInvariantError, PoaWithdrawalNotFoundError, PoaWithdrawalPendingError, QuoteError, RelayPublishError, RouteEnum, RpcRequestError, TimeoutError, TokenNotFoundInDestinationChainError, TrustlineNotFoundError, UnsupportedAssetIdError, UnsupportedDestinationMemoError, createDefaultRoute, createHotBridgeRoute, createIntentSignerNEP413, createIntentSignerNearKeyPair, createIntentSignerViem, createInternalTransferRoute, createNearWithdrawalRoute, createOmniBridgeRoute, createPoaBridgeRoute, createVirtualChainRoute };
+export { AssertionError, BaseError, BridgeNameEnum, Chains, DestinationExplicitNearAccountDoesntExistError, FailedToFetchFeeError, FeeExceedsAmountError, HotWithdrawalCancelledError, HotWithdrawalNotFoundError, HotWithdrawalPendingError, HttpRequestError, IntentSettlementError, IntentsNearOmniAvailableBalanceTooLowError, IntentsSDK, MinWithdrawalAmountError, OmniTokenNormalisationCheckError, OmniTransferDestinationChainHashNotFoundError, OmniTransferNotFoundError, PoaWithdrawalInvariantError, PoaWithdrawalNotFoundError, PoaWithdrawalPendingError, QuoteError, RelayPublishError, RouteEnum, RpcRequestError, TimeoutError, TokenNotFoundInDestinationChainError, TrustlineNotFoundError, UnsupportedAssetIdError, UnsupportedDestinationMemoError, createDefaultRoute, createHotBridgeRoute, createIntentSignerNEP413, createIntentSignerNearKeyPair, createIntentSignerViem, createInternalTransferRoute, createNearWithdrawalRoute, createOmniBridgeRoute, createPoaBridgeRoute, createVirtualChainRoute };

package/dist/src/bridges/direct-bridge/direct-bridge-utils.cjs

@@ -3,6 +3,8 @@ const require_route_enum = require('../../constants/route-enum.cjs');
 const require_direct_bridge_constants = require('./direct-bridge-constants.cjs');
 let __defuse_protocol_internal_utils = require("@defuse-protocol/internal-utils");
 __defuse_protocol_internal_utils = require_rolldown_runtime.__toESM(__defuse_protocol_internal_utils);
+let near_api_js_lib_providers = require("near-api-js/lib/providers");
+near_api_js_lib_providers = require_rolldown_runtime.__toESM(near_api_js_lib_providers);
 
 //#region src/bridges/direct-bridge/direct-bridge-utils.ts
 function createWithdrawIntentPrimitive(params) {
@@ -25,7 +27,21 @@ function createWithdrawIntentPrimitive(params) {
 function withdrawalParamsInvariant(params) {
 	(0, __defuse_protocol_internal_utils.assert)(!params.routeConfig ? true : params.routeConfig.route === require_route_enum.RouteEnum.NearWithdrawal, "Bridge is not direct");
 }
+async function accountExistsInNEAR(provider, accountId) {
+	try {
+		await (0, __defuse_protocol_internal_utils.unwrapNearFailoverRpcProvider)(provider).query({
+			request_type: "view_account",
+			account_id: accountId,
+			finality: "final"
+		});
+		return true;
+	} catch (error) {
+		if (error instanceof near_api_js_lib_providers.TypedError && error.type === "AccountDoesNotExist") return false;
+		throw error;
+	}
+}
 
 //#endregion
+exports.accountExistsInNEAR = accountExistsInNEAR;
 exports.createWithdrawIntentPrimitive = createWithdrawIntentPrimitive;
 exports.withdrawalParamsInvariant = withdrawalParamsInvariant;

package/dist/src/bridges/direct-bridge/direct-bridge-utils.js

@@ -1,6 +1,7 @@
 import { RouteEnum } from "../../constants/route-enum.js";
 import { NEAR_NATIVE_ASSET_ID } from "./direct-bridge-constants.js";
-import { assert, utils } from "@defuse-protocol/internal-utils";
+import { assert, unwrapNearFailoverRpcProvider, utils } from "@defuse-protocol/internal-utils";
+import { TypedError } from "near-api-js/lib/providers";
 
 //#region src/bridges/direct-bridge/direct-bridge-utils.ts
 function createWithdrawIntentPrimitive(params) {
@@ -23,6 +24,19 @@ function createWithdrawIntentPrimitive(params) {
 function withdrawalParamsInvariant(params) {
 	assert(!params.routeConfig ? true : params.routeConfig.route === RouteEnum.NearWithdrawal, "Bridge is not direct");
 }
+async function accountExistsInNEAR(provider, accountId) {
+	try {
+		await unwrapNearFailoverRpcProvider(provider).query({
+			request_type: "view_account",
+			account_id: accountId,
+			finality: "final"
+		});
+		return true;
+	} catch (error) {
+		if (error instanceof TypedError && error.type === "AccountDoesNotExist") return false;
+		throw error;
+	}
+}
 
 //#endregion
-export { createWithdrawIntentPrimitive, withdrawalParamsInvariant };
+export { accountExistsInNEAR, createWithdrawIntentPrimitive, withdrawalParamsInvariant };

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

@@ -8,12 +8,23 @@ const require_validateAddress = require('../../lib/validateAddress.cjs');
 const require_bridge_name_enum = require('../../constants/bridge-name-enum.cjs');
 const require_direct_bridge_constants = require('./direct-bridge-constants.cjs');
 const require_direct_bridge_utils = require('./direct-bridge-utils.cjs');
+const require_error = require('./error.cjs');
 let __defuse_protocol_internal_utils = require("@defuse-protocol/internal-utils");
 __defuse_protocol_internal_utils = require_rolldown_runtime.__toESM(__defuse_protocol_internal_utils);
+let lru_cache = require("lru-cache");
+lru_cache = require_rolldown_runtime.__toESM(lru_cache);
 
 //#region src/bridges/direct-bridge/direct-bridge.ts
 var DirectBridge = class {
 	constructor({ env, nearProvider, solverRelayApiKey }) {
+		this.storageDepositCache = new lru_cache.LRUCache({
+			max: 100,
+			ttl: 36e5
+		});
+		this.accountExistenceCache = new lru_cache.LRUCache({
+			max: 100,
+			ttl: 36e5
+		});
 		this.env = env;
 		this.nearProvider = nearProvider;
 		this.solverRelayApiKey = solverRelayApiKey;
@@ -62,6 +73,7 @@ var DirectBridge = class {
 	*/
 	async validateWithdrawal(args) {
 		if (require_validateAddress.validateAddress(args.destinationAddress, require_caip2.Chains.Near) === false) throw new require_errors.InvalidDestinationAddressForWithdrawalError(args.destinationAddress, require_caip2.Chains.Near);
+		if (__defuse_protocol_internal_utils.utils.isImplicitAccount(args.destinationAddress) === false && await this.getCachedAccountExistenceCheck(args.destinationAddress) === false) throw new require_error.DestinationExplicitNearAccountDoesntExistError(args.destinationAddress);
 	}
 	async estimateWithdrawalFee(args) {
 		require_direct_bridge_utils.withdrawalParamsInvariant(args.withdrawalParams);
@@ -71,14 +83,7 @@ var DirectBridge = class {
 			amount: 0n,
 			quote: null
 		};
-		const [minStorageBalance, userStorageBalance] = await Promise.all([(0, __defuse_protocol_internal_utils.getNearNep141MinStorageBalance)({
-			contractId: tokenAccountId,
-			nearProvider: this.nearProvider
-		}), (0, __defuse_protocol_internal_utils.getNearNep141StorageBalance)({
-			contractId: tokenAccountId,
-			accountId: args.withdrawalParams.destinationAddress,
-			nearProvider: this.nearProvider
-		})]);
+		const [minStorageBalance, userStorageBalance] = await this.getCachedStorageDepositValue(tokenAccountId, args.withdrawalParams.destinationAddress);
 		if (minStorageBalance <= userStorageBalance) return {
 			amount: 0n,
 			quote: null
@@ -99,6 +104,34 @@ var DirectBridge = class {
 			quote: feeQuote
 		};
 	}
+	/**
+	* Gets storage deposit for a token to avoid frequent RPC calls.
+	*/
+	async getCachedStorageDepositValue(contractId, accountId) {
+		const key = `${contractId}${accountId}`;
+		const cached = this.storageDepositCache.get(key);
+		if (cached !== void 0) return cached;
+		const result = await Promise.all([(0, __defuse_protocol_internal_utils.getNearNep141MinStorageBalance)({
+			contractId,
+			nearProvider: this.nearProvider
+		}), (0, __defuse_protocol_internal_utils.getNearNep141StorageBalance)({
+			contractId,
+			accountId,
+			nearProvider: this.nearProvider
+		})]);
+		if (result[1] >= result[0]) this.storageDepositCache.set(key, result);
+		return result;
+	}
+	/**
+	* Checks account existence to avoid frequent RPC calls.
+	*/
+	async getCachedAccountExistenceCheck(accountId) {
+		const cached = this.accountExistenceCache.get(accountId);
+		if (cached !== void 0) return cached;
+		const exist = await require_direct_bridge_utils.accountExistsInNEAR(this.nearProvider, accountId);
+		if (exist) this.accountExistenceCache.set(accountId, exist);
+		return exist;
+	}
 	async waitForWithdrawalCompletion(args) {
 		return { hash: args.tx.hash };
 	}

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

@@ -6,12 +6,22 @@ import { Chains } from "../../lib/caip2.js";
 import { validateAddress } from "../../lib/validateAddress.js";
 import { BridgeNameEnum } from "../../constants/bridge-name-enum.js";
 import { NEAR_NATIVE_ASSET_ID } from "./direct-bridge-constants.js";
-import { createWithdrawIntentPrimitive, withdrawalParamsInvariant } from "./direct-bridge-utils.js";
+import { accountExistsInNEAR, createWithdrawIntentPrimitive, withdrawalParamsInvariant } from "./direct-bridge-utils.js";
+import { DestinationExplicitNearAccountDoesntExistError } from "./error.js";
 import { assert, getNearNep141MinStorageBalance, getNearNep141StorageBalance, utils } from "@defuse-protocol/internal-utils";
+import { LRUCache } from "lru-cache";
 
 //#region src/bridges/direct-bridge/direct-bridge.ts
 var DirectBridge = class {
 	constructor({ env, nearProvider, solverRelayApiKey }) {
+		this.storageDepositCache = new LRUCache({
+			max: 100,
+			ttl: 36e5
+		});
+		this.accountExistenceCache = new LRUCache({
+			max: 100,
+			ttl: 36e5
+		});
 		this.env = env;
 		this.nearProvider = nearProvider;
 		this.solverRelayApiKey = solverRelayApiKey;
@@ -60,6 +70,7 @@ var DirectBridge = class {
 	*/
 	async validateWithdrawal(args) {
 		if (validateAddress(args.destinationAddress, Chains.Near) === false) throw new InvalidDestinationAddressForWithdrawalError(args.destinationAddress, Chains.Near);
+		if (utils.isImplicitAccount(args.destinationAddress) === false && await this.getCachedAccountExistenceCheck(args.destinationAddress) === false) throw new DestinationExplicitNearAccountDoesntExistError(args.destinationAddress);
 	}
 	async estimateWithdrawalFee(args) {
 		withdrawalParamsInvariant(args.withdrawalParams);
@@ -69,14 +80,7 @@ var DirectBridge = class {
 			amount: 0n,
 			quote: null
 		};
-		const [minStorageBalance, userStorageBalance] = await Promise.all([getNearNep141MinStorageBalance({
-			contractId: tokenAccountId,
-			nearProvider: this.nearProvider
-		}), getNearNep141StorageBalance({
-			contractId: tokenAccountId,
-			accountId: args.withdrawalParams.destinationAddress,
-			nearProvider: this.nearProvider
-		})]);
+		const [minStorageBalance, userStorageBalance] = await this.getCachedStorageDepositValue(tokenAccountId, args.withdrawalParams.destinationAddress);
 		if (minStorageBalance <= userStorageBalance) return {
 			amount: 0n,
 			quote: null
@@ -97,6 +101,34 @@ var DirectBridge = class {
 			quote: feeQuote
 		};
 	}
+	/**
+	* Gets storage deposit for a token to avoid frequent RPC calls.
+	*/
+	async getCachedStorageDepositValue(contractId, accountId) {
+		const key = `${contractId}${accountId}`;
+		const cached = this.storageDepositCache.get(key);
+		if (cached !== void 0) return cached;
+		const result = await Promise.all([getNearNep141MinStorageBalance({
+			contractId,
+			nearProvider: this.nearProvider
+		}), getNearNep141StorageBalance({
+			contractId,
+			accountId,
+			nearProvider: this.nearProvider
+		})]);
+		if (result[1] >= result[0]) this.storageDepositCache.set(key, result);
+		return result;
+	}
+	/**
+	* Checks account existence to avoid frequent RPC calls.
+	*/
+	async getCachedAccountExistenceCheck(accountId) {
+		const cached = this.accountExistenceCache.get(accountId);
+		if (cached !== void 0) return cached;
+		const exist = await accountExistsInNEAR(this.nearProvider, accountId);
+		if (exist) this.accountExistenceCache.set(accountId, exist);
+		return exist;
+	}
 	async waitForWithdrawalCompletion(args) {
 		return { hash: args.tx.hash };
 	}

package/dist/src/bridges/direct-bridge/error.cjs

@@ -0,0 +1,17 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+let __defuse_protocol_internal_utils = require("@defuse-protocol/internal-utils");
+__defuse_protocol_internal_utils = require_rolldown_runtime.__toESM(__defuse_protocol_internal_utils);
+
+//#region src/bridges/direct-bridge/error.ts
+var DestinationExplicitNearAccountDoesntExistError = class extends __defuse_protocol_internal_utils.BaseError {
+	constructor(accountId) {
+		super("Destination explicit NEAR account doesn't exist.", {
+			metaMessages: [`Account Id: ${accountId}`],
+			name: "DestinationExplicitNearAccountDoesntExistError"
+		});
+		this.accountId = accountId;
+	}
+};
+
+//#endregion
+exports.DestinationExplicitNearAccountDoesntExistError = DestinationExplicitNearAccountDoesntExistError;

package/dist/src/bridges/direct-bridge/error.d.cts

@@ -0,0 +1,12 @@
+import { BaseError } from "@defuse-protocol/internal-utils";
+
+//#region src/bridges/direct-bridge/error.d.ts
+type DestinationExplicitNearAccountDoesntExistErrorType = DestinationExplicitNearAccountDoesntExistError & {
+  name: "DestinationExplicitNearAccountDoesntExistError";
+};
+declare class DestinationExplicitNearAccountDoesntExistError extends BaseError {
+  accountId: string;
+  constructor(accountId: string);
+}
+//#endregion
+export { DestinationExplicitNearAccountDoesntExistError, DestinationExplicitNearAccountDoesntExistErrorType };

package/dist/src/bridges/direct-bridge/error.d.ts

@@ -0,0 +1,12 @@
+import { BaseError } from "@defuse-protocol/internal-utils";
+
+//#region src/bridges/direct-bridge/error.d.ts
+type DestinationExplicitNearAccountDoesntExistErrorType = DestinationExplicitNearAccountDoesntExistError & {
+  name: "DestinationExplicitNearAccountDoesntExistError";
+};
+declare class DestinationExplicitNearAccountDoesntExistError extends BaseError {
+  accountId: string;
+  constructor(accountId: string);
+}
+//#endregion
+export { DestinationExplicitNearAccountDoesntExistError, DestinationExplicitNearAccountDoesntExistErrorType };

package/dist/src/bridges/direct-bridge/error.js

@@ -0,0 +1,15 @@
+import { BaseError } from "@defuse-protocol/internal-utils";
+
+//#region src/bridges/direct-bridge/error.ts
+var DestinationExplicitNearAccountDoesntExistError = class extends BaseError {
+	constructor(accountId) {
+		super("Destination explicit NEAR account doesn't exist.", {
+			metaMessages: [`Account Id: ${accountId}`],
+			name: "DestinationExplicitNearAccountDoesntExistError"
+		});
+		this.accountId = accountId;
+	}
+};
+
+//#endregion
+export { DestinationExplicitNearAccountDoesntExistError };

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

@@ -10,14 +10,14 @@ const require_omni_bridge_constants = require('./omni-bridge-constants.cjs');
 const require_omni_bridge_utils = require('./omni-bridge-utils.cjs');
 let __defuse_protocol_internal_utils = require("@defuse-protocol/internal-utils");
 __defuse_protocol_internal_utils = require_rolldown_runtime.__toESM(__defuse_protocol_internal_utils);
+let lru_cache = require("lru-cache");
+lru_cache = require_rolldown_runtime.__toESM(lru_cache);
 let __lifeomic_attempt = require("@lifeomic/attempt");
 __lifeomic_attempt = require_rolldown_runtime.__toESM(__lifeomic_attempt);
 let __isaacs_ttlcache = require("@isaacs/ttlcache");
 __isaacs_ttlcache = require_rolldown_runtime.__toESM(__isaacs_ttlcache);
 let omni_bridge_sdk = require("omni-bridge-sdk");
 omni_bridge_sdk = require_rolldown_runtime.__toESM(omni_bridge_sdk);
-let lru_cache = require("lru-cache");
-lru_cache = require_rolldown_runtime.__toESM(lru_cache);
 
 //#region src/bridges/omni-bridge/omni-bridge.ts
 var OmniBridge = class {

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

@@ -8,10 +8,10 @@ import { FailedToFetchFeeError, IntentsNearOmniAvailableBalanceTooLowError, Omni
 import { MIN_ALLOWED_STORAGE_BALANCE_FOR_INTENTS_NEAR, NEAR_NATIVE_ASSET_ID, OMNI_BRIDGE_CONTRACT } from "./omni-bridge-constants.js";
 import { caip2ToChainKind, chainKindToCaip2, createWithdrawIntentsPrimitive, getAccountOmniStorageBalance, getBridgedToken, getTokenDecimals, validateOmniToken } from "./omni-bridge-utils.js";
 import { RETRY_CONFIGS, assert, configsByEnvironment, getNearNep141MinStorageBalance, getNearNep141StorageBalance } from "@defuse-protocol/internal-utils";
+import { LRUCache } from "lru-cache";
 import { retry } from "@lifeomic/attempt";
 import TTLCache from "@isaacs/ttlcache";
 import { ChainKind, OmniBridgeAPI, getChain, getMinimumTransferableAmount, isEvmChain, omniAddress, parseOriginChain, verifyTransferAmount } from "omni-bridge-sdk";
-import { LRUCache } from "lru-cache";
 
 //#region src/bridges/omni-bridge/omni-bridge.ts
 var OmniBridge = class {

package/dist/src/intents/intent-executer-impl/intent-executer.cjs

@@ -14,7 +14,7 @@ var IntentExecuter = class {
 		this.intentSigner = args.intentSigner;
 		this.onBeforePublishIntent = args.onBeforePublishIntent;
 	}
-	async signAndSendIntent({ relayParams: relayParamsFactory,...intentParams }) {
+	async signAndSendIntent({ relayParams: relayParamsFactory, signedIntents,...intentParams }) {
 		const verifyingContract = __defuse_protocol_internal_utils.configsByEnvironment[this.env].contractID;
 		let intentPayload = require_intent_payload_factory.defaultIntentPayloadFactory({
 			verifying_contract: verifyingContract,
@@ -32,6 +32,14 @@ var IntentExecuter = class {
 				relayParams
 			});
 		}
+		const composedPayloads = composeMultiPayloads(multiPayload, signedIntents);
+		if (composedPayloads.length > 1) {
+			const quoteHashes = relayParams.quoteHashes ?? [];
+			return { ticket: (await this.intentRelayer.publishIntents({
+				multiPayloads: composedPayloads,
+				quoteHashes
+			}, { logger: this.logger }))[signedIntents?.before?.length ?? 0] };
+		}
 		return { ticket: await this.intentRelayer.publishIntent({
 			multiPayload,
 			...relayParams
@@ -50,6 +58,21 @@ async function mergeIntentPayloads(basePayload, intentPayloadFactory) {
 		intents: Array.from(new Set([...customPayloadIntents, ...basePayload.intents]))
 	};
 }
+/**
+* Composes a new MultiPayload with pre-signed intents for atomic execution.
+*
+* @param newPayload - The newly signed MultiPayload
+* @param signedIntents - Optional configuration with before/after intents
+* @returns Array of MultiPayloads in execution order: [before...] -> newPayload -> [after...]
+*/
+function composeMultiPayloads(newPayload, signedIntents) {
+	if (!signedIntents) return [newPayload];
+	const result = [];
+	if (signedIntents.before && signedIntents.before.length > 0) result.push(...signedIntents.before);
+	result.push(newPayload);
+	if (signedIntents.after && signedIntents.after.length > 0) result.push(...signedIntents.after);
+	return result;
+}
 
 //#endregion
 exports.IntentExecuter = IntentExecuter;

package/dist/src/intents/intent-executer-impl/intent-executer.js

@@ -12,7 +12,7 @@ var IntentExecuter = class {
 		this.intentSigner = args.intentSigner;
 		this.onBeforePublishIntent = args.onBeforePublishIntent;
 	}
-	async signAndSendIntent({ relayParams: relayParamsFactory,...intentParams }) {
+	async signAndSendIntent({ relayParams: relayParamsFactory, signedIntents,...intentParams }) {
 		const verifyingContract = configsByEnvironment[this.env].contractID;
 		let intentPayload = defaultIntentPayloadFactory({
 			verifying_contract: verifyingContract,
@@ -30,6 +30,14 @@ var IntentExecuter = class {
 				relayParams
 			});
 		}
+		const composedPayloads = composeMultiPayloads(multiPayload, signedIntents);
+		if (composedPayloads.length > 1) {
+			const quoteHashes = relayParams.quoteHashes ?? [];
+			return { ticket: (await this.intentRelayer.publishIntents({
+				multiPayloads: composedPayloads,
+				quoteHashes
+			}, { logger: this.logger }))[signedIntents?.before?.length ?? 0] };
+		}
 		return { ticket: await this.intentRelayer.publishIntent({
 			multiPayload,
 			...relayParams
@@ -48,6 +56,21 @@ async function mergeIntentPayloads(basePayload, intentPayloadFactory) {
 		intents: Array.from(new Set([...customPayloadIntents, ...basePayload.intents]))
 	};
 }
+/**
+* Composes a new MultiPayload with pre-signed intents for atomic execution.
+*
+* @param newPayload - The newly signed MultiPayload
+* @param signedIntents - Optional configuration with before/after intents
+* @returns Array of MultiPayloads in execution order: [before...] -> newPayload -> [after...]
+*/
+function composeMultiPayloads(newPayload, signedIntents) {
+	if (!signedIntents) return [newPayload];
+	const result = [];
+	if (signedIntents.before && signedIntents.before.length > 0) result.push(...signedIntents.before);
+	result.push(newPayload);
+	if (signedIntents.after && signedIntents.after.length > 0) result.push(...signedIntents.after);
+	return result;
+}
 
 //#endregion
 export { IntentExecuter };

package/dist/src/intents/interfaces/intent-relayer.d.cts

@@ -1,12 +1,37 @@
-import { RelayParamsDefault } from "../shared-types.cjs";
+import { MultiPayload, RelayParamsDefault } from "../shared-types.cjs";
 import { NearTxInfo } from "../../shared-types.cjs";
 import { ILogger } from "@defuse-protocol/internal-utils";
 
 //#region src/intents/interfaces/intent-relayer.d.ts
 interface IIntentRelayer<Ticket, RelayParams = RelayParamsDefault> {
+  /**
+   * Publishes a single intent to the relayer.
+   * @param params - The relay parameters including the signed multi-payload
+   * @param ctx - Optional context with logger
+   * @returns A ticket (typically an intent hash) for tracking the intent
+   */
   publishIntent(params: RelayParams, ctx?: {
     logger?: ILogger;
   }): Promise<Ticket>;
+  /**
+   * Publishes multiple intents atomically to the relayer.
+   * All intents will be executed together or not at all.
+   * @param params - Parameters including array of multi-payloads and quote hashes
+   * @param ctx - Optional context with logger
+   * @returns Array of tickets (typically intent hashes) for tracking the intents
+   */
+  publishIntents(params: {
+    multiPayloads: MultiPayload[];
+    quoteHashes: string[];
+  }, ctx?: {
+    logger?: ILogger;
+  }): Promise<Ticket[]>;
+  /**
+   * Waits for an intent to be settled on-chain.
+   * @param ticket - The ticket returned from publishIntent
+   * @param ctx - Optional context with logger
+   * @returns Transaction information once settled
+   */
   waitForSettlement(ticket: Ticket, ctx?: {
     logger?: ILogger;
   }): Promise<{

package/dist/src/intents/interfaces/intent-relayer.d.ts

@@ -1,12 +1,37 @@
-import { RelayParamsDefault } from "../shared-types.js";
+import { MultiPayload, RelayParamsDefault } from "../shared-types.js";
 import { NearTxInfo } from "../../shared-types.js";
 import { ILogger } from "@defuse-protocol/internal-utils";
 
 //#region src/intents/interfaces/intent-relayer.d.ts
 interface IIntentRelayer<Ticket, RelayParams = RelayParamsDefault> {
+  /**
+   * Publishes a single intent to the relayer.
+   * @param params - The relay parameters including the signed multi-payload
+   * @param ctx - Optional context with logger
+   * @returns A ticket (typically an intent hash) for tracking the intent
+   */
   publishIntent(params: RelayParams, ctx?: {
     logger?: ILogger;
   }): Promise<Ticket>;
+  /**
+   * Publishes multiple intents atomically to the relayer.
+   * All intents will be executed together or not at all.
+   * @param params - Parameters including array of multi-payloads and quote hashes
+   * @param ctx - Optional context with logger
+   * @returns Array of tickets (typically intent hashes) for tracking the intents
+   */
+  publishIntents(params: {
+    multiPayloads: MultiPayload[];
+    quoteHashes: string[];
+  }, ctx?: {
+    logger?: ILogger;
+  }): Promise<Ticket[]>;
+  /**
+   * Waits for an intent to be settled on-chain.
+   * @param ticket - The ticket returned from publishIntent
+   * @param ctx - Optional context with logger
+   * @returns Transaction information once settled
+   */
   waitForSettlement(ticket: Ticket, ctx?: {
     logger?: ILogger;
   }): Promise<{

package/dist/src/lib/estimate-fee.cjs

@@ -14,7 +14,10 @@ async function getFeeQuote({ feeAmount, feeAssetId, tokenAssetId, quoteOptions,
 				defuse_asset_identifier_in: tokenAssetId,
 				defuse_asset_identifier_out: feeAssetId,
 				exact_amount_out: feeAmount.toString(),
-				wait_ms: quoteOptions?.waitMs
+				wait_ms: quoteOptions?.waitMs,
+				min_wait_ms: quoteOptions?.minWaitMs,
+				max_wait_ms: quoteOptions?.maxWaitMs,
+				trusted_metadata: quoteOptions?.trustedMetadata
 			},
 			config: {
 				baseURL: __defuse_protocol_internal_utils.configsByEnvironment[env].solverRelayBaseURL,
@@ -45,7 +48,10 @@ async function getFeeQuote({ feeAmount, feeAssetId, tokenAssetId, quoteOptions,
 				defuse_asset_identifier_in: tokenAssetId,
 				defuse_asset_identifier_out: feeAssetId,
 				exact_amount_in: exactAmountIn.toString(),
-				wait_ms: quoteOptions?.waitMs
+				wait_ms: quoteOptions?.waitMs,
+				min_wait_ms: quoteOptions?.minWaitMs,
+				max_wait_ms: quoteOptions?.maxWaitMs,
+				trusted_metadata: quoteOptions?.trustedMetadata
 			},
 			config: {
 				baseURL: __defuse_protocol_internal_utils.configsByEnvironment[env].solverRelayBaseURL,

package/dist/src/lib/estimate-fee.js

@@ -12,7 +12,10 @@ async function getFeeQuote({ feeAmount, feeAssetId, tokenAssetId, quoteOptions,
 				defuse_asset_identifier_in: tokenAssetId,
 				defuse_asset_identifier_out: feeAssetId,
 				exact_amount_out: feeAmount.toString(),
-				wait_ms: quoteOptions?.waitMs
+				wait_ms: quoteOptions?.waitMs,
+				min_wait_ms: quoteOptions?.minWaitMs,
+				max_wait_ms: quoteOptions?.maxWaitMs,
+				trusted_metadata: quoteOptions?.trustedMetadata
 			},
 			config: {
 				baseURL: configsByEnvironment[env].solverRelayBaseURL,
@@ -43,7 +46,10 @@ async function getFeeQuote({ feeAmount, feeAssetId, tokenAssetId, quoteOptions,
 				defuse_asset_identifier_in: tokenAssetId,
 				defuse_asset_identifier_out: feeAssetId,
 				exact_amount_in: exactAmountIn.toString(),
-				wait_ms: quoteOptions?.waitMs
+				wait_ms: quoteOptions?.waitMs,
+				min_wait_ms: quoteOptions?.minWaitMs,
+				max_wait_ms: quoteOptions?.maxWaitMs,
+				trusted_metadata: quoteOptions?.trustedMetadata
 			},
 			config: {
 				baseURL: configsByEnvironment[env].solverRelayBaseURL,

package/dist/src/sdk.cjs

@@ -181,7 +181,8 @@ var IntentsSDK = class {
 			onBeforePublishIntent: args.onBeforePublishIntent
 		}).signAndSendIntent({
 			intents: args.intents,
-			relayParams: args.relayParams
+			relayParams: args.relayParams,
+			signedIntents: args.signedIntents
 		});
 		return { intentHash: ticket };
 	}
@@ -219,7 +220,8 @@ var IntentsSDK = class {
 			onBeforePublishIntent: args.intent?.onBeforePublishIntent,
 			relayParams: relayParamsFn,
 			payload: args.intent?.payload,
-			logger: args.logger
+			logger: args.logger,
+			signedIntents: args.intent?.signedIntents
 		});
 	}
 	async waitForIntentSettlement(args) {

package/dist/src/sdk.d.cts

@@ -1,6 +1,6 @@
 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, SignAndSendArgs, SignAndSendWithdrawalArgs, TxInfo, TxNoInfo, WithdrawalIdentifier, WithdrawalParams, WithdrawalResult } from "./shared-types.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 { IIntentRelayer } from "./intents/interfaces/intent-relayer.cjs";
 import { ILogger, NearIntentsEnv, RetryOptions } from "@defuse-protocol/internal-utils";
 
@@ -29,23 +29,17 @@ declare class IntentsSDK implements IIntentsSDK {
   }): Promise<IntentPrimitive[]>;
   estimateWithdrawalFee(args: {
     withdrawalParams: WithdrawalParams;
-    quoteOptions?: {
-      waitMs: number;
-    };
+    quoteOptions?: QuoteOptions;
     logger?: ILogger;
   }): Promise<FeeEstimation>;
   estimateWithdrawalFee(args: {
     withdrawalParams: WithdrawalParams[];
-    quoteOptions?: {
-      waitMs: number;
-    };
+    quoteOptions?: QuoteOptions;
     logger?: ILogger;
   }): Promise<FeeEstimation[]>;
   protected _estimateWithdrawalFee(args: {
     withdrawalParams: WithdrawalParams;
-    quoteOptions?: {
-      waitMs: number;
-    };
+    quoteOptions?: QuoteOptions;
     logger?: ILogger;
   }): Promise<FeeEstimation>;
   protected getWithdrawalsIdentifiers({

package/dist/src/sdk.d.ts

@@ -1,6 +1,6 @@
 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, SignAndSendArgs, SignAndSendWithdrawalArgs, TxInfo, TxNoInfo, WithdrawalIdentifier, WithdrawalParams, WithdrawalResult } from "./shared-types.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 { IIntentRelayer } from "./intents/interfaces/intent-relayer.js";
 import { ILogger, NearIntentsEnv, RetryOptions } from "@defuse-protocol/internal-utils";
 
@@ -29,23 +29,17 @@ declare class IntentsSDK implements IIntentsSDK {
   }): Promise<IntentPrimitive[]>;
   estimateWithdrawalFee(args: {
     withdrawalParams: WithdrawalParams;
-    quoteOptions?: {
-      waitMs: number;
-    };
+    quoteOptions?: QuoteOptions;
     logger?: ILogger;
   }): Promise<FeeEstimation>;
   estimateWithdrawalFee(args: {
     withdrawalParams: WithdrawalParams[];
-    quoteOptions?: {
-      waitMs: number;
-    };
+    quoteOptions?: QuoteOptions;
     logger?: ILogger;
   }): Promise<FeeEstimation[]>;
   protected _estimateWithdrawalFee(args: {
     withdrawalParams: WithdrawalParams;
-    quoteOptions?: {
-      waitMs: number;
-    };
+    quoteOptions?: QuoteOptions;
     logger?: ILogger;
   }): Promise<FeeEstimation>;
   protected getWithdrawalsIdentifiers({

package/dist/src/sdk.js

@@ -177,7 +177,8 @@ var IntentsSDK = class {
 			onBeforePublishIntent: args.onBeforePublishIntent
 		}).signAndSendIntent({
 			intents: args.intents,
-			relayParams: args.relayParams
+			relayParams: args.relayParams,
+			signedIntents: args.signedIntents
 		});
 		return { intentHash: ticket };
 	}
@@ -215,7 +216,8 @@ var IntentsSDK = class {
 			onBeforePublishIntent: args.intent?.onBeforePublishIntent,
 			relayParams: relayParamsFn,
 			payload: args.intent?.payload,
-			logger: args.logger
+			logger: args.logger,
+			signedIntents: args.intent?.signedIntents
 		});
 	}
 	async waitForIntentSettlement(args) {

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

@@ -1,7 +1,7 @@
 import { HotBridgeEVMChain } from "./bridges/hot-bridge/hot-bridge-chains.cjs";
 import { BridgeNameEnumValues } from "./constants/bridge-name-enum.cjs";
 import { RouteEnum } from "./constants/route-enum.cjs";
-import { IntentHash, IntentPayloadFactory, IntentPrimitive, IntentRelayParamsFactory } from "./intents/shared-types.cjs";
+import { IntentHash, IntentPayloadFactory, IntentPrimitive, IntentRelayParamsFactory, MultiPayload } from "./intents/shared-types.cjs";
 import { IIntentSigner } from "./intents/interfaces/intent-signer.cjs";
 import { OnBeforePublishIntentHook } from "./intents/intent-executer-impl/intent-executer.cjs";
 import { Chain, Chains } from "./lib/caip2.cjs";
@@ -24,12 +24,63 @@ interface BatchWithdrawalResult {
   destinationTx: (TxInfo | TxNoInfo)[];
 }
 type IntentSettlementStatus = solverRelay.GetStatusReturnType;
+/**
+ * Configuration for including pre-signed intents to be published atomically.
+ *
+ * Pre-signed intents can be included in two ways:
+ * - `before`: Pre-signed intents that execute before the newly created intent
+ * - `after`: Pre-signed intents that execute after the newly created intent
+ *
+ * The execution order is guaranteed: before → new intent → after
+ *
+ * @example
+ * ```typescript
+ * // Include pre-signed intents from other users
+ * const signedIntents: SignedIntents = {
+ *   before: [signedIntent1, signedIntent2],
+ *   after: [cleanupIntent],
+ * };
+ *
+ * await sdk.signAndSendIntent({
+ *   intents: [myNewIntent],
+ *   signedIntents,
+ * });
+ * ```
+ */
+interface SignedIntentsComposition {
+  /**
+   * Pre-signed intents (MultiPayload) to execute before the newly created intent.
+   * Useful for dependencies that must be executed first.
+   */
+  before?: MultiPayload[];
+  /**
+   * Pre-signed intents (MultiPayload) to execute after the newly created intent.
+   * Useful for cleanup or follow-up actions.
+   */
+  after?: MultiPayload[];
+}
 interface SignAndSendArgs {
   intents: IntentPrimitive[];
+  /**
+   * Factory function to modify the intent payload draft before signing.
+   * Use this to add or modify intent primitives in the payload.
+   *
+   * @example
+   * ```typescript
+   * payload: (draft) => ({
+   *   intents: [...draft.intents, { intent: "transfer", ... }]
+   * })
+   * ```
+   */
   payload?: IntentPayloadFactory;
   relayParams?: IntentRelayParamsFactory;
   signer?: IIntentSigner;
   onBeforePublishIntent?: OnBeforePublishIntentHook;
+  /**
+   * Pre-signed intents for atomic execution.
+   * The newly created intent will be published together with these pre-signed intents.
+   */
+  signedIntents?: SignedIntentsComposition;
   logger?: ILogger;
 }
 type SignAndSendWithdrawalArgs<T extends WithdrawalParams | WithdrawalParams[]> = {
@@ -43,10 +94,16 @@ type ProcessWithdrawalArgs<T extends WithdrawalParams | WithdrawalParams[]> = {
   withdrawalParams: T;
   feeEstimation?: T extends WithdrawalParams[] ? FeeEstimation[] : FeeEstimation;
   intent?: {
+    /** @see SignAndSendArgs.payload */
     payload?: IntentPayloadFactory;
+    /** @see SignAndSendArgs.relayParams */
     relayParams?: IntentRelayParamsFactory;
+    /** @see SignAndSendArgs.signer */
     signer?: IIntentSigner;
+    /** @see SignAndSendArgs.onBeforePublishIntent */
     onBeforePublishIntent?: OnBeforePublishIntentHook;
+    /** @see SignAndSendArgs.signedIntents */
+    signedIntents?: SignedIntentsComposition;
   };
   referral?: string;
   retryOptions?: RetryOptions;
@@ -65,16 +122,12 @@ interface IIntentsSDK {
   }): Promise<IntentSettlementStatus>;
   estimateWithdrawalFee(args: {
     withdrawalParams: WithdrawalParams;
-    quoteOptions?: {
-      waitMs: number;
-    };
+    quoteOptions?: QuoteOptions;
     logger?: ILogger;
   }): Promise<FeeEstimation>;
   estimateWithdrawalFee(args: {
     withdrawalParams: WithdrawalParams[];
-    quoteOptions?: {
-      waitMs: number;
-    };
+    quoteOptions?: QuoteOptions;
     logger?: ILogger;
   }): Promise<FeeEstimation[]>;
   signAndSendWithdrawalIntent(args: SignAndSendWithdrawalArgs<WithdrawalParams> | SignAndSendWithdrawalArgs<WithdrawalParams[]>): Promise<IntentPublishResult>;
@@ -102,6 +155,12 @@ interface IIntentsSDK {
   processWithdrawal(args: ProcessWithdrawalArgs<WithdrawalParams>): Promise<WithdrawalResult>;
   processWithdrawal(args: ProcessWithdrawalArgs<WithdrawalParams[]>): Promise<BatchWithdrawalResult>;
 }
+interface QuoteOptions {
+  waitMs?: number;
+  minWaitMs?: number;
+  maxWaitMs?: number;
+  trustedMetadata?: unknown;
+}
 interface NearTxInfo {
   hash: string;
   accountId: string;
@@ -174,9 +233,7 @@ interface Bridge {
   }): Promise<void>;
   estimateWithdrawalFee<T extends Pick<WithdrawalParams, "assetId" | "destinationAddress" | "routeConfig">>(args: {
     withdrawalParams: T;
-    quoteOptions?: {
-      waitMs: number;
-    };
+    quoteOptions?: QuoteOptions;
     logger?: ILogger;
   }): Promise<FeeEstimation>;
   createWithdrawalIntents(args: {
@@ -221,4 +278,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, RouteConfig, SignAndSendArgs, SignAndSendWithdrawalArgs, TxInfo, TxNoInfo, VirtualChainRouteConfig, WithdrawalIdentifier, WithdrawalParams, WithdrawalResult };
+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 };

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

@@ -1,7 +1,7 @@
 import { HotBridgeEVMChain } from "./bridges/hot-bridge/hot-bridge-chains.js";
 import { BridgeNameEnumValues } from "./constants/bridge-name-enum.js";
 import { RouteEnum } from "./constants/route-enum.js";
-import { IntentHash, IntentPayloadFactory, IntentPrimitive, IntentRelayParamsFactory } from "./intents/shared-types.js";
+import { IntentHash, IntentPayloadFactory, IntentPrimitive, IntentRelayParamsFactory, MultiPayload } from "./intents/shared-types.js";
 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";
@@ -24,12 +24,63 @@ interface BatchWithdrawalResult {
   destinationTx: (TxInfo | TxNoInfo)[];
 }
 type IntentSettlementStatus = solverRelay.GetStatusReturnType;
+/**
+ * Configuration for including pre-signed intents to be published atomically.
+ *
+ * Pre-signed intents can be included in two ways:
+ * - `before`: Pre-signed intents that execute before the newly created intent
+ * - `after`: Pre-signed intents that execute after the newly created intent
+ *
+ * The execution order is guaranteed: before → new intent → after
+ *
+ * @example
+ * ```typescript
+ * // Include pre-signed intents from other users
+ * const signedIntents: SignedIntents = {
+ *   before: [signedIntent1, signedIntent2],
+ *   after: [cleanupIntent],
+ * };
+ *
+ * await sdk.signAndSendIntent({
+ *   intents: [myNewIntent],
+ *   signedIntents,
+ * });
+ * ```
+ */
+interface SignedIntentsComposition {
+  /**
+   * Pre-signed intents (MultiPayload) to execute before the newly created intent.
+   * Useful for dependencies that must be executed first.
+   */
+  before?: MultiPayload[];
+  /**
+   * Pre-signed intents (MultiPayload) to execute after the newly created intent.
+   * Useful for cleanup or follow-up actions.
+   */
+  after?: MultiPayload[];
+}
 interface SignAndSendArgs {
   intents: IntentPrimitive[];
+  /**
+   * Factory function to modify the intent payload draft before signing.
+   * Use this to add or modify intent primitives in the payload.
+   *
+   * @example
+   * ```typescript
+   * payload: (draft) => ({
+   *   intents: [...draft.intents, { intent: "transfer", ... }]
+   * })
+   * ```
+   */
   payload?: IntentPayloadFactory;
   relayParams?: IntentRelayParamsFactory;
   signer?: IIntentSigner;
   onBeforePublishIntent?: OnBeforePublishIntentHook;
+  /**
+   * Pre-signed intents for atomic execution.
+   * The newly created intent will be published together with these pre-signed intents.
+   */
+  signedIntents?: SignedIntentsComposition;
   logger?: ILogger;
 }
 type SignAndSendWithdrawalArgs<T extends WithdrawalParams | WithdrawalParams[]> = {
@@ -43,10 +94,16 @@ type ProcessWithdrawalArgs<T extends WithdrawalParams | WithdrawalParams[]> = {
   withdrawalParams: T;
   feeEstimation?: T extends WithdrawalParams[] ? FeeEstimation[] : FeeEstimation;
   intent?: {
+    /** @see SignAndSendArgs.payload */
     payload?: IntentPayloadFactory;
+    /** @see SignAndSendArgs.relayParams */
     relayParams?: IntentRelayParamsFactory;
+    /** @see SignAndSendArgs.signer */
     signer?: IIntentSigner;
+    /** @see SignAndSendArgs.onBeforePublishIntent */
     onBeforePublishIntent?: OnBeforePublishIntentHook;
+    /** @see SignAndSendArgs.signedIntents */
+    signedIntents?: SignedIntentsComposition;
   };
   referral?: string;
   retryOptions?: RetryOptions;
@@ -65,16 +122,12 @@ interface IIntentsSDK {
   }): Promise<IntentSettlementStatus>;
   estimateWithdrawalFee(args: {
     withdrawalParams: WithdrawalParams;
-    quoteOptions?: {
-      waitMs: number;
-    };
+    quoteOptions?: QuoteOptions;
     logger?: ILogger;
   }): Promise<FeeEstimation>;
   estimateWithdrawalFee(args: {
     withdrawalParams: WithdrawalParams[];
-    quoteOptions?: {
-      waitMs: number;
-    };
+    quoteOptions?: QuoteOptions;
     logger?: ILogger;
   }): Promise<FeeEstimation[]>;
   signAndSendWithdrawalIntent(args: SignAndSendWithdrawalArgs<WithdrawalParams> | SignAndSendWithdrawalArgs<WithdrawalParams[]>): Promise<IntentPublishResult>;
@@ -102,6 +155,12 @@ interface IIntentsSDK {
   processWithdrawal(args: ProcessWithdrawalArgs<WithdrawalParams>): Promise<WithdrawalResult>;
   processWithdrawal(args: ProcessWithdrawalArgs<WithdrawalParams[]>): Promise<BatchWithdrawalResult>;
 }
+interface QuoteOptions {
+  waitMs?: number;
+  minWaitMs?: number;
+  maxWaitMs?: number;
+  trustedMetadata?: unknown;
+}
 interface NearTxInfo {
   hash: string;
   accountId: string;
@@ -174,9 +233,7 @@ interface Bridge {
   }): Promise<void>;
   estimateWithdrawalFee<T extends Pick<WithdrawalParams, "assetId" | "destinationAddress" | "routeConfig">>(args: {
     withdrawalParams: T;
-    quoteOptions?: {
-      waitMs: number;
-    };
+    quoteOptions?: QuoteOptions;
     logger?: ILogger;
   }): Promise<FeeEstimation>;
   createWithdrawalIntents(args: {
@@ -221,4 +278,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, RouteConfig, SignAndSendArgs, SignAndSendWithdrawalArgs, TxInfo, TxNoInfo, VirtualChainRouteConfig, WithdrawalIdentifier, WithdrawalParams, WithdrawalResult };
+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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defuse-protocol/intents-sdk",
-  "version": "0.26.4",
+  "version": "0.28.0",
   "private": false,
   "type": "module",
   "sideEffects": false,
@@ -39,7 +39,7 @@
     "valibot": "^1.0.0",
     "viem": "^2.0.0",
     "@defuse-protocol/contract-types": "0.1.2",
-    "@defuse-protocol/internal-utils": "0.15.2"
+    "@defuse-protocol/internal-utils": "0.17.0"
   },
   "devDependencies": {
     "tsdown": "0.15.5",