fairseal

Fairseal 🦭

为游戏、战利品箱以及任何随机分配提供可证明的公平选择。

Fairseal 会创建可验证的收据（CSR），证明选择在结果尚不可知之前就已提交。每一次战利品掉落、扭蛋抽取和随机选择，都可独立验证，无需信任任何人。

---

立即试用

npx @fairseal/commit

只需一条命令，即可在终端中进行可验证的扭蛋抽取。无需设置。

快速开始

npm install @fairseal/commit

import { createCommitment, resolveCommitment, createReceipt, verifyReceipt } from '@fairseal/commit';

// 1. Lock your loot table BEFORE the outcome is knowable
const commitment = createCommitment({
  rule: JSON.stringify(LOOT_TABLE),
  inputs: [playerId, pullNumber.toString()],
  revealAfter: 10,
});

// 2. Resolve with verifiable entropy from drand
const resolution = await resolveCommitment(commitment);

// 3. Your algorithm + verifiable entropy = provably fair drop
const drop = yourWeightedPull(LOOT_TABLE, resolution.beaconRandomness);

// 4. Package as a receipt anyone can verify
const receipt = createReceipt(commitment, resolution);
const proof = await verifyReceipt(receipt); // ✅ PARTIAL

工作原理

1. 提交 — 在随机性产生之前，将掉落表和玩家 ID 锁定到哈希中
2. 熵 — 等待公开的 drand 信标轮次（Cloudflare + Protocol Labs）
3. 解析 — 根据信标熵和已提交的规则推导出选择结果
4. 验证 — 任何人都可以重新执行每一步。drand 信标签名通过 BLS12-381 验证；FairSeal 收据签名使用 EIP-191（secp256k1）/ Ed25519，不会使用 BLS 签名。无需信任任何人。

性能

操作	耗时
创建承诺	0.006ms（每秒 170,000+ 次）
获取信标	约 200ms
drand 信标验证（BLS12-381）	约 150ms
收据大小	0.9 KB

在客户端运行。无需服务端。无需账户。PARTIAL 验证无需费用。

软件包

软件包	说明
@fairseal/game	面向 RGS 工作室的游戏 API。 老虎老虎机、扭蛋、战利品箱。（v0.1 ALPHA）
@fairseal/commit	已提交选择的收据。核心库。
@fairseal/core	密码学原语、签名、Merkle 树。
@fairseal/verify	独立验证收据。
@fairseal/mcp-server	面向 AI Agent 的 MCP 服务。 通过 Model Context Protocol 提供可验证熵、可证明公平的游戏和密码学收据验证。

使用场景

场景	方式
扭蛋 / 战利品箱	每次抽取都有收据。玩家可验证掉落结果是否符合公布的概率。
Boss 战利品掉落	每次遭遇都会提交掉落表。无法暗中削弱掉落率。
匹配	提交配对算法。玩家可验证是否存在偏袒。
锦标赛对阵表	种子顺序可证明是随机的，而非操纵所得。
NFT 铸造顺序	排队顺序可证明公平，无内部人士抢先交易。
老虎老虎机	种子承诺模型——可验证的旋转结果，无需 nonce 链。

结果公证与活动收据

如今大多数“Agent 收据”都是活动收据：平台记录 Agent 执行的操作，你必须信任日志的编写者。Fairseal 收据属于结果公证，采用不同的信任模型：

	活动收据（平台日志）	Fairseal 结果公证
你信任谁？	编写日志的运营方	无需信任任何人——收据可离线验证
证明了什么？	某项操作已被记录	某个结果在尚不可知时就已提交
时间证明	服务端时间戳（由运营方控制）	在 Base 上的外部锚定（可独立核查）
篡改证据	取决于日志完整性	由哈希锚定；任何修改都会导致验证失败

相关标准：Google/Mastercard 的 AP2（授权指令）、Visa 的 TAP 和 OpenAI/Stripe 的 ACP 等支付授权协议，证明 Agent 可以执行操作以及它的身份。Fairseal 证明的是发生了什么——某个结果已提交，且此后未被篡改。Fairseal 通过 Coinbase 的 x402 结算小额支付，但不实现 AP2/TAP/ACP；这些层彼此互补。

链接

• 🌐 fairseal.io — 产品首页
• 📦 npm @fairseal — 所有软件包
• 🔍 verify.fairseal.io — 收据验证器
• 📖 @fairseal/commit README — 完整文档

列表

• PayAPI Market — FairSeal Cryptographic Receipts API — 已验证的列表（已完成链上测试付款）

许可证

MIT — Fairseal