@reyaxyz/sdk 0.151.4 → 0.152.0

package/src/services/orders/nonce.ts

@@ -0,0 +1,34 @@
+// Per-wallet monotonic nonce generator for matching-engine order signatures.
+//
+// The matching engine enforces strict `newNonce > currentNonce` per signer.
+// Using raw `Date.now()` as the nonce would fail under same-millisecond batches
+// (UI mass-create / mass-cancel).
+//
+// We use microsecond-scaled wall time as the base and bump from the last
+// returned nonce on collision — matching the Python SDK pattern.
+// JavaScript's single-threaded event loop makes the read-modify-write below
+// atomic per process; no lock is needed.
+//
+// LIMITATION — single-process only: `lastNonceByWallet` is module state, so
+// this guarantee holds ONLY within one process/realm. Two browser tabs, an
+// SSR + client pair, or multiple Node workers signing for the SAME wallet
+// keep independent maps and can mint the same `Date.now()*1000` base in one
+// millisecond; the matching engine's strict comparison silently rejects the
+// loser (a dropped order/cancel, not an auth break). For
+// concurrent multi-context signing, pass an explicit `nonce` (seeded from the
+// matching engine's current nonce) rather than relying on this generator.
+
+const lastNonceByWallet = new Map<string, bigint>();
+
+const US_PER_MS = BigInt(1000);
+const ONE = BigInt(1);
+const ZERO = BigInt(0);
+
+export const nextNonce = (walletAddress: string): bigint => {
+  const key = walletAddress.toLowerCase();
+  const nowUs = BigInt(Date.now()) * US_PER_MS;
+  const prev = lastNonceByWallet.get(key) ?? ZERO;
+  const next = nowUs > prev ? nowUs : prev + ONE;
+  lastNonceByWallet.set(key, next);
+  return next;
+};