Merge branch 'main' of https://github.com/smartcontractkit/documentation into ccip-0209

Author: gfletcher-cll

src/config/sidebar.ts

@@ -323,6 +323,10 @@ export const SIDEBAR: Partial<Record<Sections, SectionEntry[]>> = {
           url: "cre/guides/workflow/time-in-workflows",
           highlightAsCurrent: ["cre/guides/workflow/time-in-workflows-ts", "cre/guides/workflow/time-in-workflows-go"],
         },
+        {
+          title: "Using Randomness in Workflows",
+          url: "cre/guides/workflow/using-randomness",
+        },
       ],
     },
     {
@@ -420,10 +424,6 @@ export const SIDEBAR: Partial<Record<Sections, SectionEntry[]>> = {
           url: "cre/concepts/non-determinism",
           highlightAsCurrent: ["cre/concepts/non-determinism-go", "cre/concepts/non-determinism-ts"],
         },
-        {
-          title: "Random in CRE",
-          url: "cre/concepts/random-in-cre",
-        },
         {
           title: "TypeScript Runtime Environment",
           url: "cre/concepts/typescript-wasm-runtime",

src/content/cre/concepts/non-determinism-go.mdx

@@ -79,7 +79,7 @@ Go's built-in `rand` package generates different random sequences on each node,
 
 **The problem:** Each node generates different random values, breaking consensus.
 
-**The solution:** Use `runtime.Rand()` from the CRE SDK, which provides consensus-safe random number generation. All nodes generate the same sequence of random values, enabling consensus. See [Random in CRE](/cre/concepts/random-in-cre) for details.
+**The solution:** Use `runtime.Rand()` from the CRE SDK, which provides consensus-safe random number generation. All nodes generate the same sequence of random values, enabling consensus. See [Using Randomness in Workflows](/cre/guides/workflow/using-randomness) for details.
 
 ## 6. Working with LLMs
 
@@ -114,5 +114,5 @@ Large Language Models (LLMs) generate different responses for the same prompt, e
 ## Related concepts
 
 - **[Time in CRE](/cre/guides/workflow/time-in-workflows-go)**: Learn about DON Time and why `runtime.Now()` is required
-- **[Random in CRE](/cre/concepts/random-in-cre)**: Understand consensus-safe random number generation
+- **[Using Randomness in Workflows](/cre/guides/workflow/using-randomness)**: Understand consensus-safe random number generation
 - **[Consensus Computing](/cre/concepts/consensus-computing)**: Deep dive into how nodes reach agreement

src/content/cre/concepts/typescript-wasm-runtime.mdx

@@ -34,6 +34,11 @@ Javy uses [QuickJS](https://bellard.org/quickjs), a lightweight JavaScript engin
 
 Not all Node.js built-in modules are available. For example, `node:crypto` is not supported. Before using third-party NPM packages, verify they don't rely on unsupported Node.js APIs.
 
+{/* prettier-ignore */}
+<Aside type="tip" title="Cryptography libraries">
+  If you need cryptographic functions, <a href="https://paulmillr.com/noble/" target="_blank" rel="noopener noreferrer">Noble</a> is a popular JavaScript cryptography library with minimal dependencies that works well with QuickJS. Always verify any third-party library in simulation before deploying.
+</Aside>
+
 <Aside type="note" title="Note on async/await with SDK capabilities">
   While JavaScript `Promise` and `async/await` are supported by QuickJS, **SDK capabilities do not use them**. The CRE
   TypeScript SDK uses a custom `.result()` pattern instead. See the [Core SDK

src/content/cre/getting-started/before-you-build-go.mdx

@@ -31,7 +31,7 @@ If your workflow needs random values (e.g., selecting a winner or generating non
 
 {/* prettier-ignore */}
 <Aside type="tip" title="Learn more">
-  See [Random in CRE](/cre/concepts/random-in-cre) for usage examples and best practices.
+  See [Using Randomness in Workflows](/cre/guides/workflow/using-randomness) for usage examples and best practices.
 </Aside>
 
 {/* prettier-ignore */}

src/content/cre/getting-started/before-you-build-ts.mdx

@@ -25,6 +25,11 @@ Your TypeScript code compiles to WebAssembly and runs in a QuickJS environment,
 1. Check if it relies on Node.js built-in modules
 1. Test with `cre workflow simulate` — simulation uses the same WASM environment as production, so compatibility issues surface immediately
 
+{/* prettier-ignore */}
+<Aside type="tip" title="Cryptography libraries">
+  If you need cryptographic functions, <a href="https://paulmillr.com/noble/" target="_blank" rel="noopener noreferrer">Noble</a> is a popular JavaScript cryptography library that works well with QuickJS. Always verify any third-party library in simulation before deploying.
+</Aside>
+
 {/* prettier-ignore */}
 <Aside type="tip" title="Learn more">
   See [TypeScript Runtime Environment](/cre/concepts/typescript-wasm-runtime) for details on QuickJS compatibility and how to [verify library support](/cre/concepts/typescript-wasm-runtime#checking-library-compatibility).

src/content/cre/guides/workflow/using-evm-client/onchain-write/overview-go.mdx

@@ -180,7 +180,7 @@ max := big.NewInt(1000)
 randomValue := new(big.Int).Rand(rnd, max)
 ```
 
-**Note**: For a complete understanding of how randomness works in CRE, including the difference between DON mode and Node mode randomness, see [Random in CRE](/cre/concepts/random-in-cre).
+**Note**: For a complete understanding of how randomness works in CRE, including the difference between DON mode and Node mode randomness, see [Using Randomness in Workflows](/cre/guides/workflow/using-randomness).
 
 ### Constructing input structs
 

src/content/cre/guides/workflow/using-http-client/get-request-ts.mdx

@@ -383,5 +383,5 @@ The request object provides several fields to customize your HTTP call. See the
 
 - **Headers**: Custom HTTP headers
 - **Body**: Request payload (for POST, PUT, etc.)
-- **Timeout**: Request timeout in milliseconds
+- **Timeout**: Request timeout as a duration string in seconds (e.g., `"5s"`, `"8s"`)
 - **Cache settings**: Control response caching behavior

…c/content/cre/concepts/random-in-cre.mdx …cre/guides/workflow/using-randomness.mdxsrc/content/cre/concepts/random-in-cre.mdx renamed to src/content/cre/guides/workflow/using-randomness.mdx src/content/cre/concepts/random-in-cre.mdx renamed to src/content/cre/guides/workflow/using-randomness.mdx

@@ -1,12 +1,12 @@
 ---
 section: cre
-title: "Random in CRE"
+title: "Using Randomness in Workflows"
 sdkLang: "go"
 date: Last Modified
 metadata:
   description: "Generate random numbers safely in CRE: use runtime.Rand() to ensure all nodes get the same values and maintain consensus."
   datePublished: "2025-11-04"
-  lastModified: "2025-11-04"
+  lastModified: "2026-02-05"
 ---
 
 import { Aside } from "@components"