شرح Nostr Wallet Connect (NWC)

قبل Nostr Wallet Connect، كان على كل عميل Nostr أن يبني تكامل المحفظة الخاص به، أو يُطلق النسخة بدون وظيفة الإشارات المالية على الإطلاق. أنتج هذا نتيجتين سيئتين: العملاء الذين أطلقوا الإشارات المالية اضطروا إلى تشغيل محفظة، والعملاء الذين لم يريدوا تشغيل محفظة لم يتمكنوا من دعم الإشارات المالية.

أصلح NWC هذا بفصل المحفظة عن العميل. المحفظة هي تطبيقها الخاص؛ يرسل العميل طلبات الإنفاق عبر Nostr نفسه؛ الجميع رابحون.

إذا كنت تستخدم الإشارات المالية على أي عميل بدون محفظة مدمجة، فأنت تستخدم NWC سواء فكرت في الأمر أم لا. يجعل هذا الدليل الآلية صريحة حتى تفهم ما تفعله سلسلة الاتصال، وما هي حدودها، وكيفية إلغاء الاتصال.

الملخص السريع. NWC هو بروتوكول (NIP-47) لعميل Nostr لطلب محفظة Lightning لدفع الفواتير. الاقتران هو سلسلة تبدو مثل nostr+walletconnect://.... تمنح السلسلة إذن الإنفاق بحد أقصى ميزانية قابلة للتكوين. أي محفظة يمكنها التحدث NWC لأي عميل يدرك NWC، لذا يعمل الاقتران عبر النظام البيئي بأكمله.

عندما تكون جاهزًا، احصل على عنوان @nostr.blog →

المشكلة قبل NWC

قبل NWC، كان لدى عميل Nostr الذي أراد دعم الإشارات المالية ثلاثة خيارات سيئة.

الخيار 1: إدراج محفظة في العميل. إدارة قنوات Lightning، معالجة الحفظ، كن شركة محفظة. معظم العملاء لم يتمكنوا من تحمل الهندسة.

الخيار 2: اطلب من المستخدم nsec و بيانات اعتماد المحفظة. وقّع الأحداث من جانب العميل وأرسل طلبات دفع الفاتورة مباشرة إلى واجهة برمجة تطبيقات المحفظة. هذا يعني أن العميل رأى مفتاح واجهة برمجة التطبيقات للمحفظة، وهو كابوس أمني.

الخيار 3: لا تدعم الإشارات المالية. اتخذ بعض العملاء هذا المسار، مما جعلهم أقل فائدة.

يفصل NWC المحفظة عن العميل باستخدام Nostr نفسه كقناة إشارة. العميل لا يرى أبدًا بيانات اعتماد المحفظة. المحفظة لا تحتاج أبدًا إلى معرفة أي شيء خاص بـ Nostr باستثناء كيفية استقبال الطلبات.

كيف يعمل البروتوكول

تم تعريف NWC في NIP-47. التدفق:

1. تولد المحفظة سلسلة اتصال. تحتوي على عنوان URL نقل Nostr، ومفتاح عام تستمع إليه المحفظة، وسر مشترك للتشفير.
2. يلصق المستخدم السلسلة في العميل. أو يمسح رمز QR ضوئيًا. في كلا الحالتين، يعرف العميل الآن أين يرسل الطلبات.
3. يرسل العميل طلبات الإنفاق المشفرة عبر Nostr. "ادفع هذه الفاتورة بـ 1000 ساتوشي" تذهب في حدث مشفر إلى المفتاح العام المستمع للمحفظة في النقل المحدد.
4. تستقبل المحفظة الطلب وتدفع. إذا كان المبلغ ضمن ميزانية الاتصال، تدفع المحفظة الفاتورة على الفور.
5. ترد المحفظة بالنتيجة. حدث Nostr مشفر يعود إلى العميل: نجح الدفع أو فشل، إليك الإثبات.

الشيء كله يحدث في أقل من ثانية. العميل لا يتعامل أبدًا مع Lightning مباشرة؛ إنه يتحدث فقط إلى Nostr. المحفظة لا تحتاج أبدًا إلى فهم ميزات Nostr الاجتماعية؛ إنها تستمع فقط لطلبات الإنفاق.

ما تحتويه سلسلة الاتصال

سلسلة NWC نموذجية:

nostr+walletconnect://abc123def456...?relay=wss://relay.example.com&secret=xyz789...

ثلاثة أجزاء.

مفتاح عام. هوية المحفظة المستمعة على Nostr. يرسل العميل الطلبات إلى هذا المفتاح العام.

نقل. حيث تستمع المحفظة. يتصل العميل والمحفظة بهذا النقل لتبادل الرسائل.

سر. يُستخدم لتشفير الرسائل بين العميل والمحفظة، بحيث يرى النقل فقط النص المشفر.

معًا، تعطي هذه القيم الثلاث للعميل إذن إرسال أوامر الإنفاق إلى المحفظة. النقل هو صندوق البريد؛ المفتاح العام هو العنوان؛ السر هو القفل.

الميزانية والأذونات

كل اتصال NWC له حدود تعيينها المحفظة عند إنشاء الاتصال.

• الحد الأقصى للمبلغ لكل دفعة. عادة 10,000 إلى 100,000 ساتوشي حسب ما تعينه. يتطلب الإنفاق أكثر من موافقة جديدة.
• الحد الأقصى للمبلغ يوميًا/أسبوعيًا/شهريًا. ميزانية متداول تمتلئ حسب الجدول.
• تاريخ الانتهاء. بعض المحافظ تنتهي صلاحية الاتصالات تلقائيًا بعد فترة؛ البعض الآخر يتركها مفتوحة حتى يتم إلغاؤها.
• الطرق المسموحة. تسمح بعض المحافظ بـ "دفع الفاتورة" فقط، مما ينفي "البحث عن الرصيد" أو "قائمة المعاملات".

الميزانية تعني أنه حتى إذا تسريب سلسلة اتصال، فإن الضرر محدود. المهاجم لا يمكنه تصريف المحفظة بالكامل؛ يمكنه الإنفاق حتى الميزانية، حيث ترفض المحفظة الطلبات الإضافية حتى تملأ الحد أو تنشئ اتصالًا جديدًا.

إعداد NWC، خطوة بخطوة

تدفق ملموس لاقتران مستخدم نموذجي لمحفظة مع عميل Nostr.

1. افتح محفظة Lightning الخاصة بك. Wallet of Satoshi أو Phoenix أو Alby Hub أو Zeus أو أي محفظة تدعم NWC.
2. ابحث عن إعدادات NWC. ابحث عن "الاتصالات" أو "Nostr Wallet Connect" أو "التطبيقات" في قائمة الإعدادات. تضع كل محفظة في مكان مختلف قليلاً.
3. أنشئ اتصالاً جديدًا. أعطه اسمًا حتى تتذكر التطبيق المقصود. عيّن ميزانية.
4. انسخ سلسلة NWC المُنشأة. أو احصل على رمز QR.
5. افتح عميل Nostr الخاص بك. انتقل إلى الإعدادات، ابحث عن "محفظة Lightning" أو "إعدادات الإشارات المالية".
6. الصق سلسلة NWC أو امسح رمز QR ضوئيًا. يختبر العميل الاتصال.
7. النجاح. تضيء أزرار الإشارات المالية؛ تذهب إشارتك المالية التالية عبر المحفظة المقترنة.

إذا أظهر العميل "فشل الاتصال" بعد الاقتران، فأكثر السبب شيوعًا هو عدم تطابق النقل (النقل في سلسلة NWC هو النقل الذي لا يمكن للعميل الوصول إليه) أو جدار حماية يسد اتصالات WebSocket.

لماذا هذا أفضل من المحفظة المدمجة

ثلاث مزايا حقيقية لـ NWC على المحافظ المدمجة.

قابلية النقل. يمكنك التبديل بين عملاء Nostr دون تبديل المحافظ. يبقى رصيدك والسجل والقنوات في مكانهم؛ يقترن العميل الجديد فقط بنفس المحفظة عبر اتصال NWC جديد.

التخصص. يركز مطورو المحفظة على بنية Lightning؛ يركز مطورو العميل على تجربة المستخدم الاجتماعية. يصبح كل جانب أفضل في نطاقه الخاص، وتعمل قابلية التشغيل البيني عبر التركيبات.

حدود أمان. العميل لا يمتلك أبدًا بيانات اعتماد المحفظة. يمكن للعميل المعيب في أسوأ الحالات إرسال فواتير خاطئة؛ لا يمكنه تصريف المحفظة أو تصدير جملة البذور.

الحالة الوحيدة التي تكون فيها المحفظة المدمجة أفضل بوضوح هي للمستخدمين الذين يريدون أقصى قدر من الحماية من الاحتكاك. يحصل العميل ذو المحفظة المضمنة على المستخدم الذي يصدر إشارات مالية خطوة واحدة أسرع من اقتران محفظة خارجية. هذا هو السبب في أن التسجيل في nostr.blog يتضمن محفظة بشكل افتراضي، ويمكن للمستخدمين بعد ذلك ربط المحافظ الخارجية عبر NWC إذا فضلوا ذلك.

إلغاء اتصال NWC

إذا فقدت جهازًا أو توقفت عن استخدام عميل أو أردت تدوير بيانات الاعتماد، ألغِ الاتصال من جانب المحفظة.

1. افتح المحفظة.
2. ابحث عن الاتصال في قائمة الإعدادات.
3. اضغط على إلغاء أو حذف.
4. سلسلة الاتصال لم تعد تعمل؛ يحصل أي عميل يحتفظ بها على "غير مصرح" في الطلب التالي.

هذا فوري. على عكس مفاتيح واجهة برمجة التطبيقات التي قد تسريب في مستودع GitHub، يمكن قتل اتصالات NWC في ثوانٍ ولا تبقى جلسات متبقية. هذه خاصية أمان ذات معنى.

مشاكل NWC الشائعة

"انتهاء المهلة الزمنية للاتصال." النقل في سلسلة NWC غير قابل للوصول من شبكتك، أو المحفظة غير متصلة. تحقق من أن تطبيق المحفظة مفتوح ومتصل؛ تتطلب بعض المحافظ أن يكون التطبيق نشطًا للرد.

"فشل الدفع" بالرغم من فاتورة صالحة. قد تفتقد قنوات المحفظة السيولة لتوجيه الدفع. هذه مشكلة على مستوى Lightning، وليست خاصة بـ NWC. جرب مبلغًا مختلفًا أو وقتًا مختلفًا.

"إذن مرفوض." ميزانية الاتصال شاملة، أو انتهت صلاحية الاتصال، أو نوع الطلب ليس في الطرق المسموحة. تحقق من إعدادات اتصال المحفظة.

"العميل لا يستطيع اكتشاف المحفظة." بعد اللصق، يتعثر العميل. أغلق وأعد فتح العميل؛ يخزن بعض العملاء حالة الاتصال ولا يعيد الفحص إلا عند التشغيل.

حيث يتجه NWC

NIP-47 ليس نهائيًا. العمل النشط في 2026 يغطي:

• أذونات أغنى. أكثر تفصيلاً من "يمكنه الإنفاق حتى X لكل فترة"، مع قواعد لكل مستقبل أو لكل مبلغ.
• توجيه محفظة متعددة. عميل مقترن بمحافظ متعددة يختار الأفضل لكل دفعة بناءً على الرصيد أو الرسوم أو المسار.
• تقارير الأخطاء الأفضل. رموز أخطاء موحدة بحيث يمكن للعملاء إظهار رسائل مفيدة عند فشل الدفعات.
• دعم المحفظة غير المتصلة. يفترض NWC الحالي أن كلا الجانبين متصلان؛ تسمح المسودات بطلبات في الطابور التي تستقر عند إعادة الاتصال بالمحفظة.

البروتوكول مستقر بما يكفي للاستخدام اليومي في 2026 وسيستمر في التطور. اقتران محفظة اليوم عملية لمدة دقيقة واحدة؛ لا يوجد شيء في التصميم الحالي سيكسر لاحقًا.