devnet · zchain-poker-devnetPLAY 娱乐筹码 · REAL 托管映射 · v1 托管网络
finality: soft accepted → BFT ordered → proven → finalized/claimable
四种状态来自技术方案 §5.1。v1 当前实际达到 soft accepted(桌级软确认)与 proven(批次证明);BFT ordered 与 finalized/claimable 属于 v1.5 / Phase 2 路线图,尚未上线。软确认不代表最终确认,也不能单独授权 REAL 提现。

ZChain Poker 文档 · docs v1.3.0-alpha (ABI v1.3)

托管边界

守恒恒等式约束链内;托管边界约束链外。两者不能混淆。

两层守恒

链内(密码学/校验约束)
Σinputs == Σpayouts + Σrake_notes == plan.gross_pot == record.pot
        == 已证明终态镜像 pot(字节级,偏移 74)
链外(托管纪律约束,v1 无密码学保证)
托管外部资产余额 == 已发行 REAL − 已销毁 REAL + 待结算流水    # 由对账验证

链内守恒被协议强制(fail-closed);链外守恒只由托管方纪律 + 对账报告支撑——这就是托管模式的风险边界,Phase 2 的 Vault root 与独立 verifier 才把它升级为外部可验证。

托管账(M7,vault.rs)

能力状态
托管账记账(按资产类隔离)完成
充值幂等(deposit_id,校验失败不烧键)完成
提现申请 + finality 双重门槛(REAL)完成
provenance 查询(note_origins,消费后保留)完成
账实对账 + 差异处理完成
链上侧接线(Starknet 收款/打款通道)未完成

REAL 发行与销毁

  • 发行:充值确认后按托管入账发行 REAL note;v1 阶段 REAL 不对公众开放(发行受白名单/限额控制,MVP 起)。
  • 销毁:提现销毁(nullifier 消耗)后托管打款;provenance 保留供打款侧核对。
  • 隔离:REAL/PLAY 不可互转、不可混树(AIR 层不变量);对外报表分开列示。

风险说明

  1. 托管方偿付能力不由链内守恒决定——用户对托管方的债权以托管账与对账报告为准。
  2. 提现延迟来源:finality 门槛、人工审核、托管打款流程、监管要求。
  3. 非零对账差异即事件:暂停打款、定位、出带事件链接的报告(运营方义务,见运营方指南)。