@defuse-protocol/intents-sdk 0.33.0 → 0.33.1

package/README.md

@@ -422,6 +422,33 @@ const payload = await sdk.intentBuilder()
     .build();
 ```
 
+### Versioned Nonce Builder
+
+By default, the nonce is generated during the intent construction process, but it is possible to generate and pass the nonce within the builder independently. All of the nonces have specific [requirements](https://github.com/near/intents/tree/main/defuse#nonces) for the structure reflecting their validity.
+
+```typescript
+import {VersionedNonceBuilder} from '@defuse-protocol/intents-sdk';
+
+// Fetch current salt from the verifier contract
+const salt_hex = await nearRPC.viewFunction({
+  contractId: "intents.near",
+  methodName: "current_salt",
+});
+
+// Example: 5-minute deadline, but actual deadline should not be greater than intent's deadline
+const deadline = new Date(Date.now() + 5 * 60 * 1000)
+
+// Create ready to use versioned nonce from salt and deadline
+const versionedNonce = VersionedNonceBuilder.encodeNonce(
+  Uint8Array.from(Buffer.from(salt_hex, "hex")),
+  deadline
+);
+
+// Create intent builder with specified nonce
+const builder = await sdk.intentBuilder().setNonce(versionedNonce);
+```
+
+
 ### Intent Publishing Hooks
 
 Use the `onBeforePublishIntent` hook to intercept and process intent data before it's published to the relayer. This is

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

@@ -135,7 +135,8 @@ var IntentPayloadBuilder = class IntentPayloadBuilder {
 	*/
 	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);
+		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);
 		return {
 			verifying_contract: this.verifyingContract,
 			signer_id: this.signerId,

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

@@ -1,5 +1,5 @@
 import { VersionedNonceBuilder } from "./expirable-nonce.js";
-import { DEFAULT_DEADLINE_MS } from "./intent-payload-factory.js";
+import { DEFAULT_DEADLINE_MS, DEFAULT_NONCE_DEADLINE_OFFSET_MS } from "./intent-payload-factory.js";
 import { configsByEnvironment, utils } from "@defuse-protocol/internal-utils";
 
 //#region src/intents/intent-payload-builder.ts
@@ -133,7 +133,8 @@ var IntentPayloadBuilder = class IntentPayloadBuilder {
 	*/
 	buildWithSalt(salt) {
 		const deadline = this.deadline ?? new Date(Date.now() + DEFAULT_DEADLINE_MS);
-		const nonce = this.customNonce ?? VersionedNonceBuilder.encodeNonce(salt, deadline);
+		const nonceDeadline = new Date(deadline.getTime() + DEFAULT_NONCE_DEADLINE_OFFSET_MS);
+		const nonce = this.customNonce ?? VersionedNonceBuilder.encodeNonce(salt, nonceDeadline);
 		return {
 			verifying_contract: this.verifyingContract,
 			signer_id: this.signerId,

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

@@ -2,13 +2,15 @@ const require_expirable_nonce = require('./expirable-nonce.cjs');
 
 //#region src/intents/intent-payload-factory.ts
 const DEFAULT_DEADLINE_MS = 60 * 1e3;
+const DEFAULT_NONCE_DEADLINE_OFFSET_MS = 30 * 1e3;
 function defaultIntentPayloadFactory(salt, { intents, verifying_contract,...params }) {
 	params = Object.fromEntries(Object.entries(params).filter(([, value]) => value !== void 0));
 	const deadline = params.deadline != null ? new Date(params.deadline) : new Date(Date.now() + DEFAULT_DEADLINE_MS);
+	const nonceDeadline = new Date(deadline.getTime() + DEFAULT_NONCE_DEADLINE_OFFSET_MS);
 	return {
 		verifying_contract,
 		deadline: deadline.toISOString(),
-		nonce: require_expirable_nonce.VersionedNonceBuilder.encodeNonce(salt, deadline),
+		nonce: require_expirable_nonce.VersionedNonceBuilder.encodeNonce(salt, nonceDeadline),
 		intents: intents == null ? [] : intents,
 		signer_id: void 0,
 		...params
@@ -17,4 +19,5 @@ function defaultIntentPayloadFactory(salt, { intents, verifying_contract,...para
 
 //#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

@@ -2,13 +2,15 @@ import { VersionedNonceBuilder } from "./expirable-nonce.js";
 
 //#region src/intents/intent-payload-factory.ts
 const DEFAULT_DEADLINE_MS = 60 * 1e3;
+const DEFAULT_NONCE_DEADLINE_OFFSET_MS = 30 * 1e3;
 function defaultIntentPayloadFactory(salt, { intents, verifying_contract,...params }) {
 	params = Object.fromEntries(Object.entries(params).filter(([, value]) => value !== void 0));
 	const deadline = params.deadline != null ? new Date(params.deadline) : new Date(Date.now() + DEFAULT_DEADLINE_MS);
+	const nonceDeadline = new Date(deadline.getTime() + DEFAULT_NONCE_DEADLINE_OFFSET_MS);
 	return {
 		verifying_contract,
 		deadline: deadline.toISOString(),
-		nonce: VersionedNonceBuilder.encodeNonce(salt, deadline),
+		nonce: VersionedNonceBuilder.encodeNonce(salt, nonceDeadline),
 		intents: intents == null ? [] : intents,
 		signer_id: void 0,
 		...params
@@ -16,4 +18,4 @@ function defaultIntentPayloadFactory(salt, { intents, verifying_contract,...para
 }
 
 //#endregion
-export { DEFAULT_DEADLINE_MS, defaultIntentPayloadFactory };
+export { DEFAULT_DEADLINE_MS, DEFAULT_NONCE_DEADLINE_OFFSET_MS, defaultIntentPayloadFactory };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defuse-protocol/intents-sdk",
-  "version": "0.33.0",
+  "version": "0.33.1",
   "private": false,
   "type": "module",
   "sideEffects": false,