Разработка Lightning-канала для мгновенных платежей

Разработка Lightning-каналов для мгновенных платежей

Lightning Network решает конкретную проблему Bitcoin: on-chain транзакция занимает 10–60 минут и стоит $1–50 в зависимости от congestion mempool. Для микроплатежей, стриминга сатоши, или платёжных систем с высокой частотой транзакций — это неприемлемо. Lightning даёт подтверждение за секунды и комиссии в единицы сатоши.

Как работают каналы: техническая суть

Lightning-канал — это мультисиг 2-of-2 на блокчейне с набором off-chain транзакций, подписанных обеими сторонами. Открытие канала — одна on-chain транзакция (funding tx). Все последующие платежи внутри канала — обмен подписанными состояниями, ничего не уходит в блокчейн.

Безопасность обеспечивает HTLC (Hash Time-Locked Contract): получатель платежа знает preimage секрета, чей хэш зафиксирован в контракте. Платёж проходит по цепочке узлов, каждый раскрывает preimage только при получении средств — это атомарность без доверия.

Закрытие канала — финальная on-chain транзакция с последним согласованным балансом. Если одна из сторон пытается broadcast старое (выгодное для себя) состояние — другая сторона может оспорить через penalty transaction в течение to_self_delay блоков.

Выбор LN реализации

LND — де-факто стандарт для server-side приложений. Хорошая документация, богатый API, широкая экосистема инструментов (LNbits, RTL, Thunderhub). Выбор по умолчанию если нет специфических требований.

Развёртывание LND

Инфраструктура

LND требует Bitcoin Core ноды (или Neutrino для light client, но не для production):

# bitcoin.conf — требования от LND
server=1
txindex=1
zmqpubrawblock=tcp://127.0.0.1:28332
zmqpubrawtx=tcp://127.0.0.1:28333
rpcuser=bitcoin
rpcpassword=secure_password

# lnd.conf
[Application Options]
alias=YourNodeName
color=#FF6600
maxpendingchannels=5

[Bitcoin]
bitcoin.active=1
bitcoin.mainnet=1
bitcoin.node=bitcoind

[Bitcoind]
bitcoind.rpchost=127.0.0.1
bitcoind.rpcuser=bitcoin
bitcoind.rpcpass=secure_password
bitcoind.zmqpubrawblock=tcp://127.0.0.1:28332
bitcoind.zmqpubrawtx=tcp://127.0.0.1:28333

[routing]
routing.assumechandb=true  # Ускоряет первый старт

Минимальные требования для production LND: 2 CPU, 4GB RAM, 50GB SSD (плюс место под Bitcoin Core).

Первоначальная настройка через lncli

# Создать кошелёк (один раз)
lncli create
# ВАЖНО: сохранить seed phrase в cold storage!

# Разблокировать при каждом запуске
lncli unlock

# Проверить синхронизацию
lncli getinfo | jq '.synced_to_chain, .block_height'

# Получить on-chain адрес для пополнения
lncli newaddress p2wkh

API интеграция: создание и приём платежей

Приём платежей (создание invoice)

import grpc, codecs
import lnd_pb2 as ln
import lnd_pb2_grpc as lnrpc

def get_lnd_stub():
    # Загружаем TLS сертификат и macaroon
    with open('/home/lnd/.lnd/tls.cert', 'rb') as f:
        cert = f.read()
    with open('/home/lnd/.lnd/data/chain/bitcoin/mainnet/invoice.macaroon', 'rb') as f:
        macaroon = codecs.encode(f.read(), 'hex').decode()

    creds = grpc.ssl_channel_credentials(cert)
    channel = grpc.secure_channel('localhost:10009', creds)

    # Добавляем macaroon к каждому запросу
    def macaroon_interceptor(continuation, client_call_details, request_iterator):
        client_call_details.metadata.append(('macaroon', macaroon))
        return continuation(client_call_details, request_iterator)

    return lnrpc.LightningStub(channel)

stub = get_lnd_stub()

def create_invoice(amount_sats: int, memo: str, expiry_seconds: int = 3600) -> dict:
    invoice = stub.AddInvoice(ln.Invoice(
        value=amount_sats,
        memo=memo,
        expiry=expiry_seconds
    ))
    return {
        "payment_hash": codecs.encode(invoice.r_hash, 'hex').decode(),
        "payment_request": invoice.payment_request,  # BOLT11 строка для QR кода
        "add_index": invoice.add_index
    }

Отслеживание оплаты

def subscribe_invoices(callback, settle_index: int = 0):
    """Стримим все новые и обновлённые invoices"""
    request = ln.InvoiceSubscription(settle_index=settle_index)
    for invoice in stub.SubscribeInvoices(request):
        if invoice.state == ln.Invoice.SETTLED:
            callback({
                "payment_hash": codecs.encode(invoice.r_hash, 'hex').decode(),
                "amount_sats": invoice.amt_paid_sat,
                "settled_at": invoice.settle_date,
                "memo": invoice.memo
            })

Отправка платежей

def pay_invoice(payment_request: str, fee_limit_sats: int = 50) -> dict:
    response = stub.SendPaymentSync(ln.SendRequest(
        payment_request=payment_request,
        fee_limit=ln.FeeLimit(fixed=fee_limit_sats),
        timeout_seconds=30
    ))

    if response.payment_error:
        raise RuntimeError(f"Payment failed: {response.payment_error}")

    return {
        "payment_preimage": codecs.encode(response.payment_preimage, 'hex').decode(),
        "payment_hash": codecs.encode(response.payment_hash, 'hex').decode(),
        "fee_sats": response.payment_route.total_fees
    }

Управление ликвидностью каналов

Самая сложная операционная задача в Lightning — ликвидность. Канал имеет две стороны: local balance (можем отправлять) и remote balance (можем принимать). Новый канал: local = вся сумма, remote = 0. Нужен баланс.

Открытие каналов

# Открыть канал с известным узлом (например, Bitfinex)
lncli openchannel \
  --node_key 033d8656219478701227199cbd6f670335c8d408a92ae88b176106c4db4a290f0 \
  --local_amt 5000000 \
  --push_amt 2500000  # сразу передаём половину на другую сторону

push_amt — начальный перевод партнёру при открытии канала. Это способ получить remote balance сразу, но технически вы отдаёте деньги.

Rebalancing через circular payments

Если local balance истощился — нужен rebalancing:

# Установить bos (Balance of Satoshis) для удобного управления
npm install -g balanceofsatoshis

# Автоматический rebalance: переливаем через внешний маршрут
bos rebalance --max-fee-rate 100 --minutes 60

Или через Loop (Lightning Labs): Loop Out — отправляем сатоши on-chain со своего LN канала, получаем on-chain BTC и создаём новую ликвидность.

Inbound ликвидность

Чтобы принимать платежи — нужен remote balance. Способы получить:

1. LSPS (Lightning Service Provider Spec) — провайдеры открывают канал к вам с готовой inbound ликвидностью (за комиссию). Провайдеры: Voltage, Amboss, Olympus.
2. Торговые отношения — открываете канал к крупному узлу с push_amt, они открывают к вам в ответ.
3. Submarine swaps — получаете on-chain BTC, он конвертируется в inbound LN ликвидность через Loop In.

Мониторинг ноды

# Установить Thunderhub или RTL (Ride The Lightning) — web UI для управления
docker run -p 3000:3000 \
  -v /home/lnd/.lnd:/lnd \
  apotdevin/thunderhub:latest

# Алерты через Grafana + Prometheus (lnd metrics endpoint)
lncli --grpc-listening-port 8080  # включить metrics

Ключевые метрики для мониторинга: channel balance (local vs remote), количество pending HTLC, channel capacity утилизация, routing fee revenue.

Сроки

Деплой production LND ноды с базовыми каналами, gRPC API интеграцией и мониторингом: 1–2 недели. Сложная платёжная система с автоматическим rebalancing, LSP интеграцией и высокой доступностью: 3–5 недель.