ZYCORD 文档
简体中文

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 市场以及各个时代 — 全部配图说明。

运行它#

参考#

最短的有用路径#

如果你今天就想加入网络,而不只是读读关于它的介绍,那么全部步骤就是这些。这个 示例加入的是公共 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)、区块和有效性规则各自一个用例的黄金向量。一个能通过它们的实现,是同侪,不是分叉。