@kynesyslabs/demosdk 4.0.13 → 4.0.15

package/build/websdk/NonceManager.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Per-address nonce sequencer for a single Demos client.
+ *
+ * The node reports an address's nonce lagging inclusion: `getAddressNonce()`
+ * returns the last confirmed nonce, not counting transactions already
+ * broadcast but not yet included. So two sends fired back-to-back both read
+ * the same on-chain value, compute the same nonce, and collide — the node
+ * rejects the second one. That is the batch-failure mode apps hit when
+ * sending several transactions from the same address at once.
+ *
+ * NonceManager fixes this on the client: it keeps a local "next nonce" per
+ * address, seeded once from the node, then hands out strictly increasing
+ * nonces without re-reading the lagging chain value between sends.
+ * Reservations are serialized per address so concurrent callers never share
+ * a nonce.
+ *
+ * Boundary: this only sequences sends from THIS client. If the same key
+ * signs from another client/device concurrently, the local counter drifts
+ * from the chain — call {@link reset} to reseed from the node. Likewise, a
+ * reserved nonce is consumed at build time; if that transaction never lands
+ * the counter runs ahead of the chain, so callers should {@link reset} the
+ * address after a nonce-rejection so the next reservation reseeds.
+ */
+export declare class NonceManager {
+    /** Next nonce to hand out per address (absent = not yet seeded). */
+    private readonly next;
+    /** Per-address serialization tail so concurrent reservations don't race. */
+    private readonly tail;
+    /**
+     * Reserve the next nonce for `address`, serialized against other
+     * reservations for the same address. Seeds from `fetchNext` on first use
+     * (or after {@link reset}); `fetchNext` must resolve the first usable nonce
+     * for the address — the confirmed on-chain nonce plus one
+     * (`Demos.getAddressNonce(address) + 1`). Subsequent reservations increment
+     * locally, which is what keeps concurrent sends from colliding.
+     */
+    reserve(address: string, fetchNext: () => Promise<number>): Promise<number>;
+    /**
+     * Drop local state for `address` so the next {@link reserve} reseeds from
+     * the node. Call after a broadcast fails with a nonce error, or when
+     * another client may have sent from the same address.
+     */
+    reset(address: string): void;
+    /** Drop local state for every address. */
+    resetAll(): void;
+    /**
+     * Force the next nonce for `address` (advanced use / recovery). The next
+     * {@link reserve} returns exactly `nextNonce`.
+     */
+    seed(address: string, nextNonce: number): void;
+    /**
+     * The nonce the next {@link reserve} would hand out for `address`, or
+     * `undefined` if the address has not been seeded yet.
+     */
+    peek(address: string): number | undefined;
+}

package/build/websdk/NonceManager.js

@@ -0,0 +1,87 @@
+import { assertValidNonce } from "../utils/index.js";
+/**
+ * Per-address nonce sequencer for a single Demos client.
+ *
+ * The node reports an address's nonce lagging inclusion: `getAddressNonce()`
+ * returns the last confirmed nonce, not counting transactions already
+ * broadcast but not yet included. So two sends fired back-to-back both read
+ * the same on-chain value, compute the same nonce, and collide — the node
+ * rejects the second one. That is the batch-failure mode apps hit when
+ * sending several transactions from the same address at once.
+ *
+ * NonceManager fixes this on the client: it keeps a local "next nonce" per
+ * address, seeded once from the node, then hands out strictly increasing
+ * nonces without re-reading the lagging chain value between sends.
+ * Reservations are serialized per address so concurrent callers never share
+ * a nonce.
+ *
+ * Boundary: this only sequences sends from THIS client. If the same key
+ * signs from another client/device concurrently, the local counter drifts
+ * from the chain — call {@link reset} to reseed from the node. Likewise, a
+ * reserved nonce is consumed at build time; if that transaction never lands
+ * the counter runs ahead of the chain, so callers should {@link reset} the
+ * address after a nonce-rejection so the next reservation reseeds.
+ */
+export class NonceManager {
+    constructor() {
+        /** Next nonce to hand out per address (absent = not yet seeded). */
+        this.next = new Map();
+        /** Per-address serialization tail so concurrent reservations don't race. */
+        this.tail = new Map();
+    }
+    /**
+     * Reserve the next nonce for `address`, serialized against other
+     * reservations for the same address. Seeds from `fetchNext` on first use
+     * (or after {@link reset}); `fetchNext` must resolve the first usable nonce
+     * for the address — the confirmed on-chain nonce plus one
+     * (`Demos.getAddressNonce(address) + 1`). Subsequent reservations increment
+     * locally, which is what keeps concurrent sends from colliding.
+     */
+    async reserve(address, fetchNext) {
+        const prior = this.tail.get(address) ?? Promise.resolve();
+        const run = prior.then(async () => {
+            let n = this.next.get(address);
+            if (n === undefined) {
+                // Seed once. `fetchNext` already returns the next nonce to
+                // use; subsequent reservations increment locally so rapid
+                // sends don't re-read the lagging confirmed nonce.
+                n = await fetchNext();
+            }
+            this.next.set(address, n + 1);
+            return n;
+        });
+        // Swallow the tail's outcome so one rejected reservation (e.g. a
+        // transient getAddressNonce failure during seeding) does not poison
+        // every later reservation for this address. The real error still
+        // surfaces to this caller via `run`.
+        this.tail.set(address, run.then(() => undefined, () => undefined));
+        return run;
+    }
+    /**
+     * Drop local state for `address` so the next {@link reserve} reseeds from
+     * the node. Call after a broadcast fails with a nonce error, or when
+     * another client may have sent from the same address.
+     */
+    reset(address) {
+        this.next.delete(address);
+    }
+    /** Drop local state for every address. */
+    resetAll() {
+        this.next.clear();
+    }
+    /**
+     * Force the next nonce for `address` (advanced use / recovery). The next
+     * {@link reserve} returns exactly `nextNonce`.
+     */
+    seed(address, nextNonce) {
+        this.next.set(address, assertValidNonce(nextNonce));
+    }
+    /**
+     * The nonce the next {@link reserve} would hand out for `address`, or
+     * `undefined` if the address has not been seeded yet.
+     */
+    peek(address) {
+        return this.next.get(address);
+    }
+}
+//# sourceMappingURL=NonceManager.js.map

package/build/websdk/NonceManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NonceManager.js","sourceRoot":"","sources":["../../../src/websdk/NonceManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE1C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,YAAY;IAAzB;QACI,oEAAoE;QACnD,SAAI,GAAG,IAAI,GAAG,EAAkB,CAAA;QACjD,4EAA4E;QAC3D,SAAI,GAAG,IAAI,GAAG,EAA4B,CAAA;IAqE/D,CAAC;IAnEG;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CACT,OAAe,EACf,SAAgC;QAEhC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAA;QACzD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAC9B,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YAC9B,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;gBAClB,2DAA2D;gBAC3D,0DAA0D;gBAC1D,mDAAmD;gBACnD,CAAC,GAAG,MAAM,SAAS,EAAE,CAAA;YACzB,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;YAC7B,OAAO,CAAC,CAAA;QACZ,CAAC,CAAC,CAAA;QACF,iEAAiE;QACjE,oEAAoE;QACpE,iEAAiE;QACjE,qCAAqC;QACrC,IAAI,CAAC,IAAI,CAAC,GAAG,CACT,OAAO,EACP,GAAG,CAAC,IAAI,CACJ,GAAG,EAAE,CAAC,SAAS,EACf,GAAG,EAAE,CAAC,SAAS,CAClB,CACJ,CAAA;QACD,OAAO,GAAG,CAAA;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAe;QACjB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC7B,CAAC;IAED,0CAA0C;IAC1C,QAAQ;QACJ,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAA;IACrB,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,OAAe,EAAE,SAAiB;QACnC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAA;IACvD,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,OAAe;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IACjC,CAAC;CACJ"}

package/build/websdk/Web2Calls.js

@@ -2,6 +2,7 @@ import { EnumWeb2Actions } from "../types/index.js";
 import { web2_request } from "./utils/skeletons.js";
 import { DemosTransactions } from "./DemosTransactions.js";
 import { canonicalJSONStringify, validatePureJson, looksLikeJsonString, } from "./utils/canonicalJson.js";
+import { resolveNonce } from "../utils/index.js";
 class Web2InvalidUrlError extends Error {
     constructor(message, code) {
         super(message);
@@ -134,8 +135,9 @@ export class Web2Proxy {
         web2Tx.content.type = "web2Request";
         web2Tx.content.data = ["web2Request", web2Payload];
         web2Tx.content.timestamp = Date.now();
-        const nonce = await this._demos.getAddressNonce(await this._demos.getEd25519Address());
-        web2Tx.content.nonce = nonce + 1;
+        const fromAddress = await this._demos.getEd25519Address();
+        const nonce = await resolveNonce(options?.nonce, () => this._demos.getAddressNonce(fromAddress), this._demos._nonceReserver(fromAddress));
+        web2Tx.content.nonce = nonce;
         const signedWeb2Tx = await this._demos.sign(web2Tx);
         const validityData = await this._demos.confirm(signedWeb2Tx);
         const txHash = validityData.response.data.transaction.hash;

package/build/websdk/Web2Calls.js.map

@@ -1 +1 @@
-{"version":3,"file":"Web2Calls.js","sourceRoot":"","sources":["../../../src/websdk/Web2Calls.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Web2Calls.js","sourceRoot":"","sources":["../../../src/websdk/Web2Calls.ts"],"names":[],"mappings":"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"}

package/build/websdk/demosclass.d.ts

@@ -42,6 +42,14 @@ export declare class Demos {
      * still see the warning exactly once per instance lifetime.
      */
     private static readonly _NETWORK_INFO_FAILURE_TTL_MS;
+    /**
+     * Client-side nonce sequencer. Opt-in via {@link enableAutoNonce}. When
+     * enabled, transaction builders reserve nonces from this manager instead
+     * of re-reading the lagging chain nonce, so batched sends from the same
+     * address don't collide. See {@link NonceManager}.
+     */
+    private readonly _nonceManager;
+    private _autoNonce;
     /** Connection status of the RPC URL */
     connected: boolean;
     dual_sign: boolean;
@@ -178,7 +186,9 @@ export declare class Demos {
      * @param amount - DEM `number` (legacy) or OS `bigint` (preferred).
      * @returns The signed transaction.
      */
-    pay(to: string, amount: number | bigint): Promise<Transaction>;
+    pay(to: string, amount: number | bigint, options?: {
+        nonce?: number;
+    }): Promise<Transaction>;
     /**
      * Create a signed DEMOS transaction to send native tokens to a given address.
      *
@@ -196,7 +206,9 @@ export declare class Demos {
      * @param amount - DEM `number` (legacy) or OS `bigint` (preferred).
      * @returns The signed transaction.
      */
-    transfer(to: string, amount: number | bigint): Promise<Transaction>;
+    transfer(to: string, amount: number | bigint, options?: {
+        nonce?: number;
+    }): Promise<Transaction>;
     /**
      * Create a signed DEMOS transaction to store binary data on the blockchain.
      * Data is stored in the sender's account.
@@ -205,7 +217,9 @@ export declare class Demos {
      *
      * @returns The signed storage transaction.
      */
-    store(bytes: Uint8Array): Promise<Transaction>;
+    store(bytes: Uint8Array, options?: {
+        nonce?: number;
+    }): Promise<Transaction>;
     storagePrograms: {
         /**
          * Creates and signs a storage program transaction given a payload.
@@ -214,7 +228,9 @@ export declare class Demos {
          * @returns The signed transaction
          *
          */
-        sign: (payload: StorageProgramPayload) => Promise<Transaction>;
+        sign: (payload: StorageProgramPayload, options?: {
+            nonce?: number;
+        }) => Promise<Transaction>;
         /**
          * Reads a storage program by address.
          *
@@ -267,7 +283,9 @@ export declare class Demos {
      * @param options - The dual-signing options
      * @returns The signed transaction
      */
-    sign(raw_tx: Transaction): Promise<Transaction>;
+    sign(raw_tx: Transaction, options?: {
+        nonce?: number;
+    }): Promise<Transaction>;
     /**
      * Signs a message.
      *
@@ -455,6 +473,47 @@ export declare class Demos {
      * @param address - The address
      */
     getAddressNonce(address: string): Promise<number>;
+    /**
+     * Enable client-side nonce sequencing for this instance.
+     *
+     * Once enabled, every transaction builder reserves its nonce from a local
+     * per-address counter (seeded once from the node) instead of re-reading
+     * `getAddressNonce` for each send. This prevents the collisions that make
+     * batched sends from the same address fail — the node rejects two txs
+     * that reuse a nonce because `getAddressNonce` lags inclusion.
+     *
+     * Opt-in for now. Passing an explicit `options.nonce` still overrides the
+     * manager. If a send is rejected for a nonce error, call
+     * {@link resetNonce} so the next send reseeds from the chain.
+     */
+    enableAutoNonce(): void;
+    /** Disable client-side nonce sequencing and clear its local state. */
+    disableAutoNonce(): void;
+    /** Whether client-side nonce sequencing is enabled for this instance. */
+    get autoNonceEnabled(): boolean;
+    /**
+     * Reseed the local nonce counter for `address` (or every address) from the
+     * node on the next send. Call after a nonce-rejection, or when the same
+     * key may have sent from another client.
+     */
+    resetNonce(address?: string): void;
+    /**
+     * Reserver passed to `resolveNonce` by the transaction builders. Returns a
+     * function that sequences the nonce for `address` when auto-nonce is on,
+     * or `undefined` so `resolveNonce` keeps its historical per-send read.
+     *
+     * Seeds once from the confirmed on-chain nonce (`getAddressNonce() + 1`),
+     * then increments locally per send. Seeding from the confirmed nonce (not a
+     * mempool-aware value) is deliberate: the node accepts any nonce greater
+     * than the confirmed one, and the confirmed nonce is consistent across
+     * every RPC — whereas a per-RPC mempool count is not. The local counter is
+     * what keeps a batch's nonces distinct (`N+1, N+2, …`) so they don't
+     * collide; re-reading `getAddressNonce` for each send would not, because it
+     * lags inclusion.
+     *
+     * @internal
+     */
+    _nonceReserver(address: string): (() => Promise<number>) | undefined;
     /**
      * Get a validator's current record (stake, status, unstake timestamps).
      * Returns null if the address is not (and never was) a validator.
@@ -664,9 +723,13 @@ export declare class Demos {
         sign: (raw_tx: Transaction) => Promise<Transaction>;
         empty: () => Transaction;
         prepare: (data?: any) => Promise<Transaction>;
-        pay(to: string, amount: number | bigint, demos: Demos): Promise<Transaction>;
+        pay(to: string, amount: number | bigint, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
         _demNumberToOsBigint(amountDem: number): bigint;
-        transfer(to: string, amount: number | bigint, demos: Demos): Promise<Transaction>;
+        transfer(to: string, amount: number | bigint, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
         signWithAlgorithm: (data: string, keypair: IKeyPair, options: {
             algorithm: SigningAlgorithm;
         }) => Promise<{
@@ -686,18 +749,32 @@ export declare class Demos {
                 blockNumber?: number;
             };
         }>;
-        store(bytes: Uint8Array, demos: Demos): Promise<Transaction>;
-        createL2PSHashUpdate(l2psUid: string, consolidatedHash: string, transactionCount: number, demos: Demos): Promise<Transaction>;
-        stake(amount: string, connectionUrl: string, demos: Demos): Promise<Transaction>;
-        unstake(demos: Demos): Promise<Transaction>;
-        validatorExit(demos: Demos): Promise<Transaction>;
+        store(bytes: Uint8Array, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        createL2PSHashUpdate(l2psUid: string, consolidatedHash: string, transactionCount: number, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        stake(amount: string, connectionUrl: string, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        unstake(demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        validatorExit(demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
         proposeNetworkUpgrade(params: {
             proposalId: string;
             proposedParameters: Partial<NetworkParameters>;
             rationale: string;
             effectiveAtBlock: number;
-        }, demos: Demos): Promise<Transaction>;
-        voteOnUpgrade(proposalId: string, approve: boolean, demos: Demos): Promise<Transaction>;
+        }, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        voteOnUpgrade(proposalId: string, approve: boolean, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
     };
     private _run?;
     /**
@@ -737,9 +814,13 @@ export declare class Demos {
     DemosTransactions: {
         empty: () => Transaction;
         prepare: (data?: any) => Promise<Transaction>;
-        pay(to: string, amount: number | bigint, demos: Demos): Promise<Transaction>;
+        pay(to: string, amount: number | bigint, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
         _demNumberToOsBigint(amountDem: number): bigint;
-        transfer(to: string, amount: number | bigint, demos: Demos): Promise<Transaction>;
+        transfer(to: string, amount: number | bigint, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
         sign: (raw_tx: Transaction, keypair: IKeyPair, options: {
             algorithm: SigningAlgorithm;
         }) => Promise<Transaction>;
@@ -762,25 +843,43 @@ export declare class Demos {
                 blockNumber?: number;
             };
         }>;
-        store(bytes: Uint8Array, demos: Demos): Promise<Transaction>;
-        createL2PSHashUpdate(l2psUid: string, consolidatedHash: string, transactionCount: number, demos: Demos): Promise<Transaction>;
-        stake(amount: string, connectionUrl: string, demos: Demos): Promise<Transaction>;
-        unstake(demos: Demos): Promise<Transaction>;
-        validatorExit(demos: Demos): Promise<Transaction>;
+        store(bytes: Uint8Array, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        createL2PSHashUpdate(l2psUid: string, consolidatedHash: string, transactionCount: number, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        stake(amount: string, connectionUrl: string, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        unstake(demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        validatorExit(demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
         proposeNetworkUpgrade(params: {
             proposalId: string;
             proposedParameters: Partial<NetworkParameters>;
             rationale: string;
             effectiveAtBlock: number;
-        }, demos: Demos): Promise<Transaction>;
-        voteOnUpgrade(proposalId: string, approve: boolean, demos: Demos): Promise<Transaction>;
+        }, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        voteOnUpgrade(proposalId: string, approve: boolean, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
     };
     transactions: {
         empty: () => Transaction;
         prepare: (data?: any) => Promise<Transaction>;
-        pay(to: string, amount: number | bigint, demos: Demos): Promise<Transaction>;
+        pay(to: string, amount: number | bigint, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
         _demNumberToOsBigint(amountDem: number): bigint;
-        transfer(to: string, amount: number | bigint, demos: Demos): Promise<Transaction>;
+        transfer(to: string, amount: number | bigint, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
         sign: (raw_tx: Transaction, keypair: IKeyPair, options: {
             algorithm: SigningAlgorithm;
         }) => Promise<Transaction>;
@@ -803,18 +902,32 @@ export declare class Demos {
                 blockNumber?: number;
             };
         }>;
-        store(bytes: Uint8Array, demos: Demos): Promise<Transaction>;
-        createL2PSHashUpdate(l2psUid: string, consolidatedHash: string, transactionCount: number, demos: Demos): Promise<Transaction>;
-        stake(amount: string, connectionUrl: string, demos: Demos): Promise<Transaction>;
-        unstake(demos: Demos): Promise<Transaction>;
-        validatorExit(demos: Demos): Promise<Transaction>;
+        store(bytes: Uint8Array, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        createL2PSHashUpdate(l2psUid: string, consolidatedHash: string, transactionCount: number, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        stake(amount: string, connectionUrl: string, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        unstake(demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        validatorExit(demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
         proposeNetworkUpgrade(params: {
             proposalId: string;
             proposedParameters: Partial<NetworkParameters>;
             rationale: string;
             effectiveAtBlock: number;
-        }, demos: Demos): Promise<Transaction>;
-        voteOnUpgrade(proposalId: string, approve: boolean, demos: Demos): Promise<Transaction>;
+        }, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
+        voteOnUpgrade(proposalId: string, approve: boolean, demos: Demos, options?: {
+            nonce?: number;
+        }): Promise<Transaction>;
     };
     DemosWebAuth: typeof DemosWebAuth;
     skeletons: typeof skeletons;

package/build/websdk/demosclass.js

@@ -8,6 +8,7 @@ import * as skeletons from "./utils/skeletons.js";
 import { TransportError } from "./TransportError.js";
 // NOTE Including custom libraries from Demos
 import { DemosTransactions } from "./DemosTransactions.js";
+import { NonceManager } from "./NonceManager.js";
 import { DemosWebAuth } from "./DemosWebAuth.js";
 import { prepareXMPayload } from "./XMTransactions.js";
 import { _required as required } from "./utils/required.js";
@@ -17,6 +18,7 @@ import { hexToUint8Array, uint8ArrayToHex, UnifiedCrypto, } from "../encryption/
 import { GCRGeneration } from "./GCRGeneration.js";
 import { Hashing } from "../encryption/Hashing.js";
 import { OS_PER_DEM, demToOs, parseOsString } from "../denomination/index.js";
+import { assertValidNonce, resolveNonce } from "../utils/index.js";
 import { serializeTransactionContent } from "../denomination/serializerGate.js";
 import { SubDemPrecisionError, } from "../denomination/networkInfo.js";
 import * as bip39 from "@scure/bip39";
@@ -77,6 +79,14 @@ export class Demos {
         this._cachedNetworkInfoFailed = false;
         this._cachedNetworkInfoFailedAt = 0;
         this._cachedNetworkInfoWarned = false;
+        /**
+         * Client-side nonce sequencer. Opt-in via {@link enableAutoNonce}. When
+         * enabled, transaction builders reserve nonces from this manager instead
+         * of re-reading the lagging chain nonce, so batched sends from the same
+         * address don't collide. See {@link NonceManager}.
+         */
+        this._nonceManager = new NonceManager();
+        this._autoNonce = false;
         /** Connection status of the RPC URL */
         this.connected = false;
         this.dual_sign = false;
@@ -88,7 +98,7 @@ export class Demos {
              * @returns The signed transaction
              *
              */
-            sign: async (payload) => {
+            sign: async (payload, options) => {
                 required(this.keypair, "Wallet not connected");
                 required(payload.storageAddress, "Storage address Not found in payload");
                 // Sender's nonce must be set on the tx like every other
@@ -100,11 +110,11 @@ export class Demos {
                 // after the first one.
                 const { publicKey } = await this.crypto.getIdentity("ed25519");
                 const publicKeyHex = uint8ArrayToHex(publicKey);
-                const nonce = await this.getAddressNonce(publicKeyHex);
+                const nonce = await resolveNonce(options?.nonce, () => this.getAddressNonce(publicKeyHex), this._nonceReserver(publicKeyHex));
                 const tx = DemosTransactions.empty();
                 tx.content.to = payload.storageAddress;
                 tx.content.type = "storageProgram";
-                tx.content.nonce = nonce + 1;
+                tx.content.nonce = nonce;
                 tx.content.data = ["storageProgram", payload];
                 return await this.sign(tx);
             },
@@ -436,11 +446,11 @@ export class Demos {
      * @param amount - DEM `number` (legacy) or OS `bigint` (preferred).
      * @returns The signed transaction.
      */
-    async pay(to, amount) {
+    async pay(to, amount, options) {
         required(this.keypair, "Wallet not connected");
         const amountOs = typeof amount === "bigint" ? amount : demToOs(amount);
         await this._assertAmountAcceptableOnTargetNode(amountOs);
-        return DemosTransactions.pay(to, amountOs, this);
+        return DemosTransactions.pay(to, amountOs, this, options);
     }
     /**
      * Create a signed DEMOS transaction to send native tokens to a given address.
@@ -459,8 +469,8 @@ export class Demos {
      * @param amount - DEM `number` (legacy) or OS `bigint` (preferred).
      * @returns The signed transaction.
      */
-    async transfer(to, amount) {
-        return this.pay(to, amount);
+    async transfer(to, amount, options) {
+        return this.pay(to, amount, options);
     }
     /**
      * Create a signed DEMOS transaction to store binary data on the blockchain.
@@ -470,9 +480,9 @@ export class Demos {
      *
      * @returns The signed storage transaction.
      */
-    store(bytes) {
+    store(bytes, options) {
         required(this.keypair, "Wallet not connected");
-        return DemosTransactions.store(bytes, this);
+        return DemosTransactions.store(bytes, this, options);
     }
     /**
      * Confirms a transaction.
@@ -514,8 +524,11 @@ export class Demos {
      * @param options - The dual-signing options
      * @returns The signed transaction
      */
-    async sign(raw_tx) {
+    async sign(raw_tx, options) {
         required(this.keypair, "Wallet not connected");
+        if (options?.nonce !== undefined) {
+            raw_tx.content.nonce = assertValidNonce(options.nonce);
+        }
         if (!raw_tx.content.timestamp || raw_tx.content.timestamp === 0) {
             raw_tx.content.timestamp = Date.now();
         }
@@ -1161,6 +1174,66 @@ export class Demos {
         }
         return 0;
     }
+    /**
+     * Enable client-side nonce sequencing for this instance.
+     *
+     * Once enabled, every transaction builder reserves its nonce from a local
+     * per-address counter (seeded once from the node) instead of re-reading
+     * `getAddressNonce` for each send. This prevents the collisions that make
+     * batched sends from the same address fail — the node rejects two txs
+     * that reuse a nonce because `getAddressNonce` lags inclusion.
+     *
+     * Opt-in for now. Passing an explicit `options.nonce` still overrides the
+     * manager. If a send is rejected for a nonce error, call
+     * {@link resetNonce} so the next send reseeds from the chain.
+     */
+    enableAutoNonce() {
+        this._autoNonce = true;
+    }
+    /** Disable client-side nonce sequencing and clear its local state. */
+    disableAutoNonce() {
+        this._autoNonce = false;
+        this._nonceManager.resetAll();
+    }
+    /** Whether client-side nonce sequencing is enabled for this instance. */
+    get autoNonceEnabled() {
+        return this._autoNonce;
+    }
+    /**
+     * Reseed the local nonce counter for `address` (or every address) from the
+     * node on the next send. Call after a nonce-rejection, or when the same
+     * key may have sent from another client.
+     */
+    resetNonce(address) {
+        if (address === undefined) {
+            this._nonceManager.resetAll();
+        }
+        else {
+            this._nonceManager.reset(address);
+        }
+    }
+    /**
+     * Reserver passed to `resolveNonce` by the transaction builders. Returns a
+     * function that sequences the nonce for `address` when auto-nonce is on,
+     * or `undefined` so `resolveNonce` keeps its historical per-send read.
+     *
+     * Seeds once from the confirmed on-chain nonce (`getAddressNonce() + 1`),
+     * then increments locally per send. Seeding from the confirmed nonce (not a
+     * mempool-aware value) is deliberate: the node accepts any nonce greater
+     * than the confirmed one, and the confirmed nonce is consistent across
+     * every RPC — whereas a per-RPC mempool count is not. The local counter is
+     * what keeps a batch's nonces distinct (`N+1, N+2, …`) so they don't
+     * collide; re-reading `getAddressNonce` for each send would not, because it
+     * lags inclusion.
+     *
+     * @internal
+     */
+    _nonceReserver(address) {
+        if (!this._autoNonce) {
+            return undefined;
+        }
+        return () => this._nonceManager.reserve(address, async () => (await this.getAddressNonce(address)) + 1);
+    }
     /**
      * Get a validator's current record (stake, status, unstake timestamps).
      * Returns null if the address is not (and never was) a validator.