测试网已上线。无需密钥，无需注册，无需排队等候。

快速入门

1. 我在哪条链上？

请先完成这一步。地址是按链区分的 — 在测试网上获得资金的地址，在任何其他 ZooBC 网络上都不存在。

curl -s https://zoobc.network/api/v1/blockchain/status

height 是链的最新高度；confirmed_height 落后于它。高于 confirmed_height 的一切都是临时性的。主网尚未启动 — 启动后，它将在自己的域名下提供一份独立的文档副本。

2. 单位

处处使用原子整数。1 ZBC = 100,000,000 个原子单位。交易中的每一个 amount 和 fee 都是原子整数。唯一的例外是水龙头，它接受十进制的 ZBC 数值。

3. 离线生成密钥

zbc-account-gen 随每个版本附带，无需联网，并以 JSON 格式输出结果。同一个密钥可以在多条链上生成地址；ZooBC 会用每条链各自的签名方案来验证每一个地址。

zbc-account-gen

4. 获取测试币

curl -s -X POST https://zoobc.network/faucet/claim \
  -H 'Content-Type: application/json' \
  -d '{"address":"ZBC_...","amount":5}'

每次领取后，发放额度都会减半。在断定水龙头出故障之前，请先查看 /faucet/stats — 这个递减机制计算的是你已经领取的数量，而不是你申请的次数。

5. 发送价值

两种方式。两者都在本地签名；链上永远不会接触到私钥。

CLI：

echo '{"sender_privkey":"…","recipient":"ZBC_…","amount":"100000000"}' \
  | zbc-cli send-zbc --json-input

HTTP： 排布字节数据，对其链绑定摘要进行签名，再以十六进制 POST 提交。该摘要为 SHA3-256("ZBC-TX" ‖ genesis_hash ‖ bytes)，因此一个签名只在恰好一条网络上有效。请从 /api/v1/node/info 读取 genesis_hash。确切的字节布局、可签名形式与传输形式的区别，以及发送交易的 JSON 请求体，均记录在 agents.md §5 中。

6. 一个文件里的可运行参考示例

curl -sO https://zoobc.network/dl/zoobc-agent-example.py
python3 zoobc-agent-example.py --api https://zoobc.network

仅使用标准库，没有任何依赖，约 200 行代码。它完整地跑通整个流程 — 生成密钥、从水龙头领取测试币、等待其变为可支配、查询所需手续费、构建字节数据、签名、提交并确认。

验证一个下载文件

每一个已发布的二进制文件，其 SHA-256 哈希值都锚定在链上。把任何下载到的文件拖入 /verify，它就会对照共识核验该哈希值。比起信任某个下载页面 — 包括本页在内 — 这才是更值得依赖的验证方式。

源代码

核心节点软件目前尚未公开。按照基金会公开表明的立场，核心节点源代码将在主网上线后六个月内开放，如果普及程度足够高，也可能提前开放。若干实用工具和命令行工具会在主网上线之前就先行开放。在此之前，请使用链上发布登记表来核实你所运行的二进制文件，是否与共识发布的版本一致。

ZooBC 上的智能体

ZooBC 内置了适合自主智能体相互交易的链上原语：

• 定时转账与归属转账 — 随时间逐步释放的额度。
• 带自动超时的托管 — 如果对方未采取行动，资金会自动退回。
• N-of-M 多签 — 任何单一一方都无法凌驾其上的支出否决机制。
• 按账户划分的数据集 — 智能体可以读写的小型结构化状态。

可以为一个智能体设定一个由共识强制执行上限的可支配额度，它所采取的每一项操作都会留下一份永久的审计记录，供人事后查验。这正是 ZooBC 作为 AI 智能体交易底层基础设施的意义所在 — 支出的边界由链本身约束，而不是依赖对智能体运行环境的信任。