Zycord 文档
关于 Zycord 已发布的全部内容,按阅读顺序排列 — 设计论证、工程规范,以及真正运行它所需的运营者指南。
mainnet 自 2026-10-07T00:00:00Z 起运行,链 id 为 1;这个时刻是已发布参数文件中的 genesis_time,而不是一则公告 — 与之不一致的节点就在另一条链上。区块 0 之前不存在任何币,也没有出售过任何币:任何向你提供 ZCD 预售、配额或空投的人都是在诈骗你。公共 testnet 的币按设计毫无价值。每一则官方公告都用 E724 39CE DD85 11F9 D607 550B 87FD 60D5 EB4A 0B29 签名,并发布在
论坛帖子里。别无他处。
Zycord 是一个网络,在 Era 2 把它交给权益证明之前以工作量证明挖矿;在其中,每一笔交易 — 称为一份凭证 — 都携带着它读取的状态和它写入的状态。因此验证一份凭证是其字节的纯函数:不需要磁盘,不需要历史,不需要共享状态,同时核查它的机器数量也没有上限。链从不执行任何东西。它对凭证排序,并以一个确定性折叠提交它们:该折叠应用每一份其所声明的输入仍然成立的凭证,并跳过其余的,把每一次跳过的费用计入该凭证所指明的保证金。拥有热点状态的合约由定序器提供服务,定序器在链下执行用户签名的意图,并把结果作为凭证发布;强制路径则让任何用户无需定序器即可触达任何合约。
这些页面就是那个系统的文档:设计论证、工程 规范,以及运行它的运营指南。它们所依据的源头,与参考实现 所构建自的源头是同一批;其中任何一页若与 代码仓库不一致,以仓库为准。
从这里开始#
从整体图景开始网络的工作原理
整个系统尽在一页:一笔在链下构建的交易,仅凭其字节就被并行验证,再由一次串行的折叠提交。凭证、折叠及其结果、类型化访问、定序器与强制路径、两个 gas 市场以及各个时代 — 全部配图说明。
运行它#
安装
把二进制文件装到一台机器上。
验证下载
校验和、签名、可复现构建。
运行节点
运维 zycordd。
挖矿
RandomX、收益支付,以及运行它的开销。
钱包
密钥、发送,以及那八条规则。
公共 testnet
加入现在正在运行的那个网络。
参考#
线路协议
节点之间彼此说些什么。
术语表
凭证、折叠、跳过、存储单元、时代。
常见问题
真正会被问到的那些问题。
RPC API
节点响应的每个路由,及其参数和字段。
交易所集成
充值、提现、手续费与确认数,供上线 ZCD 参考。
最短的有用路径#
如果你今天就想加入网络,而不只是读读关于它的介绍,那么全部步骤就是这些。这个
示例加入的是公共 testnet,它运行与 mainnet 相同的发行版,但使用自己的参数
文件和链 id;去掉 --testnet,并使用一个单独的目录,同一条命令
就会加入 mainnet。
# Build the binary that can join a RandomX network.
# `make build` produces a devnet-only binary -- see Installation, "Two tiers".
make build-randomx
# A payout address. The node never sees the key behind it.
./bin/zcd-randomx wallet new --out miner.json
# Join, and mine to yourself. Coins come from mining; on testnet there is
# also a faucet at zycord.com/faucet/ for a first, small balance.
./bin/zycordd-randomx --testnet --dir ./testnet \
--mine --payout $(./bin/zcd-randomx wallet address --key miner.json)
你想什么时候启动都行,包括在一个网络的首个区块到期之前:节点会拒绝 构建一个自己的时钟尚未走到的区块,说明还要等多久,并自行 开始挖矿。没有什么需要排定,也没有什么需要重启。这件事的完整版本在 公共 testnet,而运行它的开销在 挖矿之下。
什么是权威的,什么只是解释#
这一点在这里比在多数项目里更重要,因为这个网络没有管理员密钥,因而无法在事后纠正错误。 这些文档是分级的,而这个分级不是走形式:
| 层级 | 它是什么 | 它在哪里 |
|---|---|---|
| 协议 | 参数文件和黄金测试向量。一个能通过这些向量的独立实现是对等实现,不是分叉。 | spec/ |
| 对等层 | 关于节点之间彼此说什么的规范性要求。 | 线路协议 |
| 论证 | 为什么设计是这个形状,并点名了已接受的风险。v2 论文,以及关于启动、时代和参数的配套文档。 | 白皮书 |
| 实现 | 参考节点如何实现上述全部内容。是解释性的,不是规范性的。 | 架构 |
| 运营者指南 | 安装、运行、挖矿和保管密钥。 | 这些页面 |
任何两者相互矛盾之处,以更精确的那个为准,而这个矛盾本身是一个值得上报的缺陷。 解释性层级中任何手写的数字都不是真相来源;它要么由代码生成,要么由一个具名测试断言,要么只是一个别处不得引用的示意值。
自己去核对#
对于一个作者不会当面替它背书的项目来说,这里没有任何东西比你不用求人就能自己核对的东西更值钱。协议就是一个文件目录:创世时冻结下来的参数文件,以及给每一条折叠 (fold)、区块和有效性规则各自一个用例的黄金向量。一个能通过它们的实现,是同侪,不是分叉。