Edit this page on GitHub (opens in a new tab)
Zallet 是一个使用 Rust 编写的全节点 [full-node] Zcash 钱包 [wallet]。它取代了过去嵌入在 zcashd 中的钱包。在 zcashd 于 2026 年 7 月 18 日在区块 [block] 高度 3417100 达到其停止支持状态后,共识 [consensus] 和钱包职责被拆分:Zebra 或 Zakura 验证链 [chain],而 Zallet 持有密钥、扫描 note,并提供钱包 JSON-RPC。
Zallet 目前处于 beta 阶段。它尚未经过完整审查。破坏性变更可能要求删除并重新创建钱包。未阅读 The Zallet Book 中的安全警告前,请勿将其视为适合大额 ZEC 的生产级托管 [custody] 方案。
zcashd 的钱包部分。节点部分是 Zebra 或 Zakura。zebrad 的直接 ReadStateService)或 Zaino。wallet.db 中。zallet(启动器)、zallet-zebra 和 zallet-zaino。zcashd 将源自 Bitcoin Core 的共识节点和钱包捆绑在同一进程中。该设计已不复存在。
| 角色 | 旧技术栈 | 当前技术栈 |
|---|---|---|
| 共识 / P2P | zcashd | Zebra(zebrad)或 Zakura |
| 钱包 / 密钥 / 余额 | zcashd wallet.dat | Zallet(wallet.db) |
| 轻客户端索引器 | lightwalletd | Zaino 或 lightwalletd |
将钱包从节点中拆分出来意味着:
zcashd 的特性。Zallet 面向此前将 zcashd 用作热钱包、交易所后端、水龙头 [faucet] 或挖矿 [mining] 支付钱包的运营者。
Zallet 处于 beta 阶段。
这在实践中意味着:
zcashd 钱包 RPC 都已移植。zcashd 不同。集成方必须阅读 已变更语义页面。反馈请提交至 GitHub issues,或发送至 Zcash R&D Discord 上的 #wallet-dev 频道。
一旦具备预期的 RPC 接口,计划进入后续稳定阶段。届时,调用方应迁移至 Zallet 的方法,包括已记录的语义差异。
Zallet 被拆分为三个 Cargo 工作区,以便两个链后端可跟踪不同的依赖关系图。
zallet launcher: reads `backend` in zallet.toml (default "zebra")
and execs zallet-zebra or zallet-zaino
zallet-core shared wallet: CLI, config, JSON-RPC, SQLite DB, sync
zallet-zebra zebra-state backend (ReadStateService + Zebra JSON-RPC)
zallet-zaino Zaino indexer backend
所有三个二进制文件都会打开同一个 wallet.db。启动器在运行时选择后端;切换时无需重新编译。
典型部署:
zebrad (or Zakura)
│ JSON-RPC / ReadStateService
▼
Zallet (zallet-zebra or zallet-zaino)
│ JSON-RPC on 127.0.0.1
▼
Your application, exchange, faucet, or operator scripts
Zallet 是一个全节点钱包:它需要本地验证节点。它不是轻客户端。有关轻钱包和紧凑区块服务器,请参阅 Zaino 和 轻钱包节点。
Zcash Foundation 的 Z3 compose 技术栈会将 Zebra 与 Zallet 一同运行,并可选择为外部轻客户端单独运行 Zaino。
Zallet 围绕 ZIP 32 账户构建,而不是 zcashd 的单一隐式账户。
zip32seedfp1…)标识。(seedfp, account index)。z_getaddressforaccount 生成的 ZIP 316 统一地址。一个账户可拥有多个多样化地址;屏蔽 [shielded] 接收方在链上 [on-chain] 不可关联。z_importkey)和仅观察地址(z_importaddress)会成为不受任何助记词覆盖的 UUID 账户。z_exportviewingkey、z_importviewingkey),包括统一完整 viewing key 和传入 viewing key。getnewaddress 尚未实现。请使用 z_getnewaccount 和 z_getaddressforaccount。
如果启用了 keystore.require_backup(zcashd 的 walletrequirebackup 的迁移形式),则 Zallet 会拒绝从尚未确认备份的助记词派生新的花费权限。
密钥材料始终经过加密。不存在未加密模式,也没有 encryptwallet RPC——该 zcashd 方法从未得到完整支持。
{datadir}/encryption-identity.txt。wallet.db 中。generate-encryption-identity -p)。通过 walletpassphrase RPC 解锁;使用 walletlock 锁定。wallet.db 副本(单独加密)。在 Zallet 运行期间复制 wallet.db 并非安全备份。SQLite 可能发生撕裂。请优先停止进程,或等待官方在线备份命令。
Zallet 通过 HTTP 和 Basic 认证实现了 zcashd 钱包 RPC 的一个子集。请绑定至回环地址。远程使用应通过加密隧道进行。rpc.allow_insecure_remote_bind 存在且不安全。
与 zcashd 的显著差异:
getwalletinfo 上的余额字段为空。请使用 z_getbalances、z_getbalanceforaccount、z_gettotalbalance。settxfee。ClientInInitialDownload / ForbiddenBySafeMode)。有意省略的方法包括 createrawtransaction、fundrawtransaction、getnewaddress、getrawchangeaddress、keypoolrefill、importwallet 和 encryptwallet。替代方案列于 Zallet Book 中。
官方安装路径(Debian 软件包、Docker、发布二进制文件)位于 安装指南。发布归档名为 zallet-<version>-<arch>.tar.gz,并包含全部三个二进制文件。
最小化的新钱包流程:
# data directory; default is $HOME/.zallet
zallet -d /path/to/zallet/datadir example-config > /path/to/zallet/datadir/zallet.toml
# edit zallet.toml: network, backend, indexer / read-state, rpc.bind
zallet -d /path/to/zallet/datadir generate-encryption-identity
zallet -d /path/to/zallet/datadir init-wallet-encryption
zallet -d /path/to/zallet/datadir generate-mnemonic
zallet -d /path/to/zallet/datadir confirm-backup
zallet -d /path/to/zallet/datadir start
将 [indexer] 指向本地 zebrad JSON-RPC 端点。zebra 后端还需要 [indexer.read_state_service] 和一个使用索引器功能构建的 zebrad,以便 Zallet 可直接读取链状态。
可复现映像可使用 StageX 构建(Docker 25+、containerd 映像存储、GNU Make)。
在确认余额并测试恢复前,请保留旧 zcashd 数据目录。
zallet init-wallet-encryption
zallet migrate-zcash-conf --zcashd-datadir /path/to/zcashd/datadir \
-o /path/to/zallet/datadir/zallet.toml
zallet migrate-zcashd-wallet --zcashd-datadir /path/to/zcashd/datadir
migrate-zcashd-wallet 仅存在于带有 zcashd-import 功能的构建中。读取 wallet.dat 需要来自 Berkeley DB 6.2 的 db_dump,即 zcashd 所使用的版本。
分步运营说明:。
| Zallet | zecd | Zashi / ZODL / YWallet | Zebra / Zakura | Zaino | |
|---|---|---|---|---|---|
| 它是什么 | 全节点 RPC 钱包 | 屏蔽优先的钱包服务器 | 最终用户钱包 | 共识节点 | 索引器 / lightwalletd 替代方案 |
| 替代对象 | zcashd 钱包 | 不是可直接替换的 zcashd 克隆 | 移动端/桌面应用 | zcashd 节点 | lightwalletd |
| 需要本地节点 | 是 | 是(默认使用 Zebra) | 否(轻客户端) | 它就是节点 | 是 |
| zcashd RPC 兼容性 | 被设计为兼容路径 | 仅选择性支持小型子集 |
Zallet 和 zecd 都可以位于 Zebra 前端。当你需要 z_* 钱包接口以及从 wallet.dat 迁移的路径时,请选择 Zallet。当你需要一个明确不是 zcashd 克隆的屏蔽优先服务器时,请选择 zecd。
在 zallet.io 上有一个使用同名的独立消费者产品。该应用不是本项目。
zcashd 节点| 不适用 |
| 部分支持 / Zakura 兼容模式 |
| 不同 API |
| 托管模型 | 运营者在 wallet.db 中持有密钥 | 可由种子恢复的服务器 | 用户设备密钥 | 无钱包 | 无密钥 |