@gibs/random

中文文档
0.0.19发布于 2026/07/24AGPL-3.0-only近 30 天下载 2348

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

中文使用文档
文档目录3 节
  1. 部署说明
  2. ZK卡合同
  3. 随机提供

随机 Coverage Status

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

部署说明

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 共同签署 ChannelStates和代表向每个表格的合法性过渡 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 共发布 17 个版本,首次发布于 2024/08/27;过去 12 个月发布了 1 个版本。

版本发布日期距今
0.0.19latest2026/07/243 个月前
0.0.182025/02/181.7 年前
0.0.172025/02/181.7 年前
0.0.162024/09/192 年前
0.0.152024/09/112 年前
0.0.142024/09/042 年前

关于 @gibs/random 的常见问题

@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 和提交记录判断。