@kynesyslabs/demosdk 4.0.14 → 4.0.16

package/build/websdk/NonceManager.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 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;
+    /**
+     * Per-address reset generation. Bumped by {@link reset}/{@link resetAll}
+     * so a reservation whose seed fetch straddled a reset does not write its
+     * now-stale seed back into `next`.
+     */
+    private readonly epoch;
+    /**
+     * 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,108 @@
+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();
+        /**
+         * Per-address reset generation. Bumped by {@link reset}/{@link resetAll}
+         * so a reservation whose seed fetch straddled a reset does not write its
+         * now-stale seed back into `next`.
+         */
+        this.epoch = 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` returns the first usable nonce;
+                // validate it so a bad node reply (NaN/negative/fractional)
+                // can't poison every later reservation. Subsequent
+                // reservations increment locally so rapid sends don't re-read
+                // the lagging confirmed nonce.
+                const startEpoch = this.epoch.get(address) ?? 0;
+                n = assertValidNonce(await fetchNext());
+                if ((this.epoch.get(address) ?? 0) !== startEpoch) {
+                    // A reset() landed while we were fetching the seed. Honour
+                    // it: hand this value to the caller but don't cache it, so
+                    // the next reservation reseeds from the node afresh.
+                    return n;
+                }
+            }
+            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);
+        this.epoch.set(address, (this.epoch.get(address) ?? 0) + 1);
+    }
+    /** Drop local state for every address. */
+    resetAll() {
+        this.next.clear();
+        // Bump the epoch of every address seen so far (the tail retains them)
+        // so any in-flight reservation reseeds instead of writing stale state.
+        for (const address of this.tail.keys()) {
+            this.epoch.set(address, (this.epoch.get(address) ?? 0) + 1);
+        }
+    }
+    /**
+     * 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":"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"}

package/build/websdk/Web2Calls.js

@@ -135,7 +135,8 @@ export class Web2Proxy {
         web2Tx.content.type = "web2Request";
         web2Tx.content.data = ["web2Request", web2Payload];
         web2Tx.content.timestamp = Date.now();
-        const nonce = await resolveNonce(options?.nonce, async () => this._demos.getAddressNonce(await this._demos.getEd25519Address()));
+        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);

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/bridge.d.ts

@@ -1,7 +1,7 @@
 import { RPCResponse } from "../types";
 import { BridgeTradePayload } from "../types/bridge/bridgeTradePayload";
 import { Demos } from "./demosclass";
-import { WrappedCrossChainTrade } from "rubic-sdk";
+import type { WrappedCrossChainTrade } from "rubic-sdk";
 export declare class RubicBridge {
     getTrade(demos: Demos, chain: string, payload: BridgeTradePayload): Promise<RPCResponse>;
     executeTrade(demos: Demos, chain: string, payload: BridgeTradePayload): Promise<RPCResponse>;

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;
@@ -132,6 +140,29 @@ export declare class Demos {
          */
         dual_sign?: boolean;
     }): Promise<string>;
+    /**
+     * Connect a wallet from a hex-encoded key instead of a mnemonic.
+     *
+     * `connectWallet(<string>)` treats a non-mnemonic string as a BIP-39
+     * *passphrase* (PBKDF2), so passing a raw hex key there silently derives an
+     * unexpected identity. This method decodes the hex to bytes and feeds them to
+     * `connectWallet` as the master seed — a deterministic identity from the key,
+     * on the exact same derivation path as `connectWallet(<bytes>)`. Existing
+     * derivation is unchanged.
+     *
+     * Note: the hex is used as the SDK **master seed**, not as a literal ed25519
+     * seed — the keypair is still derived (sha3_512 → HKDF → forge). Use this for
+     * service accounts that want a stable identity from a fixed secret; it does not
+     * import a keypair produced by an external ed25519 tool.
+     *
+     * @param privateKeyHex - A 32-byte key as 64 hex chars, optionally `0x`-prefixed.
+     * @param options - Same options as {@link connectWallet}.
+     * @returns The public key of the connected wallet (hex).
+     */
+    connectWalletFromPrivateKey(privateKeyHex: string, options?: {
+        algorithm?: SigningAlgorithm;
+        dual_sign?: boolean;
+    }): Promise<string>;
     /**
      * Returns the public key of the connected wallet.
      *
@@ -174,9 +205,13 @@ export declare class Demos {
      * await demos.pay("0x...", 100)                          // legacy DEM number (deprecated)
      * ```
      *
+     * ⚠️ This only **signs** the transaction — it does NOT broadcast it, so
+     * on its own it moves no funds. Use {@link payAndWait} (or
+     * {@link transferAndWait}) to sign, broadcast, and wait for inclusion.
+     *
      * @param to - The receiver address (0x-prefixed hex).
      * @param amount - DEM `number` (legacy) or OS `bigint` (preferred).
-     * @returns The signed transaction.
+     * @returns The signed transaction (NOT broadcast).
      */
     pay(to: string, amount: number | bigint, options?: {
         nonce?: number;
@@ -194,13 +229,90 @@ export declare class Demos {
      * await demos.transfer("0x...", 1_500_000_000n)                // raw OS
      * ```
      *
+     * ⚠️ Like {@link pay}, this only **signs** — it does NOT broadcast. Use
+     * {@link transferAndWait} to sign, broadcast, and wait for inclusion.
+     *
      * @param to - The receiver address (0x-prefixed hex).
      * @param amount - DEM `number` (legacy) or OS `bigint` (preferred).
-     * @returns The signed transaction.
+     * @returns The signed transaction (NOT broadcast).
      */
     transfer(to: string, amount: number | bigint, options?: {
         nonce?: number;
     }): Promise<Transaction>;
+    /**
+     * Sign, broadcast, and wait for a native transfer to land on chain.
+     *
+     * The broadcasting counterpart to {@link pay}: it runs the full path
+     * (sign → confirm → broadcastAndWait), so the funds actually move. Prefer
+     * this over `pay`/`transfer` unless you deliberately want to handle
+     * broadcasting yourself. Throws `BroadcastTimeoutError` if the transaction
+     * doesn't reach a terminal state before the timeout.
+     *
+     * @example
+     * ```ts
+     * import { denomination } from "@kynesyslabs/demosdk"
+     * await demos.payAndWait("0x...", denomination.demToOs(100))  // sent & confirmed
+     * ```
+     *
+     * @param to - The receiver address (0x-prefixed hex).
+     * @param amount - DEM `number` (legacy) or OS `bigint` (preferred).
+     * @param options.nonce - Optional explicit nonce.
+     * @param options.timeoutMs - Max time to wait for on-chain inclusion (the
+     *   broadcast-and-poll phase). Defaults to 60_000. The preceding confirm
+     *   RPC is a single call and is not bounded by this.
+     * @param options.pollIntervalMs - Delay between inclusion polls. Defaults to 500.
+     * @param options.failFastOnBroadcastError - Reject immediately if the broadcast
+     *   RPC errors, instead of polling for a terminal status.
+     * @returns `{ broadcast, status }` — the broadcast RPC response and the
+     *   terminal on-chain status (`included` | `failed`, with optional `blockNumber`).
+     */
+    payAndWait(to: string, amount: number | bigint, options?: {
+        nonce?: number;
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+        failFastOnBroadcastError?: boolean;
+    }): Promise<{
+        broadcast: RPCResponse;
+        status: {
+            state: "included" | "failed";
+            blockNumber?: number;
+        };
+    }>;
+    /**
+     * Alias of {@link payAndWait}: sign, broadcast, and wait for a native
+     * transfer. The broadcasting counterpart to {@link transfer} (which only
+     * signs).
+     *
+     * @example
+     * ```ts
+     * import { denomination } from "@kynesyslabs/demosdk"
+     * await demos.transferAndWait("0x...", denomination.demToOs(100))  // sent & confirmed
+     * ```
+     *
+     * @param to - The receiver address (0x-prefixed hex).
+     * @param amount - DEM `number` (legacy) or OS `bigint` (preferred).
+     * @param options.nonce - Optional explicit nonce.
+     * @param options.timeoutMs - Max time to wait for on-chain inclusion (the
+     *   broadcast-and-poll phase). Defaults to 60_000. The preceding confirm
+     *   RPC is a single call and is not bounded by this.
+     * @param options.pollIntervalMs - Delay between inclusion polls. Defaults to 500.
+     * @param options.failFastOnBroadcastError - Reject immediately if the broadcast
+     *   RPC errors, instead of polling for a terminal status.
+     * @returns `{ broadcast, status }` — the broadcast RPC response and the
+     *   terminal on-chain status (`included` | `failed`, with optional `blockNumber`).
+     */
+    transferAndWait(to: string, amount: number | bigint, options?: {
+        nonce?: number;
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+        failFastOnBroadcastError?: boolean;
+    }): Promise<{
+        broadcast: RPCResponse;
+        status: {
+            state: "included" | "failed";
+            blockNumber?: number;
+        };
+    }>;
     /**
      * Create a signed DEMOS transaction to store binary data on the blockchain.
      * Data is stored in the sender's account.
@@ -257,10 +369,13 @@ export declare class Demos {
      * @param validationData - The validity data of the transaction
      * @param opts.timeoutMs - Total time to wait. Defaults to 60_000.
      * @param opts.pollIntervalMs - Delay between polls. Defaults to 500.
+     * @param opts.failFastOnBroadcastError - Reject immediately if the broadcast
+     *   RPC errors, instead of polling for a terminal status.
      */
     broadcastAndWait(validationData: RPCResponseWithValidityData, opts?: {
         timeoutMs?: number;
         pollIntervalMs?: number;
+        failFastOnBroadcastError?: boolean;
     }): Promise<{
         broadcast: RPCResponse;
         status: {
@@ -465,6 +580,69 @@ export declare class Demos {
      * @param address - The address
      */
     getAddressNonce(address: string): Promise<number>;
+    /**
+     * Poll the node until the nonce for `address` reaches (or exceeds) `target`.
+     *
+     * The node's `getAddressNonce` lags inclusion, so sending several transactions
+     * back-to-back can silently evict one: the next `pay`/`sign` reads a stale
+     * nonce and collides. When you must sequence dependent sends, wait for the
+     * nonce to advance past the last-sent one before signing the next.
+     *
+     * (For a single native transfer, prefer {@link payAndWait}, which already waits
+     * for on-chain inclusion.)
+     *
+     * @param address - The account address (hex).
+     * @param target - The nonce value to wait for (e.g. `lastSentNonce + 1`).
+     * @param opts.timeoutMs - Total time to wait. Defaults to 60_000.
+     * @param opts.pollIntervalMs - Delay between polls. Defaults to 500.
+     * @returns The observed nonce (>= `target`).
+     * @throws if `target` isn't reached before the timeout elapses.
+     */
+    waitForNonce(address: string, target: number, opts?: {
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+    }): 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.