164 / 691BOLT11

BOLT 11

فاتورة موقعة لدفع عبر Lightning

يحمل BOLT 11 شروط دفعة Lightning محددة. صلاحية الفاتورة لا تعني وجود مسار متاح ولا اكتمال الدفع.

BOLT 11 معيار فاتورة Lightning موقعة ومشفّرة ترميزياً بصيغة Bech32. تحتوي payment hash وبيانات المستلم وشروط الدفع؛ إنها طلب وليست دليلاً على نجاح الدفع.

يملك Bech32 مجموع تحقق لأخطاء النسخ، وليس تشفيراً سرياً. يحمي توقيع ECDSA على secp256k1 المحتوى ويربطه بمفتاح المستلم، لا بشخص موثّق. خلافاً لعناوين Bech32 لا يفرض BOLT 11 حد 90 محرفاً. يمكن أن يستخدم QR أحرفاً كبيرة؛ خلط الكبيرة والصغيرة غير صالح. [BOLT 11 — Invoice protocol]

تشير lnbc إلى mainnet وlntb إلى testnet وlntbs إلى signet وlnbcrt إلى regtest. المبلغ بوحدة BTC مع المضاعف m أو u أو n أو p. مع p يجب أن تكون الخانة الأخيرة 0 ليكون المبلغ عدداً صحيحاً من msat؛ كل 1000 msat تساوي satoshi واحداً. غياب المبلغ يعني أن الدافع يحدده، لا دفعة صفرية. [BOLT 11 — Invoice protocol]

يحمل الحقل p قيمة payment hash وهي SHA256 لقيمة payment preimage. ويحمل s قيمة payment_secret التي يطلبها المستلم في الجزء الأخير من الدفع الموجّه. Secret ليس preimage ولا seed المحفظة. يتطلب BOLT 11 الحالي الحقلين؛ قراءة secret من الفاتورة لا تثبت الدفع. [BOLT 11 — Invoice protocol] [BOLT 4 — Onion routing]

تحتوي الفاتورة خياراً واحداً بالضبط: النص d أو تجزئة h لوصف خارجي. مع h يجب على المحفظة التحقق من SHA256 للوصف المقدم؛ التجزئة وحدها لا تشرح المشتريات. يربط التوقيع المحتوى بمفتاح، ولا يثبت صحة وعد التاجر. ينبغي عرض النص المفكوك ترميزياً بأمان بوصفه بيانات. [BOLT 11 — Invoice protocol]

يحدد timestamp مضافاً إليه x وقت الانتهاء؛ دون x المدة الافتراضية 3600 ثانية. الحقل c هو min_final_cltv_expiry_delta لآخر HTLC بوحدة الكتل، وليس مدة أخرى بالثواني؛ عند غيابه يُستخدم ما لا يقل عن 18 كتلة. انتهاء الفاتورة لا يعكس دفعة مكتملة. [BOLT 11 — Invoice protocol]

يحدد الحقل 9 الميزات المطلوبة والاختيارية. البت الزوجي المجهول يستلزم الرفض، والفردي المجهول يُتجاهل؛ ويجب استيفاء اعتماديات الميزات المعروفة. لا يجوز استخدام Basic MPP إلا إذا عُرضت basic_mpp. تقسيم الدفع لا ينشئ فواتير مستقلة متعددة. [BOLT 11 — Invoice protocol] [BOLT 9 — Assigned feature flags]

يضيف الحقل r معلومات routing hints للوصول إلى المستلم؛ وقد يكشف مفاتيح العقد ومعرفات القنوات ومعلمات الرسوم. لا يثبت السيولة الحالية. قد يوفر الحقل الاختياري f عنواناً on-chain، وهو طريقة دفع مختلفة برسوم وتأكيدات خاصة بها. لذلك ليست الفاتورة جهة اتصال خاصة أو قابلة لإعادة الاستخدام إلى الأبد. [BOLT 11 — Invoice protocol] [BOLT 4 — Onion routing]

بعد الإرسال ميّز بين الانتظار والاكتمال. احتفظ بالفاتورة وبـpreimage المطابق كأدلة تسوية، لا بصورة QR فقط. عند فقدان الرد تحقق أولاً من الحالة في المحفظة. قد تؤدي فاتورة جديدة أو طريقة أخرى إلى دفعة إضافية؛ الصيغة وحدها لا توفر حماية شاملة من التكرار. [BOLT 4 — Onion routing] [Core Lightning — Payment result]

للحصول على صورة أوضح، اقرأ هذا المدخل مع Lightning Network, HTLC, BOLT 12, Nostr Wallet Connect, Satoshi. تشير إلى هذا المدخل أيضًا Nostr Wallet Connect, BOLT 12, LNURL, Lightning Address.

DOC · 001BOLT 11 — Invoice protocolمواصفة ↗DOC · 002BOLT 4 — Onion routingمواصفة ↗DOC · 003BOLT 9 — Assigned feature flagsمواصفة ↗DOC · 004Core Lightning — Payment resultتوثيق ↗
المصادر أولًا · ليست نصيحة استثمارية