Кальтер / Блог

Bitcoin descriptor watch-only: что именно видит кошелёк

Разбери, как публичный Bitcoin descriptor задаёт наблюдаемые адреса, что означает timestamp при импорте в Bitcoin Core и почему watch-only не равен возможности тратить.

Материал подготовлен с помощью ИИ; официальная документация Bitcoin Core и синтетический пример проверены редакцией ZASLON. Импорт не выполнялся.

Редакционная схема: Кошелёк для наблюдения. Условные обозначения, не скриншот сервиса или реальной операции.
Редакционная схема: Кошелёк для наблюдения. Условные обозначения, не скриншот сервиса или реальной операции.

Watch-only кошелёк наблюдает за Bitcoin-адресами и транзакциями, соответствующими импортированному публичному descriptor, но сам по себе не даёт права подписывать расходование. Это удобно для отдельного просмотра поступлений, но descriptor может раскрыть адресное семейство и историю. Поэтому сначала реши, где хранить его и какой объём данных готов раскрыть.

В Bitcoin Core 26.0 RPC importdescriptors импортирует один или несколько дескрипторов, а timestamp задаёт начало пересканирования. Значение 0 означает просмотр всей истории; "now" пропускает сканирование для адресов, которые точно не использовались. Импорт требует новой резервной копии кошелька, а длительный rescan может временно показывать неполную историю (документация importdescriptors 26.0). Начиная с Bitcoin Core 0.21 появились descriptor wallets и RPC importdescriptors; эта версия документации не является универсальной инструкцией для всех релизов.

Что понадобится

  • Публичный descriptor, экспортированный из своего кошелька официальным способом. Не вставляй seed, приватный ключ или descriptor с приватными данными в чат или веб-сервис.
  • Отдельный Bitcoin Core descriptor wallet, если выбран именно этот способ просмотра.
  • Безопасная резервная копия до и после изменения кошелька; документация Core прямо указывает, что импорт требует новую backup.
  • Оценка приватности: xpub-подобные публичные данные всё равно могут связать множество адресов и операций.

Упрощённая форма ниже — только невалидная схема для чтения, не импортируй её:

wpkh([FINGERPRINT_PLACEHOLDER/84h/0h/0h]XPUB_PLACEHOLDER/0/*)#CHECKSUM_PLACEHOLDER

Все значения намеренно заменены. Реальный descriptor должен быть корректным для конкретного аккаунта и содержать рассчитанную контрольную сумму. Не пытайся превращать этот пример в рабочий, подставляя случайные строки.

Сквозной синтетический пример

Допустим, команда демонстрационного проекта хочет наблюдать только входящие платежи тестового аккаунта, а не подписывать их. Владелец экспортирует публичный receive descriptor локально и проверяет его в своей версии Core. В этой статье мы его не публикуем и не исполняем.

В отчёте учебной среды после полного rescan могли бы быть строки вроде:

Поле Синтетическое значение
Начало сканирования 2026-01-01T00:00:00Z
Найденная входящая операция TXID_PLACEHOLDER, высота 900000
Получено 0.01200000 BTC
Возможность подписать нет: watch-only наблюдение

Это демонстрирует ожидаемое различие: кошелёк может сопоставлять историю с descriptor и показывать полученную сумму, но без доступных приватных ключей не создаёт подпись для траты. Синтетическая строка не подтверждает реальный блок или баланс.

Как оценить результат

  1. Сверь сеть, аккаунт и тип descriptor с тем кошельком, откуда он экспортирован.
  2. Проверь, завершилось ли сканирование. До конца rescan часть прошлых операций может отсутствовать.
  3. Если нужна полная история, выбери подходящий timestamp. 0 сканирует с начала; слишком поздняя дата может скрыть предыдущие транзакции.
  4. Зафиксируй, кто имеет доступ к descriptor и узлу. Публичный просмотр не равен анонимности: наблюдатель может увидеть связанное адресное пространство.
  5. Храни новую резервную копию кошелька в соответствии с документацией и не публикуй её.

Проверка настройки в Bitcoin Core 26.0

Если работаешь именно с Core, отдельный кошелёк наблюдения создают с disable_private_keys=true и descriptors=true. Это параметры createwallet, а не вывод из названия кошелька. Не меняй существующий рабочий кошелёк ради примера. Выбери свою установленную версию документации: 26.0 здесь служит фиксированной технической точкой отсчёта.

После локального импорта публичного descriptor проверь ответ каждой записи: success: true и отсутствие необъяснённых warnings. Для диапазонного descriptor проверь range; receive-ветвь /0/* не включает автоматически change-ветвь /1/*. Если нужна история всего аккаунта, потребуются обе соответствующие ветви, корректные диапазоны и достаточно ранний timestamp. Полученные ключевые данные остаются локально.

В выбранном кошельке запрос getwalletinfo позволяет проверить настройки. Ниже учебный фрагмент ожидаемого ответа, не результат выполненного RPC:

{
  "walletname": "watch_demo",
  "private_keys_enabled": false,
  "descriptors": true,
  "external_signer": false,
  "scanning": false
}

private_keys_enabled: false подтверждает запрет приватных ключей в этом кошельке. external_signer: false исключает настроенного внешнего подписанта в данном примере. scanning: false означает отсутствие текущего пересканирования, но не доказывает полноту импорта: неверный диапазон или пропущенная change-ветвь всё ещё оставят пробелы.

Для контрольной сверки возьми одну известную тебе прошлую операцию и один известный адрес сдачи, сравни их локально с исходным кошельком. При несовпадении проверяй сеть, ветви, диапазон и дату сканирования; не передавай seed «для восстановления истории». Результат проверки — понятное покрытие нужных ветвей и операций, а не просто ненулевой баланс на экране.

Копируемый запрос к ИИ

Проверь описание watch-only Bitcoin descriptor на техническую точность. Используй только приложенную официальную документацию и явно отделяй факт из источника от вывода. Проверь: что позволяет наблюдать публичный descriptor; означает ли importdescriptors автоматическое наличие права тратить; как timestamp влияет на rescan и полноту истории; какие backup/privacy caveats нельзя опускать. Не проси seed, приватный ключ, xpub или реальные адреса. Верни таблицу «утверждение / подтверждение / неопределённость / безопасная редакция». Если доказательств нет — напиши «не подтверждено».

Что материал не доказывает

Он не подтверждает, что любой descriptor совместим с любой версией Bitcoin Core, что отображённая история полна до окончания сканирования или что публичный descriptor безопасно раскрывать. Это инструкция для понимания watch-only принципа, не совет импортировать чужие ключевые данные. Для основ кошельков см. гайд по Bitcoin и безопасность seed-фразы.

Материал подготовлен с помощью ИИ. Descriptor и таблица вымышлены; импорт, rescan и транзакции не выполнялись.