ZooBC 钱包用户手册

基于 V0.36 手册针对钱包 V0.51 重写。术语已更新：链已将 game/games 更名为 app/apps，因此端点为 /api/v1/apps，键名为 app_type。

版本 V0.36 · 2026 年 7 月

本手册记录了 ZooBC 钱包中的每个界面、标签页、字段和交易类型。钱包是一个完全在你的浏览器中运行的单个 HTML 文件：你的密钥永远不会离开你的设备，所有交易都在本地构建和签名，只有最终签好名的字节才会发送到网络。

目录

1. 核心概念
2. 入门
3. 主界面
4. 首页：仪表盘、待办、进行中、活动
5. 钱包：发送、接收、存入、提取、计划、多签、策略
6. 资产：代币、文件、交易所、市场
7. 社交：联系人、在线、聊天、通话
8. 商务：发票、表单、公证
9. 应用：游戏厅
10. 高级：密钥与种子、纸钱包、提交
11. 系统：设置、节点、网络、网关、中继、治理
12. 交易参考
13. 故障排除
14. 术语表

1. 核心概念

1.1 币及其单位

原生币为 ZBC。在链上，所有金额都以原子单位存储：1 ZBC = 100,000,000 原子单位（10⁸）。钱包始终显示便于阅读的金额，只在输入和输出时进行换算。发行的代币有各自的小数位数（0–8），同样以基本单位存储。

1.2 账户与地址格式

一个钱包可以持有多种密钥方案下的账户。每个账户在链上都以类型化账户的形式存储：4 字节的类型前缀 + 密钥材料。支持的格式：

任何格式都可以在 ZooBC 链上发送和接收，比特币格式的账户会用其比特币密钥签署 ZooBC 交易。地址的推导方式与原链完全一致，因此从该链跨桥存入的资金会自动记入对应的镜像账户（参见存入).

推导路径（基于 BIP-39 助记词）：ZooBC m/44'/883'/account'（SLIP-0010 ed25519）；ETH/BNB 使用 BIP-44 coin 60；BTC 的传统/SegWit/Taproot 地址分别使用 BIP-44/84/86；Solana m/44'/501'/account'；Cardano 使用 coin 1815；Tezos 使用 coin 1729；Polkadot 使用 substrate mini-secret 推导。

1.3 交易、手续费、托管

链上的每一个操作都是一笔已签名的交易，包含类型编号、以 ZBC 计的手续费、可选的消息，以及可选的托管包装（审批人 + 截止期限 + 佣金 + 指示）。默认网络手续费为 0.05 ZBC（基础 0.025 + 为携带数据的交易预留的余量）；钱包会预先填入，并在消息较大时自动提高。完整的类型列表见第 12 节.

1.4 网关、节点、中继

• 节点负责验证链。
• 网关是钱包与之通信的 Web 服务器；它提供钱包/区块浏览器，并作为一个或多个节点的前端。
• 中继是网关运行的通话/在线状态服务器；它负责传递通话信令和在线状态。
• 归档节点还会额外提供完整历史和区块浏览器 API。

如果配置的网关宕机，钱包会自动故障转移：当前节点 → 内置备用节点 → 你添加的额外节点（设置 → 节点）→ 从链上注册表获知的网关。

1.5 存储租金与存续对象

写入链上的数据（数据集、存储的文件、代币）需要支付存储租金。每个对象都有一个可注资的 ZBS_ 押金地址，由创建它的交易推导而来；押金耗尽后，该对象可能会被清理。你可以为任何对象延长存续期（参见文件 → 对象).

1.6 安全模型

• 你的助记词 / 密钥永远不会离开页面；签名在本地完成。
• 设备上的持久化存储是一个由 6 位 PIN 锁定的加密保险库（输错 5 次将清空保险库，可用助记词恢复）。
• 可选的通行密钥解锁（Face ID / Touch ID / Windows Hello）。
• 仅观察账户可以查看所有内容但无法签名；需要密钥的页面会被隐藏。
• 物理隔离模式离线签名，并导出 JSON/二维码，而不是直接广播。

2. 入门

2.1 打开之前，先确认文件是真的

这个钱包是一个单独的文件，你在浏览器中打开它，然后输入你的助记词。一个伪造的

副本看起来一模一样，行为也完全正常，直到它把你的助记词发送到别处

的那一刻。屏幕上的任何东西都无法警告你，因为那时负责发出警告的正是这个伪造页面。

所以，打开文件之前先检查它。只需大约十秒钟。

简单的方法。在你下载文件的网关上打开 /verify，然后把文件拖到框中。

检查在你自己的浏览器中进行，文件永远不会被上传到任何地方。

只需要终端的方法。哈希是文件的指纹：改动一个字节，

它就会彻底改变，而且没有人能够反推出另一个具有相同

指纹的不同文件。

sha256sum "ZooBC Wallet.html"

将输出结果与该文件公布的哈希逐个字符进行比对。

然后问一问：是谁告诉你这个指纹的？这才是关键所在，/verify 页面对此

说得很明确：

凡是涉及资金的事，都应坚持要求链上匹配。网关为它自己的

下载文件作担保，不能算作证明。

如何在完全不信任任何网站的情况下核验。上面的一切仍然运行在别人提供给你的

页面上。如果你想要一种不依赖网页的核验方式，就直接询问节点，任何节点都可以，包括你自己

运行的节点。只需两条命令：

sha256sum "ZooBC Wallet.html"
curl -s https://zoobc.network/api/v1/release/list

如果你的文件哈希出现在该列表中，它就是发布授权方发布的文件。如果

没有出现，那么无论任何网站如何保证，向它输入助记词都是不安全的。

你还可以查询究竟哪把密钥被允许发布：

curl -s https://zoobc.network/api/v1/release/authority

zoobc.network 是公共 ZooBC TestNet 网关，而不是 MainNet。将主机替换为你自己的节点，即可在不信任该网关的情况下进行核验。

每个节点的回答都相同，因为它写在链上。询问两个由不同的人

运行的节点并进行比较，这正是该设计的全部意义所在，而你只需多付出一条

命令的代价。

如果 /verify 警告发布授权方的变更正在等待生效，请先停下来查明原因，再决定是否

信任你从该网站下载的任何内容。授权方是该页面上每一项声明背后的那唯一一把密钥，

而提议转移它，恰恰是刚刚窃取了它的人会做的事。这

很可能是一次计划中的轮换，但请通过一个不经过

该网站的渠道加以确认，因为一个已被攻破的网站会很乐意就它自己的移交向你作出保证。

随着 ZooBC 拓展到其他钱包和其他语言，这一点会越来越重要。你永远不必听信任何人关于哪个文件是真品的说法，链的存在就是为了让你无需这样做。

2.2 首次启动：风险提示

首次启动时，会显示一份软件界面声明与用户风险确认书。你必须接受（或退出）；完整的服务条款可随时从页脚查看。

2.3 欢迎界面

引导卡片提供以下选项：

• 助记词或私钥：粘贴 12/15/18/21/24 个单词的 BIP-39 助记词，或 64 位十六进制私钥。眼睛按钮可显示/隐藏内容。
• 钱包格式：ZooBC（默认）、以太坊、BNB、比特币、Solana、Polkadot、Cardano、Ripple、Tron、Tezos。选择比特币时，还会出现一个额外的选择器，用于选择 SegWit（bc1q…）、传统（1…）或 Taproot（bc1p…）。同一组助记词在每种格式下会生成不同的地址。
• 账户 #：用步进器选择推导索引（一组助记词可生成多个账户）。
• 解锁钱包：使用输入的凭据打开钱包。
• 创建新钱包：生成一组新的助记词（见下文）。
• 从备份文件恢复：加载加密的保险库备份（.json）；系统会要求输入保存备份时使用的 PIN。
• 节点设置链接：在登录前设置网关 URL。

2.4 创建新钱包

1. 选择助记词长度（12–24 个单词）。单词以带编号的标签显示；提供复制助记词、复制编号列表、新助记词按钮。
2. 警告会提醒你，助记词是唯一的备份。勾选“我已写下我的助记词”.
3. 验证：为几个随机位置选出正确的单词。
4. 设置 PIN：选择并确认一个 6 位 PIN。它会在本设备上加密保险库，这样刷新页面后钱包依然存在。

2.5 再次使用：解锁

输入你的 PIN（若已设置，也可以使用通行密钥按钮）。下方链接：从备份文件恢复和在此设备上重置钱包（清除本地数据；可用助记词恢复）。

2.6 仅观察

观察地址可在没有密钥的情况下显示任意地址的余额与活动。余额主区会显示仅观察徽章，所有签名页面都会被隐藏。

3. 主界面

3.1 顶栏

• 徽标 + 版本徽章（例如 V0.36）。
• 通知铃铛：客户端生成的提醒，包括新聊天消息、签名请求、链上警报；带红色计数徽章；点击条目可直接跳转到相应页面（例如发票通知会打开付款页面）。
• 主题：切换深色/浅色。
• 锁定：立即锁定钱包（需输入 PIN 重新打开）。
• 设置：打开设置页面。
• 通话中继指示器：在相关时显示剩余的中继流量。
• 网络状态标签：圆点 + 文字：block N（已连接；显示已确认高度，即最新高度 − 3）、synchronizing…（短暂故障 < 30 秒）、chain unreachable（持续故障）。点击它会打开区块浏览器 (explorer.<gateway-domain>).

3.2 余额主区（左栏）

• 余额，带范围切换：此钱包 / 所有钱包合计。
• 点击币图标可刷新；点击 V 形箭头可打开代币面板，列出你的代币余额。
• 可用余额：余额减去锁定金额（质押额、托管、挂出的报价）。
• 地址卡片：账户头像（点击可切换账户）、可编辑的钱包名称、地址以及复制按钮。
• 徽章：仅观察、多签.
• 发送和接收快捷按钮。

3.3 左侧菜单

可折叠的分组（会记住你的展开/折叠状态；可在“设置 → 菜单”中隐藏整个分组）：

在窄屏上，菜单会收起为顶部导航栏 / 汉堡菜单。

3.4 页脚

法律与信息页面：条款与条件、隐私政策、帮助与手册、参与项目.

4. 首页

4.1 仪表盘（概览）

解锁后进入的页面：

• 你的币：你所有钱包中各币种的合计余额。
• 你的钱包：每个账户一张卡片，显示名称、地址、实时余额（小数部分弱化显示）、链徽章以及多签/观察徽章。状态框会突出显示需要你处理的事项。
• 你的代币：你持有的代币，并提供通往代币页面的探索快捷入口。
• 你的节点：你的钱包所拥有的已注册节点（每 10 分钟自动刷新）。

4.2 待办

“所有等你处理的事项：批准、结算或回复。”一个列表汇总了：

• 由你担任审批人的托管（可直接批准 / 拒绝），
• 等待你签名的多签交易,
• 发给你的付款/托管请求，
• 等待你付款的发票，
• 轮到你走的应用回合以及即将到期的事项。

菜单项上的计数徽章会显示数量。刷新会重新拉取全部内容。页面打开期间每 60 秒自动刷新一次。

4.3 进行中（进行中的交易）

当前正在生效的交易，分为四个标签页：

• 全部：合并列表，附各标签页计数。
• 批准 / 拒绝托管：作为指定审批人，输入（或选择）一笔托管交易 ID，然后选择批准并放款（资金转给收款方）或拒绝并退回（资金退回发送方）。广播 ApprovalEscrow（类型 4）。
• 停止流动支付：停止你发起的流动支付；尚未解锁的余额将退还给你（LiquidPaymentStop，类型 262）。
• 停止解锁计划：你创建的正在运行的计划；撤销后，尚未执行的剩余部分将退还，已交付的部分仍归收款方所有（CancelSchedule，类型 30）。

4.4 活动

你的交易历史。

• 账户筛选：单个钱包或全部。
• 币种筛选：所有币种或某一特定币种。
• 来源选择：最新交易（所连接节点的近期窗口）或全部交易（归档节点的完整历史）。
• 类别标签：全部 · 钱包 · 买卖 · 应用 · 工具 · 铸币 · 手续费，并显示各类别合计。
• 钱包广播的每一笔交易也会保存在本地日志中（连同其主体字节），因此它会立即显示、不受节点清理影响，并能按类型呈现完整详情。展开行可查看金额、交易对方（已知时显示联系人名称）、手续费、托管详情、消息（发给你的消息会被解密）以及复制哈希按钮。

5. 钱包

5.1 发送

主要的转账页面。字段自上而下依次为：

• 收款方：任何受支持的地址格式（ZBC_…、0x…、1…、bc1…、Solana、SS58、addr1…、r…、T…、tz1…）或联系人（选择器按钮）。字段下方会显示有效性指示和解析出的联系人名称。
• 金额 + 最大（填入可用余额减去手续费）。
• 网络手续费（ZBC）：根据网络预先填入；随消息大小增加；你可以调高。
• 消息（可选）：存储在链上。对于 ZBC → ZBC 转账，你可以勾选加密消息（端到端；只有收款方能阅读）。手续费提示会随字节大小更新。
• 私人备注（可选）：仅保存在本设备上，绝不上链。
• 存续期（视情况显示）：向 ZBS_ 对象地址发送时出现，用于将此笔转账标记为租金充值。
• 流动支付复选框：金额在你选定的时间段（分钟）内逐步解锁给收款方。收款方可随解锁进度按比例领取；你可以在进行中页面提前停止（未解锁部分会退回）。发送的是 LiquidPayment（类型 6），而不是普通转账。
• 托管复选框：冻结资金，直到审批人批准：
• 审批人地址（或联系人），
• 冻结至：预设标签（1 天 … 6 个月）或精确的日期/时间选择器；以区块高度超时的形式显示，并注明区块时间只是估算值，实际时间会有偏差，
• 审批人佣金（ZBC）,
• 指示（自由文本，例如“交货后放款”）。
• 一个链接：想要收款？→ 发起付款请求（收款方托管，位于计划页面）。
• 用此代币支付网络手续费（视情况显示，适用于启用了手续费功能的代币）：销毁手续费代币，并释放等额的 ZBC 支撑资产（托管模式下不可用）。
• 仅创建交易：签名但不广播，生成已签名的 JSON + 二维码，供稍后或在其他设备上提交（参见提交).
• 预览：金额、佣金、手续费、总计。
• 检查并发送：弹出确认窗口，然后广播。重置表单会清空所有内容。发送后会显示交易 ID（即使你离开页面也会保留），并附带复制和区块浏览器链接。

广播内容：SendZBC（类型 1）；若在余额主区选中了代币，则为 TransferToken（11）；若勾选了流动支付，则为 LiquidPayment（6）。托管信息可附加在其中任意一种的信封中。

5.2 接收

以大尺寸二维码显示你的地址，并附有文本地址和复制地址按钮。

5.3 存入

跨桥转入 ZooBC：将 BTC、ETH、USDC 或 USDT 以包装币的形式带到链上（例如 BTC → ZBTC），确认后按 1:1 铸造。共有两个标签页：

• 开始：选择一种币（不支持的币显示即将推出）。钱包会显示：
• 原链的托管存款地址（二维码 + 复制），
• 所需的确认数,
• 记入谁的账户：存款会记入与你的发送地址互为镜像的 ZooBC 账户（同一把密钥）；托管地址是共用的，因此发送地址是唯一的所有权证明。请从一个你在此处掌控其密钥的钱包发送。
• 达到确认数后，由 ZooBC 节点中 2/3 的绝对多数进行证明，然后铸造包装币（几分钟到约 1 小时）。
• 追踪：三个子标签页：在途（每 20 秒自动刷新；状态依次为已检测 → 确认中 → 证明中 → 已铸造，并显示各链的预计时间）、观察其他账户（任意原链地址或 ZBC_ 地址）、历史（已完成和已丢弃）。

5.4 提取

跨链转出 ZooBC（将包装币转回其原生链）。此界面仅为原型，出站跨链桥尚不可用；它展示了计划支持的币种列表和流程。

5.5 定时

按计时器转移的价值。共五个标签页：

• 解锁：预先锁定的计划，创建时即锁定全部总额，再分期释放给收款人。字段：收款人、币种/代币、每期金额、间隔、期数（1–520）、可选悬崖期、可撤销/不可撤销、可选结束时间。广播 ScheduledTransfer（29），funding_mode 为 0。
• 定期：触发时扣款，不锁定任何资金；每期在触发时从你的余额中扣取（余额不足时安全失败）。字段相同；funding_mode 为 1。
• 按高度：一次性触发器，现在锁定一笔金额，当链到达指定区块高度时支付给受益人。高度字段带有日期/时间日历助手（换算为估算高度；实际时间会随出块时间漂移）。广播 CreateTrigger（15）；取消并退款请使用 CancelTrigger (16).
• 请求：由收款方发起的托管，由你请求一笔付款，设置付款人、金额（ZBC 或代币）、审批人、截止时间、佣金和说明；付款人会在“待办”中收到请求并为其注资。广播 EscrowRequest (260).
• 列表：你创建或接收的所有计划，分组显示；每行显示类型（解锁/定期/一次性）、进度（已交付/总额）、下次触发时间、角色徽章及操作：撤销（若可撤销）、将剩余分期重新指派给新收款人（ReassignSchedule，31，仅限当前收款人）。

5.6 多签

每笔支出都需要多个签名的账户。共两个标签页：

• 创建多签账户：参与者地址（每行一个，任意格式；可从联系人添加）、最少签名数、Nonce。计算地址会显示确定性的 ZBC_ 地址。然后：
• 链上注册：记录参与者集合（MultisigRegistration，类型 5），
• 添加到我的钱包：使其可作为账户选择（带多签徽章），用于收款和发起支出提案。
• 签署多签交易：发给你的待处理项显示在顶部。粘贴上一位签名者传来的交易（hex / base64 / JSON），点击用我的密钥签名，再将输出交给下一位签名者；签名操作从不广播。收集到足够签名后，广播（提交页面）会打开提交页面并预填该数据。

5.7 策略：“我接受哪些交易”

按账户设置并记录在链上的类别退出，由每个节点强制执行。关闭某一类别是双向的：你既不能发送也不能接收该类交易；任何尝试者都会被拒回（资金不会转移，对方只需支付网络手续费）。共九个开关：

摘要标签会显示“接受所有交易”或“拒绝：…”。关闭支付或节点与基础设施时需要额外确认（它们可能让你无法进行日常操作）。保存策略会广播 SetTransactPolicy（类型 50，掩码 u16 LE，手续费约 0.05 ZBC）；区块确认后生效。

6. 资产

6.1 代币

链上所有币种的登记册（创世币种 + 用户发行的“染色币”）。两种模式：

• 浏览：所有已注册代币的可搜索列表，显示图标、符号、名称、供应量、储备和你的余额；你可以为代币设置本地昵称。有储备的代币保持恒定的 ZBC 价值。
• 发行与管理（也可通过“多签中心 → 代币”进入）：
• 发行代币：符号（按字符集和保留符号黑名单校验）、名称、总供应量、小数位（0–8）、储备（锁定的 ZBC）（无储备代币填 0）、标志可赎回（销毁 → 取回你对应份额的储备）和可增发（发行者可追加供应），以及可选的 SVG 徽标 + 描述（随交易消息附带，≤ 6,144 字节）。广播 IssueToken (10).
• 发送代币：代币、数量、收款人（TransferToken，11；支持托管和以代币支付手续费）。
• 增发或销毁：增发（仅限发行者，适用于可增发代币；增加供应量同时锁定更多储备，使单位价值保持不变，类型 12）、销毁 / 赎回（销毁你的代币；可赎回代币会返还你对应份额的储备，类型 13）、续费（为代币的存续租金充值，以免被清除，类型 14）。

6.2 文件

去中心化文件存储（DFS）以及全部数据生命周期工具。共六个标签页：

• 我的文件：你存储的文件，包括名称、大小、根哈希、副本健康度和租金状态；可下载或复制分享链接。
• 上传文件：节点将文件拆分为按内容寻址的分片，并分发到其副本集；随后钱包通过 StoreFile（类型 40）在链上锚定该文件：文件根（32 B）、大小、分片大小、租金押金（最低 0.01 ZBC）以及分片列表。如果你的文件列表为空，默认打开此标签页。
• 按根下载：通过 64 位十六进制根（或 ZTX_ ID）从存储网络获取任意文件。
• 数据集：你的原始链上条目。每条聊天消息、投票、发票、表单和资料字段，都是某个账户上的一条数据集条目：
• 我的条目：条目列表，可一键移除。
• 添加条目：账户（留空 = 你自己的账户）、属性、值（最多 4,096 字节，实时显示字节数）。广播 SetupAccountDataset（类型 3）。
• 手动移除条目：收款人 + 属性（包括聊天中显示的 #… 后缀）+ 值必须完全匹配。广播 RemoveAccountDataset (259).
• 存储充值：为你的账户预付数据集租金（FundStorage，类型 9）。按单个数据集定向充值将随下一条链推出。
• 对象：存续租金对象管理：
• 你的对象列表，含租金余额和预计到期时间，
• 转移所有权：分两步，你发出转让（TransferDataset，42），收款人接受 (AcceptDataset, 44),
• 访问策略：账户允许/拒绝列表 (SetDatasetPolicy, 43),
• 删除 (DeleteDataset, 45),
• 按创建交易哈希为任意对象注资：通过交易 ID 查找该对象的 ZBS_ 押金地址，并用普通（可托管）转账为其充值。

6.3 交易所

链上订单簿交易所（CLOB）。标题徽章如实显示连接中… / 在线 / 离线；端点不可用时不会模拟任何数据。

• 模式：简洁（表单优先，不显示订单簿和成交记录）和专业（深度图、订单簿、最新成交、订单，交易终端布局）。
• 交易对选择器：“从 / 换成”两行列出所有已注册币种；带翻转按钮；已存在的市场以标签显示（附你的未成交订单数）。
• 统计栏：最新价格、24 小时涨跌/最高/最低/成交量、迷你走势图。
• 市场深度与订单簿：实时读取链上数据；订单簿为空时会说明原因：“暂无订单，来做第一个吧” / 节点离线 / 缺少读取 API。
• 下单表单：买入/卖出，订单类型市价 / 限价 / 止损，数量（可按实时余额一键填入最大值），限价，总额，预估手续费（0.1%）。订单簿为空时会禁止市价单并给出说明（没有可匹配的价格）。下单会广播 PlaceOrder（类型 22）；如果该交易对的市场尚不存在，会提示你创建市场（CreateMarket，21，需缴纳 ZBC 租金押金）。
• 我的订单：按设备保存；待处理时显示等待出块，之后显示未成交/已成交/已取消；取消会广播 CancelOrder（23，退还未成交部分）；清除已成交可整理列表。

6.4 交易市场

点对点的兑换报价板（OTC）：“发布你提供什么、想要什么，任何人都可以接受。”完全原子化，节点要么在同一个区块内完成双方兑换，要么完全不执行。仅在在线时可用，离线时如实显示离线状态。

• 浏览报价：按“提供 / 想要”资产筛选；每张报价卡显示挂单方（头像 + 联系人名称）、提供 → 想要的数量、隐含价格、到期时间和状态（未成交 / 已成交 / 已取消 / 已过期）。接受会广播 AcceptSwapOffer（19），接单方支付想要的一侧，并收到被锁定的提供一侧。
• 创建报价：提供的资产 + 数量（报价有效期间从你的余额中锁定）、想要的资产 + 数量、可选的到期时间（0 = 撤销前一直有效）、可选的指定对手方（仅该地址可以接受）。会先显示确认卡片，然后广播 CreateSwapOffer (18).
• 我的报价：你当前有效的报价，可取消（CancelSwapOffer，20，退还锁定金额），另有本设备保存的已售出 / 已接受 / 已取消 / 已过期报价历史。

7. 社交

7.1 联系人

你的通讯录。添加联系人：名称、可选照片和备注，以及任意数量的跨链地址（每个地址都带有链徽章）。在整个钱包中（发送、活动、聊天、交易市场…），联系人名称会替代原始地址，原始地址始终一键即可复制。联系人保存在加密保险库中，并随备份一同迁移。

7.2 在线

联系人的实时在线状态。每行显示状态（在线 / 离开 / 离线），并提供聊天或通话的快捷操作。在线状态采用推送机制：钱包每约 60 秒通过中继发送一次信标，列表按计时器刷新，两个钱包无需任何跳转即可互相看到。你如何显示，由“通话 → 可见性”控制。

7.3 聊天

链上消息。分为两层：

• 会话视图：WhatsApp 风格，会话列表带未读徽章、头像（联系人照片或姓名首字母）、搜索和本地重命名；会话界面显示气泡、时间戳，端到端加密的消息（ZBC ↔ ZBC）带锁形图标。来自你自己任一钱包的消息会被识别为“你”。
• 原始发送表单：收件人（地址或联系人）、主题（可选；例如走子时填写应用 ID，默认为 chat）、消息。每条消息都是收件人账户上的一笔 SetupAccountDataset 交易（类型 3），需支付正常的网络手续费。

消息可通过“文件 → 数据集”删除（移除时必须与条目完全匹配）。

7.4 通话

语音、视频和屏幕共享，均为点对点。直连通话免费；当防火墙阻止直连时，由中继网关转发流量，费用从你充值的额度中扣除。共五个标签页：

• 在线联系人：当前可联系的人（仅在线 / 全部筛选）；点按即可发起语音/视频通话。
• 中继：你的中继额度，以剩余数据流量（MB）显示，并附有换算估计（语音约 0.36 MB/分钟，视频约 15 MB/分钟；额度只按流量计算，不按分钟）。中继网关列表附健康状态；添加网关；充值即向中继运营者支付 ZBC，并在链上确认（待处理的充值会持续轮询，直至到账）。
• 最近通话：记录方向、时长、路由（直连 / 中继）、使用流量和网关。
• 启用账户：选择哪些账户可以通话（与中继进行签名登记）。
• 可见性：你对谁可见：所有人 / 全部联系人 / 选定联系人 / 无人（选择选定联系人时可逐一勾选联系人）。即使设为“无人”，你仍可发起通话。

通话期间：静音、摄像头开关、屏幕共享，以及实时流量计。中继通话时，顶栏的中继指示器会显示剩余流量。

8. 商务

8.1 发票

通过链接发送可支付的发票，币种可以是 ZBC 或任意已注册的币种/代币（ZUSD、ZBTC…）。付款是以该币种进行的普通转账；状态会根据链上数据自动对账。

• 创建发票：金额 + 币种、描述、可选到期日；发票会作为数据集写入你的账户，你会得到一个分享链接 (参见 8.4).
• 两个标签页：我开具的和我收到的，各自分为待付款与已付款两组。已付款条目会链接到结算交易。收到的发票也会出现在通知和“待办”中，并可直达付款页面。
• 付款页面：通过链接打开，显示开票人、金额、币种和备注；一键即可生成准确的转账。

8.2 表单

发布表单、分享链接，收集只有你能读取的已签名且加密的提交内容，并能证明谁签署了什么。定义字段，发布（作为你账户上的一个数据集），分享链接；提交内容使用你的密钥加密，并附带签名者地址和时间戳列出。

8.3 公证（存在证明）

为任意文件打上链上时间戳，文档始终不会离开你的设备。

• 公证：拖入文件，在本地计算哈希（SHA3-256）。对于图片，你可以选择附加一张小缩略图（可选择加密为仅自己可读）；PDF 会如实提示“无预览”。哈希（+ 可选缩略图）作为数据集写入你的账户，由其自身的存储租金支付。
• 我的锚定：你的锚定记录，含区块高度/时间；待处理的记录（已提交但尚未上链）会在本地跟踪，直至确认。
• 验证：拖入文件重新计算哈希并查找其锚定记录，默认在你自己的账户中查找；也可粘贴任意 ZBC_ 地址 / 链接，验证他人的记录。

8.4 分享链接

发票、表单、投票和付款页面的链接会根据钱包的提供方式自动适配：从真实的 https:// 源访问时，它们是完整 URL；从本地文件运行时，它们是#片段链接，收件人需将片段粘贴到自己钱包的 …wallet.html 之后（链接中从不嵌入任何 file:// 路径）。

9. 应用

游戏厅：链上、基于质押的回合制应用。大厅会如实把关：当链无法访问时，遮罩层会阻止游戏，直到链恢复。

9.1 视图

• 大厅：网络奖池（ZBC + 代币）、你未结束的对局和挑战（附加入按钮）、统计数据以及应用库。
• 单人：与庄家对战的单人应用（骰子、抛硬币、轮盘、老虎机、彩票、崩盘…）。
• 1 对 1：回合制应用，包括井字棋、国际象棋、四子棋、跳棋、黑白棋、五子棋、海战棋、点格棋等。你可以挑战特定对手（地址/联系人，邀请会出现在对方的钱包中），也可以发布任何人都能加入的公开挑战。
• 3 人以上：聚会类应用（飞行棋、猪骰子、竞速、类大富翁）。

9.2 开始对局

新对局表单：应用、质押额（金额 + 币种，可以是 ZBC 或奖池列表中的任意代币；0 = 友谊赛）、座位数、对手（1 对 1），以及在支持时可启用的快速模式（状态通道）。创建时广播 CreateApp（24），锁定你的质押额；加入者通过 JoinApp 锁定其质押额 (25).

9.3 对局进行

棋盘视图显示状态栏（轮到谁、倒计时）、棋盘、玩家栏和走子历史。走子合法性在客户端检查；节点的应用虚拟机会重新验证每一步。

• 链上模式：每一步都是一笔 AppMove（26）交易；倒计时下限为实测出块时间。如果钱包出现不同步，可以从链上重建整个应用.
• 快速模式（通道）：走子以签名凭证的形式即时交换（每约 10 秒重发一次，直至确认）；结束时任一玩家提交 SettleApp（39），链会按照自身规则重放签名凭证，进行裁决并派发奖励。
• 认输（27）即弃权，质押额归对手所有。超时判胜（28）：如果对手超过单步时限仍未走子，即可宣告获胜。
• 离开是安全的：未完成的回合会保存在本地，重新打开同一应用即可重新连接；结果在链上封存。

10. 高级

10.1 密钥与种子

管理保险库中的每个身份：

• 种子：已命名的助记词。你可以从每个种子派生任意受支持链、任意账户索引上的账户，无需重新输入助记词。支持显示（需 PIN）、重命名和移除。
• 导入密钥：单个 64 位十六进制私钥，任意格式均可。
• 观察地址：添加一个仅观察条目。
• 已导入的密钥和观察地址列表，每行显示地址、实时余额，并可移除。

10.2 纸钱包

可打印的冷存储。控件：来源，可选我的钱包（你持有的账户）或新空钱包（当场生成新助记词，绝不存储）；布局选项；打印。打印件包含地址二维码 + 助记词/密钥，并附有醒目的保管警告。

10.3 提交

广播一笔在其他地方签名的交易（气隙设备、多签联署人、“发送”页面中的“仅创建”）。粘贴已签名的 JSON，或用摄像头扫描二维码。无需密钥。会显示所得的交易 ID，或原样显示节点返回的错误。

11. 系统

11.1 设置

分为以下子标签页：

• 安全：更改 6 位 PIN（此后下载的备份需要使用新 PIN）。
• 通行密钥：设置 / 移除平台通行密钥解锁（Face ID / Touch ID / Windows Hello）。
• 自动锁定：闲置一段时间后锁定。
• 菜单：显示/隐藏整个侧边栏分区（设备偏好）。只有“首页”始终显示；“设置”始终可从顶栏进入。
• 备份与恢复：下载加密保险库（需要你的 PIN 才能打开；任何同时拥有文件和 PIN 的人都能动用资金）/ 从备份文件恢复。
• 节点（登录前也可进入）：当前网关及健康指示点、列出网关并检查在线状态（来自链上登记）、用于添加额外备用节点的手动节点 URL 输入，以及高级节点设置。
• 主题：深色 / 浅色。
• 气隙模式：开启后钱包从不广播，每笔交易都会被签名并导出（JSON + 二维码），交由一台联网设备提交。顶栏会显示指示标志。
• 重置：清除此设备上的数据（保险库、缓存）；你的助记词可以恢复所有重要内容。

11.2 节点

运行验证者节点所需的一切（仅限 ZooBC 账户）：

• 我的节点：你的钱包所拥有的每个节点（全部账户或单个账户）；可在本地为其命名，并复制其密钥。
• 注册节点：粘贴节点的 64 位十六进制私钥 + 锁定余额（最低 1 ZBC，默认 1000）。钱包会获取一个最近的区块并构建所有权证明（POOWN），由节点密钥对 owner ‖ block hash ‖ height 签名，然后广播 NodeRegistration（类型 2）。移除节点时，质押额会被释放。
• 移除节点：注销；锁定余额被释放 (RemoveNode, 514).
• 更新节点质押额：新的锁定余额（只能保持不变或增加）；新的 POOWN (UpdateNode, 258).
• 认领节点：将节点所有权重新分配给此钱包，用其私钥证明控制权 (ClaimNode, 770).

11.3 网络

你的链上基础设施记录，以及三个登记表的实时概览：

• 注册网关：跳转到“网关”表单（锁定 10 ZBC 质押额，注销时退还；网关此后必须持续发送心跳，否则会被自动清除，质押额退还）。
• 注册 / 更新中继：发布中继以供发现，包括中继密钥（ZBR_/64 位十六进制）、所服务的网关、域名、URL（RegisterRelay，48；注销，49）。中继仍由链下的中继绑定证书（见下文）进行认证，此记录只是让它可被找到。
• 注册 / 更新归档节点：将你已注册的某个节点标记为提供完整历史 + 区块浏览器 API，包括节点密钥（ZNK_/64 位十六进制）、域名、URL（RegisterArchival，46；注销，47）。这会在区块浏览器中为其加上归档徽章。

使用同一密钥重新注册会更新域名/URL；只有所有者的重新声明/注销才会生效。

11.4 网关

• 网关列表：此钱包当前通信的网关，并可对所有已注册网关进行健康检查（列出网关并检查在线状态）；选择要连接的网关。高级节点设置…会打开原始 URL 配置。
• 注册网关：生成网关密钥（或粘贴 64 位十六进制密钥；ZBG_ 地址预览会实时更新）、域名、URL → RegisterGateway（36），锁定 10 ZBC 质押额。心跳（37）由运行中的网关自动发出。
• 注销网关：按密钥注销；退还质押额 (UnregisterGateway, 38).

11.5 中继

注册中继（运营者流程，无交易、无手续费）：选择由哪个网关的 ZBG_ 密钥签名，设置证书有效期（天），点击生成中继密钥和证书。钱包会生成中继的 ZBR_ 密钥，以及由你的网关密钥签名的证书；将输出粘贴到中继服务器的 /etc/zoobc/relay.env 中并重启，其日志会显示 [fed] ON，并连接到对等网关。可随时重新运行以轮换密钥。

11.6 治理

• 投票：投票是一条链上记录（一个数据集），包括问题、选项、描述、投票时间窗口和资格规则（最低 ZBC 余额、最低账户年龄、最低交易笔数）。新建投票会打开编辑器；打开投票链接…可粘贴共享的 #gov=poll/... 链接。每一票都是来自投票者账户的一笔签名交易；计票结果直接读取自链上。投票卡片显示状态（即将开始 / 进行中 / 已结束）、票数、复制链接和打开按钮。
• 手续费投票：投票调高或调低网络手续费系数（1.0× = 正常）。所有节点投票的中位数决定其变动，每个周期的范围限制在 0.5×–2.0× 之间。分两步：

1. 承诺：你的投票以哈希形式广播（FeeVoteCommit，类型 7）；钱包会在本设备上记住原始投票内容。
2. 揭示：在揭示窗口内，广播投票 + 你的原始签名 (FeeVoteReveal, 263).

12. 交易参考

所有整数均为小端序；金额以原子单位表示（ZBC 为 ×10⁸，代币为 ×10^decimals）。每笔交易共享相同的信封：type(u32) · version(1) · timestamp(u64) · sender(typed acct) · recipient(typed acct; 02000000 = none) · fee(u64) · body_len(u32) · body · escrow-or-marker · message_len(u32) · message。托管块（任何可托管类型）为 approver(typed) · commission(u64) · timeout(u64) · instruction(lp4) · multi_party(1)；不使用托管时写入一个 4 字节标记（=2）。ZBC 账户对 SHA3-256("ZBC-TX" ‖ genesis_hash(32) ‖ unsigned_bytes) 进行 ed25519 签名；其他格式使用各自的原生方案对同一摘要签名。将创世哈希绑定进摘要，正是为了防止签名在另一个 ZooBC 网络上被重放，自 v0.4.0 起为必需。

支付与托管

调度器

消息与数据

object_id = 创建交易的哈希（ZTX_/64 位十六进制）。延长寿命的充值就是向对象的 ZBS_ 押金地址（账户类型 10）发送普通的 SendZBC，并且可以托管。

代币（染色币）

买卖交易

应用

节点与基础设施

治理与策略

13. 故障排除

• 顶栏显示“同步中…”：网络短暂波动；钱包会在连续失败 30 秒后才判定链无法访问，在此期间会自动尝试备用节点和已知网关。
• “检测到新链”：节点的链顶远低于此钱包见过的最高区块，说明网络已从创世重新启动。钱包提供一键清理旧链缓存（活动、代币、应用、通知）；密钥、种子和联系人都会保留.
• 忘记 PIN：连续输错 5 次后，保险库会被清除。请使用助记词（或备份文件 + 其 PIN）恢复。
• 交易被拒绝且只扣除了手续费：对方（或你自己）设置了拒绝该类别的交易策略（§5.7）。
• 交易所/交易市场/应用显示离线：节点缺少相应端点或无法访问；这些标签页会持续探测，恢复后会自动切换为在线。
• 应用卡住 / 对局中浏览器被关闭：从大厅重新打开同一应用即可重新连接；链上应用会从链上重建，快速模式应用会自动重发凭证。
• 从另一台设备发送的消息/交易未出现在“活动”中：“活动”的最新交易数据源只显示所连节点的近期窗口；将数据源切换为全部交易（归档）即可查看完整历史。
• 分享链接以 # 开头：你正在从本地文件运行；收件人需将片段粘贴到自己副本或任一网关托管钱包的 …wallet.html 之后。

14. 术语表

• 原子单位：链上最小单位；10⁻⁸ ZBC。
• 有储备代币：背后锁定了 ZBC 的代币；销毁时按比例赎回储备。
• 数据集：账户上的属性→值记录；链的通用数据存储。
• 托管：资金被冻结，直到指定审批人批准或拒绝，或截止时间到期后自动处理。
• 快速模式 / 通道：链下签名的走子凭证，由一笔最终交易结算。
• 网关：钱包连接所经由的 Web 服务器（ZBG_ 密钥）。
• 流动支付：随时间持续解锁的转账。
• POOWN：节点所有权证明，由节点密钥对所有者 + 最新区块哈希 + 高度进行签名。
• 中继：由网关运行的通话/在线状态服务器（ZBR_ 密钥）。
• 可用余额：余额减去所有锁定部分（质押、托管、报价、计划）。
• 保险库：以 PIN 加密的本地存储，保存种子、密钥和联系人。
• 仅观察：未添加密钥的地址；可以查看，但无法签名。
• ZBS_ 地址：对象的租金押金账户，可像任何地址一样充值。
• ZTX_：交易哈希的显示形式。