# @gibs/random 中文文档

规范地址：https://npmcn.com/package/%40gibs/random/

版本：0\.0\.19
npm 元数据更新时间：2026-07-23T20:50:39.051Z
中文译文更新时间：2026-11-16T08:39:18.553Z
软件包许可：AGPL-3\.0-only

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40gibs/random
原文对照：https://npmcn.com/package/%40gibs/random/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：27.7 MB，175 个文件
- TypeScript 类型：未声明
- 运行依赖：10 个
- 首次发布：2024-08-27T15:09:48.743Z
- 最新版本发布：2026-07-23T20:50:38.883Z
- 近 30 天下载量：2348（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 1 个）

## 中文简介

用于生成链上随机性的回波

## 安装

```sh
npm install @gibs/random
```

也可以使用：`pnpm add @gibs/random`、`yarn add @gibs/random`、`bun add @gibs/random`

## README

# 随机 [![Coverage Status](https://coveralls.io/repos/github/gibsfinance/random/badge.svg?branch=master)](https://coveralls.io/github/gibsfinance/random?branch=master)

用于生成链上随机性的回波

## 部署说明

```bash
npx hardhat ignition deploy ignition/modules/Random.ts --network pulsechainV4
npx hardhat ignition deploy ignition/modules/Reader.ts --network pulsechainV4
npx hardhat ignition deploy ignition/modules/Consumer.ts --network pulsechainV4
npx hardhat ignition verify chain-943 --include-unrelated-contracts
```

## ZK卡合同

游戏不可知的两党国家频道卡表外加第一游戏规则和游戏 SNARK 负责裁决争端的核查者。 通过 `ignition/modules/ZkCards.ts`。 。 。 .

-   **`ZkTable`** ——代管+频道/争议机. 这是游戏不可知:它验证 EIP-712 共同签署 `ChannelState`s和代表向每个表格的合法性过渡 `IGameRules` 合同 `create` (加入国通过加入来接受这些规则——不) 所有人,不实行登记管理)。 诚实的路径是三个交易(创建,加入, 并且从不支付验证气体.
-   **`IGameRules`** ——规则接合. `ZkTable` 每张表格中,请查看其中一张 `hashGameState` 编号 : `whoseTurn` 编号 : `isFinal` 编号 : `applyMove`。 。 。 .
-   **`HiLoWarRules`** (游戏 id 1) —— 纯镜像 `@gibs/hilo-war`是因为 `applyMove`, (中文(简体) ), 只有争议机器咨询。 技术支助单元是规范性的; `HiLoWarParity` 模糊线 二者相对.
-   **销售单位** (单位:千美元)`contracts/vendor/uzkge/`,锁定承诺 `2ae729db`页:1 调用数据形状 `ShuffleVerifier52` 包装. **针头是一个共识常数** —— 说 这些核查人必须来自同一行为 `contracts/vendor/VENDOR.md` 指针,GPL-3.0牌照姿势,以及主网前阻塞器.

争端由更高非共同签署国通过要求的游戏动作进行解答 (由规则合同确认)或要求的披露份额——后者是 **Groth16 仅限声带** (单位:千美元)`RevealVerifier`); 禁止链路上的CP-DL 15.6M 气体。 时钟过期后将争议的锅子交给争议者,并结算余额 从有争议的共同签署国。 棋子时钟是每个表格的创建者设置 (单位:千美元)`clockBlocks`,以 30–60480 为界,~5分到~1周;建议客户默认为 360–1小时); v1没有争议保证金.

EIP-712域名为: `("ZkTable", "1", chainId, zkTableAddress)`,通过 `makeDomain` 内 `@gibs/zk-cards-core`。频道状态和游戏状态的散列是abi-encode (不是JSON) 所以合同可以复制它们—— 罐头的Tiple在TS中被镜像 通过对等测试执行.

## 随机提供

提供随机,在一天结束时,是一个数字游戏(excuse the pun).

您需要能够确保验证者有理由在线保持并保持其堆积的预想更新,但您希望它尽可能少地以成本和复杂性发生,这样提供者就不会有高屏障交叉来得到您所要求的随机性.

本游戏使用以下力学实现:

-   供应商为提供种子而投下一些他们期望(平均)得到的奖牌
-   消费者以一定金额支付所要求的全部随机性种子。 每个供应商的相片价格可能不同
-   在消费者要求结束竞选活动之前,任何通过消费者或通过自己写出其秘密的供应商都不会被砍掉
-   消费者可以使用他们要求的、没有交付的假象来“斜线”任何验证器
-   连锁店都得不到秘密 意味着提供商不会从消费者赌注的资金中得到回报
-   如果气体是考虑的因素,供应商必须自己把秘密放在链上,或提出分批这样做的机制
-   消费者必须要求一些种子,使生成的数量可信中性,幸运的是,只有一位演员必须诚实,才能让种子可信地随机产生

考虑以下例子:

爱丽丝从Bob、Charlie和David那里请求随机性 Bob的预想花费了90个PLS,而Charlie则花费了125个和David花费了100个. 爱丽丝将不得不为315 PLS(90+125+100)进行赌注,以适当要求3个来源的随机性输入. 从这里可以得出以下结果:

-   所有3家供应商都向大众公开他们的秘密,艾丽丝在链上写出数据,把锅分给被结果的种子随机选择的达维德.
-   所有三家提供商都向大众公开他们的秘密, 达维德指出他是赢家, 他决定把随机性写在链上, 向每个验证人分发符号, 和锅给自己.
-   三个供应商都暴露了他们的秘密 虱子的过错 然后三个供应商都暴露了 在这种情况下,任何拥有适当数据和秘密的地址都可以连锁提交。 bob是第一个回到网上的人 他决定提交所有三个秘密 3家供应商各自放回赌注 然后把大麻分给david.
-   供货商暴露了 爱丽丝和供货商的过错 bob上线了 只知道他的秘密 他提出这个秘密是为了确保他不会被砍伤。 相继上线并拥有全部3个秘密,但因时间已过而选择取消. 她带着她的木桩 以及charlie和david的木桩标志物.

## 常见问题

### @gibs/random 是什么？

用于生成链上随机性的回波

### 如何安装 @gibs/random？

在项目目录运行 npm install @gibs/random，或使用 pnpm add / yarn add / bun add。

### @gibs/random 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/gibs\_\_random 是否存在。

### @gibs/random 可以商用吗？

@gibs/random 使用 AGPL-3\.0-only 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @gibs/random 的下载量有多少？

根据 npm 官方下载统计，@gibs/random 在 2026/10/17 – 2026/11/15 这 30 天内被下载 2,348 次，日均约 78 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @gibs/random 还在维护吗？

最新版本 0\.0\.19 发布于 2026/07/24（3 个月前）；至今共发布 17 个版本，其中过去 12 个月发布了 1 个；首次发布于 2024/08/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

