@defuse-protocol/intents-sdk 0.29.1 → 0.30.0

package/README.md

@@ -19,6 +19,7 @@ interacting with various bridge implementations across multiple blockchains.
 - [Advanced Usage](#advanced-usage)
     - [Custom RPC URLs](#custom-rpc-urls)
     - [Other Intent Signers](#other-intent-signers)
+    - [Intent Payload Builder](#intent-payload-builder)
     - [Intent Publishing Hooks](#intent-publishing-hooks)
     - [Batch Withdrawals](#batch-withdrawals)
     - [Intent Management](#intent-management)
@@ -403,6 +404,23 @@ const signer = createIntentSignerViem({ signer: account });
 sdk.setIntentSigner(signer);
 ```
 
+### Intent Payload Builder
+
+For API builders who need to generate intent payloads based on user metadata (e.g., generating payloads server-side for users to sign with MetaMask), the SDK provides a fluent `IntentPayloadBuilder`:
+
+```typescript
+// Build an intent payload for your users
+const payload = await sdk.intentBuilder()
+    .setSigner('0x742d35cc6634c0532925a3b8d84b2021f90a51a3') // User's EVM address
+    .setDeadline(new Date(Date.now() + 5 * 60 * 1000)) // 5 minutes
+    .addIntent({
+        intent: "transfer",
+        tokens: { "token.near": "100" },
+        receiver_id: "receiver.near",
+    })
+    .build();
+```
+
 ### Intent Publishing Hooks
 
 Use the `onBeforePublishIntent` hook to intercept and process intent data before it's published to the relayer. This is

package/dist/index.cjs

@@ -8,6 +8,7 @@ const require_error$1 = require('./src/bridges/hot-bridge/error.cjs');
 const require_error$2 = require('./src/bridges/omni-bridge/error.cjs');
 const require_expirable_nonce = require('./src/intents/expirable-nonce.cjs');
 const require_route_config_factory = require('./src/lib/route-config-factory.cjs');
+const require_intent_payload_builder = require('./src/intents/intent-payload-builder.cjs');
 const require_sdk = require('./src/sdk.cjs');
 const require_factories = require('./src/intents/intent-signer-impl/factories.cjs');
 let __defuse_protocol_internal_utils = require("@defuse-protocol/internal-utils");
@@ -39,6 +40,7 @@ Object.defineProperty(exports, 'HttpRequestError', {
     return __defuse_protocol_internal_utils.HttpRequestError;
   }
 });
+exports.IntentPayloadBuilder = require_intent_payload_builder.IntentPayloadBuilder;
 Object.defineProperty(exports, 'IntentSettlementError', {
   enumerable: true,
   get: function () {

package/dist/index.d.cts

@@ -6,6 +6,7 @@ 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, SignAndSendArgs, SignAndSendWithdrawalArgs, SignedIntentsComposition, TxInfo, TxNoInfo, VirtualChainRouteConfig, WithdrawalIdentifier, WithdrawalParams, WithdrawalResult } from "./src/shared-types.cjs";
+import { IntentPayloadBuilder } from "./src/intents/intent-payload-builder.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";
@@ -14,4 +15,4 @@ import { DestinationExplicitNearAccountDoesntExistError, DestinationExplicitNear
 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, 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, VersionedNonceBuilder, 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, IntentPayloadBuilder, 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, VersionedNonceBuilder, type VirtualChainRouteConfig, type WithdrawalIdentifier, type WithdrawalParams, type WithdrawalResult, createDefaultRoute, createHotBridgeRoute, createIntentSignerNEP413, createIntentSignerNearKeyPair, createIntentSignerViem, createInternalTransferRoute, createNearWithdrawalRoute, createOmniBridgeRoute, createPoaBridgeRoute, createVirtualChainRoute };

package/dist/index.d.ts

@@ -6,6 +6,7 @@ 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, SignAndSendArgs, SignAndSendWithdrawalArgs, SignedIntentsComposition, TxInfo, TxNoInfo, VirtualChainRouteConfig, WithdrawalIdentifier, WithdrawalParams, WithdrawalResult } from "./src/shared-types.js";
+import { IntentPayloadBuilder } from "./src/intents/intent-payload-builder.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";
@@ -14,4 +15,4 @@ import { DestinationExplicitNearAccountDoesntExistError, DestinationExplicitNear
 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, 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, VersionedNonceBuilder, 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, IntentPayloadBuilder, 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, VersionedNonceBuilder, type VirtualChainRouteConfig, type WithdrawalIdentifier, type WithdrawalParams, type WithdrawalResult, createDefaultRoute, createHotBridgeRoute, createIntentSignerNEP413, createIntentSignerNearKeyPair, createIntentSignerViem, createInternalTransferRoute, createNearWithdrawalRoute, createOmniBridgeRoute, createPoaBridgeRoute, createVirtualChainRoute };

package/dist/index.js

@@ -7,8 +7,9 @@ import { HotWithdrawalCancelledError, HotWithdrawalNotFoundError, HotWithdrawalP
 import { FailedToFetchFeeError, IntentsNearOmniAvailableBalanceTooLowError, OmniTokenNormalisationCheckError, OmniTransferDestinationChainHashNotFoundError, OmniTransferNotFoundError, TokenNotFoundInDestinationChainError } from "./src/bridges/omni-bridge/error.js";
 import { VersionedNonceBuilder } from "./src/intents/expirable-nonce.js";
 import { createDefaultRoute, createHotBridgeRoute, createInternalTransferRoute, createNearWithdrawalRoute, createOmniBridgeRoute, createPoaBridgeRoute, createVirtualChainRoute } from "./src/lib/route-config-factory.js";
+import { IntentPayloadBuilder } from "./src/intents/intent-payload-builder.js";
 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, 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, VersionedNonceBuilder, createDefaultRoute, createHotBridgeRoute, createIntentSignerNEP413, createIntentSignerNearKeyPair, createIntentSignerViem, createInternalTransferRoute, createNearWithdrawalRoute, createOmniBridgeRoute, createPoaBridgeRoute, createVirtualChainRoute };
+export { AssertionError, BaseError, BridgeNameEnum, Chains, DestinationExplicitNearAccountDoesntExistError, FailedToFetchFeeError, FeeExceedsAmountError, HotWithdrawalCancelledError, HotWithdrawalNotFoundError, HotWithdrawalPendingError, HttpRequestError, IntentPayloadBuilder, IntentSettlementError, IntentsNearOmniAvailableBalanceTooLowError, IntentsSDK, MinWithdrawalAmountError, OmniTokenNormalisationCheckError, OmniTransferDestinationChainHashNotFoundError, OmniTransferNotFoundError, PoaWithdrawalInvariantError, PoaWithdrawalNotFoundError, PoaWithdrawalPendingError, QuoteError, RelayPublishError, RouteEnum, RpcRequestError, TimeoutError, TokenNotFoundInDestinationChainError, TrustlineNotFoundError, UnsupportedAssetIdError, UnsupportedDestinationMemoError, VersionedNonceBuilder, createDefaultRoute, createHotBridgeRoute, createIntentSignerNEP413, createIntentSignerNearKeyPair, createIntentSignerViem, createInternalTransferRoute, createNearWithdrawalRoute, createOmniBridgeRoute, createPoaBridgeRoute, createVirtualChainRoute };

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

@@ -25,7 +25,7 @@ function createWithdrawIntentsPrimitive(params) {
 	});
 	(0, __defuse_protocol_internal_utils.assert)(standard === "nep141", "Only NEP-141 is supported");
 	return [{
-		account_id: implicitAccount,
+		deposit_for_account_id: implicitAccount,
 		amount: params.nativeFee.toString(),
 		contract_id: require_omni_bridge_constants.OMNI_BRIDGE_CONTRACT,
 		intent: "storage_deposit"

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

@@ -21,7 +21,7 @@ function createWithdrawIntentsPrimitive(params) {
 	});
 	assert(standard === "nep141", "Only NEP-141 is supported");
 	return [{
-		account_id: implicitAccount,
+		deposit_for_account_id: implicitAccount,
 		amount: params.nativeFee.toString(),
 		contract_id: OMNI_BRIDGE_CONTRACT,
 		intent: "storage_deposit"

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

@@ -20,7 +20,7 @@ var IntentExecuter = class {
 			verifying_contract: verifyingContract,
 			...intentParams
 		});
-		if (this.intentPayloadFactory) intentPayload = await mergeIntentPayloads(intentPayload, this.intentPayloadFactory);
+		if (this.intentPayloadFactory) intentPayload = await mergeIntentPayloads(intentPayload, this.intentPayloadFactory, salt);
 		const multiPayload = await this.intentSigner.signIntent(intentPayload);
 		const relayParams = relayParamsFactory ? await relayParamsFactory() : {};
 		if (this.onBeforePublishIntent) {
@@ -49,14 +49,15 @@ var IntentExecuter = class {
 		return this.intentRelayer.waitForSettlement(ticket, { logger: this.logger });
 	}
 };
-async function mergeIntentPayloads(basePayload, intentPayloadFactory) {
-	const customPayload = await intentPayloadFactory(basePayload);
+async function mergeIntentPayloads(defaultPayload, intentPayloadFactory, salt) {
+	const customPayload = await intentPayloadFactory(defaultPayload);
 	const customPayloadIntents = customPayload.intents ?? [];
-	return {
+	const { nonce: _nonce,...basePayload } = defaultPayload;
+	return require_intent_payload_factory.defaultIntentPayloadFactory(salt, {
 		...basePayload,
 		...customPayload,
 		intents: Array.from(new Set([...customPayloadIntents, ...basePayload.intents]))
-	};
+	});
 }
 /**
 * Composes a new MultiPayload with pre-signed intents for atomic execution.

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

@@ -18,7 +18,7 @@ var IntentExecuter = class {
 			verifying_contract: verifyingContract,
 			...intentParams
 		});
-		if (this.intentPayloadFactory) intentPayload = await mergeIntentPayloads(intentPayload, this.intentPayloadFactory);
+		if (this.intentPayloadFactory) intentPayload = await mergeIntentPayloads(intentPayload, this.intentPayloadFactory, salt);
 		const multiPayload = await this.intentSigner.signIntent(intentPayload);
 		const relayParams = relayParamsFactory ? await relayParamsFactory() : {};
 		if (this.onBeforePublishIntent) {
@@ -47,14 +47,15 @@ var IntentExecuter = class {
 		return this.intentRelayer.waitForSettlement(ticket, { logger: this.logger });
 	}
 };
-async function mergeIntentPayloads(basePayload, intentPayloadFactory) {
-	const customPayload = await intentPayloadFactory(basePayload);
+async function mergeIntentPayloads(defaultPayload, intentPayloadFactory, salt) {
+	const customPayload = await intentPayloadFactory(defaultPayload);
 	const customPayloadIntents = customPayload.intents ?? [];
-	return {
+	const { nonce: _nonce,...basePayload } = defaultPayload;
+	return defaultIntentPayloadFactory(salt, {
 		...basePayload,
 		...customPayload,
 		intents: Array.from(new Set([...customPayloadIntents, ...basePayload.intents]))
-	};
+	});
 }
 /**
 * Composes a new MultiPayload with pre-signed intents for atomic execution.

package/dist/src/intents/intent-payload-builder.cjs

@@ -0,0 +1,205 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_expirable_nonce = require('./expirable-nonce.cjs');
+const require_intent_payload_factory = require('./intent-payload-factory.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/intents/intent-payload-builder.ts
+/**
+* Fluent builder for constructing intent payloads with environment context.
+* Provides a convenient API for generating intents that can be signed with different standards.
+*
+* @example
+* ```typescript
+* const sdk = new IntentsSDK({ env: 'production', referral: 'my-app' });
+*
+* // Build an intent payload
+* const payload = await sdk.intentBuilder()
+*   .setSigner('0x1234...') // EVM address or NEAR account
+*   .setDeadline(new Date(Date.now() + 5 * 60 * 1000)) // 5 minutes
+*   .addIntent({
+*     intent: 'ft_withdraw',
+*     token: 'usdc.omft.near',
+*     amount: '1000000',
+*     receiver_id: 'user.near'
+*   })
+*   .build();
+*
+* // Sign with your preferred method
+* const multiPayload = await signer.signIntent(payload);
+* ```
+*/
+var IntentPayloadBuilder = class IntentPayloadBuilder {
+	constructor(config) {
+		this.intents = [];
+		this.env = config.env;
+		this.saltManager = config.saltManager;
+		this.verifyingContract = __defuse_protocol_internal_utils.configsByEnvironment[this.env].contractID;
+	}
+	/**
+	* Set the signer ID (address or account that will sign the intent).
+	* Can be an EVM address (for ERC191) or NEAR account ID (for NEP413).
+	*
+	* @param signerId - The identifier of the signer (must be a valid NEAR account ID)
+	* @returns The builder instance for chaining with updated type
+	* @throws Error if signerId is not a valid NEAR account ID
+	*/
+	setSigner(signerId) {
+		if (!__defuse_protocol_internal_utils.utils.validateNearAddress(signerId)) throw new Error(`Invalid signer_id: "${signerId}" is not a valid NEAR account ID`);
+		this.signerId = signerId;
+		return this;
+	}
+	/**
+	* Set the deadline for the intent expiration.
+	* If not set, defaults to 1 minute from build time.
+	*
+	* @param deadline - The expiration time for the intent
+	* @returns The builder instance for chaining
+	*/
+	setDeadline(deadline) {
+		this.deadline = deadline;
+		return this;
+	}
+	/**
+	* Add an intent to the payload.
+	* Multiple intents can be added and will execute atomically.
+	*
+	* @param intent - The intent primitive to add
+	* @returns The builder instance for chaining
+	*/
+	addIntent(intent) {
+		this.intents.push(intent);
+		return this;
+	}
+	/**
+	* Add multiple intents to the payload at once.
+	*
+	* @param intents - Array of intent primitives to add
+	* @returns The builder instance for chaining
+	*/
+	addIntents(intents) {
+		this.intents.push(...intents);
+		return this;
+	}
+	/**
+	* Override the verifying contract address.
+	* Use with caution - normally this is automatically set based on environment.
+	*
+	* @param contractAddress - The contract address to use
+	* @returns The builder instance for chaining
+	*/
+	setVerifyingContract(contractAddress) {
+		this.verifyingContract = contractAddress;
+		return this;
+	}
+	/**
+	* Set a custom nonce. If not provided, a nonce will be automatically generated.
+	* The nonce must be a valid versioned nonce format.
+	*
+	* @param nonce - Custom nonce string (base64 encoded)
+	* @returns The builder instance for chaining
+	*/
+	setNonce(nonce) {
+		this.customNonce = nonce;
+		return this;
+	}
+	/**
+	* Clear all intents from the builder.
+	*
+	* @returns The builder instance for chaining
+	*/
+	clearIntents() {
+		this.intents = [];
+		return this;
+	}
+	/**
+	* Reset the builder to its initial state.
+	* Keeps environment and salt manager but clears all user-set values.
+	*
+	* @returns The builder instance for chaining
+	*/
+	reset() {
+		this.signerId = void 0;
+		this.deadline = void 0;
+		this.intents = [];
+		this.customNonce = void 0;
+		this.verifyingContract = __defuse_protocol_internal_utils.configsByEnvironment[this.env].contractID;
+		return this;
+	}
+	/**
+	* Build the intent payload using a custom salt.
+	* Use this method if you need explicit control over the salt.
+	*
+	* @param salt - The salt to use for nonce generation
+	* @returns The constructed intent payload with appropriate typing
+	*/
+	buildWithSalt(salt) {
+		const deadline = this.deadline ?? new Date(Date.now() + require_intent_payload_factory.DEFAULT_DEADLINE_MS);
+		const nonce = this.customNonce ?? require_expirable_nonce.VersionedNonceBuilder.encodeNonce(salt, deadline);
+		return {
+			verifying_contract: this.verifyingContract,
+			signer_id: this.signerId,
+			deadline: deadline.toISOString(),
+			nonce,
+			intents: [...this.intents]
+		};
+	}
+	/**
+	* Build the intent payload. Automatically fetches a fresh salt if needed.
+	* This is the recommended method for most use cases.
+	*
+	* @returns Promise resolving to the constructed intent payload with appropriate typing
+	*/
+	async build() {
+		const salt = await this.saltManager.getCachedSalt();
+		return this.buildWithSalt(salt);
+	}
+	/**
+	* Build and sign the intent payload in one step.
+	* Convenience method that combines build() and signing.
+	*
+	* @param signer - The intent signer to use
+	* @returns Promise resolving to the signed multi-payload
+	*/
+	async buildAndSign(signer) {
+		const payload = await this.build();
+		return signer.signIntent(payload);
+	}
+	/**
+	* Create a new builder instance with the same configuration.
+	* Useful when you need multiple independent builders.
+	*
+	* @returns A new IntentPayloadBuilder instance
+	*/
+	clone() {
+		const builder = new IntentPayloadBuilder({
+			env: this.env,
+			saltManager: this.saltManager
+		});
+		builder.verifyingContract = this.verifyingContract;
+		builder.signerId = this.signerId;
+		builder.deadline = this.deadline;
+		builder.intents = [...this.intents];
+		builder.customNonce = this.customNonce;
+		return builder;
+	}
+	/**
+	* Get the current state of the builder as a plain object.
+	* Useful for debugging or inspecting the builder configuration.
+	*
+	* @returns Object containing the current builder state
+	*/
+	getState() {
+		return {
+			env: this.env,
+			verifyingContract: this.verifyingContract,
+			signerId: this.signerId,
+			deadline: this.deadline,
+			intents: [...this.intents],
+			customNonce: this.customNonce
+		};
+	}
+};
+
+//#endregion
+exports.IntentPayloadBuilder = IntentPayloadBuilder;

package/dist/src/intents/intent-payload-builder.d.cts

@@ -0,0 +1,158 @@
+import { Salt } from "./expirable-nonce.cjs";
+import { IntentPayload, IntentPrimitive, MultiPayload } from "./shared-types.cjs";
+import { IIntentSigner } from "./interfaces/intent-signer.cjs";
+import { ISaltManager } from "./interfaces/salt-manager.cjs";
+import { NearIntentsEnv } from "@defuse-protocol/internal-utils";
+
+//#region src/intents/intent-payload-builder.d.ts
+interface IntentPayloadBuilderConfig {
+  env: NearIntentsEnv;
+  saltManager: ISaltManager;
+}
+/**
+ * Type helper to make signer_id required when HasSigner is true
+ */
+type IntentPayloadWithSigner<HasSigner extends boolean> = HasSigner extends true ? IntentPayload & {
+  signer_id: string;
+} : IntentPayload;
+/**
+ * Fluent builder for constructing intent payloads with environment context.
+ * Provides a convenient API for generating intents that can be signed with different standards.
+ *
+ * @example
+ * ```typescript
+ * const sdk = new IntentsSDK({ env: 'production', referral: 'my-app' });
+ *
+ * // Build an intent payload
+ * const payload = await sdk.intentBuilder()
+ *   .setSigner('0x1234...') // EVM address or NEAR account
+ *   .setDeadline(new Date(Date.now() + 5 * 60 * 1000)) // 5 minutes
+ *   .addIntent({
+ *     intent: 'ft_withdraw',
+ *     token: 'usdc.omft.near',
+ *     amount: '1000000',
+ *     receiver_id: 'user.near'
+ *   })
+ *   .build();
+ *
+ * // Sign with your preferred method
+ * const multiPayload = await signer.signIntent(payload);
+ * ```
+ */
+declare class IntentPayloadBuilder<HasSigner extends boolean = false> {
+  private env;
+  private saltManager;
+  private verifyingContract;
+  private signerId?;
+  private deadline?;
+  private intents;
+  private customNonce?;
+  constructor(config: IntentPayloadBuilderConfig);
+  /**
+   * Set the signer ID (address or account that will sign the intent).
+   * Can be an EVM address (for ERC191) or NEAR account ID (for NEP413).
+   *
+   * @param signerId - The identifier of the signer (must be a valid NEAR account ID)
+   * @returns The builder instance for chaining with updated type
+   * @throws Error if signerId is not a valid NEAR account ID
+   */
+  setSigner(signerId: string): IntentPayloadBuilder<true>;
+  /**
+   * Set the deadline for the intent expiration.
+   * If not set, defaults to 1 minute from build time.
+   *
+   * @param deadline - The expiration time for the intent
+   * @returns The builder instance for chaining
+   */
+  setDeadline(deadline: Date): this;
+  /**
+   * Add an intent to the payload.
+   * Multiple intents can be added and will execute atomically.
+   *
+   * @param intent - The intent primitive to add
+   * @returns The builder instance for chaining
+   */
+  addIntent(intent: IntentPrimitive): this;
+  /**
+   * Add multiple intents to the payload at once.
+   *
+   * @param intents - Array of intent primitives to add
+   * @returns The builder instance for chaining
+   */
+  addIntents(intents: IntentPrimitive[]): this;
+  /**
+   * Override the verifying contract address.
+   * Use with caution - normally this is automatically set based on environment.
+   *
+   * @param contractAddress - The contract address to use
+   * @returns The builder instance for chaining
+   */
+  setVerifyingContract(contractAddress: string): this;
+  /**
+   * Set a custom nonce. If not provided, a nonce will be automatically generated.
+   * The nonce must be a valid versioned nonce format.
+   *
+   * @param nonce - Custom nonce string (base64 encoded)
+   * @returns The builder instance for chaining
+   */
+  setNonce(nonce: string): this;
+  /**
+   * Clear all intents from the builder.
+   *
+   * @returns The builder instance for chaining
+   */
+  clearIntents(): this;
+  /**
+   * Reset the builder to its initial state.
+   * Keeps environment and salt manager but clears all user-set values.
+   *
+   * @returns The builder instance for chaining
+   */
+  reset(): IntentPayloadBuilder<false>;
+  /**
+   * Build the intent payload using a custom salt.
+   * Use this method if you need explicit control over the salt.
+   *
+   * @param salt - The salt to use for nonce generation
+   * @returns The constructed intent payload with appropriate typing
+   */
+  buildWithSalt(salt: Salt): IntentPayloadWithSigner<HasSigner>;
+  /**
+   * Build the intent payload. Automatically fetches a fresh salt if needed.
+   * This is the recommended method for most use cases.
+   *
+   * @returns Promise resolving to the constructed intent payload with appropriate typing
+   */
+  build(): Promise<IntentPayloadWithSigner<HasSigner>>;
+  /**
+   * Build and sign the intent payload in one step.
+   * Convenience method that combines build() and signing.
+   *
+   * @param signer - The intent signer to use
+   * @returns Promise resolving to the signed multi-payload
+   */
+  buildAndSign(signer: IIntentSigner): Promise<MultiPayload>;
+  /**
+   * Create a new builder instance with the same configuration.
+   * Useful when you need multiple independent builders.
+   *
+   * @returns A new IntentPayloadBuilder instance
+   */
+  clone(): IntentPayloadBuilder<HasSigner>;
+  /**
+   * Get the current state of the builder as a plain object.
+   * Useful for debugging or inspecting the builder configuration.
+   *
+   * @returns Object containing the current builder state
+   */
+  getState(): {
+    env: NearIntentsEnv;
+    verifyingContract: string;
+    signerId?: string;
+    deadline?: Date;
+    intents: IntentPrimitive[];
+    customNonce?: string;
+  };
+}
+//#endregion
+export { IntentPayloadBuilder };

package/dist/src/intents/intent-payload-builder.d.ts

@@ -0,0 +1,158 @@
+import { Salt } from "./expirable-nonce.js";
+import { IntentPayload, IntentPrimitive, MultiPayload } from "./shared-types.js";
+import { IIntentSigner } from "./interfaces/intent-signer.js";
+import { ISaltManager } from "./interfaces/salt-manager.js";
+import { NearIntentsEnv } from "@defuse-protocol/internal-utils";
+
+//#region src/intents/intent-payload-builder.d.ts
+interface IntentPayloadBuilderConfig {
+  env: NearIntentsEnv;
+  saltManager: ISaltManager;
+}
+/**
+ * Type helper to make signer_id required when HasSigner is true
+ */
+type IntentPayloadWithSigner<HasSigner extends boolean> = HasSigner extends true ? IntentPayload & {
+  signer_id: string;
+} : IntentPayload;
+/**
+ * Fluent builder for constructing intent payloads with environment context.
+ * Provides a convenient API for generating intents that can be signed with different standards.
+ *
+ * @example
+ * ```typescript
+ * const sdk = new IntentsSDK({ env: 'production', referral: 'my-app' });
+ *
+ * // Build an intent payload
+ * const payload = await sdk.intentBuilder()
+ *   .setSigner('0x1234...') // EVM address or NEAR account
+ *   .setDeadline(new Date(Date.now() + 5 * 60 * 1000)) // 5 minutes
+ *   .addIntent({
+ *     intent: 'ft_withdraw',
+ *     token: 'usdc.omft.near',
+ *     amount: '1000000',
+ *     receiver_id: 'user.near'
+ *   })
+ *   .build();
+ *
+ * // Sign with your preferred method
+ * const multiPayload = await signer.signIntent(payload);
+ * ```
+ */
+declare class IntentPayloadBuilder<HasSigner extends boolean = false> {
+  private env;
+  private saltManager;
+  private verifyingContract;
+  private signerId?;
+  private deadline?;
+  private intents;
+  private customNonce?;
+  constructor(config: IntentPayloadBuilderConfig);
+  /**
+   * Set the signer ID (address or account that will sign the intent).
+   * Can be an EVM address (for ERC191) or NEAR account ID (for NEP413).
+   *
+   * @param signerId - The identifier of the signer (must be a valid NEAR account ID)
+   * @returns The builder instance for chaining with updated type
+   * @throws Error if signerId is not a valid NEAR account ID
+   */
+  setSigner(signerId: string): IntentPayloadBuilder<true>;
+  /**
+   * Set the deadline for the intent expiration.
+   * If not set, defaults to 1 minute from build time.
+   *
+   * @param deadline - The expiration time for the intent
+   * @returns The builder instance for chaining
+   */
+  setDeadline(deadline: Date): this;
+  /**
+   * Add an intent to the payload.
+   * Multiple intents can be added and will execute atomically.
+   *
+   * @param intent - The intent primitive to add
+   * @returns The builder instance for chaining
+   */
+  addIntent(intent: IntentPrimitive): this;
+  /**
+   * Add multiple intents to the payload at once.
+   *
+   * @param intents - Array of intent primitives to add
+   * @returns The builder instance for chaining
+   */
+  addIntents(intents: IntentPrimitive[]): this;
+  /**
+   * Override the verifying contract address.
+   * Use with caution - normally this is automatically set based on environment.
+   *
+   * @param contractAddress - The contract address to use
+   * @returns The builder instance for chaining
+   */
+  setVerifyingContract(contractAddress: string): this;
+  /**
+   * Set a custom nonce. If not provided, a nonce will be automatically generated.
+   * The nonce must be a valid versioned nonce format.
+   *
+   * @param nonce - Custom nonce string (base64 encoded)
+   * @returns The builder instance for chaining
+   */
+  setNonce(nonce: string): this;
+  /**
+   * Clear all intents from the builder.
+   *
+   * @returns The builder instance for chaining
+   */
+  clearIntents(): this;
+  /**
+   * Reset the builder to its initial state.
+   * Keeps environment and salt manager but clears all user-set values.
+   *
+   * @returns The builder instance for chaining
+   */
+  reset(): IntentPayloadBuilder<false>;
+  /**
+   * Build the intent payload using a custom salt.
+   * Use this method if you need explicit control over the salt.
+   *
+   * @param salt - The salt to use for nonce generation
+   * @returns The constructed intent payload with appropriate typing
+   */
+  buildWithSalt(salt: Salt): IntentPayloadWithSigner<HasSigner>;
+  /**
+   * Build the intent payload. Automatically fetches a fresh salt if needed.
+   * This is the recommended method for most use cases.
+   *
+   * @returns Promise resolving to the constructed intent payload with appropriate typing
+   */
+  build(): Promise<IntentPayloadWithSigner<HasSigner>>;
+  /**
+   * Build and sign the intent payload in one step.
+   * Convenience method that combines build() and signing.
+   *
+   * @param signer - The intent signer to use
+   * @returns Promise resolving to the signed multi-payload
+   */
+  buildAndSign(signer: IIntentSigner): Promise<MultiPayload>;
+  /**
+   * Create a new builder instance with the same configuration.
+   * Useful when you need multiple independent builders.
+   *
+   * @returns A new IntentPayloadBuilder instance
+   */
+  clone(): IntentPayloadBuilder<HasSigner>;
+  /**
+   * Get the current state of the builder as a plain object.
+   * Useful for debugging or inspecting the builder configuration.
+   *
+   * @returns Object containing the current builder state
+   */
+  getState(): {
+    env: NearIntentsEnv;
+    verifyingContract: string;
+    signerId?: string;
+    deadline?: Date;
+    intents: IntentPrimitive[];
+    customNonce?: string;
+  };
+}
+//#endregion
+export { IntentPayloadBuilder };

package/dist/src/intents/intent-payload-builder.js

@@ -0,0 +1,203 @@
+import { VersionedNonceBuilder } from "./expirable-nonce.js";
+import { DEFAULT_DEADLINE_MS } from "./intent-payload-factory.js";
+import { configsByEnvironment, utils } from "@defuse-protocol/internal-utils";
+
+//#region src/intents/intent-payload-builder.ts
+/**
+* Fluent builder for constructing intent payloads with environment context.
+* Provides a convenient API for generating intents that can be signed with different standards.
+*
+* @example
+* ```typescript
+* const sdk = new IntentsSDK({ env: 'production', referral: 'my-app' });
+*
+* // Build an intent payload
+* const payload = await sdk.intentBuilder()
+*   .setSigner('0x1234...') // EVM address or NEAR account
+*   .setDeadline(new Date(Date.now() + 5 * 60 * 1000)) // 5 minutes
+*   .addIntent({
+*     intent: 'ft_withdraw',
+*     token: 'usdc.omft.near',
+*     amount: '1000000',
+*     receiver_id: 'user.near'
+*   })
+*   .build();
+*
+* // Sign with your preferred method
+* const multiPayload = await signer.signIntent(payload);
+* ```
+*/
+var IntentPayloadBuilder = class IntentPayloadBuilder {
+	constructor(config) {
+		this.intents = [];
+		this.env = config.env;
+		this.saltManager = config.saltManager;
+		this.verifyingContract = configsByEnvironment[this.env].contractID;
+	}
+	/**
+	* Set the signer ID (address or account that will sign the intent).
+	* Can be an EVM address (for ERC191) or NEAR account ID (for NEP413).
+	*
+	* @param signerId - The identifier of the signer (must be a valid NEAR account ID)
+	* @returns The builder instance for chaining with updated type
+	* @throws Error if signerId is not a valid NEAR account ID
+	*/
+	setSigner(signerId) {
+		if (!utils.validateNearAddress(signerId)) throw new Error(`Invalid signer_id: "${signerId}" is not a valid NEAR account ID`);
+		this.signerId = signerId;
+		return this;
+	}
+	/**
+	* Set the deadline for the intent expiration.
+	* If not set, defaults to 1 minute from build time.
+	*
+	* @param deadline - The expiration time for the intent
+	* @returns The builder instance for chaining
+	*/
+	setDeadline(deadline) {
+		this.deadline = deadline;
+		return this;
+	}
+	/**
+	* Add an intent to the payload.
+	* Multiple intents can be added and will execute atomically.
+	*
+	* @param intent - The intent primitive to add
+	* @returns The builder instance for chaining
+	*/
+	addIntent(intent) {
+		this.intents.push(intent);
+		return this;
+	}
+	/**
+	* Add multiple intents to the payload at once.
+	*
+	* @param intents - Array of intent primitives to add
+	* @returns The builder instance for chaining
+	*/
+	addIntents(intents) {
+		this.intents.push(...intents);
+		return this;
+	}
+	/**
+	* Override the verifying contract address.
+	* Use with caution - normally this is automatically set based on environment.
+	*
+	* @param contractAddress - The contract address to use
+	* @returns The builder instance for chaining
+	*/
+	setVerifyingContract(contractAddress) {
+		this.verifyingContract = contractAddress;
+		return this;
+	}
+	/**
+	* Set a custom nonce. If not provided, a nonce will be automatically generated.
+	* The nonce must be a valid versioned nonce format.
+	*
+	* @param nonce - Custom nonce string (base64 encoded)
+	* @returns The builder instance for chaining
+	*/
+	setNonce(nonce) {
+		this.customNonce = nonce;
+		return this;
+	}
+	/**
+	* Clear all intents from the builder.
+	*
+	* @returns The builder instance for chaining
+	*/
+	clearIntents() {
+		this.intents = [];
+		return this;
+	}
+	/**
+	* Reset the builder to its initial state.
+	* Keeps environment and salt manager but clears all user-set values.
+	*
+	* @returns The builder instance for chaining
+	*/
+	reset() {
+		this.signerId = void 0;
+		this.deadline = void 0;
+		this.intents = [];
+		this.customNonce = void 0;
+		this.verifyingContract = configsByEnvironment[this.env].contractID;
+		return this;
+	}
+	/**
+	* Build the intent payload using a custom salt.
+	* Use this method if you need explicit control over the salt.
+	*
+	* @param salt - The salt to use for nonce generation
+	* @returns The constructed intent payload with appropriate typing
+	*/
+	buildWithSalt(salt) {
+		const deadline = this.deadline ?? new Date(Date.now() + DEFAULT_DEADLINE_MS);
+		const nonce = this.customNonce ?? VersionedNonceBuilder.encodeNonce(salt, deadline);
+		return {
+			verifying_contract: this.verifyingContract,
+			signer_id: this.signerId,
+			deadline: deadline.toISOString(),
+			nonce,
+			intents: [...this.intents]
+		};
+	}
+	/**
+	* Build the intent payload. Automatically fetches a fresh salt if needed.
+	* This is the recommended method for most use cases.
+	*
+	* @returns Promise resolving to the constructed intent payload with appropriate typing
+	*/
+	async build() {
+		const salt = await this.saltManager.getCachedSalt();
+		return this.buildWithSalt(salt);
+	}
+	/**
+	* Build and sign the intent payload in one step.
+	* Convenience method that combines build() and signing.
+	*
+	* @param signer - The intent signer to use
+	* @returns Promise resolving to the signed multi-payload
+	*/
+	async buildAndSign(signer) {
+		const payload = await this.build();
+		return signer.signIntent(payload);
+	}
+	/**
+	* Create a new builder instance with the same configuration.
+	* Useful when you need multiple independent builders.
+	*
+	* @returns A new IntentPayloadBuilder instance
+	*/
+	clone() {
+		const builder = new IntentPayloadBuilder({
+			env: this.env,
+			saltManager: this.saltManager
+		});
+		builder.verifyingContract = this.verifyingContract;
+		builder.signerId = this.signerId;
+		builder.deadline = this.deadline;
+		builder.intents = [...this.intents];
+		builder.customNonce = this.customNonce;
+		return builder;
+	}
+	/**
+	* Get the current state of the builder as a plain object.
+	* Useful for debugging or inspecting the builder configuration.
+	*
+	* @returns Object containing the current builder state
+	*/
+	getState() {
+		return {
+			env: this.env,
+			verifyingContract: this.verifyingContract,
+			signerId: this.signerId,
+			deadline: this.deadline,
+			intents: [...this.intents],
+			customNonce: this.customNonce
+		};
+	}
+};
+
+//#endregion
+export { IntentPayloadBuilder };

package/dist/src/intents/intent-payload-factory.cjs

@@ -4,7 +4,7 @@ const require_expirable_nonce = require('./expirable-nonce.cjs');
 const DEFAULT_DEADLINE_MS = 60 * 1e3;
 function defaultIntentPayloadFactory(salt, { intents, verifying_contract,...params }) {
 	params = Object.fromEntries(Object.entries(params).filter(([, value]) => value !== void 0));
-	const deadline = new Date(Date.now() + DEFAULT_DEADLINE_MS);
+	const deadline = params.deadline != null ? new Date(params.deadline) : new Date(Date.now() + DEFAULT_DEADLINE_MS);
 	return {
 		verifying_contract,
 		deadline: deadline.toISOString(),
@@ -16,4 +16,5 @@ function defaultIntentPayloadFactory(salt, { intents, verifying_contract,...para
 }
 
 //#endregion
+exports.DEFAULT_DEADLINE_MS = DEFAULT_DEADLINE_MS;
 exports.defaultIntentPayloadFactory = defaultIntentPayloadFactory;

package/dist/src/intents/intent-payload-factory.js

@@ -4,7 +4,7 @@ import { VersionedNonceBuilder } from "./expirable-nonce.js";
 const DEFAULT_DEADLINE_MS = 60 * 1e3;
 function defaultIntentPayloadFactory(salt, { intents, verifying_contract,...params }) {
 	params = Object.fromEntries(Object.entries(params).filter(([, value]) => value !== void 0));
-	const deadline = new Date(Date.now() + DEFAULT_DEADLINE_MS);
+	const deadline = params.deadline != null ? new Date(params.deadline) : new Date(Date.now() + DEFAULT_DEADLINE_MS);
 	return {
 		verifying_contract,
 		deadline: deadline.toISOString(),
@@ -16,4 +16,4 @@ function defaultIntentPayloadFactory(salt, { intents, verifying_contract,...para
 }
 
 //#endregion
-export { defaultIntentPayloadFactory };
+export { DEFAULT_DEADLINE_MS, defaultIntentPayloadFactory };

package/dist/src/sdk.cjs

@@ -16,6 +16,7 @@ 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_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");
 __defuse_protocol_internal_utils = require_rolldown_runtime.__toESM(__defuse_protocol_internal_utils);
 let __hot_labs_omni_sdk = require("@hot-labs/omni-sdk");
@@ -84,6 +85,36 @@ var IntentsSDK = class {
 	setIntentSigner(signer) {
 		this.intentSigner = signer;
 	}
+	/**
+	* Create a new intent payload builder with environment context.
+	* Use this to build custom intent payloads for your API or advanced use cases.
+	*
+	* @returns A new IntentPayloadBuilder instance configured with the SDK's environment
+	*
+	* @example
+	* ```typescript
+	* // Build a custom intent payload
+	* const payload = await sdk.intentBuilder()
+	*   .setSigner('0x1234...') // User's EVM address
+	*   .setDeadline(new Date(Date.now() + 5 * 60 * 1000))
+	*   .addIntent({
+	*     intent: 'ft_withdraw',
+	*     token: 'usdc.omft.near',
+	*     amount: '1000000',
+	*     receiver_id: 'user.near'
+	*   })
+	*   .build();
+	*
+	* // Return to user for signing with their preferred method (MetaMask, etc.)
+	* return payload;
+	* ```
+	*/
+	intentBuilder() {
+		return new require_intent_payload_builder.IntentPayloadBuilder({
+			env: this.env,
+			saltManager: this.saltManager
+		});
+	}
 	async createWithdrawalIntents(args) {
 		for (const bridge of this.bridges) if (await bridge.supports(args.withdrawalParams)) {
 			const actualAmount = args.withdrawalParams.feeInclusive ? args.withdrawalParams.amount - args.feeEstimation.amount : args.withdrawalParams.amount;

package/dist/src/sdk.d.cts

@@ -3,6 +3,7 @@ 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 { 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";
 
 //#region src/sdk.d.ts
@@ -23,6 +24,31 @@ declare class IntentsSDK implements IIntentsSDK {
   protected saltManager: ISaltManager;
   constructor(args: IntentsSDKConfig);
   setIntentSigner(signer: IIntentSigner): void;
+  /**
+   * Create a new intent payload builder with environment context.
+   * Use this to build custom intent payloads for your API or advanced use cases.
+   *
+   * @returns A new IntentPayloadBuilder instance configured with the SDK's environment
+   *
+   * @example
+   * ```typescript
+   * // Build a custom intent payload
+   * const payload = await sdk.intentBuilder()
+   *   .setSigner('0x1234...') // User's EVM address
+   *   .setDeadline(new Date(Date.now() + 5 * 60 * 1000))
+   *   .addIntent({
+   *     intent: 'ft_withdraw',
+   *     token: 'usdc.omft.near',
+   *     amount: '1000000',
+   *     receiver_id: 'user.near'
+   *   })
+   *   .build();
+   *
+   * // Return to user for signing with their preferred method (MetaMask, etc.)
+   * return payload;
+   * ```
+   */
+  intentBuilder(): IntentPayloadBuilder;
   createWithdrawalIntents(args: {
     withdrawalParams: WithdrawalParams;
     feeEstimation: FeeEstimation;

package/dist/src/sdk.d.ts

@@ -3,6 +3,7 @@ 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 { 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";
 
 //#region src/sdk.d.ts
@@ -23,6 +24,31 @@ declare class IntentsSDK implements IIntentsSDK {
   protected saltManager: ISaltManager;
   constructor(args: IntentsSDKConfig);
   setIntentSigner(signer: IIntentSigner): void;
+  /**
+   * Create a new intent payload builder with environment context.
+   * Use this to build custom intent payloads for your API or advanced use cases.
+   *
+   * @returns A new IntentPayloadBuilder instance configured with the SDK's environment
+   *
+   * @example
+   * ```typescript
+   * // Build a custom intent payload
+   * const payload = await sdk.intentBuilder()
+   *   .setSigner('0x1234...') // User's EVM address
+   *   .setDeadline(new Date(Date.now() + 5 * 60 * 1000))
+   *   .addIntent({
+   *     intent: 'ft_withdraw',
+   *     token: 'usdc.omft.near',
+   *     amount: '1000000',
+   *     receiver_id: 'user.near'
+   *   })
+   *   .build();
+   *
+   * // Return to user for signing with their preferred method (MetaMask, etc.)
+   * return payload;
+   * ```
+   */
+  intentBuilder(): IntentPayloadBuilder;
   createWithdrawalIntents(args: {
     withdrawalParams: WithdrawalParams;
     feeEstimation: FeeEstimation;

package/dist/src/sdk.js

@@ -15,6 +15,7 @@ import { zip } from "./lib/array.js";
 import { configureEvmRpcUrls, configureStellarRpcUrls } from "./lib/configure-rpc-config.js";
 import { determineRouteConfig } from "./lib/route-config.js";
 import { SaltManager } from "./intents/salt-manager.js";
+import { IntentPayloadBuilder } from "./intents/intent-payload-builder.js";
 import { PUBLIC_NEAR_RPC_URLS, RETRY_CONFIGS, RelayPublishError, assert, configsByEnvironment, nearFailoverRpcProvider, solverRelay } from "@defuse-protocol/internal-utils";
 import { HotBridge } from "@hot-labs/omni-sdk";
 import { stringify } from "viem";
@@ -80,6 +81,36 @@ var IntentsSDK = class {
 	setIntentSigner(signer) {
 		this.intentSigner = signer;
 	}
+	/**
+	* Create a new intent payload builder with environment context.
+	* Use this to build custom intent payloads for your API or advanced use cases.
+	*
+	* @returns A new IntentPayloadBuilder instance configured with the SDK's environment
+	*
+	* @example
+	* ```typescript
+	* // Build a custom intent payload
+	* const payload = await sdk.intentBuilder()
+	*   .setSigner('0x1234...') // User's EVM address
+	*   .setDeadline(new Date(Date.now() + 5 * 60 * 1000))
+	*   .addIntent({
+	*     intent: 'ft_withdraw',
+	*     token: 'usdc.omft.near',
+	*     amount: '1000000',
+	*     receiver_id: 'user.near'
+	*   })
+	*   .build();
+	*
+	* // Return to user for signing with their preferred method (MetaMask, etc.)
+	* return payload;
+	* ```
+	*/
+	intentBuilder() {
+		return new IntentPayloadBuilder({
+			env: this.env,
+			saltManager: this.saltManager
+		});
+	}
 	async createWithdrawalIntents(args) {
 		for (const bridge of this.bridges) if (await bridge.supports(args.withdrawalParams)) {
 			const actualAmount = args.withdrawalParams.feeInclusive ? args.withdrawalParams.amount - args.feeEstimation.amount : args.withdrawalParams.amount;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defuse-protocol/intents-sdk",
-  "version": "0.29.1",
+  "version": "0.30.0",
   "private": false,
   "type": "module",
   "sideEffects": false,
@@ -38,8 +38,8 @@
     "ripple-address-codec": "^5.0.0",
     "valibot": "^1.0.0",
     "viem": "^2.0.0",
-    "@defuse-protocol/contract-types": "0.2.0",
-    "@defuse-protocol/internal-utils": "0.18.0"
+    "@defuse-protocol/contract-types": "0.3.0",
+    "@defuse-protocol/internal-utils": "0.18.1"
   },
   "devDependencies": {
     "tsdown": "0.15.5",