@defuse-protocol/intents-sdk 0.32.2 → 0.33.0

package/README.md

@@ -23,6 +23,7 @@ interacting with various bridge implementations across multiple blockchains.
     - [Intent Publishing Hooks](#intent-publishing-hooks)
     - [Batch Withdrawals](#batch-withdrawals)
     - [Intent Management](#intent-management)
+    - [Nonce Invalidation](#nonce-invalidation)
     - [Configure Withdrawal Routes](#configure-withdrawal-routes)
     - [Asset Information Parsing](#asset-information-parsing)
     - [Waiting for Completion](#waiting-for-completion)
@@ -572,6 +573,17 @@ if (status.status === 'SETTLED') {
 - `SETTLED` - Intent successfully completed
 - `NOT_FOUND_OR_NOT_VALID` - Intent not found or invalid, it isn't executed onchain
 
+### Nonce Invalidation
+
+Invalidate nonces to prevent execution of previously created intent payloads. Primarily used by **solvers** to revoke quotes due to price volatility, liquidity changes, or risk management.
+
+```typescript
+await sdk.invalidateNonces({
+    nonces: ['VigoxLwmUGf35MGLVBG9Fh5cCtJw3D68pSKFcqGCkHU='],
+    signer: customIntentSigner, // optional - uses SDK default if not provided
+});
+```
+
 ### Configure Withdrawal Routes
 
 **Recommended**: Use factory functions to create route configurations. The SDK provides factory functions for type-safe

package/dist/src/intents/expirable-nonce.cjs

@@ -1,6 +1,8 @@
 const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
 let __scure_base = require("@scure/base");
 __scure_base = require_rolldown_runtime.__toESM(__scure_base);
+let valibot = require("valibot");
+valibot = require_rolldown_runtime.__toESM(valibot);
 let near_api_js_lib_utils_serialize = require("near-api-js/lib/utils/serialize");
 near_api_js_lib_utils_serialize = require_rolldown_runtime.__toESM(near_api_js_lib_utils_serialize);
 
@@ -12,6 +14,17 @@ const VERSIONED_MAGIC_PREFIX = new Uint8Array([
 	198
 ]);
 const LATEST_VERSION = 0;
+/**
+* Schema for validating decoded salted nonce structure.
+* The decoded value from `VersionedNonceBuilder.decodeNonce()` should match this structure.
+*/
+const saltedNonceSchema = valibot.object({
+	salt: valibot.array(valibot.number()),
+	inner: valibot.object({
+		deadline: valibot.bigint(),
+		nonce: valibot.array(valibot.number())
+	})
+});
 var SaltedNonce = class {
 	constructor(salt, inner) {
 		this.salt = salt;
@@ -80,4 +93,5 @@ Object.defineProperty(exports, 'VersionedNonceBuilder', {
   get: function () {
     return VersionedNonceBuilder;
   }
-});
+});
+exports.saltedNonceSchema = saltedNonceSchema;

package/dist/src/intents/expirable-nonce.d.ts

@@ -1,5 +1,6 @@
-//#region src/intents/expirable-nonce.d.ts
+import "valibot";
 
+//#region src/intents/expirable-nonce.d.ts
 type Salt = Uint8Array;
 declare class ExpirableNonce {
   deadline: bigint;

package/dist/src/intents/expirable-nonce.js

@@ -1,4 +1,5 @@
 import { base64 } from "@scure/base";
+import * as v from "valibot";
 import { deserialize, serialize } from "near-api-js/lib/utils/serialize";
 
 //#region src/intents/expirable-nonce.ts
@@ -9,6 +10,17 @@ const VERSIONED_MAGIC_PREFIX = new Uint8Array([
 	198
 ]);
 const LATEST_VERSION = 0;
+/**
+* Schema for validating decoded salted nonce structure.
+* The decoded value from `VersionedNonceBuilder.decodeNonce()` should match this structure.
+*/
+const saltedNonceSchema = v.object({
+	salt: v.array(v.number()),
+	inner: v.object({
+		deadline: v.bigint(),
+		nonce: v.array(v.number())
+	})
+});
 var SaltedNonce = class {
 	constructor(salt, inner) {
 		this.salt = salt;
@@ -72,4 +84,4 @@ let VersionedNonceBuilder;
 })(VersionedNonceBuilder || (VersionedNonceBuilder = {}));
 
 //#endregion
-export { VersionedNonceBuilder };
+export { VersionedNonceBuilder, saltedNonceSchema };

package/dist/src/intents/intent-hash.cjs

@@ -37,7 +37,7 @@ async function computeIntentHashHashBytes(signed) {
 		case "webauthn": return require_webauthn.computeSignedWebAuthnHash(signed);
 		case "ton_connect": return require_ton_connect.computeSignedTonConnectHash(signed);
 		case "sep53": return require_sep53.computeSignedSep53Hash(signed);
-		default: throw new Error(`Unknown payload standard: ${signed.standard}`);
+		default: throw new Error(`Unknown payload standard: ${standard}`);
 	}
 }
 async function computeIntentHash(multiPayload) {

package/dist/src/intents/intent-hash.js

@@ -35,7 +35,7 @@ async function computeIntentHashHashBytes(signed) {
 		case "webauthn": return computeSignedWebAuthnHash(signed);
 		case "ton_connect": return computeSignedTonConnectHash(signed);
 		case "sep53": return computeSignedSep53Hash(signed);
-		default: throw new Error(`Unknown payload standard: ${signed.standard}`);
+		default: throw new Error(`Unknown payload standard: ${standard}`);
 	}
 }
 async function computeIntentHash(multiPayload) {

package/dist/src/sdk.cjs

@@ -9,6 +9,8 @@ const require_intents_bridge = require('./bridges/intents-bridge/intents-bridge.
 const require_omni_bridge = require('./bridges/omni-bridge/omni-bridge.cjs');
 const require_poa_bridge = require('./bridges/poa-bridge/poa-bridge.cjs');
 const require_public_rpc_urls = require('./constants/public-rpc-urls.cjs');
+const require_expirable_nonce = require('./intents/expirable-nonce.cjs');
+const require_intent_payload_factory = require('./intents/intent-payload-factory.cjs');
 const require_intent_executer = require('./intents/intent-executer-impl/intent-executer.cjs');
 const require_intent_relayer_public = require('./intents/intent-relayer-impl/intent-relayer-public.cjs');
 const require_intent_signer_noop = require('./intents/intent-signer-impl/intent-signer-noop.cjs');
@@ -23,6 +25,8 @@ let __hot_labs_omni_sdk = require("@hot-labs/omni-sdk");
 __hot_labs_omni_sdk = require_rolldown_runtime.__toESM(__hot_labs_omni_sdk);
 let viem = require("viem");
 viem = require_rolldown_runtime.__toESM(viem);
+let valibot = require("valibot");
+valibot = require_rolldown_runtime.__toESM(valibot);
 
 //#region src/sdk.ts
 var IntentsSDK = class {
@@ -115,6 +119,50 @@ var IntentsSDK = class {
 			saltManager: this.saltManager
 		});
 	}
+	/**
+	* Invalidate multiple nonces by creating and sending empty signed intents.
+	* This prevents previously created but unused intent payloads from being executed.
+	*
+	* For expirable nonces (versioned nonces with embedded deadlines), the intent's
+	* deadline is automatically set to the minimum of:
+	* 1. The nonce's embedded deadline (can't exceed this)
+	* 2. 1 minute from now (for quick invalidation when possible)
+	*
+	* @param args.nonces - Array of nonce strings to invalidate (up to 400 nonces per call, but depends on gas consumption)
+	* @param args.signer - Optional intent signer to use (defaults to SDK's configured signer)
+	* @param args.logger - Optional logger for debugging
+	*
+	* @example
+	* ```typescript
+	* // Invalidate unused nonces
+	* await sdk.invalidateNonces({
+	*   nonces: ['nonce1', 'nonce2', 'nonce3']
+	* });
+	* ```
+	*/
+	async invalidateNonces(args) {
+		if (args.nonces.length === 0) return;
+		const intentSigner = args.signer ?? this.intentSigner;
+		(0, __defuse_protocol_internal_utils.assert)(intentSigner != null, "Intent signer is not provided");
+		const signedIntents = await Promise.all(args.nonces.map(async (nonce) => {
+			const builder = this.intentBuilder().setNonce(nonce);
+			try {
+				const decoded = require_expirable_nonce.VersionedNonceBuilder.decodeNonce(nonce);
+				if (valibot.is(require_expirable_nonce.saltedNonceSchema, decoded.value)) {
+					const nonceDeadlineMs = Number(decoded.value.inner.deadline / 1000000n);
+					const nonceDeadline = new Date(nonceDeadlineMs);
+					const oneMinuteFromNow = new Date(Date.now() + require_intent_payload_factory.DEFAULT_DEADLINE_MS);
+					const deadline = oneMinuteFromNow < nonceDeadline ? oneMinuteFromNow : nonceDeadline;
+					builder.setDeadline(deadline);
+				} else args.logger?.warn?.("Decoded nonce has unexpected structure, using default deadline");
+			} catch {}
+			return builder.buildAndSign(intentSigner);
+		}));
+		await this.intentRelayer.publishIntents({
+			multiPayloads: signedIntents,
+			quoteHashes: []
+		}, { logger: args.logger });
+	}
 	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

@@ -49,6 +49,32 @@ declare class IntentsSDK implements IIntentsSDK {
    * ```
    */
   intentBuilder(): IntentPayloadBuilder;
+  /**
+   * Invalidate multiple nonces by creating and sending empty signed intents.
+   * This prevents previously created but unused intent payloads from being executed.
+   *
+   * For expirable nonces (versioned nonces with embedded deadlines), the intent's
+   * deadline is automatically set to the minimum of:
+   * 1. The nonce's embedded deadline (can't exceed this)
+   * 2. 1 minute from now (for quick invalidation when possible)
+   *
+   * @param args.nonces - Array of nonce strings to invalidate (up to 400 nonces per call, but depends on gas consumption)
+   * @param args.signer - Optional intent signer to use (defaults to SDK's configured signer)
+   * @param args.logger - Optional logger for debugging
+   *
+   * @example
+   * ```typescript
+   * // Invalidate unused nonces
+   * await sdk.invalidateNonces({
+   *   nonces: ['nonce1', 'nonce2', 'nonce3']
+   * });
+   * ```
+   */
+  invalidateNonces(args: {
+    nonces: string[];
+    signer?: IIntentSigner;
+    logger?: ILogger;
+  }): Promise<void>;
   createWithdrawalIntents(args: {
     withdrawalParams: WithdrawalParams;
     feeEstimation: FeeEstimation;

package/dist/src/sdk.d.ts

@@ -49,6 +49,32 @@ declare class IntentsSDK implements IIntentsSDK {
    * ```
    */
   intentBuilder(): IntentPayloadBuilder;
+  /**
+   * Invalidate multiple nonces by creating and sending empty signed intents.
+   * This prevents previously created but unused intent payloads from being executed.
+   *
+   * For expirable nonces (versioned nonces with embedded deadlines), the intent's
+   * deadline is automatically set to the minimum of:
+   * 1. The nonce's embedded deadline (can't exceed this)
+   * 2. 1 minute from now (for quick invalidation when possible)
+   *
+   * @param args.nonces - Array of nonce strings to invalidate (up to 400 nonces per call, but depends on gas consumption)
+   * @param args.signer - Optional intent signer to use (defaults to SDK's configured signer)
+   * @param args.logger - Optional logger for debugging
+   *
+   * @example
+   * ```typescript
+   * // Invalidate unused nonces
+   * await sdk.invalidateNonces({
+   *   nonces: ['nonce1', 'nonce2', 'nonce3']
+   * });
+   * ```
+   */
+  invalidateNonces(args: {
+    nonces: string[];
+    signer?: IIntentSigner;
+    logger?: ILogger;
+  }): Promise<void>;
   createWithdrawalIntents(args: {
     withdrawalParams: WithdrawalParams;
     feeEstimation: FeeEstimation;

package/dist/src/sdk.js

@@ -8,6 +8,8 @@ import { IntentsBridge } from "./bridges/intents-bridge/intents-bridge.js";
 import { OmniBridge } from "./bridges/omni-bridge/omni-bridge.js";
 import { PoaBridge } from "./bridges/poa-bridge/poa-bridge.js";
 import { PUBLIC_EVM_RPC_URLS, PUBLIC_STELLAR_RPC_URLS } from "./constants/public-rpc-urls.js";
+import { VersionedNonceBuilder, saltedNonceSchema } from "./intents/expirable-nonce.js";
+import { DEFAULT_DEADLINE_MS } from "./intents/intent-payload-factory.js";
 import { IntentExecuter } from "./intents/intent-executer-impl/intent-executer.js";
 import { IntentRelayerPublic } from "./intents/intent-relayer-impl/intent-relayer-public.js";
 import { noopIntentSigner } from "./intents/intent-signer-impl/intent-signer-noop.js";
@@ -19,6 +21,7 @@ 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";
+import * as v from "valibot";
 
 //#region src/sdk.ts
 var IntentsSDK = class {
@@ -111,6 +114,50 @@ var IntentsSDK = class {
 			saltManager: this.saltManager
 		});
 	}
+	/**
+	* Invalidate multiple nonces by creating and sending empty signed intents.
+	* This prevents previously created but unused intent payloads from being executed.
+	*
+	* For expirable nonces (versioned nonces with embedded deadlines), the intent's
+	* deadline is automatically set to the minimum of:
+	* 1. The nonce's embedded deadline (can't exceed this)
+	* 2. 1 minute from now (for quick invalidation when possible)
+	*
+	* @param args.nonces - Array of nonce strings to invalidate (up to 400 nonces per call, but depends on gas consumption)
+	* @param args.signer - Optional intent signer to use (defaults to SDK's configured signer)
+	* @param args.logger - Optional logger for debugging
+	*
+	* @example
+	* ```typescript
+	* // Invalidate unused nonces
+	* await sdk.invalidateNonces({
+	*   nonces: ['nonce1', 'nonce2', 'nonce3']
+	* });
+	* ```
+	*/
+	async invalidateNonces(args) {
+		if (args.nonces.length === 0) return;
+		const intentSigner = args.signer ?? this.intentSigner;
+		assert(intentSigner != null, "Intent signer is not provided");
+		const signedIntents = await Promise.all(args.nonces.map(async (nonce) => {
+			const builder = this.intentBuilder().setNonce(nonce);
+			try {
+				const decoded = VersionedNonceBuilder.decodeNonce(nonce);
+				if (v.is(saltedNonceSchema, decoded.value)) {
+					const nonceDeadlineMs = Number(decoded.value.inner.deadline / 1000000n);
+					const nonceDeadline = new Date(nonceDeadlineMs);
+					const oneMinuteFromNow = new Date(Date.now() + DEFAULT_DEADLINE_MS);
+					const deadline = oneMinuteFromNow < nonceDeadline ? oneMinuteFromNow : nonceDeadline;
+					builder.setDeadline(deadline);
+				} else args.logger?.warn?.("Decoded nonce has unexpected structure, using default deadline");
+			} catch {}
+			return builder.buildAndSign(intentSigner);
+		}));
+		await this.intentRelayer.publishIntents({
+			multiPayloads: signedIntents,
+			quoteHashes: []
+		}, { logger: args.logger });
+	}
 	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/shared-types.d.cts

@@ -120,6 +120,11 @@ interface IIntentsSDK {
     intentHash: IntentHash;
     logger?: ILogger;
   }): Promise<IntentSettlementStatus>;
+  invalidateNonces(args: {
+    nonces: string[];
+    signer?: IIntentSigner;
+    logger?: ILogger;
+  }): Promise<void>;
   estimateWithdrawalFee(args: {
     withdrawalParams: WithdrawalParams;
     quoteOptions?: QuoteOptions;

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

@@ -120,6 +120,11 @@ interface IIntentsSDK {
     intentHash: IntentHash;
     logger?: ILogger;
   }): Promise<IntentSettlementStatus>;
+  invalidateNonces(args: {
+    nonces: string[];
+    signer?: IIntentSigner;
+    logger?: ILogger;
+  }): Promise<void>;
   estimateWithdrawalFee(args: {
     withdrawalParams: WithdrawalParams;
     quoteOptions?: QuoteOptions;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defuse-protocol/intents-sdk",
-  "version": "0.32.2",
+  "version": "0.33.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.3.0",
-    "@defuse-protocol/internal-utils": "0.19.0"
+    "@defuse-protocol/contract-types": "0.3.1",
+    "@defuse-protocol/internal-utils": "0.19.1"
   },
   "devDependencies": {
     "tsdown": "0.15.5",