feat(random): add explicitly granted OS entropy API

This commit is contained in:
Marqdo Agent committed 2026-11-21 10:25:11 +08:00
1 parent 6338fa10e9
commit ee0c6cc80a
20 files changed
+309 -15

No files matched your search

+37
View File
@@ -0,0 +1,37 @@
## 字节
`(数量)`
读取 `数量` 个 OS 熵字节,返回 `List<Int>`(每个 0–255)。仅项目模式,
需要显式 `--allow-random`;`pure`/`strict` 拒绝。
*resource.request("random.bytes", [数量])*
## 整数
`(上限)`
返回 `0 <= 值 < 上限` 的整数。`上限` 必须大于 0;使用 8 个熵字节
组合后取模(无偏拒绝采样尚未实现)。
1. `上限 <= 0`
*{ok: false, code: "random.invalid", message: "上限必须大于 0"}*
**字节结果 = 字节(8)**
1. `not 字节结果.ok`
*字节结果*
**值 = 0**
**下标 = 0**
- `下标 < 8`
**值 = 值 * 256 + 字节结果.value[下标]**
**下标 = 下标 + 1**
*{ok: true, value: 值 % 上限}*