البنية التحتية وأدوات المطورين
إصدار Pera Connect SDK 1.6.0 يطرح توقيعًا تجريبيًا عبر إضافات المتصفح وفق ARC-27
قراءة في مركز المطوّرين لدى Pera: الإصدار 1.6.0 من @perawallet/connect يضيف توقيعًا اختياريًا عبر إضافة المتصفح وفق ARC-27، إلى جانب واجهة البيانات العامة لأصول ASA، ومواصفات محلل NFT، والروابط العميقة لتطبيق الجوال.

بوابة المطوّرين إلى محفظة Algorand الافتراضية
عندما يطلب تطبيق ويب على Algorand من زائر ربط محفظته، تكون المحفظة التي تُفتح في العادة هي Pera1. أُطلقت Pera بوصفها المحفظة الرسمية للشبكة، ثم أُعيدت تسميتها في فبراير 2022، ولا تزال الخيار الافتراضي على الجوال: فتطبيق iOS يحمل متوسط تقييم 4.8 نجمة من 7,952 تقييمًا، وأعلن الفريق في 11 أغسطس إعادة بناء تطبيقيه من الصفر على قاعدة كود واحدة بـ React Native. وقبل اثني عشر يومًا من ذلك الإعلان، أصدر الفريق نفسه الإصدار 1.6.0 من @perawallet/connect2، وهو مجموعة أدوات تطوير JavaScript التي تتيح لتطبيقات الويب مخاطبة المحفظة. أما الإضافة الأبرز في هذا الإصدار — طلبات التوقيع عبر إضافة للمتصفح، المعيارية وفق ARC-27 — فهي متحفّظة عن قصد: إذ تصدر خلف علم تجريبي معطّل افتراضيًا.
تقع هذه المجموعة في قلب مركز التوثيق التقني لدى Pera3، الذي ينظّم أربعة أسطح تكامل أمام مطوّري الأطراف الثالثة. وكل سطح منها يتيح للمشروع أن يستعير بنية تحتية تشغّلها Pera أصلًا لمنتجاتها، بدل أن يبنيها من الصفر.
| سطح التكامل | ما يغطيه | الأثر العملي |
|---|---|---|
| Pera Connect SDK | مكتبة JavaScript تربط تطبيقات الويب بمحفظة Pera | الكود الذي يقف خلف معظم أزرار «ربط المحفظة» في تطبيقات Algorand اللامركزية |
| واجهة برمجة التطبيقات العامة | نقاط نهاية تُعيد البيانات الوصفية وعلامات التحقق لأي أصل معياري على Algorand | تتيح للتطبيقات عرض أسماء الرموز وشعاراتها وأسعارها وشارات الثقة الخاصة بـ Pera دون تشغيل مُفهرِس خاص بها |
| مواصفات محلل NFT | كيف تكتشف منظومة Pera الرموز غير القابلة للاستبدال وتجلبها وتصنّفها على نطاق واسع | تعرض المحافظ والمستكشفات وسائط المقتنيات وسماتها دون أن يكتب كل مشروع محلّله الخاص |
| مخططات عناوين URL لتطبيق الجوال | روابط perawallet:// العميقة التي يقبلها تطبيقا iOS وAndroid | يستطيع أي موقع فتح Pera مباشرة على مسار الإرسال أو الموافقة على أصل أو إضافة حساب مراقبة |
ما الذي يضيفه الإصدار 1.6.0 فعلًا
يعمل Pera Connect على بروتوكول WalletConnect، وهو يتيح لتطبيق ويب الاتصال بالمحفظة عبر مسح رمز QR، فيقرأ عنوان المحفظة ويطلب توقيع معاملات من دون أن يحوز المفاتيح الخاصة قط. أما الدوال الأساسية في المجموعة فقليلة: connect() يعيد عناوين الحسابات، وsignTransaction() يوقّع معاملة مفردة أو مجموعة ذرّية — أي مجموعة يجب أن تُسجَّل كاملة أو لا شيء منها — وsignData() يوقّع بايتات حرة لأغراض المصادقة والهوية.
يضيف الإصدار 1.6.0، الصادر في 30 يوليو، قناة نقل ثانية للتوقيع: ARC-27، المعيار الذي أطلقته Algorand ليتيح لمحفظة على شكل إضافة متصفح أن تجيب طلبات التطبيق اللامركزي مباشرة، من دون المرور بمسار رمز QR ذهابًا وإيابًا. ولأن الدعم محكوم بعلم تجريبي معطّل افتراضيًا، لا يتغير شيء في عمليات التكامل القائمة ما لم يفعّله المطوّر بنفسه. وبمجرد التفعيل، تعرض نافذة الربط خيار «الاتصال عبر إضافة Pera»، وتكتشف تلقائيًا أي إضافة متوافقة مثبّتة عبر جولة تعريف ARC-27، وتعود إلى QR أو Pera Web إن لم تجد إضافة. ويدعم مسار الإضافة توقيع البيانات وفق ARC-60 — مع التحقق من النطاق الطالب مقابل أصل الصفحة — لكنه لا يدعم توقيع البيانات الحرة بالطريقة القديمة، إذ يُطلق خطأ عملية غير مدعومة. وحمل الإصدار نفسه دفعة من التصحيحات للالتزام بمواصفات ARC-60، فيما يستقر الإصدار 1.6.1-beta.0 الآن على وسم beta في npm.
سجّلت الحزمة 46,854 عملية تنزيل خلال الشهر الأخير، منها 11,724 في الأسبوع الماضي، ويعتمد عليها 46 حزمة أخرى مسجّلة في npm. ويحمل مستودع GitHub4 70✓1 نجمة، وآخر تحديث له يعود إلى 14 أغسطس بتصحيحات لمسار التوقيع في متصفح Safari على iOS ولأخطاء signData موسومة خطأً — وهو إيقاع صيانة يوازي إيقاع المحفظة نفسها: فـالتطبيق اللامركزي النموذجي5 الذي يصونه الفريق يختبر أكثر من مئة سيناريو توقيع، من دفعة واحدة إلى دفعات تضم 1,000✓2 معاملة.
بقية المركز: البيانات والمقتنيات والروابط العميقة
تعالج الأسطح الثلاثة الأخرى ما يحتاجه التطبيق اللامركزي حول مسار التوقيع نفسه. فـواجهة برمجة التطبيقات العامة، المتاحة من mainnet.api.perawallet.app، تُعيد البيانات الوصفية لأي ASA على الشبكة — الاسم، واسم الوحدة، والمنازل العشرية، وإجمالي المعروض، والمنشئ، والشعار، والقيمة بالدولار — إضافة إلى طبقة تحقق من أربع قيم: موثوق، أو موثَّق، أو غير موثَّق، أو مشبوه، مع تخزين الردود مؤقتًا خمس دقائق. كما تُعيد نقاط النهاية المخصصة للأصول الموثَّقة والأصول الموسومة قوائم مسموح بها في رد واحد، وتضع الوثائق رابطًا إلى Swagger UI ومواصفة OpenAPI قابلة للتنزيل. وهناك تحفّظان: إشعار إلغاء صادر في 2024 نقل نقاط النهاية إلى مسار /v1/public/ مع إعادة توجيه اعتبارًا من 1 أغسطس من ذلك العام، ومتطلبات استخدام الواجهة هي التزامات تتعلق بالعلامة — فعلى المرخَّص له أن يُظهر عبارة «البيانات مقدَّمة من Pera» مع شعار Pera، وأن يعرض شارتَي التوثيق والاشتباه بجانب كل ASA، وأن يربط بصفحة الأصل على Pera Explorer مع دعوة ظاهرة للنقر تقول «عرض على Pera Explorer».
توضح مواصفات محلل NFT كيف تملأ Pera قاعدة بيانات مقتنياتها: مهمة تعمل بلا توقف تمرّ على كل أصل، فتجلب البيانات الوصفية والوسائط عبر بوابة IPFS مخصصة، وتصنّف أي كائن JSON بوصفه NFT من نوع ARC3 (البيانات الوصفية) وأي صورة أو فيديو بوصفه NFT من نوع ARC69 (الوسائط). وبما أن بيانات ARC69 الوصفية قابلة للتغيير، تعيد المنظومة تحليلها من أحدث معاملة إعداد للأصل في كل دورة، أما وسائط ARC3 فتُجلب مرة واحدة وتُخزَّن مؤقتًا؛ وتُهمل الملفات التي تتجاوز 100 ميغابايت، ويُعاد المحاولة ثلاث مرات عند فشل الجلب. وتكتمل المجموعة بمخططات عناوين تطبيق الجوال عبر روابط perawallet:// التي تفتح التطبيق على إجراء محدد — إضافة حساب مراقبة، أو الموافقة على أصل، أو تعبئة تحويل ALGO أو ASA مسبقًا مع ملاحظة — مع التعبير عن المبالغ بالميكروألجو.
المقايضات التي يرثها المطوّر
ما لا تُبرزه الوثائق هو مدى إحكام هذه الأسطح لارتباط المشروع بمورّد واحد. فمخطط الروابط العميقة لا يفتح سوى Pera، ونافذة الربط تحمل علامة Pera، وشروط واجهة برمجة التطبيقات العامة تفرض إظهار شعار Pera وشاراتها بدل تقديم البيانات بحياد — وهذه الشارات اجتهاد خاص بـ Pera وليست سجلًا مستقلًا، إذ تنص شروطها على أن الشارة ليست تزكية. ولا تشير الوثائق ولا ملاحظات الإصدار إلى أي تدقيق أمني خارجي على المجموعة، ما يعني أن الفرق التي تتبناها تعتمد على هندسة Pera وسجلها. وهذا السجل حقيقي — فإعادة بناء المحفظة في الإصدار 7.0 ودورة الإصدارات الشهرية للمجموعة يدلان على صيانة نشطة — لكنه يعني أيضًا أن Pera، بوصفها المحفظة الافتراضية في المنظومة، لديها مصلحة تجارية في كل تكامل تدعمه. وهناك تخفيفان للفرق التي تريد مسافة: يشير ملف README إلى الغلاف المحايد تجاه المحافظ use-wallet6 لدعم محافظ متعددة، فيما تصل أسئلة المطوّرين إلى قناة #dev-support على Discord الخاص بـ Pera.
العلم التجريبي هو التحفّظ الصادق: فـ Pera تشير إلى اتجاهها عبر ARC-27 بدل أن تعِد بقصة إضافة مكتملة، وبوابة التفعيل الاختياري تعني أن المبادرين الأوائل يختبرون لا يعتمدون. وبالنسبة إلى فريق مرتاح في جعل Pera بنيته التحتية للمحافظ، تبقى المجموعة أسرع طريق من الصفر إلى زر «ربط المحفظة» عامل؛ أما الفريق الذي يريد البقاء محايدًا بين محافظ Algorand، فطبقات الغلاف توفر مخرجًا. وفي الحالتين، بات مركز التوثيق أوضح خريطة لما تنوي المحفظة الافتراضية فعله بتجربة المطوّرين في المنظومة.
المصادر
- توثيق محفظة Pera3
- @perawallet/connect على npm2
- perawallet/connect على GitHub4
- تطبيق Pera Wallet النموذجي5
- docs.perawallet.app7
- docs.perawallet.app8
- Pera Connect | توثيق محفظة Pera9
- مواصفات محلل NFT | توثيق محفظة Pera10
- مخططات عناوين URL لتطبيق الجوال | توثيق محفظة Pera11
- raw.githubusercontent.com12
- raw.githubusercontent.com13
- مستكشف Pera على Algorand14
- docs.perawallet.app15
- raw.githubusercontent.com16
- مقدمة | توثيق محفظة Pera17
- https://registry.npmjs.org/@perawallet/connect18
تم التحقق من رقمين في هذه القصة.عرض كل عمليات التحقق
المصادر
- 1Pera perawallet.app↩
- 2@perawallet/connect npmjs.com↩
- 3مركز التوثيق التقني لدى Pera docs.perawallet.app↩
- 4مستودع GitHub github.com↩
- 5التطبيق اللامركزي النموذجي perawallet.github.io↩
- 6use-wallet github.com↩
- 7docs.perawallet.app/llms.txt docs.perawallet.app↩
- 8docs.perawallet.app/llms-full.txt docs.perawallet.app↩
- 9Pera Connect | توثيق محفظة Pera docs.perawallet.app↩
- 10مواصفات محلل NFT | توثيق محفظة Pera docs.perawallet.app↩
- 11مخططات عناوين URL لتطبيق الجوال | توثيق محفظة Pera docs.perawallet.app↩
- 12raw.githubusercontent.com/algorandfoundation/ARCs/main/ARCs/arc-0027.md raw.githubusercontent.com↩
- 13raw.githubusercontent.com/perawallet/connect/main/README.md raw.githubusercontent.com↩
- 14مستكشف Pera على Algorand explorer.perawallet.app↩
- 15docs.perawallet.app/llms-small.txt docs.perawallet.app↩
- 16raw.githubusercontent.com/algorandfoundation/ARCs/main/ARCs/arc-0060.md raw.githubusercontent.com↩
- 17مقدمة | توثيق محفظة Pera docs.perawallet.app↩
- 18registry.npmjs.org/@perawallet/connect registry.npmjs.org↩