Прийом платежів у 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 успішних проєктів — гарантія коректної роботи інтеграції. Наші інженери мають сертифікати з безпеки смарт-контрактів. Отримайте консультацію інженера — ми оцінимо ваше завдання та запропонуємо оптимальне рішення.