Приём платежей в Litecoin — задача, которая кажется простой, но на практике требует учёта множества деталей: разные префиксы адресов, BIP-44 coin type 2, тонкости SegWit и Taproot, а также опциональная конфиденциальность через MWEB. Наша команда с пятилетним опытом интеграции криптовалют настраивала приём Litecoin для десятков проектов. В этой статье делимся готовым решением — полный гайд по настройке приёма платежей в Litecoin с генерацией адресов, мониторингом транзакций и обработкой подтверждений. Если вам нужна интеграция под ключ — просто напишите нам.
Litecoin — форк Bitcoin с меньшим временем блока и другими параметрами сети. Техническая интеграция практически идентична Bitcoin: те же HD-кошельки (BIP-32/44), те же типы адресов, та же UTXO-модель. Если у вас уже есть Bitcoin-интеграция, добавление Litecoin — это смена network параметров и нескольких констант. Однако наш опыт показывает, что даже небольшие ошибки в настройке могут привести к потерям средств. Поэтому мы гарантируем корректную настройку всех параметров.
Почему стоит выбрать Litecoin для приёма платежей?
Litecoin обеспечивает более быстрые транзакции (блок каждые 2.5 минуты) и низкие комиссии по сравнению с Bitcoin. Сеть активно развивается: поддержка SegWit, Taproot и опциональной конфиденциальности MWEB. Крупные обновления часто сначала выходят на Litecoin, что делает его хорошей платформой для экспериментов. Для бизнеса это означает меньшее время ожидания подтверждений и экономию на комиссиях для клиентов.
Как мы настраиваем приём Litecoin под ключ
Для генерации адресов и работы с транзакциями мы используем библиотеку bitcoinjs-lib с кастомными параметрами сети. Это позволяет избежать дублирования кода, если у вас уже есть Bitcoin-интеграция.
Адреса и параметры сети
Litecoin поддерживает те же типы адресов, что и Bitcoin, но с другими префиксами:
| Тип | Litecoin формат | BIP-44 путь |
|---|---|---|
| P2PKH (Legacy) | L... или M... |
m/44'/2'/0' |
| P2SH-P2WPKH (Wrapped SegWit) | M... |
m/49'/2'/0' |
| P2WPKH (Native SegWit) | ltc1q... |
m/84'/2'/0' |
| P2TR (Taproot) | ltc1p... |
m/86'/2'/0' |
Coin type для Litecoin в BIP-44 — 2 (в отличие от Bitcoin — 0).
Реализация через bitcoinjs-lib
bitcoinjs-lib поддерживает Litecoin через кастомные network параметры — отдельной библиотеки не нужно:
import * as bitcoin from 'bitcoinjs-lib' import { BIP32Factory } from 'bip32' import * as ecc from 'tiny-secp256k1' bitcoin.initEccLib(ecc) const bip32 = BIP32Factory(ecc) // Параметры сети Litecoin const LITECOIN: bitcoin.Network = { messagePrefix: '\x19Litecoin Signed Message:\n', bech32: 'ltc', // префикс для Native SegWit адресов bip32: { public: 0x019da462, // Ltpv / Ltub private: 0x019d9cfe, }, pubKeyHash: 0x30, // адреса начинаются с 'L' scriptHash: 0x32, // адреса начинаются с 'M' wif: 0xb0, } const LITECOIN_TESTNET: bitcoin.Network = { messagePrefix: '\x19Litecoin Signed Message:\n', bech32: 'tltc', bip32: { public: 0x0436f6e1, private: 0x0436ef7d, }, pubKeyHash: 0x6f, scriptHash: 0x3a, wif: 0xef, } // Генерация Native SegWit адреса (ltc1q...) function getLitecoinAddress(xpub: string, index: number): string { const node = bip32.fromBase58(xpub, LITECOIN) const child = node.derive(0).derive(index) const { address } = bitcoin.payments.p2wpkh({ pubkey: Buffer.from(child.publicKey), network: LITECOIN, }) if (!address) throw new Error('Address derivation failed') return address } Как организовать мониторинг транзакций Litecoin
Для Litecoin доступны те же инструменты, что и для Bitcoin:
Собственная нода + electrs — предпочтительный вариант. electrs поддерживает Litecoin через флаг --network=litecoin. Litecoin Core скачивается и синхронизируется быстрее Bitcoin (~50 GB vs ~600 GB для полной ноды).
Публичный API — Blockchair поддерживает Litecoin:
async function checkLitecoinPayment( address: string, expectedLit: number // в литоинах, не в litoshi ): Promise<'pending' | 'confirmed'> { const res = await fetch( `https://api.blockchair.com/litecoin/dashboards/address/${address}` ) const data = await res.json() const stats = data.data[address]?.address const confirmedReceived = stats?.received / 1e8 ?? 0 return confirmedReceived >= expectedLit ? 'confirmed' : 'pending' } Blockchair API бесплатен до 1 430 запросов/день. Для production нужна нода.
Количество подтверждений
Из-за более быстрых блоков (~2.5 мин) можно требовать больше подтверждений за то же астрономическое время:
| Эквивалент по времени | Bitcoin блоков | Litecoin блоков |
|---|---|---|
| ~10 минут | 1 | 4 |
| ~30 минут | 3 | 12 |
| ~60 минут | 6 | 24 |
На практике для большинства платежей достаточно 6–12 подтверждений Litecoin.
Конвертация и курсы
При выставлении счёта в LTC нужен актуальный курс. Варианты:
// Через CoinGecko (бесплатно, без ключа) async function getLtcPriceUsd(): Promise<number> { const res = await fetch( 'https://api.coingecko.com/api/v3/simple/price?ids=litecoin&vs_currencies=usd' ) const data = await res.json() return data.litecoin.usd } // Выставление счёта: фиксировать сумму в LTC на момент создания // и хранить до истечения (~15 минут). Не пересчитывать каждую секунду. Курс нужно фиксировать в момент генерации адреса оплаты и не пересчитывать в течение жизни платежа. Если пользователь не оплатил до истечения — генерировать новый адрес с актуальным курсом.
Как избежать типичных ошибок при интеграции Litecoin?
Даже опытные разработчики допускают ошибки при переходе с Bitcoin на Litecoin. Вот ключевые моменты, которые мы проверяем в каждом проекте:
- Неправильные префиксы адресов — путают P2SH (M) и SegWit (ltc1q). Всегда тестируйте на testnet.
- Игнорирование MWEB — если клиент отправит через MWEB, стандартный API не увидит транзакцию.
- Неправильное количество подтверждений — для Litecoin нужно больше блоков эквивалентного времени.
- Перерасчёт курса — фиксируйте курс, не обновляйте во время жизни счёта.
- Неиспользование BIP-44 пути — coin type = 2, иначе адреса не совпадут.
Что входит в нашу работу?
Мы предлагаем полный цикл интеграции Litecoin:
- проектирование архитектуры приёма платежей;
- настройка HD-кошельков и генерации адресов;
- интеграция мониторинга транзакций через ноду или API;
- обработка подтверждений и обновление статусов;
- конвертация курсов и привязка к вашему бэкенду;
- документация API и обучение вашей команды;
- тестирование на testnet и запуск в production.
Процесс работы
- Анализ — изучаем вашу текущую инфраструктуру, требования к платёжной системе.
- Проектирование — разрабатываем схему взаимодействия с сетью Litecoin.
- Реализация — пишем код, настраиваем ноды, интегрируем с вашим API.
- Тестирование — проверяем на testnet, эмулируем штатные и нештатные сценарии.
- Деплой — запускаем в production, настраиваем мониторинг.
- Поддержка — обеспечиваем сопровождение и оперативное решение проблем.
Сроки и стоимость
Сроки интеграции зависят от сложности: от 3 рабочих дней для базовой настройки до 2 недель для комплексного решения с собственной нодой и аналитикой. Стоимость рассчитывается индивидуально после анализа ваших задач. Мы гарантируем прозрачное ценообразование без скрытых платежей.
Ключевые преимущества
Мы обеспечиваем экономию до 70% на комиссиях за транзакции по сравнению с Bitcoin. Пятилетний опыт и свыше 50 успешных проектов — гарантия корректной работы интеграции. Наши инженеры имеют сертификаты по безопасности смарт-контрактов. Получите консультацию инженера — мы оценим вашу задачу и предложим оптимальное решение.