Lightning-адрес похож на e-mail — например, alice@wallet.example — и позволяет любому платить вам через Lightning, не запрашивая каждый раз новый инвойс. За ним стоит LNURL-pay: кошелёк плательщика просит сервер домена выписать инвойс на выбранную сумму и оплачивает его. Это удобно и многоразово, но означает, что между плательщиком и вами стоит тот, кто управляет доменом. Это не ончейн-адрес Bitcoin, и использовать его там, где нужен адрес bc1…, нельзя.
Что происходит, когда кто-то платит alice@wallet.example
- Кошелёк плательщика превращает адрес в URL:
https://wallet.example/.well-known/lnurlp/alice. - Сервер отвечает JSON: URL обратного вызова, минимум и максимум в миллисатоши и короткое описание.
- Плательщик вводит сумму в пределах лимитов; кошелёк вызывает callback с параметром
?amount=в миллисатоши. - Сервер возвращает инвойс BOLT11 на эту сумму, созданный узлом получателя или кастодиальным провайдером.
- Кошелёк проверяет, что сумма и хеш описания в инвойсе совпадают, и оплачивает его через Lightning.
Всё это описано в документах LNURL (LUD-06 для запросов оплаты, LUD-16 для формы name@domain). Инвойс на шаге 4 — обычный инвойс; декодер инвойсов Lightning покажет сумму и срок, если хотите проверить, что кошелёк собирается оплатить.
Строки LNURL: lnurl1…
До того как форма e-mail стала популярной, ссылки LNURL передавали длинными bech32-строками, начинающимися с lnurl1, или QR-кодами. В раскодированном виде такая строка — просто HTTPS-URL. Тот же механизм покрывает выводы (LNURL-withdraw, которым краны и некоторые биржи дают «вытянуть» средства в кошелёк) и вход (LNURL-auth). Что делать, кошелёк решает по тегу в ответе сервера.
| Формат | Начало | Многоразовый | Нужен веб-сервер |
|---|---|---|---|
| Инвойс BOLT11 | lnbc… | Нет | Нет |
| Ссылка LNURL-pay | lnurl1… | Да | Да |
| Lightning-адрес | name@domain | Да | Да |
| Предложение BOLT12 | lno1… | Да | Нет — запрос идёт через сам Lightning |
| Ончейн-адрес (не Lightning) | bc1… | Технически | Нет |
Как получить Lightning-адрес
Обычно Lightning-адрес выдаёт кошелёк: кастодиальные и ряд некастодиальных кошельков создают адрес на своём домене при регистрации. Операторы узлов могут запустить собственный сервер LNURL или самостоятельно размещаемый инструмент, чтобы адрес был на подконтрольном домене; сервер тогда запрашивает инвойсы у их узла. Некоторые сервисы позволяют направить адрес на личном домене на кошелёк, опубликовав нужное перенаправление. Какой бы путь вы ни выбрали, адрес работает, только пока отвечающий за него сервер в сети.
Некоторые серверы LNURL-pay поддерживают дополнительные возможности из других документов LUD: поле комментария для плательщика, сведения о плательщике или действие после оплаты с сообщением или ссылкой. Кошельки показывают их, если сервер их предлагает; для простого платежа ничего из этого не нужно.
Доверие и приватность
- Инвойсы выписывает владелец домена. Если домен взломан, злоумышленник может отдавать инвойсы, которые платят ему, а не вам. Используйте адреса кошельков и доменов, которым доверяете.
- Кастодиальные адреса. Многие Lightning-адреса выдают кастодиальные кошельки: платежи попадают на счёт, который держит провайдер.
- Сервер видит запросы. Он узнаёт IP-адрес плательщика (если кошелёк не использует прокси) и запрошенные суммы.
- Похожие домены. wallet-example.com и wallet.example — разные серверы. Проверка фишинговых ссылок отмечает типичные приёмы с двойниками.
BOLT12 как альтернатива
BOLT12 добавляет многоразовые платёжные коды в сам протокол Lightning: предложение, начинающееся с lno1, можно оплачивать много раз, а кошелёк плательщика получает свежий инвойс от узла получателя через сообщения Lightning — без веб-сервера и домена. Спецификация вошла в BOLT в 2024 году и поддерживается, в частности, Core Lightning, Eclair и Phoenix; поддержка в других реализациях и кошельках пока неравномерна. Некоторые сервисы публикуют и Lightning-адрес, и предложение BOLT12.
Частые ошибки
- «Amount out of range». Сумма вне minSendable или maxSendable сервера. Лимиты в миллисатоши: 1 000 000 msat — это 1 000 сат.
- «Could not fetch». Сервер недоступен или домен не поддерживает LNURL. Попросите инвойс.
- Оплата Lightning-адреса с биржи. Многие биржи для вывода принимают только инвойсы; создайте инвойс в кошельке получателя.
- Lightning-адрес для выплаты обмена. KOT.CASH выплачивает BTC только ончейн; укажите адрес bc1….
Прежде чем публиковать свой Lightning-адрес, отправьте себе небольшой тестовый платёж из другого кошелька. Так вы убедитесь, что сервер отвечает, лимиты подходят под ожидаемые суммы, а платежи попадают в тот кошелёк, о котором вы думаете.
Частые вопросы
Lightning-адрес — это то же, что e-mail?
Только внешне. Он указывает на сервер LNURL-pay на этом домене, а не на почтовый ящик.
Можно ли получить ончейн-BTC на Lightning-адрес?
Нет. Он возвращает инвойсы Lightning. Для ончейн-BTC дайте адрес bc1….
Чем LNURL отличается от Lightning-адреса?
Lightning-адрес — удобочитаемая форма ссылки LNURL-pay; оба превращаются в инвойс через HTTPS-сервер.
Что такое предложение BOLT12?
Многоразовый платёжный код Lightning (lno1…), который получает инвойсы через сам Lightning, без веб-сервера.
Может ли KOT.CASH выплатить на мой Lightning-адрес?
Нет. KOT.CASH отправляет BTC только ончейн.