Посібник з міграції: з zcashd на Zebrad/Zallet
Традиційний повний вузол zcashd, який підтримували Electric Coin Company (ECC) / Zodl, було замінено Zebra і Zallet. zcashd досяг зупинки наприкінці підтримки 18 липня 2026 року й більше не працює.
- Zebra — це сучасна реалізація протоколу Zcash мовою Rust, розроблена Zcash Foundation
- Zallet — це легкий гаманець, створений для безшовної взаємодії з вузлами Zebra, розроблений Zodl
Цей посібник проведе вас через міграцію з zcashd на Zebrad і Zallet, зокрема налаштування, імпорт гаманця та усунення типових проблем міграції.
zcashd припинив роботу 18 липня 2026 року
Що це означає
- zcashd досяг зупинки наприкінці підтримки 18 липня 2026 року. Він більше не синхронізуватиметься з вершиною ланцюга та не може надсилати або отримувати кошти. Це вже сталося, а не заплановано.
- Дві функції zcashd тепер розділені: zebrad — це повний вузол, а Zallet — гаманець.
- Zallet перебуває у бета-версії. Між випусками можливі несумісні зміни, а деякі методи JSON-RPC zcashd ще не реалізовано. Перевірте матрицю статусу методів, перш ніж покладатися на певний виклик.
- Якщо ви досі маєте кошти Sprout, спершу прочитайте попередження в кроці 6. Zallet не підтримує пул Sprout, а для звичайного способу переміщення цих коштів був потрібен запущений zcashd.
Чому варто мігрувати — не лише через припинення підтримки
Навіть якщо не враховувати припинення підтримки, є переконливі причини перейти:
- Безпека й надійність: безпечність пам’яті Rust і сучасні інструменти зменшують ризики вразливостей.
- Продуктивність та ефективність: Zebrad спроєктовано для паралелізму, ефективнішого використання ресурсів і швидшої синхронізації.
- Модульна архітектура: розділення логіки вузла (Zebrad) та інтерфейсу гаманця (Zallet) забезпечує чіткіші межі й кращі шляхи оновлення.
- Сумісність із майбутньою екосистемою: інструменти, вдосконалення та решта екосистеми Zcash дедалі більше орієнтуватимуться на Zebrad/Zallet.
- Спокій: не доведеться залишитися з застарілим компонентом без підтримки.
А тепер перейдемо до посібника з міграції
1. Створіть резервні копії всього
- Створіть резервну копію wallet.dat (або будь-якого іншого файлу гаманця / сховища ключів) із вашого вузла zcashd.
- Збережіть zcash.conf і всі користувацькі налаштування.
- Експортуйте копію всіх сценаріїв RPC або автоматизацій, якими ви користуєтеся.
- Переконайтеся, що ваші резервні копії дійсні (наприклад, в іншому середовищі спробуйте їх відкрити або перевірити).
- Перегляньте, на які методи JSON-RPC ви зараз покладаєтеся.
- Порівняйте з таблицею запланованої сумісності, яку підтримує сайт підтримки Zcash
- Підготуйтеся до змін або відсутніх методів (для деяких можуть знадобитися обхідні рішення чи адаптація).
2. Системні вимоги та місце на диску
- Місце на диску — це вимога, яку люди недооцінюють. Ланцюг Zcash перевищив 270 ГБ у серпні 2026 року, тож передбачте щонайменше 300 ГБ вільного місця, бажано на SSD.
- Переконайтеся, що ваш комп’ютер має стабільне мережеве з’єднання, достатньо CPU та RAM.
- Підключення до інтернету
- Якщо ви плануєте компілювати з вихідного коду, встановіть Rust і Cargo.
3. Встановлення / налаштування Zebrad
Ви можете завантажити попередньо зібраний виконуваний файл або зібрати програму з вихідного коду.
Варіант A: Встановлення через попередньо зібраний виконуваний файл
У Linux/macOS:
Це встановлює останню стабільну версію zebrad.
Варіант B: Збірка з вихідного коду
Після збирання перемістіть виконуваний файл до вашого шляху:
4. Конфігурація та запуск
Згенеруйте стандартну конфігурацію:
Відредагуйте zebrad.toml відповідно до ваших уподобань (адреса прослуховування, порти, каталог стану, кешування).
Запустіть вузол:
Вузол почне синхронізацію від генезису — залежно від обладнання та мережі очікуйте кілька годин (або більше).
5. Встановлення / налаштування Zallet (гаманця)
Zallet призначений для заміни частини гаманця в zcashd.
Перегляньте сторінку Zallet на GitHub / сторінку випусків, щоб знайти виконувані файли.
Або зберіть із вихідного коду:
- Запустіть GUI або CLI (залежно від вашого встановлення).
- Налаштуйте його на підключення до вашого локального вузла Zebrad через кінцеву точку RPC або API.
6. Імпорт вашого гаманця zcashd у Zallet
Для цього вам не потрібен запущений zcashd. Zallet читає файл wallet.dat безпосередньо, що важливо, оскільки zcashd більше не можна запустити.
Збережіть wallet.dat. Міграція повідомляє про все, що не може бути представлено в гаманці Zallet, замість імпортування, і цей ключовий матеріал тоді існує лише у wallet.dat. Не видаляйте його після міграції.
Спочатку виконайте zallet init-wallet-encryption. Zallet шифрує ключовий матеріал за допомогою ідентичності age, і ця ідентичність має існувати до імпорту будь-яких ключів.
Потім перетворіть вашу конфігурацію та гаманець:
Code-highlight
# translate zcash.conf into zallet.toml
zallet migrate-zcash-conf --zcashd-datadir /path/to/zcashd/datadir -o /path/to/zallet/datadir/zallet.toml
# import wallet.dat into Zallet's wallet.db
zallet migrate-zcashd-wallet --zcashd-datadir /path/to/zcashd/datadir
migrate-zcashd-wallet доступний лише у збірках із функцією zcashd-import, а для читання wallet.dat потрібна утиліта db_dump із Berkeley DB 6.2 — версії, яку використовував zcashd. Якщо у вас є кілька файлів гаманця, запускайте команду один раз для кожного файлу та додавайте --allow-multiple-wallet-imports у наступних запусках; кожен стане окремим набором облікових записів. Ваші rpcuser і rpcpassword не переносяться, оскільки JSON-RPC Zallet за замовчуванням використовує автентифікацію cookie; додайте облікові дані через zallet add-rpc-user, якщо вони вам потрібні.
Що переноситься
- Мнемонічні фрази та похідні від них ключі, з обліковими записами, відтвореними відповідно до гаманця zcashd
- Окремо імпортовані ключі витрачання Sapling і прозорі ключі
- Прозорі записи лише для перегляду, що містять їхній публічний ключ або сценарій погашення
- Дати народження облікових записів, щоб сканування ланцюга починалося з правильної висоти
Що не переноситься. Про ці дані повідомляється з указанням кількості, а не виконується їх імпорт:
- Ключі витрачання та кошти Sprout. Zallet не підтримує пул Sprout. Документований шлях полягав у переміщенні коштів Sprout за допомогою zcashd до його припинення, і це більше неможливо. Якщо це стосується вас, запитайте в Zcash R&D Discord або на форумі спільноти, перш ніж робити щось інше.
- Записи адресної книги
- Записи лише для перегляду, збережені без публічного ключа або сценарію погашення, а також записи зі стисненими публічними ключами
- Гаманці Regtest
Створення резервної копії після цього. Самої мнемонічної фрази недостатньо для повної резервної копії, оскільки імпортовані ключі існують лише в базі даних гаманця. Зберігайте захищені копії wallet.db, файлу ідентичності шифрування age, названого параметром keystore.encryption_identity, і вашої мнемонічної фрази, а також збережіть оригінальний wallet.dat. Зверніть увагу, що wallet.db сам по собі не зашифрований: він зберігає вашу історію транзакцій і ключі перегляду у відкритому вигляді, тому зберігайте резервну копію в безпечному місці.
Повторне сканування та синхронізація гаманця
- Після імпорту ключів Zallet запустить повторне сканування ланцюга через Zebrad.
- Дайте Zallet трохи часу, щоб відновити ваш баланс та історію транзакцій.
7. Перевірка балансів і синхронізації
Після імпорту Zallet підключиться до вашого вузла Zebrad і повторно просканує блокчейн.
Після завершення синхронізації ваші баланси й транзакції мають відображатися точно так само, як раніше.
Ви можете перевірити статус синхронізації вашого вузла, виконавши:
Або перевірте журнали.
8. Усунення несправностей
| Проблема | Можлива причина | Рішення |
|---|
| Zebrad не запускається | Порт використовується або неправильна конфігурація | Перевірте zebrad.toml і використайте вільний порт |
| Повільна синхронізація | Перевантаження мережі | Переконайтеся у стабільному інтернет-з’єднанні, перезапустіть Zebrad |
| У гаманці відсутні транзакції | Частковий імпорт ключів | Повторно імпортуйте ключі або повторно проскануйте в Zallet |
| Zallet не може підключитися до вузла | Вузол не працює або неправильна кінцева точка | Запустіть Zebrad і перевірте правильність порту RPC |
| Zallet аварійно завершує роботу | Застаріла збірка | Оновіть до останнього випуску з GitHub |
9. Висновок
Міграція з zcashd на Zebrad і Zallet забезпечує швидшу, безпечнішу та сучаснішу взаємодію з Zcash.
Завдяки безпеці на основі Rust, модульному дизайну та кращим інструментам це налаштування гарантує, що ваш вузол і гаманець будуть готовими до майбутнього, поки екосистема Zcash продовжує розвиватися.
Порада: зберігайте ключі гаманця офлайн і регулярно створюйте резервні копії даних Zallet.
Відвідайте zebra.zfnd.org для Zebra та The Zallet Book або репозиторій Zallet для Zallet. Розділ Міграція з zcashd у The Zallet Book є авторитетним довідником для кроку 6.
