LNURL عائلة إجراءات تطبيقية اختيارية لـLightning موثقة في LUD. تنقل المعلمات والطلبات بين المحفظة والخدمة؛ وليست قاعدة إجماع Bitcoin أو تفويضاً شاملاً.
يتضمن LNURL كلاً من payRequest للدفع وwithdrawRequest للسحب وlogin للدخول، إضافة لامتدادات أخرى. تدعم المحافظ مجموعات مختلفة من LUD. عبارة «يدعم LNURL» لا تعني عمل كل العمليات أو تساوي أثر الموافقة عليها. [LNURL — LUD index] [Lightning Labs — LNURL glossary]
يرمز LNURL الأساسي وفق LUD-01 رابط HTTPS أو onion باستخدام Bech32. ليس تشفيراً سرياً ولا فاتورة BOLT 11. يحدد tag في URL أو في JSON بعد GET نوع العملية. يجب أن تتعرف المحفظة على النطاق والعملية؛ مظهر QR وحده لا يثبت المستلم. [LNURL — LUD-01 encoding]
يعيد payRequest حقول callback وminSendable وmaxSendable وmetadata. الحدود وamount المختار بوحدة msat؛ كل 1000 msat تساوي satoshi واحداً. بعد الموافقة على الشروط تطلب المحفظة فاتورة في pr وتتحقق من المبلغ قبل الدفع. الرابط الثابت ليس دليلاً على الدفع. [LNURL — LUD-06 payRequest]
Metadata سلسلة نصية تحتوي مصفوفة JSON مع سجل text/plain إلزامي، والأنواع الأخرى اختيارية. اقرأ الوصف مع النطاق والمبلغ. يفسر LNURL الأساسي جسم JSON، لا رمز HTTP وحده؛ ERROR أو تلقي فاتورة pr لا يعني دفعاً ناجحاً. [LNURL — LUD-01 encoding] [LNURL — LUD-06 payRequest]
يعيد withdrawRequest حقول k1 وcallback وحدود minWithdrawable/maxWithdrawable بوحدة msat. تنشئ محفظتك فاتورة استقبال وترسلها كـpr إلى الخدمة التي يجب أن تدفعها. Status OK يقر بالطلب؛ والمحفظة ما زالت تنتظر وصول المال. قد يحمل رابط السحب إذناً، فلا تتعامل معه كجهة اتصال عامة للدفع. [LNURL — LUD-03 withdrawRequest]
يستخدم LNURL-auth مع tag login التحدي k1 ومفتاح linkingKey خاصاً بالنطاق. بعد الموافقة توقّع المحفظة باستخدام ECDSA على secp256k1 دون إرسال seed إلى الخدمة. قد تعني Action التسجيل أو الدخول أو الربط أو تفويضاً آخر. التوقيع ليس دفعة bitcoin ولا إثباتاً تلقائياً لهوية شخص. [LNURL — LUD-04 authentication]
يحمي HTTPS النقل، لكن الخدمة قد تعرف الطلبات وتوقيتها. يمكن ربط الاستخدامات المتكررة. يشتق auth المفتاح من اسم النطاق الكامل؛ تغيير النطاق الفرعي يغير linkingKey وقد يؤدي إلى حساب مختلف. قابلية نقل الدخول بين المحافظ غير مضمونة لاختلاف الاشتقاق. LNURL لا يحدد حيازة bitcoin. [LNURL — LUD-01 encoding] [LNURL — LUD-04 authentication]
يضيف LUD-21 الاختياري رابط verify؛ ويميز الرد بين settled true/false وقد يعيد preimage. Status OK وحده لا يعني settled true. تحقق من ارتباطه بالفاتورة المحددة وحالة المحفظة. عند فقدان الرد لا تدفع مجدداً بلا تحقق؛ التوفر وسيولة الاستقبال ونطاق الموافقة شروط مستقلة. [LNURL — LUD index] [LNURL — LUD-21 verification]
للحصول على صورة أوضح، اقرأ هذا المدخل مع BOLT 11, BOLT 12, Lightning Network, Lightning Address, خصوصية Bitcoin, Satoshi. تشير إلى هذا المدخل أيضًا BOLT 12, Lightning Address, Confirmo.