From a4d9bcac6f9c56863bb5c543f52eb224589f9225 Mon Sep 17 00:00:00 2001 From: Chase Fleming <1666730+chasefleming@users.noreply.github.com> Date: Fri, 9 May 2025 14:17:29 -0700 Subject: [PATCH 1/5] Update docs wording --- docs/tools/kit/index.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/tools/kit/index.md b/docs/tools/kit/index.md index 2170fccc4a..0c1a6113c0 100644 --- a/docs/tools/kit/index.md +++ b/docs/tools/kit/index.md @@ -377,11 +377,11 @@ function RandomValues() { #### Notes: -- Randomness is generated using Flow’s **on-chain `revertibleRandom`**, producing pseudorandom values tied to block and transaction execution. -- The value returned for identical calls within the same block will be identical. -- This hook is intended for **non-critical randomness** like randomized UIs, loot crates, and temporary rewards. -- For **critical applications** requiring secure and unpredictable randomness, use a [commit-reveal scheme] on Flow instead. -- Values are **deterministic**: if a transaction fails and retries, the same random value will be regenerated. +* Randomness is generated using Flow’s **on-chain `revertibleRandom`**, producing pseudorandom values tied to block and transaction execution. +* The value returned for identical calls within the same block will be identical. +* This hook is designed for simple use cases that **don’t require a [commit-reveal scheme]**, such as randomized UIs, loot crates, and temporary rewards. +* For **more advanced use cases** that **do** require a [commit-reveal scheme], Flow provides built-in support for that pattern. +* Values are **deterministic**: if a transaction fails and retries, the same random value will be regenerated. --- From 7db0a21364fd438c50b4d39d5583dce6cf59b060 Mon Sep 17 00:00:00 2001 From: Chase Fleming <1666730+chasefleming@users.noreply.github.com> Date: Fri, 9 May 2025 14:20:44 -0700 Subject: [PATCH 2/5] Update --- docs/tools/kit/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tools/kit/index.md b/docs/tools/kit/index.md index 0c1a6113c0..cc6288f21d 100644 --- a/docs/tools/kit/index.md +++ b/docs/tools/kit/index.md @@ -379,7 +379,7 @@ function RandomValues() { * Randomness is generated using Flow’s **on-chain `revertibleRandom`**, producing pseudorandom values tied to block and transaction execution. * The value returned for identical calls within the same block will be identical. -* This hook is designed for simple use cases that **don’t require a [commit-reveal scheme]**, such as randomized UIs, loot crates, and temporary rewards. +* This hook is designed for simple use cases that **don’t require a [commit-reveal scheme]**, such as randomized UIs or loot crates. * For **more advanced use cases** that **do** require a [commit-reveal scheme], Flow provides built-in support for that pattern. * Values are **deterministic**: if a transaction fails and retries, the same random value will be regenerated. From 3f8268d941faafcdb2a8f874ee374a3f6d633d68 Mon Sep 17 00:00:00 2001 From: Chase Fleming Date: Fri, 9 May 2025 14:25:40 -0700 Subject: [PATCH 3/5] Update docs/tools/kit/index.md Co-authored-by: Brian Doyle --- docs/tools/kit/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tools/kit/index.md b/docs/tools/kit/index.md index cc6288f21d..3a45ba4835 100644 --- a/docs/tools/kit/index.md +++ b/docs/tools/kit/index.md @@ -379,7 +379,7 @@ function RandomValues() { * Randomness is generated using Flow’s **on-chain `revertibleRandom`**, producing pseudorandom values tied to block and transaction execution. * The value returned for identical calls within the same block will be identical. -* This hook is designed for simple use cases that **don’t require a [commit-reveal scheme]**, such as randomized UIs or loot crates. +* This hook is designed for simple use cases that **don’t require a [commit-reveal scheme]**, such as randomized UIs or calls from a trusted signer. * For **more advanced use cases** that **do** require a [commit-reveal scheme], Flow provides built-in support for that pattern. * Values are **deterministic**: if a transaction fails and retries, the same random value will be regenerated. From 645e51334d09c9400781145f9f52953ab0f75aec Mon Sep 17 00:00:00 2001 From: Chase Fleming <1666730+chasefleming@users.noreply.github.com> Date: Fri, 9 May 2025 14:26:30 -0700 Subject: [PATCH 4/5] Revert --- docs/tools/kit/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tools/kit/index.md b/docs/tools/kit/index.md index 3a45ba4835..cc6288f21d 100644 --- a/docs/tools/kit/index.md +++ b/docs/tools/kit/index.md @@ -379,7 +379,7 @@ function RandomValues() { * Randomness is generated using Flow’s **on-chain `revertibleRandom`**, producing pseudorandom values tied to block and transaction execution. * The value returned for identical calls within the same block will be identical. -* This hook is designed for simple use cases that **don’t require a [commit-reveal scheme]**, such as randomized UIs or calls from a trusted signer. +* This hook is designed for simple use cases that **don’t require a [commit-reveal scheme]**, such as randomized UIs or loot crates. * For **more advanced use cases** that **do** require a [commit-reveal scheme], Flow provides built-in support for that pattern. * Values are **deterministic**: if a transaction fails and retries, the same random value will be regenerated. From e493fb8811ce793b5f7a12b5ec55f1dfbc1caebd Mon Sep 17 00:00:00 2001 From: Chase Fleming <1666730+chasefleming@users.noreply.github.com> Date: Fri, 9 May 2025 14:27:50 -0700 Subject: [PATCH 5/5] Remove --- docs/tools/kit/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tools/kit/index.md b/docs/tools/kit/index.md index cc6288f21d..70a5bc521c 100644 --- a/docs/tools/kit/index.md +++ b/docs/tools/kit/index.md @@ -379,7 +379,7 @@ function RandomValues() { * Randomness is generated using Flow’s **on-chain `revertibleRandom`**, producing pseudorandom values tied to block and transaction execution. * The value returned for identical calls within the same block will be identical. -* This hook is designed for simple use cases that **don’t require a [commit-reveal scheme]**, such as randomized UIs or loot crates. +* This hook is designed for simple use cases that **don’t require a [commit-reveal scheme]**, such as randomized UIs. * For **more advanced use cases** that **do** require a [commit-reveal scheme], Flow provides built-in support for that pattern. * Values are **deterministic**: if a transaction fails and retries, the same random value will be regenerated.