BITCOIN LIGHTNING

Принимай платежи Lightning.

Подключи кошелёк для приёма, включи его в магазине и дай покупателям платить по QR-коду Lightning.

Подключение к кошельку, не к публичному узлу.

Публичный эндпоинт Bitcoin читает блокчейн, но не может принимать за тебя платежи Lightning. Для Lightning нужен кошелёк, который создаёт счета и сообщает об их окончательной оплате.

Твоя конфигурация	Способ подключения	Кто управляет?
Собственный узел	LND по HTTPS или совместимый NWC-кошелёк	Ты управляешь ключами, каналами, ликвидностью и резервными копиями.
Кошелёк с твоими ключами и обслуживанием провайдера	NWC, например Alby Hub с хостингом	Сервис помогает его запускать. Убедись, что контроль ключей и доступ к восстановлению остаются у тебя.
Кастодиальный аккаунт	NWC-подключение совместимого провайдера	Средства хранит провайдер. Комиссии, лимиты аккаунта и требования проверки зависят от него.

NWC - протокол подключения, а не гарантия владения ключами. Выбери подходящую для бизнеса модель кошелька. Wholly Crypto не хранит средства Lightning и не устанавливает узел.

Подключи свой узел LND.

Открой Настройки → Подключения к сетям → Подключить Lightning. Выбери LND · HTTPS.
Введи доступный извне HTTPS REST-эндпоинт и macaroon с ограниченными правами в шестнадцатеричном формате. Разреши чтение и создание счетов, а также info:read. Добавь offchain:read если хочешь видеть балансы каналов. Никогда не используй admin.macaroon и не давай права на расходование средств.
Если LND использует свой сертификат TLS, вставь его публичный сертификат PEM. Не вставляй закрытый ключ TLS. Разреши доступ с VPS продавца в файрволе узла.
Выбери проекты, которым разрешено подключение. Проверь и сохрани, затем включи его для новых счетов.

Узел должен быть синхронизирован с основной сетью Bitcoin. Проверка TLS остаётся включённой. Подключение принимает только публичные HTTPS-адреса; частные, loopback и зарезервированные адреса блокируются. Держи узел отдельно от платёжного сервера.

Права macaroon LND ↗

Подключение через Nostr Wallet Connect.

В Alby Hub или другом совместимом кошельке создай отдельное подключение для приёма.
Разреши make_invoice, lookup_invoice и get_info. get_balance необязателен. Не разрешай методы оплаты или вывода.
Выбери Nostr Wallet Connect в Wholly Crypto и вставь полную nostr+walletconnect://… строку подключения. Обращайся с ней как с паролем.
Используй один публичный WSS-relay в строке подключения. Выбери модель хранения средств и доступ проектов, затем проверь и сохрани.

Wholly Crypto проверяет подписанные ответы и поддерживает шифрование NIP-44 v2 с совместимостью с прежним NIP-04. Кошелёк должен поддерживать поиск входящих счетов с доказательством оплаты. Не каждый NWC-аккаунт поддерживает все методы приёма.

Инструкция Alby Hub ↗ · Спецификация NWC ↗

Включи для своего магазина.

Открой Проект → Магазины → Способы оплаты → Bitcoin Lightning. Выбери подключение и включи его. Ончейн-Bitcoin - отдельный вариант; можно предложить один или оба.

Создай небольшой счёт вручную или через обычный API. На платёжной странице выбери Bitcoin, затем Bitcoin Lightning. Отсканируй QR-код или открой запрос в Lightning-кошельке. Новый API-маршрут для создания счёта не нужен.

Оплачен - значит окончательно зачислен.

Каждый запрос получает отдельный счёт BOLT11 и хеш платежа. Цена использует фиатную валюту и наценку магазина с округлением вверх до целых сатоши. Wholly Crypto записывает поступления с точностью до миллисатоши.

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

LND использует одну подписку на зачисления на подключение и восстановительные запросы. NWC использует поиск счетов. Ожидающие запросы обычно проверяются примерно каждые 10 секунд; сбои, очереди и лимиты провайдеров могут задерживать обновления. Неоплаченные запросы отслеживаются ещё 24 часа после срока счёта продавца.

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

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

Позаботься о ёмкости и резервных копиях.

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

Текстовая копия кошельков проекта не создаёт копию Lightning. Следуй процедуре восстановления своего узла или кошелька, включая нужные копии каналов. Одной сид-фразы может быть недостаточно для безопасного восстановления средств каналов. Копируй базу Wholly Crypto и ключ шифрования, чтобы сохранить отслеживание счетов и зашифрованные данные подключений.

Восстановление LND ↗

Сначала проверь подключение.

Доступ отклонён: проверь права приёма и действительность ключа доступа.
Не удалось подключиться: проверь HTTPS/WSS, TLS, DNS, файрвол и доступность кошелька.
Запрос недоступен: проверь доступ проекта, включение магазина, актуальность курсов и работу кошелька в основной сети.
Для платежа нет маршрута: проверь входящую ликвидность Lightning-кошелька. Исправное API-подключение не доказывает наличие маршрута.

Проверь небольшой платёж и уведомления, прежде чем предлагать Lightning покупателям. Никогда не отправляй поддержке ключи кошельков, macaroons или секреты NWC.