ГЛАВНАЯ / ИНСТРУКЦИИ / DESCRIPTOR WALLET И LEGACY WALLET В BITCOIN CORE: В ЧЁМ РАЗНИЦА
Descriptor wallet и legacy wallet в Bitcoin Core: в чём разница
Descriptor wallet явно хранит описание сценариев получения и расходования средств; legacy wallet использует историческую key-based модель. В текущем Bitcoin Core новые кошельки создаются как descriptor по умолчанию, а поддержку legacy следует считать устаревающей и зависящей от сборки и настроек.
Legacy опирается на ключевую модель, descriptor явно задаёт скрипты
Legacy wallet – исторический тип кошелька Bitcoin Core, где некоторые шаблоны выходов определяются через ключи и связанные с ними данные. Descriptor wallet хранит output descriptors – явные описания набора scriptPubKey, derivation paths, ключей и типов адресов, которые кошелёк должен отслеживать.
Явное описание упрощает понимание того, какие скрипты относятся к кошельку, и поддерживает современные сценарии, включая SegWit и Taproot. Это не означает, что descriptor-файл сам является приватным ключом или что любое стороннее приложение одинаково понимает любой descriptor.
- descriptor задаёт сценарии выходов явно;
- legacy wallet сохраняет историческую совместимость;
- тип базы влияет на импорт и watch-only операции.
Новые кошельки создаются как descriptor по умолчанию
В текущей документации Bitcoin Core RPC `createwallet` параметр `descriptors` по умолчанию включён. Создание или открытие legacy wallet может быть ограничено конкретной версией, поддержкой Berkeley DB и параметрами сборки; не используйте старый совет о том, что Legacy обязательно остаётся обычным вариантом по умолчанию.
Откройте справку именно установленной версии, проверьте тип кошелька её средствами и не меняйте параметры запуска только по инструкции для другой версии. Названия и возможности GUI также менялись со временем.
- сверена версия Bitcoin Core;
- проверено значение descriptors для своей команды;
- legacy-совместимость не предполагается по умолчанию.
Переход может создать несколько связанных wallet-файлов
Команда `migratewallet` может перенести известные ключи и скрипты в descriptor wallet, а отдельные watch-only или solvables данные сохранить в дополнительных кошельках. Bitcoin Core описывает процесс как best effort: необычные legacy scripts могут потребовать отдельной проверки.
Перед миграцией остановите изменение исходного кошелька и сохраните независимую копию. После завершения проверьте все ожидаемые адреса и историю, посмотрите список созданных баз и создайте новые backups. Не удаляйте legacy копию только потому, что RPC вернул успешный статус.
- исходная база сохранена без изменений;
- новые кошельки и их назначения записаны;
- контрольные адреса и старые UTXO обнаружены;
- новые резервные копии созданы и проверены.
Descriptor export не заменяет seed и ключевой backup
Публичный descriptor может содержать xpub и структуру derivation, но не приватный материал для траты, если он намеренно исключён. Watch-only descriptor помогает следить за адресами, однако для подписи нужен соответствующий signer или приватные ключи.
Не загружайте приватный descriptor в сторонний сервис и не отправляйте туда seed. Перед переносом между приложениями сравните адреса, диапазон деривации, внутренние change-скрипты и тип сети.
- публичный и приватный export различены;
- watch-only не принят за wallet backup;
- полученные адреса совпадают с ожидаемыми;
- состав резервной копии документирован.
Частые вопросы
Миграция меняет сами Bitcoin-адреса?
Старые outputs остаются в блокчейне, но descriptor wallet может выдавать новые адреса и по-иному описывать отслеживаемые scripts.
Можно ли удалить старый wallet после миграции?
Не удаляйте оригинал до проверки всех адресов, новых резервных копий и возможных исключённых scripts.
Descriptor – это seed-фраза?
Нет. Descriptor описывает набор выходных скриптов и derivation; он может быть публичным или содержать приватный материал, в зависимости от содержимого.
Как определить значение createwallet для моей версии?
Используйте локальную справку RPC и официальную документацию именно установленной версии Bitcoin Core.
Чек-лист: descriptor wallet и legacy wallet в bitcoin core: в чём разница
- версия Bitcoin Core зафиксирована;
- тип кошелька подтверждён;
- исходный backup сохранён;
- миграция понимается как best effort;
- контрольные адреса и скрипты сверены;
- дополнительные кошельки и новые backups учтены;
- старый wallet не удалён преждевременно.
Материал подготовлен редакцией сайта и проверен 3 октября 2026 года. Условия бирж, кошельков и блокчейн-сетей могут меняться. Перед операцией сверяйте данные в интерфейсе выбранного сервиса.