Edit this page on GitHub (opens in a new tab)
Zallet — это кошелёк Zcash для полного узла, написанный на Rust. Он заменяет кошелёк, который раньше был встроен в zcashd. После того как zcashd достиг остановки End-of-Support 18 июля 2026 года на высоте блока 3417100, обязанности консенсуса и кошелька были разделены: Zebra или Zakura проверяют цепочку, а Zallet хранит ключи, сканирует ноты и предоставляет JSON-RPC кошелька.
Zallet сейчас находится в бета-версии. Он не прошёл полный аудит. Несовместимые изменения могут потребовать удаления и повторного создания кошелька. Не считайте его решением для промышленного хранения крупных сумм ZEC, не ознакомившись с предупреждениями по безопасности в Книге Zallet.
zcashd. Часть узла — это Zebra или Zakura.ReadStateService к локальному zebrad) или 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 как горячий кошелёк, бэкенд биржи, кран или кошелёк для выплат от майнинга.
Zallet находится в бета-версии.
На практике это означает:
zcashd.zcashd. Интеграциям следует ознакомиться со страницей изменённой семантики.Отзывы направляйте в issues GitHub или канал #wallet-dev в Zcash R&D Discord.
Позднее запланирована стабильная фаза, когда будет реализован предусмотренный набор 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 и Узлах Lightwallet.
Стек compose Zcash Foundation Z3 запускает вместе Zebra + Zallet, с опциональным отдельным Zaino для внешних лёгких клиентов.
Zallet построен вокруг 32 аккаунтов ZIP, а не единственного неявного аккаунта zcashd.
zip32seedfp1…).(seedfp, account index).z_getaddressforaccount. Один аккаунт может иметь множество диверсифицированных адресов; экранированные получатели не связываются в блокчейне.z_importkey) и адреса только для наблюдения (z_importaddress) становятся UUID-аккаунтами, не покрываемыми ни одной мнемонической фразой.z_exportviewingkey, z_importviewingkey), включая унифицированные полные ключи просмотра и входящие ключи просмотра.getnewaddress не реализован. Используйте z_getnewaccount и z_getaddressforaccount.
Если включён keystore.require_backup (перенесённая форма zcashd из walletrequirebackup), Zallet отказывается выводить новые полномочия на расходование из мнемонической фразы, резервная копия которой не была подтверждена.
Ключевой материал всегда зашифрован. Незашифрованного режима и RPC encryptwallet не существует — этот метод zcashd никогда не поддерживался полностью.
{datadir}/encryption-identity.txt.wallet.db.generate-encryption-identity -p). Разблокируйте его через RPC walletpassphrase; заблокируйте через walletlock.wallet.db.Копирование wallet.db во время работы Zallet не является безопасной резервной копией. SQLite может сохранить файл в повреждённом состоянии. Предпочтителен остановленный процесс либо ожидание официальной команды онлайн-резервного копирования.
Zallet реализует подмножество RPC кошелька zcashd по HTTP с Basic auth. Привязывайте к loopback. Для удалённого использования следует применять зашифрованный туннель. rpc.allow_insecure_remote_bind существует и небезопасен.
Заметные отличия от zcashd:
getwalletinfo пусты. Используйте z_getbalances, z_getbalanceforaccount, z_gettotalbalance.settxfee отсутствует.ClientInInitialDownload / ForbiddenBySafeMode).К намеренно исключённым методам относятся createrawtransaction, fundrawtransaction, getnewaddress, getrawchangeaddress, keypoolrefill, importwallet и encryptwallet. Замены перечислены в Книге Zallet.
Официальные способы установки (пакеты 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] на локальную конечную точку JSON-RPC zebrad. Бэкенду 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 требуется db_dump из Berkeley DB 6.2 — версии, которую использовал zcashd.
Пошаговые заметки для операторов: .
| Zallet | zecd | Zashi / ZODL / YWallet | Zebra / Zakura | Zaino | |
|---|---|---|---|---|---|
| Что это | RPC-кошелёк полного узла | Сервер кошелька с приоритетом экранирования | Пользовательские кошельки | Узел консенсуса | Индексатор / замена lightwalletd |
| Заменяет | Кошелёк zcashd | Не является прямой заменой zcashd | Мобильные/настольные приложения | Узел zcashd | lightwalletd |
| Нужен локальный узел | Да | Да (по умолчанию Zebra) | Нет (лёгкий клиент) | Это и есть узел | Да |
Zallet и zecd оба могут работать перед Zebra. Выбирайте Zallet, если вам нужен интерфейс кошелька z_* и путь миграции с wallet.dat. Выбирайте zecd, если хотите сервер с приоритетом экранирования, который явно не является клоном zcashd.
Существует отдельный потребительский продукт по адресу zallet.io, использующий это же название. Это приложение не относится к данному проекту.
zcashd| Совместимость с RPC zcashd |
| Спроектирован как путь совместимости |
| Только небольшое выбранное подмножество |
| Н/Д |
| Частичная / режим совместимости Zakura |
| Другой API |
| Модель хранения | Оператор хранит ключи в wallet.db | Сервер, восстанавливаемый из seed | Ключи на устройстве пользователя | Нет кошелька | Нет ключей |