Документация Bob

Отправка HNS через псевдоним кошелька

Псевдоним кошелька позволяет ввести запоминающееся имя хоста, например @pay.example, вместо вставки адреса Handshake. Bob определяет адрес и проверяет результат перед разрешением платежа.

Предупреждение для Bob LearnHNS 2.3.1: эта версия может отправлять запросы псевдонимов на неверный локальный порт DNS. Обновитесь до Bob LearnHNS 2.3.2 для постоянного исправления. До обновления откройте Settings и задайте Alias Resolver значение 10892, затем вернитесь в Send. Переустановка 2.3.1 проблему не исправляет.

Использование псевдонима

Откройте Send и выберите Send HNS.
Введите полный псевдоним, включая начальный символ @.
Вставьте псевдоним, нажмите Enter, выберите Resolve alias или покиньте поле после ввода, чтобы начать определение адреса.
Дождитесь, пока Bob покажет найденный адрес HNS и значок замка.
Проверьте имя хоста и найденный адрес перед продолжением. Знакомый псевдоним не заменяет проверку платежа.

Как Bob выполняет проверку

Bob убирает используемый только интерфейсом @, запрашивает https://hostname/.well-known/wallets/HNS и проверяет запись TLSA по адресу _443._tcp.hostname. Он принимает полученный адрес HNS, только если сертификат TLS проходит проверку DANE, а адрес подходит для активной сети.

Если HIP-2 не срабатывает, Bob независимо ищет запись TXT того же самого имени хоста, начинающуюся с hns: или hns=. Bob принимает этот результат, только если ответ DNS удостоверен Handshake/DNSSEC, а адрес подходит для активной сети.

Два независимых метода защиты: для хостинга HIP-2 требуется соответствующая запись TLSA. Удостоверенная запись кошелька HNS TXT не использует HTTPS-хостинг, поэтому запись TLSA ей не нужна. Bob всё равно отклоняет неаутентифицированные, некорректные, неоднозначные значения TXT и адреса другой сети.

Значение сообщений об ошибках

Сертификат псевдонима не соответствует его записи TLSA: Владелец псевдонима должен исправить HIP-2. Получаемый пользователями сертификат не соответствует опубликованной записи TLSA. Bob всё ещё может использовать отдельно удостоверенную запись кошелька HNS TXT, если она опубликована; иначе не отправляйте платёж.
Резервная запись TXT псевдонима не удостоверена DNSSEC: Это должен исправить владелец псевдонима. Bob нашёл резервную TXT-запись, но не смог удостоверить её. Не отправляйте платёж до успешной проверки DNSSEC.
Для этого псевдонима не опубликован безопасно проверенный адрес HNS: Это должен исправить владелец псевдонима. У имени хоста нет ни пригодного ответа HIP-2, ни удостоверенной TXT-записи hns:/hns=.
Псевдоним вернул неверный адрес HNS или несколько адресов: Это должен исправить владелец псевдонима. Опубликованное значение некорректно, относится к другой сети, слишком велико или содержит противоречащие друг другу адреса.
Введите полный псевдоним, начинающийся с @: Вы можете это исправить. Используйте полное имя хоста, например @pay.example. Без @ Bob рассматривает ввод как обычный платёжный адрес HNS.
Не удалось связаться с хостом псевдонима: Возможно, вы можете это исправить. Проверьте написание и подключение к интернету, затем повторите попытку. Если сбой только в Bob LearnHNS 2.3.1, используйте описанный выше обходной способ с портом резолвера.
Не удалось выполнить DNS-запрос псевдонима: Сначала проверьте Bob. Убедитесь, что Bob синхронизирован, DNS включён, а Alias Resolver в Settings соответствует порту рекурсивного DNS Bob. В противном случае повторите позже или обратитесь в поддержку.

Список настроек для оператора

Выдавайте один обычный адрес HNS через /.well-known/wallets/HNS по HTTPS.
Опубликуйте удостоверенную DNSSEC запись TLSA по адресу _443._tcp.your-hostname, соответствующую сертификату, который действительно получают пользователи.
Для записи кошелька, независимой от хостинга, опубликуйте одно допустимое значение TXT, например hns:hs1… или hns=hs1…, и обеспечьте успешную проверку Handshake/DNSSEC. Этот метод не требует TLSA.
Проверьте работу извне вашей сети хостинга и для каждого пограничного адреса или региона CDN, который может обслуживать имя хоста.
Следите за продлением сертификата и ротацией ключей. Сертификаты под управлением CDN могут меняться, поэтому поддержка TLSA может требовать автоматизации или стратегии сертификатов со стабильным ключом.

Примеры проверок:

dig +dnssec _443._tcp.your-hostname TLSA
dig +dnssec your-hostname TXT
curl https://your-hostname/.well-known/wallets/HNS

Конфиденциальность и поддержка

Определение адреса псевдонима выполняет DNS- и HTTPS-запросы к его имени хоста, что может раскрыть факт запроса этого имени. Bob не отправляет хосту псевдонима вашу секретную фразу восстановления, закрытые ключи, пароль кошелька или сумму платежа.

Текущие исправленные сборки выводят в терминал безопасные для конфиденциальности строки, например [Bob action] Hip2.fetchAddress failed [ETLSAMISMATCH]. Они показывают операцию и результат, не печатая имя хоста псевдонима, найденный адрес, сумму, пароль, секретную фразу или содержимое транзакции. Терминал также показывает активный локальный порт Alias Resolver в Bob.

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