Устранение проблем в Ginger Wallet

Уровень чтения: повседневное использование. Обратитесь к этому руководству, когда вам нужно выполнить описанную задачу.

Начните с точного текста ошибки, выбранного кошелька, сети и версии приложения. Сохраните сведения для восстановления и файлы кошелька, прежде чем менять данные. Переустановка, удаление каталогов или создание новых слов редко являются первым шагом при проблемах подключения или отображения.

Баланс, восстановление и получение

Симптом	Что проверить сначала	Следующий шаг
Восстановленный кошелёк пуст	Исходные слова, точную парольную фразу, сеть и ход сканирования	После синхронизации сравните известные адреса или историю; используйте углублённые проверки восстановления, только если обычные проверки не объясняют проблему
Нет входящего платежа	Правильность адреса, идентификатор транзакции отправителя и выбранный кошелёк	Проверьте публикацию и подтверждение, затем локальную синхронизацию
Нет Receive или Send	Продолжается ли восстановление? Является ли кошелёк кошельком только для наблюдения?	Дождитесь восстановления или используйте требуемое подписывающее устройство
Старый адрес исчез из списка получения	Поступили ли на него средства или был ли он скрыт?	Проверьте историю; видимость в списке не определяет действительность ключей
Отсутствует только очень маленький платёж	Порог пыли и синхронизацию	Сверьте настроенный порог, прежде чем предполагать кражу средств
После восстановления из seed исчезли метки	Была ли резервная копия соответствующего файла ATTR?	Сохраните этот файл; метки нельзя воссоздать из блокчейна

Не вводите слова восстановления на сайте для «повторной синхронизации» кошелька. Используйте процедуру восстановления установленного и проверенного кошелька только на компьютере, которому доверяете.

Подключение или синхронизация

Проверьте связь, часы компьютера, свободное место и состояние настроенного полного узла. Первому сканированию может просто требоваться время. Если продвижение совсем не меняется, закройте Ginger обычным способом и откройте снова один раз. Запишите, что происходит, вместо многократного перезапуска сканирования.

Awaiting connection может препятствовать CoinJoin и другим сервисам, даже если в кошельке есть сохранённая история. Считайте баланс без подключения потенциально неполным. Не выключайте Tor при выяснении причин. P2P-подключение настроенного узла и оценки комиссий через RPC независимы; работа одного не доказывает, что другое тоже работает.

Если вы используете Wallet Settings → Tools → Resync, сначала сохраните резервные копии и ожидайте нового сканирования. Не удаляйте Wallets, WalletBackups или файлы 2FA только ради исчезновения сообщения о ходе выполнения.

При запуске сообщается о неверной конфигурации

В v2.0.27 Ginger останавливает запуск, если не может загрузить Config.json, сохраняя исходный файл. Ошибка указывает его путь. По возможности Ginger создаёт рядом отдельный Config.Default.json как шаблон настроек по умолчанию; уже существующий шаблон также сохраняется. Эта ошибка относится к настройкам приложения и сама по себе не означает повреждения кошелька или его ключей.

1. Закройте Ginger и сохраните папку данных и резервные копии кошелька перед изменением файлов. Сделайте отдельную копию исходного Config.json.
2. Если вы разбираетесь в конфигурации, сравните её с Config.Default.json и исправьте неверный JSON или значение настройки. Шаблона может не быть, если Ginger не смог его записать.
3. Чтобы намеренно запустить приложение с настройками по умолчанию, переименуйте исходный Config.json, например в Config.before-repair.json, и сохраните его. Перезапустите Ginger, чтобы создать новый Config.json.
4. Проверьте настройки сети, Tor, полного узла и другие пользовательские настройки перед возвращением к обычной работе. Переименование этого файла настроек не восстанавливает забытую парольную фразу и не заменяет резервных копий кошелька. Оставьте Wallets, WalletBackups и файлы 2FA нетронутыми.

Если настройки запуска Windows раньше вызывали ошибку, v2.0.27 обрабатывает отсутствие записи автозапуска в реестре. После обновления проверьте Settings → General → Run Ginger when computer starts.

JSON-RPC не запускается

Эта проверка относится к случаям, когда вы явно включили сервер JSON-RPC кошелька Ginger. В v2.0.27 оба параметра JsonRpcUser и JsonRpcPassword должны содержать непустые значения; строки только из пробелов отклоняются. Без них сервер RPC отказывается запускаться и записывает причину в журнал, а приложение кошелька продолжает работать.

Закрыв Ginger, задайте оба учётных параметра в Config.json и настройте подключающийся клиент на их использование. Если сервер вам не нужен, вместо этого установите JsonRpcServerEnabled в false. Не включайте учётные данные в публикуемые журналы и обращения в поддержку. Это настройки RPC кошелька Ginger, отдельные от учётных данных RPC узла Bitcoin Core и парольной фразы кошелька.

CoinJoin не запускается

Сообщение или условие	Вероятное действие
Insufficient funds eligible for coinjoin	Проверьте подтверждения, суммы монет, комиссии и исключения; один общий баланс не определяет пригодность
Only excluded funds are available	Проверьте Exclude Coins, если хотите разрешить участие некоторым монетам
Only immature funds are available	Дождитесь необходимого числа подтверждений; недавно добытые выходы имеют особые правила расходования
Some funds are rejected from coinjoining	Прочитайте причину и текущие условия сервиса; отклонение не передаёт право собственности на ваши средства
Awaiting cheaper coinjoins	Проверьте предпочтения по стоимости и решите, соответствует ли ожидание вашей цели
Coinjoin may be uneconomical	Проверьте порог остановки и относительные затраты, прежде чем вручную обходить ограничение
Awaiting the blame round	Дождитесь повторной попытки протокола; это не указание обвинять другого пользователя
Awaiting closure of send dialog	Завершите или закройте процедуру отправки
Mining fee rate was too high или Coordination fee rate was too high	Подождите или изучите предложенные условия; не повышайте ограничения вслепую
Аппаратный кошелёк как источник средств	Автоматическая подпись CoinJoin требует подходящего программного кошелька

Участники раунда могут не завершить свои действия, а после прерванного участия монета может стать временно недоступной. Многократные повторные попытки, импорты или попытки обойти отказ координатора не являются исправлением. На основе причины и текущего состояния решите, следует ли ждать или обратиться в официальную поддержку.

Версия 2.0.27 исправляет аварийное завершение macOS при остановке CoinJoin. Если Ginger закрывается во время участия, откройте его снова, дождитесь синхронизации кошелька и изучите историю, прежде чем считать транзакцию неудачной. Закрытие приложения не отменяет уже переданную в сеть транзакцию. Запишите повторяющуюся ошибку и установленную версию для обращения в поддержку.

Проблемы платежей или комиссий

Когда оценки комиссий недоступны, подождите, восстановите соединение с выбранным поставщиком или узлом либо используйте понятную вам ставку комиссии, выбранную вручную. Убедитесь, что итоговая сумма вместе с комиссиями укладывается в доступные для расходования средства. Длинная цепочка неподтверждённых транзакций может потребовать ожидания подтверждений предыдущих транзакций.

Используйте Speed Up Transaction или Cancel Transaction, только когда Ginger предлагает эту возможность и вы проверили комиссию. Отмена — это попытка заменить ожидающий платёж, а не отмена уже подтверждённого платежа. Если результат передачи в сеть неясен, проверьте историю, прежде чем заплатить дважды.

2FA и аппаратные устройства

Если код аутентификатора отклоняется, проверьте время телефона, выбранную запись, совместимость аутентификатора с Ginger и связь через Tor с сервисом. Сохраните существующие файлы кошелька и 2FA. Если обычный запуск восстановить не удаётся, слова восстановления и исходная парольная фраза служат независимой резервной копией ключей; переустановка поверх тех же данных не воссоздаёт потерянный аутентификатор. Углублённые вопросы объясняют зависимость от файлов.

Для обнаружения устройства используйте один разблокированный аппаратный кошелёк, кабель передачи данных и прямое USB-подключение, закрыв другие приложения, работающие с устройством. Выполните требуемые на устройстве шаги с приложением Bitcoin, PIN или парольной фразой. В Linux проверьте разрешения USB согласно инструкциям производителя. Не переносите seed устройства на компьютер.

Полезное сообщение о проблеме

Используйте ссылки из официального репозитория Ginger. Укажите версию выпуска, операционную систему и процессор, точную ошибку, ожидаемый результат и самые короткие шаги воспроизведения, не содержащие секретов. Когда это имеет значение, укажите модель аппаратного устройства и прошивку.

Действие Logs в поиске Ginger открывает диагностические журналы. Просмотрите их и удалите чувствительные сведения перед отправкой: пути, адреса, идентификаторы транзакций, метки и сведения о заказах могут быть конфиденциальными. Поделитесь минимальным относящимся к делу фрагментом, а не всем каталогом данных. Публичное сообщение о проблеме общедоступно; ни одно обращение в поддержку не должно требовать ваши слова восстановления или парольную фразу.