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

Как проверить Lightning-инвойс до оплаты: сумма, срок и получатель

Сверь сеть, сумму, timestamp, expiry и назначение Lightning invoice, подтверди получателя независимо и остановись при несовпадении до оплаты.

Материал подготовлен с помощью ИИ; источники и синтетический расчёт проверены редакцией ZASLON. Платёж не создавался и не отправлялся.

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

До оплаты Lightning invoice проверь сумму и валюту, сеть, время выпуска, срок действия и назначение платежа. Сверь получателя по независимому каналу с тем, кто выставил счёт. Декодирование показывает, какие данные закодированы в invoice; оно не удостоверяет личность продавца и не доказывает, что просить оплату вправе именно этот человек.

Спецификация BOLT-11 задаёт формат Lightning payment request: человекочитаемая часть содержит префикс валюты/сети и необязательную сумму, а данные включают timestamp и expiry. В спецификации сказано, что после timestamp + expiry payer не должен пытаться платить по invoice. Это не то же самое, что статус уже совершённого платежа. Используй проверенный кошелёк или собственную Lightning-нодовую программу; не отправляй invoice неизвестному сайту для декодирования.

Какие поля нужны

Из интерфейса доверенного кошелька/локального декодера выпиши:

  • network/HRP (lnbc для Bitcoin mainnet, lntb для testnet и другие поддерживаемые префиксы);
  • amount (может отсутствовать, тогда сумма задаётся отдельно или правилами приложения);
  • timestamp (время создания, обычно UNIX time в корректном поле/представлении инструмента);
  • expiry (длительность в секундах; проверь фактическое поле в выбранном декодере);
  • description или описание/description hash (если показаны);
  • destination/public node identifier, если инструмент его показывает.

Поля и названия зависят от decoder API. LND DecodePayReq — пример локального API для декодирования invoice своей ноды; использовать чужой публичный endpoint для частного счёта не нужно. Даже destination узла не всегда равен проверенному человеческому имени получателя.

Полный учебный пример

Все данные вымышлены и не образуют платёжный invoice:

Поле Учебное значение Проверка
network Bitcoin mainnet (lnbc) счёт выставлен для Bitcoin mainnet
amount 25 000 sat сравнить с согласованной суммой; 25 000 sat = 0,00025 BTC
timestamp 2026-11-06 12:00:00 UTC время выпуска в вымышленной записи
expiry 3 600 секунд час после выпуска
description «Учебный заказ 204» сверить номер заказа в официальной переписке
destination 03…DEMO учебная заглушка, личность не подтверждает

Время истечения: 12:00:00 UTC + 3 600 секунд = 13:00:00 UTC, 6 ноября 2026 года. Если сейчас 13:05 UTC, этот учебный invoice просрочен; запроси новый. Не пытайся оплатить старый и не считай сам факт истечения доказательством, что платёж был или не был отправлен.

Теперь сравни сумму с запросом продавца. Если invoice показывает 25 000 sat, а согласовано 20 000 sat, остановись. Не рассчитывай, что кошелёк автоматически исправит сумму. Если amount отсутствует, это не обязательно ошибка формата, но сумма должна быть однозначно указана другим способом в доверенном интерфейсе и подтверждена перед платежом.

Проверка от получения до решения

  1. Открой invoice в своём кошельке. Не копируй его в чат или неизвестный сайт. Проверь, что это Lightning payment request, а не похожая строка другого формата.
  2. Проверь сеть и сумму. Убедись, что wallet и получатель ожидают ту же сеть. Пересчитай единицы: BTC, sat и денежная валюта — не одно и то же.
  3. Рассчитай expiry. Возьми timestamp и expiry из декодера, сложи их в одной временной зоне. Если срок истёк или времени не хватает для проверки — запроси новый invoice.
  4. Сверь назначение и получателя отдельно. Спроси продавца через ранее известный канал, что заказ/сумма/назначение актуальны. Нельзя считать описание invoice доказательством личности.
  5. Проверь отображение кошелька перед отправкой. Сумма и получатель должны совпадать с экраном подтверждения. Не подтверждай платёж, если показаны другие данные или маршрут/комиссия неожиданны.
  6. Если платёж уже отправлен — не делай вывод по expiry. Перейди к проверке статуса исходного payment в кошельке/ноде; истечение счёта не отменяет автоматически уже начатую попытку.

Примеры решений и частые ошибки

  • Сумма совпала, но получатель не подтверждён. Не плати; проверь через известный контактный канал.
  • Описание отсутствует. Если уникальный счёт/заказ невозможно сверить другим надёжным способом, запроси перевыпуск с понятным назначением.
  • Invoice expired. Запроси свежий invoice; не меняй timestamp или строку вручную.
  • Осталось мало времени. Не спеши; попроси новый invoice с достаточным сроком.
  • Сумма без явной валюты. Остановись и уточни единицу, сеть и точный размер.
  • Декодер показывает destination. Это данные протокола, не самостоятельная проверка юридического/человеческого имени.
  • Публичный декодер обещает «проверить получателя». Не загружай частный invoice; такой инструмент не может удостоверить продавца только по строке.

Если все поля понятны, адресат подтверждён независимо, срок действителен и экран кошелька совпадает, ты завершил preflight-проверку. Это не гарантия доставки платежа, возврата средств или добросовестности получателя; это проверка намерения до необратимого действия.

Материал подготовлен с помощью ИИ. Для диагностики уже отправленной операции см. как проверить pending crypto transfer. Инвойс и заказ в примере синтетические; платёж не создавался и не отправлялся. Ещё по теме: базовое руководство по Bitcoin.