يشرح هذا الدليل كيفية إعداد مدفوعات البيتكوين على موقعك الإلكتروني باستخدام Electrum. سوف نستخدم طلبات الدفع الموقعة من SSL، باتباع BIP-70 القياسية. هذه الوثائق حديثة لإلكتروم 4.0 والإصدارات الأحدث.
قبل أن تبدأ، تأكد من أن لديك
- شهادة SSL صالحة (موقعة من المرجع المصدق (CA)، مثل شهادة SSL المجانية LetsEncrypt).
- تم تثبيت إصدار التطوير من Electrum.
تذكر تشغيل أمر تحديث الوحدة الفرعية أثناء التثبيت.
إعداد شهادة SSL الخاصة بك في Electrum
لتمكين الاتصالات الآمنة، تحتاج إلى إضافة شهادة SSL إلى Electrum. استخدم هذه الأوامر في جهازك الطرفي:
electrum -o setconfig ssl_keyfile /path/to/ssl/privkey.pem
electrum -o setconfig ssl_certfile /path/to/ssl/fullchain.pem
للمزيد من الإرشادات التفصيلية حول إضافة SSL إلى Electrum، راجع تكوين SSL لإلكتروم.
إنشاء محفظة التاجر واستخدامها
قم بإعداد محفظة آمنة لمعاملاتك التجارية. تساعد هذه العملية على حماية عملتك الرقمية حتى لو تعرض خادم التاجر الخاص بك للخطر.
- إنشاء محفظة جديدة
على جهاز كمبيوتر آمن، قم بإنشاء محفظة جديدة:
electrum create
من الأفضل استخدام محفظة منفصلة لعملك، وليس محفظتك الشخصية.
- تصدير المفتاح العام الرئيسي
لا يزال على حاسوبك الآمن، قم بتصدير المفتاح العام الرئيسي (xpub):
electrum getmpk -w .electrum/wallets/your-wallet
- إعداد خادم التاجر
على جهاز الخادم الخاص بك، قم باستعادة المحفظة باستخدام المفتاح العام الرئيسي الذي تم تصديره:
electrum restore xpub...............................................
استبدل xpub... مع المفتاح العام الرئيسي الفعلي الخاص بك
- تكوين إعدادات الخادم.
electrum -o setconfig payserver_address yourdomain.com:80
استبدل yourdomain.com بنطاقك الفعلي.
بدء تشغيل البرنامج الخفي للإلكتروم
بعد إعداد محفظتك للقراءة فقط، تحتاج إلى تشغيل Electrum كخدمة خلفية. إليك الطريقة:
- بدء تشغيل البرنامج الخفي
قم بتشغيل هذا الأمر لبدء تشغيل Electrum كبرنامج خفي:
electrum daemon -d
يؤدي هذا إلى تشغيل Electrum في وضع البرنامج الخفي، مما يسمح بتشغيله في الخلفية.
- قم بتحميل محفظتك
بعد ذلك، قم بتحميل محفظتك في البرنامج الخفي قيد التشغيل:
electrum load_wallet
هذا الأمر يجعل محفظتك نشطة وجاهزة للاستخدام.
إيقاف البرنامج الشيطاني
إذا كنت بحاجة إلى إيقاف البرنامج الخفي Electrum في أي وقت، استخدم هذا الأمر:
electrum stop
سيؤدي هذا إلى إيقاف تشغيل البرنامج الخفي Electrum بأمان.
إنشاء طلب دفع موقّع
electrum add_request 0.5 -m "test"
{
"URI": "bitcoin:bc1q3hr4xnta7s4jgeymjhs498ygqa53qkjxqhlx3z?amount=0.5&message=test&time=1589115653&exp=3600",
"address": "bc1q3hr4xnta7s4jgeymjhs498ygqa53qkjxqhlx3z",
"amount": 50000000,
"amount_BTC": "0.5",
"bip70_url": "https://yourdomain.com:80/bip70/bc1qyr5xx5jkue3k72sldm5xa0taqs3n2achupymz8.bip70",
"exp": 3600,
"id": "63822b69013",
"memo": "test",
"status": 0,
"status_str": "Expires in about 1 hour",
"time": 1589115653,
"type": 0,
"view_url": "https://yourdomain.com:80/r/pay?id=bc1q3hr4xnta7s4jgeymjhs498ygqa53qkjxqhlx3z"
}
فيما يلي تفصيل للمعلومات الأساسية:
URI: معرّف URI للبيتكوين يتضمن المبلغ والرسالة والطابع الزمني وانتهاء الصلاحية.address: عنوان البيتكوين للدفع.amount: المبلغ المطلوب بالساتوشي.amount_BTC: المبلغ المطلوب بعملة البيتكوين.bip70_url: عنوان URL الخاص بطلب BIP70 الموقّع.view_url: عنوان URL لصفحة الويب التي تعرض الطلب.
يتضمن إخراج الأمر عنوانين مهمين لعناوين URL:
bip70_url: هذا هو عنوان URL لطلب BIP70 الموقّع.view_url: هذا هو عنوان URL لصفحة الويب التي تعرض تفاصيل الطلب.
لعرض قائمة الطلبات الحالية الخاصة بك، استخدم زر list_requests الأمر.
لإزالة جميع الطلبات من القائمة، استخدم الخيار clear_requests الأمر.
افتح صفحة طلب الدفع في متصفحك
بعد إنشاء طلب الدفع، يمكنك عرضه في متصفح الويب.
إليك كيفية استخدام صفحة طلب الدفع:
- افتح
view_urlمن مخرجات طلب الدفع في متصفح الويب الخاص بك. - ستعرض الصفحة تفاصيل طلب الدفع، بما في ذلك:
- معرّف URI للبيتكوين يمكن فتحه باستخدام المحفظة.
- رمز الاستجابة السريعة الذي يمكن مسحه ضوئياً للدفع.
- الوقت المتبقي حتى انتهاء صلاحية الطلب.
- لإجراء عملية الدفع
- استخدم محفظة Bitcoin لفتح معرّف URI للبيتكوين المقدم.
- امسح رمز الاستجابة السريعة ضوئياً باستخدام محفظة الهاتف المحمول.
- تستخدم الصفحة مآخذ الويب للتحديث في الوقت الفعلي. عند استلام الدفعة، سيتم تحديث الصفحة تلقائيًا لإظهار الحالة المحدثة.
قد يختلف المظهر الفعلي للصفحة، ولكنها ستحتوي على المعلومات الأساسية اللازمة لإتمام عملية الدفع.
هام: تحقق دائمًا من تفاصيل الدفع قبل إرسال أي أموال.
مدفوعات البرق
إعداد البرق
لاستخدام Lightning، تحتاج إلى إعداد مفاتيح Lightning في محفظتك. اتبع هذه الخطوات:
- إيقاف البرنامج الخفي Electrum:
electrum stop - تهيئة مفاتيح البرق:
electrum -o init_lightning - أعد تشغيل البرنامج الخفي:
electrum daemon -d
يمكنك إضافة مفاتيح Lightning إلى محفظة للمشاهدة فقط. لن تتمكن هذه المحفظة من إنفاق العملات على السلسلة، ولكن يمكنها إجراء معاملات Lightning.
فتح قناة
بعد إعداد Lightning، تحتاج إلى فتح قناة:
electrum open_channel <node_id> <amount>
للتحقق مما إذا كانت القناة جاهزة للاستخدام:
electrum list_channels
لاحظ أن قناتك الجديدة لن يكون لديها سعة واردة في البداية، لذلك لا يمكنك تلقي المدفوعات على الفور. إذا كنت بحاجة إلى الاستلام على الفور، ففكر في إجراء مقايضة فرعية لأموال قناتك.
إنشاء طلب الدفع البرق
لإنشاء طلب دفع لايتنينج:
electrum add_lightning_request 0.0001 -m "test"
ينشئ هذا الأمر طلب 0.0001 بيتكوين مع رسالة "اختبار".