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. Інтеграції мають прочитати сторінку зміненої семантики.Відгуки надсилайте до проблем 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 із базовою автентифікацією. Прив’язуйте до 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 | Ключі на пристрої користувача | Без гаманця | Без ключів |