From 9b1f7d07c0ec8c94660911b0c1f577ef73008e26 Mon Sep 17 00:00:00 2001 From: nabeel378 Date: Sun, 5 Apr 2026 16:38:01 +0500 Subject: [PATCH] doc: note non-monotonic clock in crypto.randomUUIDv7 Signed-off-by: nabeel378 --- doc/api/crypto.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/api/crypto.md b/doc/api/crypto.md index 55b948aac50db5..81bc4d20582e42 100644 --- a/doc/api/crypto.md +++ b/doc/api/crypto.md @@ -5843,7 +5843,9 @@ added: REPLACEME Generates a random [RFC 9562][] version 7 UUID. The UUID contains a millisecond precision Unix timestamp in the most significant 48 bits, followed by cryptographically secure random bits for the remaining fields, making it -suitable for use as a database key with time-based sorting. +suitable for use as a database key with time-based sorting. The embedded +timestamp relies on a non-monotonic clock and is not guaranteed to be strictly +increasing. ### `crypto.scrypt(password, salt, keylen[, options], callback)`