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 提现。

文档

版本化文档站:13 个板块,从 15 分钟 quickstart 到协议规范与威胁模型。docs v1.3.0-alpha (ABI v1.2.3)。

文档站与代码同步版本化:latest 只指向已发布 release,草案进入 next版本说明)。生产环境将托管于 docs.zchain.example,路径结构与本站 /docs/ 完全一致。

快速开始

15 分钟 quickstart:启动 devnet、完成一手 PLAY、验证证明;玩家网络配置。

核心概念

Note、nullifier、桌、手、rake 与四阶段最终性。

协议规范

ABI(v1.2.x)、Operation 集、SoftConfirmFrame、SettlementPlan、批次根与 attestation。

系统架构

Appchain 分层、证明管道、Vault 边界、DA 与抗审查设计现状。

开发者指南

RPC、事件、错误码、限流与重试语义。

验证者指南

节点部署、validator set 现状、BFT 路线、密钥与监控。

运营方指南

牌桌运营、费率注册、充值提现、对账与故障处置。

证明系统

Texas AIR、公开输入(scope v2)、验证器与审计导出。

安全

威胁模型、三层 REAL 门、漏洞披露与暂停/恢复。

经济模型

rake 公式(含 contested 口径)、分账、托管边界;安全关键公式附数学式与伪代码。

API 参考

RPC/ABI 手工参考层;自动生成流水线待接入。

变更日志

docs/ABI 版本、协议变更、迁移与兼容性、latest/next 机制。

法务与合规

条款、隐私、地区限制与责任边界(与官网 /legal/ 同源)。

文档发布最低要求对照

每个代码 release 对应 docs tag / ABI 版本 / genesis hash;API 文档含正负例与错误码;安全关键公式同时给出数学表达式、规范伪代码与测试向量;Note/结算/提现/checkpoint 提供独立验证命令;"已实现/部分实现/仅 PoC/禁止生产使用"明确列出;性能数字附硬件与分位数。逐条状态见仓库内 website/docs-status.md