@defuse-protocol/intents-sdk 0.48.0 → 0.49.0

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

@@ -53,14 +53,22 @@ const SALTED_NONCE_BORSH_SCHEMA = { struct: {
 } };
 let VersionedNonceBuilder;
 (function(_VersionedNonceBuilder) {
-	function encodeNonce(salt, deadline) {
+	const RANDOM_BYTES_LENGTH = 15;
+	function createTimestampedNonceBytes(startTime) {
+		const bytes = new Uint8Array(RANDOM_BYTES_LENGTH);
+		new DataView(bytes.buffer).setBigInt64(0, BigInt(startTime.getTime()) * 1000000n, true);
+		crypto.getRandomValues(bytes.subarray(8));
+		return bytes;
+	}
+	_VersionedNonceBuilder.createTimestampedNonceBytes = createTimestampedNonceBytes;
+	function encodeNonce(salt, deadline, randomBytes = crypto.getRandomValues(new Uint8Array(RANDOM_BYTES_LENGTH))) {
 		if (salt.length !== 4) throw new Error(`Invalid salt length: ${salt.length}, expected 4`);
+		if (randomBytes.length !== RANDOM_BYTES_LENGTH) throw new Error(`Invalid randomBytes length: ${randomBytes.length}, expected ${RANDOM_BYTES_LENGTH}`);
 		const deadlineBigInt = BigInt(deadline.getTime()) * 1000000n;
-		const nonceBytes = crypto.getRandomValues(new Uint8Array(15));
 		const borshBytes = new Uint8Array(27);
 		borshBytes.set(salt, 0);
 		new DataView(borshBytes.buffer, borshBytes.byteOffset, borshBytes.byteLength).setBigUint64(4, deadlineBigInt, true);
-		borshBytes.set(nonceBytes, 12);
+		borshBytes.set(randomBytes, 12);
 		const result = new Uint8Array(5 + borshBytes.length);
 		result.set(VERSIONED_MAGIC_PREFIX, 0);
 		result.set([LATEST_VERSION], 4);

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

@@ -24,14 +24,23 @@ declare class VersionedNonce {
   static latest(saltedNonce: SaltedNonce): VersionedNonce;
 }
 declare namespace VersionedNonceBuilder {
+  /**
+   * Creates nonce bytes with embedded start timestamp.
+   * Layout: [startTime: 8 bytes LE nanoseconds] [random: 7 bytes]
+   *
+   * @param startTime The start time to embed in the nonce
+   * @returns 15-byte Uint8Array with timestamp and random data
+   */
+  function createTimestampedNonceBytes(startTime: Date): Uint8Array;
   /**
    * Encodes a versioned expirable nonce with the given salt and deadline
    *
    * @param salt The salt to use for the nonce
    * @param deadline The expiration deadline for the nonce
+   * @param randomBytes Optional random bytes to use. If not provided, random bytes will be generated.
    * @returns The encoded nonce as a base64 string
    */
-  function encodeNonce(salt: Salt, deadline: Date): string;
+  function encodeNonce(salt: Salt, deadline: Date, randomBytes?: Uint8Array<ArrayBufferLike>): string;
   /**
    * Decodes a versioned expirable nonce from a base64-encoded string
    *

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

@@ -1,4 +1,5 @@
 import "valibot";
+import "near-api-js/lib/utils/serialize";
 
 //#region src/intents/expirable-nonce.d.ts
 type Salt = Uint8Array;
@@ -25,14 +26,23 @@ declare class VersionedNonce {
   static latest(saltedNonce: SaltedNonce): VersionedNonce;
 }
 declare namespace VersionedNonceBuilder {
+  /**
+   * Creates nonce bytes with embedded start timestamp.
+   * Layout: [startTime: 8 bytes LE nanoseconds] [random: 7 bytes]
+   *
+   * @param startTime The start time to embed in the nonce
+   * @returns 15-byte Uint8Array with timestamp and random data
+   */
+  function createTimestampedNonceBytes(startTime: Date): Uint8Array;
   /**
    * Encodes a versioned expirable nonce with the given salt and deadline
    *
    * @param salt The salt to use for the nonce
    * @param deadline The expiration deadline for the nonce
+   * @param randomBytes Optional random bytes to use. If not provided, random bytes will be generated.
    * @returns The encoded nonce as a base64 string
    */
-  function encodeNonce(salt: Salt, deadline: Date): string;
+  function encodeNonce(salt: Salt, deadline: Date, randomBytes?: Uint8Array<ArrayBufferLike>): string;
   /**
    * Decodes a versioned expirable nonce from a base64-encoded string
    *

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

@@ -51,14 +51,22 @@ const SALTED_NONCE_BORSH_SCHEMA = { struct: {
 } };
 let VersionedNonceBuilder;
 (function(_VersionedNonceBuilder) {
-	function encodeNonce(salt, deadline) {
+	const RANDOM_BYTES_LENGTH = 15;
+	function createTimestampedNonceBytes(startTime) {
+		const bytes = new Uint8Array(RANDOM_BYTES_LENGTH);
+		new DataView(bytes.buffer).setBigInt64(0, BigInt(startTime.getTime()) * 1000000n, true);
+		crypto.getRandomValues(bytes.subarray(8));
+		return bytes;
+	}
+	_VersionedNonceBuilder.createTimestampedNonceBytes = createTimestampedNonceBytes;
+	function encodeNonce(salt, deadline, randomBytes = crypto.getRandomValues(new Uint8Array(RANDOM_BYTES_LENGTH))) {
 		if (salt.length !== 4) throw new Error(`Invalid salt length: ${salt.length}, expected 4`);
+		if (randomBytes.length !== RANDOM_BYTES_LENGTH) throw new Error(`Invalid randomBytes length: ${randomBytes.length}, expected ${RANDOM_BYTES_LENGTH}`);
 		const deadlineBigInt = BigInt(deadline.getTime()) * 1000000n;
-		const nonceBytes = crypto.getRandomValues(new Uint8Array(15));
 		const borshBytes = new Uint8Array(27);
 		borshBytes.set(salt, 0);
 		new DataView(borshBytes.buffer, borshBytes.byteOffset, borshBytes.byteLength).setBigUint64(4, deadlineBigInt, true);
-		borshBytes.set(nonceBytes, 12);
+		borshBytes.set(randomBytes, 12);
 		const result = new Uint8Array(5 + borshBytes.length);
 		result.set(VERSIONED_MAGIC_PREFIX, 0);
 		result.set([LATEST_VERSION], 4);

package/dist/src/intents/intent-hashes/ton-connect.cjs

@@ -52,8 +52,6 @@ function parseTonAddress(addressString) {
 *   payload
 * )
 *
-* For cell payloads: Uses TON TLB message serialization (not fully implemented here)
-*
 * @param payload - The TON Connect payload to hash
 * @returns 32-byte hash as Uint8Array
 */
@@ -86,8 +84,6 @@ function computeTonConnectHash(payload) {
 			}
 			return (0, _noble_hashes_sha2.sha256)(message);
 		}
-		case "binary": throw new Error("Binary payload hashing is not yet supported");
-		case "cell": throw new Error("Cell payload hashing is not yet supported.");
 		default: throw new Error(`Unknown TON Connect payload type: ${schemaType}`);
 	}
 }

package/dist/src/intents/intent-hashes/ton-connect.js

@@ -51,8 +51,6 @@ function parseTonAddress(addressString) {
 *   payload
 * )
 *
-* For cell payloads: Uses TON TLB message serialization (not fully implemented here)
-*
 * @param payload - The TON Connect payload to hash
 * @returns 32-byte hash as Uint8Array
 */
@@ -85,8 +83,6 @@ function computeTonConnectHash(payload) {
 			}
 			return sha256(message);
 		}
-		case "binary": throw new Error("Binary payload hashing is not yet supported");
-		case "cell": throw new Error("Cell payload hashing is not yet supported.");
 		default: throw new Error(`Unknown TON Connect payload type: ${schemaType}`);
 	}
 }

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

@@ -92,8 +92,12 @@ var IntentPayloadBuilder = class IntentPayloadBuilder {
 		return this;
 	}
 	/**
-	* Set a custom nonce. If not provided, a nonce will be automatically generated.
-	* The nonce must be a valid versioned nonce format.
+	* Set a pre-built nonce directly.
+	* Use this when you have a complete nonce from an external source
+	* or need to reuse/invalidate a specific nonce.
+	*
+	* For most cases where you need custom random bytes, use {@link setNonceRandomBytes} instead,
+	* which handles salt fetching and nonce encoding automatically.
 	*
 	* @param nonce - Custom nonce string (base64 encoded)
 	* @returns The builder instance for chaining
@@ -103,6 +107,23 @@ var IntentPayloadBuilder = class IntentPayloadBuilder {
 		return this;
 	}
 	/**
+	* Set custom random bytes for nonce generation.
+	* The nonce will be automatically created at build time using these bytes,
+	* the deadline, and the contract salt.
+	*
+	* Use this when you need control over the random portion of the nonce
+	* (e.g., embedding a start timestamp via {@link VersionedNonceBuilder.createTimestampedNonceBytes}).
+	*
+	* For pre-built nonces, use {@link setNonce} instead.
+	*
+	* @param randomBytes - 15 bytes to use as the random portion of the nonce
+	* @returns The builder instance for chaining
+	*/
+	setNonceRandomBytes(randomBytes) {
+		this.customRandomBytes = randomBytes;
+		return this;
+	}
+	/**
 	* Clear all intents from the builder.
 	*
 	* @returns The builder instance for chaining
@@ -122,6 +143,7 @@ var IntentPayloadBuilder = class IntentPayloadBuilder {
 		this.deadline = void 0;
 		this.intents = [];
 		this.customNonce = void 0;
+		this.customRandomBytes = void 0;
 		this.verifyingContract = this.envConfig.contractID;
 		return this;
 	}
@@ -134,8 +156,7 @@ var IntentPayloadBuilder = class IntentPayloadBuilder {
 	*/
 	buildWithSalt(salt) {
 		const deadline = this.deadline ?? new Date(Date.now() + require_intent_payload_factory.DEFAULT_DEADLINE_MS);
-		const nonceDeadline = new Date(deadline.getTime() + require_intent_payload_factory.DEFAULT_NONCE_DEADLINE_OFFSET_MS);
-		const nonce = this.customNonce ?? require_expirable_nonce.VersionedNonceBuilder.encodeNonce(salt, nonceDeadline);
+		const nonce = this.customNonce ?? require_expirable_nonce.VersionedNonceBuilder.encodeNonce(salt, deadline, this.customRandomBytes);
 		return {
 			verifying_contract: this.verifyingContract,
 			signer_id: this.signerId,
@@ -184,6 +205,7 @@ var IntentPayloadBuilder = class IntentPayloadBuilder {
 		builder.deadline = this.deadline;
 		builder.intents = [...this.intents];
 		builder.customNonce = this.customNonce;
+		builder.customRandomBytes = this.customRandomBytes;
 		return builder;
 	}
 	/**

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

@@ -47,6 +47,7 @@ declare class IntentPayloadBuilder<HasSigner extends boolean = false> {
   private deadline?;
   private intents;
   private customNonce?;
+  private customRandomBytes?;
   constructor(config: IntentPayloadBuilderConfig);
   /**
    * Set the signer ID (address or account that will sign the intent).
@@ -89,13 +90,31 @@ declare class IntentPayloadBuilder<HasSigner extends boolean = false> {
    */
   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.
+   * Set a pre-built nonce directly.
+   * Use this when you have a complete nonce from an external source
+   * or need to reuse/invalidate a specific nonce.
+   *
+   * For most cases where you need custom random bytes, use {@link setNonceRandomBytes} instead,
+   * which handles salt fetching and nonce encoding automatically.
    *
    * @param nonce - Custom nonce string (base64 encoded)
    * @returns The builder instance for chaining
    */
   setNonce(nonce: string): this;
+  /**
+   * Set custom random bytes for nonce generation.
+   * The nonce will be automatically created at build time using these bytes,
+   * the deadline, and the contract salt.
+   *
+   * Use this when you need control over the random portion of the nonce
+   * (e.g., embedding a start timestamp via {@link VersionedNonceBuilder.createTimestampedNonceBytes}).
+   *
+   * For pre-built nonces, use {@link setNonce} instead.
+   *
+   * @param randomBytes - 15 bytes to use as the random portion of the nonce
+   * @returns The builder instance for chaining
+   */
+  setNonceRandomBytes(randomBytes: Uint8Array<ArrayBufferLike>): this;
   /**
    * Clear all intents from the builder.
    *

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

@@ -47,6 +47,7 @@ declare class IntentPayloadBuilder<HasSigner extends boolean = false> {
   private deadline?;
   private intents;
   private customNonce?;
+  private customRandomBytes?;
   constructor(config: IntentPayloadBuilderConfig);
   /**
    * Set the signer ID (address or account that will sign the intent).
@@ -89,13 +90,31 @@ declare class IntentPayloadBuilder<HasSigner extends boolean = false> {
    */
   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.
+   * Set a pre-built nonce directly.
+   * Use this when you have a complete nonce from an external source
+   * or need to reuse/invalidate a specific nonce.
+   *
+   * For most cases where you need custom random bytes, use {@link setNonceRandomBytes} instead,
+   * which handles salt fetching and nonce encoding automatically.
    *
    * @param nonce - Custom nonce string (base64 encoded)
    * @returns The builder instance for chaining
    */
   setNonce(nonce: string): this;
+  /**
+   * Set custom random bytes for nonce generation.
+   * The nonce will be automatically created at build time using these bytes,
+   * the deadline, and the contract salt.
+   *
+   * Use this when you need control over the random portion of the nonce
+   * (e.g., embedding a start timestamp via {@link VersionedNonceBuilder.createTimestampedNonceBytes}).
+   *
+   * For pre-built nonces, use {@link setNonce} instead.
+   *
+   * @param randomBytes - 15 bytes to use as the random portion of the nonce
+   * @returns The builder instance for chaining
+   */
+  setNonceRandomBytes(randomBytes: Uint8Array<ArrayBufferLike>): this;
   /**
    * Clear all intents from the builder.
    *

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

@@ -1,5 +1,5 @@
 import { VersionedNonceBuilder } from "./expirable-nonce.js";
-import { DEFAULT_DEADLINE_MS, DEFAULT_NONCE_DEADLINE_OFFSET_MS } from "./intent-payload-factory.js";
+import { DEFAULT_DEADLINE_MS } from "./intent-payload-factory.js";
 import { utils } from "@defuse-protocol/internal-utils";
 
 //#region src/intents/intent-payload-builder.ts
@@ -91,8 +91,12 @@ var IntentPayloadBuilder = class IntentPayloadBuilder {
 		return this;
 	}
 	/**
-	* Set a custom nonce. If not provided, a nonce will be automatically generated.
-	* The nonce must be a valid versioned nonce format.
+	* Set a pre-built nonce directly.
+	* Use this when you have a complete nonce from an external source
+	* or need to reuse/invalidate a specific nonce.
+	*
+	* For most cases where you need custom random bytes, use {@link setNonceRandomBytes} instead,
+	* which handles salt fetching and nonce encoding automatically.
 	*
 	* @param nonce - Custom nonce string (base64 encoded)
 	* @returns The builder instance for chaining
@@ -102,6 +106,23 @@ var IntentPayloadBuilder = class IntentPayloadBuilder {
 		return this;
 	}
 	/**
+	* Set custom random bytes for nonce generation.
+	* The nonce will be automatically created at build time using these bytes,
+	* the deadline, and the contract salt.
+	*
+	* Use this when you need control over the random portion of the nonce
+	* (e.g., embedding a start timestamp via {@link VersionedNonceBuilder.createTimestampedNonceBytes}).
+	*
+	* For pre-built nonces, use {@link setNonce} instead.
+	*
+	* @param randomBytes - 15 bytes to use as the random portion of the nonce
+	* @returns The builder instance for chaining
+	*/
+	setNonceRandomBytes(randomBytes) {
+		this.customRandomBytes = randomBytes;
+		return this;
+	}
+	/**
 	* Clear all intents from the builder.
 	*
 	* @returns The builder instance for chaining
@@ -121,6 +142,7 @@ var IntentPayloadBuilder = class IntentPayloadBuilder {
 		this.deadline = void 0;
 		this.intents = [];
 		this.customNonce = void 0;
+		this.customRandomBytes = void 0;
 		this.verifyingContract = this.envConfig.contractID;
 		return this;
 	}
@@ -133,8 +155,7 @@ var IntentPayloadBuilder = class IntentPayloadBuilder {
 	*/
 	buildWithSalt(salt) {
 		const deadline = this.deadline ?? new Date(Date.now() + DEFAULT_DEADLINE_MS);
-		const nonceDeadline = new Date(deadline.getTime() + DEFAULT_NONCE_DEADLINE_OFFSET_MS);
-		const nonce = this.customNonce ?? VersionedNonceBuilder.encodeNonce(salt, nonceDeadline);
+		const nonce = this.customNonce ?? VersionedNonceBuilder.encodeNonce(salt, deadline, this.customRandomBytes);
 		return {
 			verifying_contract: this.verifyingContract,
 			signer_id: this.signerId,
@@ -183,6 +204,7 @@ var IntentPayloadBuilder = class IntentPayloadBuilder {
 		builder.deadline = this.deadline;
 		builder.intents = [...this.intents];
 		builder.customNonce = this.customNonce;
+		builder.customRandomBytes = this.customRandomBytes;
 		return builder;
 	}
 	/**

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

@@ -19,5 +19,4 @@ function defaultIntentPayloadFactory(salt, { intents, verifying_contract, ...par
 
 //#endregion
 exports.DEFAULT_DEADLINE_MS = DEFAULT_DEADLINE_MS;
-exports.DEFAULT_NONCE_DEADLINE_OFFSET_MS = DEFAULT_NONCE_DEADLINE_OFFSET_MS;
 exports.defaultIntentPayloadFactory = defaultIntentPayloadFactory;

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

@@ -18,4 +18,4 @@ function defaultIntentPayloadFactory(salt, { intents, verifying_contract, ...par
 }
 
 //#endregion
-export { DEFAULT_DEADLINE_MS, DEFAULT_NONCE_DEADLINE_OFFSET_MS, defaultIntentPayloadFactory };
+export { DEFAULT_DEADLINE_MS, defaultIntentPayloadFactory };

package/dist/src/intents/salt-manager.cjs

@@ -6,6 +6,25 @@ valibot = require_rolldown_runtime.__toESM(valibot);
 
 //#region src/intents/salt-manager.ts
 const SALT_TTL_MS = 300 * 1e3;
+/**
+* Salt manager that returns a static, pre-configured salt.
+* Use when salt is known ahead of time (e.g., private blockchain with fixed salt).
+*/
+var StaticSaltManager = class {
+	/**
+	* @param saltHex Salt as hex string (e.g., "01020304")
+	*/
+	constructor(saltHex) {
+		this.salt = _scure_base.hex.decode(saltHex);
+		if (this.salt.length !== 4) throw new Error(`Invalid salt length: ${this.salt.length}, expected 4`);
+	}
+	async getCachedSalt() {
+		return this.salt;
+	}
+	async refresh() {
+		return this.salt;
+	}
+};
 var SaltManager = class {
 	constructor({ envConfig, nearProvider }) {
 		this.currentSalt = null;
@@ -71,4 +90,5 @@ async function fetchSalt(nearProvider, contractId) {
 }
 
 //#endregion
-exports.SaltManager = SaltManager;
+exports.SaltManager = SaltManager;
+exports.StaticSaltManager = StaticSaltManager;

package/dist/src/intents/salt-manager.js

@@ -4,6 +4,25 @@ import * as v from "valibot";
 
 //#region src/intents/salt-manager.ts
 const SALT_TTL_MS = 300 * 1e3;
+/**
+* Salt manager that returns a static, pre-configured salt.
+* Use when salt is known ahead of time (e.g., private blockchain with fixed salt).
+*/
+var StaticSaltManager = class {
+	/**
+	* @param saltHex Salt as hex string (e.g., "01020304")
+	*/
+	constructor(saltHex) {
+		this.salt = hex.decode(saltHex);
+		if (this.salt.length !== 4) throw new Error(`Invalid salt length: ${this.salt.length}, expected 4`);
+	}
+	async getCachedSalt() {
+		return this.salt;
+	}
+	async refresh() {
+		return this.salt;
+	}
+};
 var SaltManager = class {
 	constructor({ envConfig, nearProvider }) {
 		this.currentSalt = null;
@@ -69,4 +88,4 @@ async function fetchSalt(nearProvider, contractId) {
 }
 
 //#endregion
-export { SaltManager };
+export { SaltManager, StaticSaltManager };

package/dist/src/sdk.cjs

@@ -84,7 +84,7 @@ var IntentsSDK = class {
 			solverRelayApiKey: this.solverRelayApiKey
 		});
 		this.intentSigner = args.intentSigner;
-		this.saltManager = new require_salt_manager.SaltManager({
+		this.saltManager = this.envConfig.contractSalt != null ? new require_salt_manager.StaticSaltManager(this.envConfig.contractSalt) : new require_salt_manager.SaltManager({
 			envConfig: this.envConfig,
 			nearProvider
 		});

package/dist/src/sdk.js

@@ -17,7 +17,7 @@ import { noopIntentSigner } from "./intents/intent-signer-impl/intent-signer-noo
 import { zip } from "./lib/array.js";
 import { configureEvmRpcUrls, configureStellarRpcUrls } from "./lib/configure-rpc-config.js";
 import { createWithdrawalIdentifiers, watchWithdrawal } from "./core/withdrawal-watcher.js";
-import { SaltManager } from "./intents/salt-manager.js";
+import { SaltManager, StaticSaltManager } from "./intents/salt-manager.js";
 import { IntentPayloadBuilder } from "./intents/intent-payload-builder.js";
 import { PUBLIC_NEAR_RPC_URLS, RelayPublishError, assert, extractRpcUrls, nearFailoverRpcProvider, resolveEnvConfig, solverRelay } from "@defuse-protocol/internal-utils";
 import { HotBridge } from "@hot-labs/omni-sdk";
@@ -82,7 +82,7 @@ var IntentsSDK = class {
 			solverRelayApiKey: this.solverRelayApiKey
 		});
 		this.intentSigner = args.intentSigner;
-		this.saltManager = new SaltManager({
+		this.saltManager = this.envConfig.contractSalt != null ? new StaticSaltManager(this.envConfig.contractSalt) : new SaltManager({
 			envConfig: this.envConfig,
 			nearProvider
 		});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defuse-protocol/intents-sdk",
-  "version": "0.48.0",
+  "version": "0.49.0",
   "private": false,
   "type": "module",
   "repository": {
@@ -47,8 +47,8 @@
     "ripple-address-codec": "^5.0.0",
     "valibot": "^1.0.0",
     "viem": "^2.0.0",
-    "@defuse-protocol/contract-types": "0.5.0",
-    "@defuse-protocol/internal-utils": "0.25.0"
+    "@defuse-protocol/contract-types": "0.6.0",
+    "@defuse-protocol/internal-utils": "0.26.0"
   },
   "devDependencies": {
     "tsdown": "0.19.0"