שילוב LND: הגדרת gRPC/API, ניהול נזילות, LNURL

Lightning Network פותר את הבעיה הבסיסית של ביטקוין: עסקאות on-chain יקרות (עד $100 להעברה) ואיטיות (10–60 דקות). דמיינו שירות מיקרופיימנט — כל תשלום של $0.01 דורש עמלה גדולה פי 1000. עם Lightning Network Daemon מ-Lightning Labs, העמלות יורדות ל-1–10 סאטושי ($0.0001–0.001), והאישור לוקח שניות. אבל אינטגרציה של Bitcoin Lightning דרך LND אינה טריוויאלית: צריך להגדיר לקוח gRPC עם אימות macaroon, לנהל נזילות ערוצים, וליישם עיבוד תשלומים ללא הפסדים. לצוות שלנו יש ניסיון של למעלה מ-5 שנים: חיברנו LND לשערי תשלום, בורסות ויישומי DeFi. בשעות שיא, עמלות on-chain יכולות לעלות על $100 להעברה — Lightning מפחית אותן לשברי סנט, ומשיג חיסכון של עד 99.98% בעלויות. לפי Lightning Labs, יישום LND יכול לחסוך עד 99% בעלויות עסקאות. לעסק שמעבד 10,000 עסקאות בחודש, מעבר מ-on-chain ($50 לעסקה) ל-Lightning ($0.01 לעסקה) מביא לחיסכון חודשי של $499,990. בואו נצלול לפרטים הטכניים.

מה זה LND ואיך זה עובד

LND הוא צומת תוכנה לרשת Lightning. הוא דורש:

• צומת ביטקוין מסונכרן (Bitcoind או מצב אור neutrino)
• ערוצי תשלום פתוחים עם עמיתים ברשת
• ניהול נזילות: כספים בצד שלך של הערוץ לתשלומים יוצאים, ובצד הנגדי לתשלומים נכנסים

ערוצי תשלום הם חוזי multisig מסוג 2-מתוך-2 על ביטקוין L1. LND מנהל את מצב הערוץ off-chain, ומפרסם רק פתיחה וסגירה של ערוצים לבלוקצ'יין. תשלומים מבוססי חשבוניות: המקבל יוצר חשבונית (בקשת תשלום BOLT-11), והמשלם משלם אותה. החשבונית מכילה hash תשלום — מנגנון HTLC מבטיח אטומיות.

אילו APIs מספק LND לאינטגרציה?

LND מציע שני APIs: gRPC (ראשי, עם כל הפונקציונליות) ו-REST (עטיפה). לייצור — gRPC, שמבצע פי 10 טוב יותר מ-REST בתרחישים של תפוקה גבוהה. השוואה:

אימות באמצעות תעודת TLS + macaroon (טוקן מבוסס הרשאות):

import * as grpc from '@grpc/grpc-js'; import * as protoLoader from '@grpc/proto-loader'; import fs from 'fs'; const TLS_CERT = fs.readFileSync('/home/bitcoin/.lnd/tls.cert'); const MACAROON = fs.readFileSync('/home/bitcoin/.lnd/data/chain/bitcoin/mainnet/admin.macaroon'); const sslCreds = grpc.credentials.createSsl(TLS_CERT); const macaroonCreds = grpc.credentials.createFromMetadataGenerator((_, callback) => { const metadata = new grpc.Metadata(); metadata.add('macaroon', MACAROON.toString('hex')); callback(null, metadata); }); const credentials = grpc.credentials.combineChannelCredentials(sslCreds, macaroonCreds); const packageDef = protoLoader.loadSync('rpc.proto', { keepCase: true }); const lnrpc = grpc.loadPackageDefinition(packageDef) as any; const lightning = new lnrpc.lnrpc.Lightning('localhost:10009', credentials); 

Macaroon הוא לא רק טוקן — זה אימות מבוסס הרשאות. אפשר ליצור invoice.macaroon (יצירת חשבוניות בלבד), readonly.macaroon (קריאה בלבד), או כאלה מותאמות עם הגבלות IP וזמן. לעולם אל תחשוף admin.macaroon ליישומים — רק הרשאות מינימליות נדרשות.

פעולות ליבה

יצירת חשבונית (קבלת תשלום)

function addInvoice(amountSats: number, memo: string): Promise<Invoice> { return new Promise((resolve, reject) => { lightning.AddInvoice({ value: amountSats, memo, expiry: 3600, }, (err: any, response: any) => { if (err) reject(err); else resolve({ paymentRequest: response.payment_request, rHash: response.r_hash.toString('hex'), addIndex: response.add_index.toString(), }); }); }); } 

המחרוזת BOLT-11 מתחילה ב-lnbc (mainnet) או lntb (testnet). זה מה שהמשתמש סורק עם הארנק שלו.

מעקב אחר תשלומים נכנסים שתי גישות: Polling — LookupInvoice לפי r_hash. פשוט אבל לא אופטימלי. מנויי סטרימינג — SubscribeInvoices מזרים את כל העדכונים בזמן אמת:

function subscribeInvoices(onSettled: (invoice: SettledInvoice) => void) { const stream = lightning.SubscribeInvoices({ settle_index: 0, }); stream.on('data', (invoice: any) => { if (invoice.state === 1) { onSettled({ rHash: invoice.r_hash.toString('hex'), amountPaidSats: Number(invoice.amt_paid_sat), settledAt: Number(invoice.settle_date), memo: invoice.memo, }); } }); stream.on('error', (err: Error) => { setTimeout(() => subscribeInvoices(onSettled), 5000); }); } 

חשוב: יש לשמור settle_index. בעת הפעלה מחדש של היישום, הירשם מ-settle_index האחרון שעובד, אחרת תפספס תשלומים שהתקבלו בזמן השבתה.

תשלומים יוצאים

async function sendPayment(paymentRequest: string): Promise<string> { return new Promise((resolve, reject) => { const routerStub = new lnrpc.routerrpc.Router('localhost:10009', credentials); const stream = routerStub.SendPaymentV2({ payment_request: paymentRequest, timeout_seconds: 60, fee_limit_sat: 100, max_parts: 4, }); stream.on('data', (payment: any) => { if (payment.status === 2) { resolve(payment.payment_preimage.toString('hex')); } else if (payment.status === 3) { reject(new Error(`Payment failed: ${payment.failure_reason}`)); } }); }); } 

SendPaymentV2 (router RPC) עדיף על SendPayment הישן — הוא תומך ב-MPP (תשלומים מרובי נתיבים) ומטפל טוב יותר בשגיאות ניתוב.

תוכנית אינטגרציה של LND שלב אחר שלב

1. הגדרת צומת ואימות. פרוס צומת LND (mainnet/testnet) או התחבר לקיים. צור תעודת TLS ו-macaroon עם הרשאות מינימליות (למשל, invoice.macaroon לקבלת תשלומים). ודא שהצומת מסונכרן והערוצים פתוחים.

2. יישום לקוח gRPC. השתמש בהגדרות protobuf ממאגר LND. הגדר אישורים משולבים (TLS + macaroon). הוסף לוגיקת התחברות מחדש עם backoff אקספוננציאלי.

3. טיפול בתשלומים. יישם יצירת חשבוניות (AddInvoice) ומנוי לאירועי settle (SubscribeInvoices) עם settle_index מתמשך. לתשלומים יוצאים, השתמש ב-SendPaymentV2 עם תמיכת MPP.

4. ניהול נזילות וניטור. הגדר איזון ערוצים אוטומטי באמצעות charge-lnd או bos. חבר ניטור (Prometheus + Grafana) למעקב אחר יתרות וזמינות.

קבל ייעוץ לפרויקט שלך — נעזור להעריך את היקף העבודה.

למה ניהול נזילות הוא קריטי

זו משימה תפעולית מתמשכת. הבעיות העיקריות:

• נזילות נכנסת: כדי לקבל תשלומים, אתה צריך נזילות בצד העמית של הערוץ. צומת חדש לעיתים קרובות לא יכול לקבל תשלומים. פתרונות: ספקי שירותי Lightning (Bitrefill Thor, Loop In, Amboss Magma) — השכרת נזילות נכנסת בתשלום; פתח ערוץ בכיוון ההפוך.
• איזון ערוצים: עם הזמן, ערוצים הופכים לא מאוזנים — כל הכספים בצד אחד. LND loop out — החלפת submarine לאיזון: מזיז כספי Lightning ל-on-chain, ומחלק מחדש. משמש אוטומטית על ידי כלים כמו charge-lnd או bos (Balance of Satoshis).
• מדיניות עמלות: לניתוב תשלומים של אחרים דרך הצומת שלך, אתה גובה base_fee + fee_rate. הגדרות עמלות נכונות משפיעות על יעילות הניתוב.

איך לעקוב אחר תשלומים ב-LND

כבר כיסינו שתי שיטות: polling וסטרימינג. לייצור, השתמש בסטרימינג עם settle_index מתמשך. זה מבטיח שאף תשלום לא הולך לאיבוד. בזמן השבתה, היישום מחדש את המנוי מהאינדקס האחרון.

LNURL ואינטגרציית ארנקים

LNURL הוא הרחבת פרוטוקול על גבי LN. סוגים מרכזיים:

דוגמת backend ל-LNURL-pay:

app.get('/.well-known/lnurlp/:username', async (req, res) => { res.json({ callback: `https://yourdomain.com/lnurlp/${req.params.username}/pay`, maxSendable: 100_000_000, minSendable: 1_000, metadata: JSON.stringify([['text/plain', `Pay ${req.params.username}`]]), tag: 'payRequest', }); }); app.get('/lnurlp/:username/pay', async (req, res) => { const { amount } = req.query; const invoice = await createInvoice(Number(amount) / 1000); res.json({ pr: invoice.paymentRequest, routes: [] }); }); 

מה כלול באינטגרציה

אינטגרציית LND סטנדרטית כוללת:

• הגדרה או חיבור לצומת LND קיים
• לקוח gRPC עם אימות TLS + macaroon
• יצירת חשבוניות ומנוי לתשלומים נכנסים עם settle_index מתמשך
• עיבוד תשלומים יוצאים עם תמיכת MPP
• נקודת קצה LNURL-pay (אם נדרש)
• טיפול בסיסי בשגיאות ולוגיקת התחברות מחדש

החלק התפעולי (ניהול ערוצים, נזילות) הוא נושא נפרד, תלוי בהיקף זרימת התשלומים. אנחנו תומכים בפרויקטים, ומבטיחים יציבות תשתית.