يحتوي Pera Connect SDK 1.6.0 على توقيع تجريبي لملحق متصفح ARC-27.

2026-08-23

sdk · wallet · api · nft · developer-tools · discovery · web · updated

يحتوي Pera Connect SDK 1.6.0 على توقيع تجريبي لملحق متصفح ARC-27.

يتم إصدار Pera Connect SDK 1.6.0 مع التوقيع التجريبي لمتصفح ARC-27.

باب الدخول للمطورين في المحفظة الافتراضية لـ Algorand

عندما تطلب من تطبيق ويب على "ألغوراند" من الزائرين ربط محفظة، تكون المحفظة التي تفتح عادةً هي Pera's. أُطلقت Pera كالمحفظة الرسمية للشبكة، وتمت إعادة تسميتها في فبراير 2022، ولا تزال الخيار الافتراضي للجوال - يحصل تطبيق iOS على متوسط 4.8 نجوم عبر 7,952 تقييمًا، وأعلن الفريق عن إعادة بناء شاملة لكليهما على قاعدة كود React Native واحدة في 11 أغسطس. قبل إعلان الفريق بيومين، أصدر نفس الفريق الإصدار 1.6.0 من @perawallet/connect، SDK JavaScript الذي يتيح للتطبيقات الويب التفاعل مع المحفظة. الإضافة الرئيسية للإصدار - طلبات التوقيع عبر ملحق متصفح، موحدة كـ ARC-27 - هي تحفظية عمدًا: يتم تشغيلها وراء راية تجريبية تكون غير نشطة افتراضيًا.

يقع SDK في قلب مركز الوثائق الفنية الخاص بـ Pera، والذي ينظّم أربع واجهات تكامل للمطورين من جهات خارجية. وتتيح كل واجهة لمشروع ما الاستفادة من البنية التحتية التي تديرها Pera بالفعل لمنتجاتها الخاصة بدلاً من بنائها من الصفر.

سطح التكامل	ما يغطيه	الآثار في العالم الحقيقي
Pera Connect SDK	مكتبة جافا سكريبت تربط تطبيقات الويب بـ Pera Wallet	الكود وراء معظم أزرار "Connect Wallet" في تطبيقات Algorand الذكية
واجهة برمجة التطبيقات العامة	نقاط نهاية تُرجع بيانات التعريف وعلامات التحقق لأي [أصل قياسي من Algorand](/glossary/algorand-standard-asset "آلية مدمجة تتيح لأي شخص إنشاء وإصدار رموز جديدة (مثل العملات المستقرة أو رموز الأغراض أو NFTs) مباشرةً على طبقة Algorand الأساسية،")	تُظهر التطبيقات أسماء الرموز واللوجات والأسعار وشارات الثقة الخاصة بـ Pera دون أن تحتاج كل مشروع إلى كتابة مُحلل خاص به
مواصفات تحليل NFTs	كيف يكتشف Pera ويستخرج ويصنف NFTs على نطاق واسع	تُظهر المحافظ ومستكشفيها الوسائط المميزة والسمات دون أن يكتب كل مشروع مُحللاً خاصاً به
خطط URL لتطبيقات الجوال	perawallet:// روابط عميقة مقبولة من تطبيقات iOS وAndroid	يمكن لأي صفحة إطلاق Pera مباشرةً في تدفق الإرسال أو القبول أو مراقبة الحساب

ماذا تضيف 1.6.0 بالفعل

يعمل Pera Connect على بروتوكول [WalletConnect](/glossary/walletconnect "بروتوكول يتيح لتطبيق ويب الاتصال بمحفظة عملات رقمية (مثل Pera أو Defly على Algorand) عن طريق فحص رمز الاستجابة السريعة، حتى يتمكن التطبيق من قراءة العنوان")، مما يتيح لتطبيق ويب الاتصال بالمحفظة عن طريق فحص رمز الاستجابة السريعة، حتى يتمكن التطبيق من قراءة عنوان المحفظة وطلب معاملات موقّعة دون الحاجة إلى الاحتفاظ بمفاتيح سرية. تتمثل الطرق الأساسية لمجموعة الأدوات البرمجية (SDK) في: return account addresses، وsignTransaction() لتوقيع معاملات فردية أو مجموعات ذرية (مجموعات يجب أن يتم إتمامها جميعًا أو لا يتم إتمام أي منها)، وsignData() لتوقيع بايتات عشوائية للتحقق من صحة الهوية وتدفقات الهوية.

إصدار 1.6.0، الذي تم إصداره في 30 يوليو، يضيف وسيلة نقل ثانية للتوقيع: ARC-27، وهو معيار Algorand يتيح لمحفظة ملحقة بالمتصفح الاستجابة لطلبات [dApp](/glossary/dapp "تطبيق لامركزي، وهو برنامج تشغيل على شبكة بلوكشين بدلاً من خادم مركزي، لذا لا يسيطر عليه طرف واحد") مباشرة، متجاوزةً مرحلة التحويل إلى رمز الاستجابة السريعة. وبما أن الدعم مقيد بوضع تجريبي افتراضي على "false"، فلا يتغير أي شيء في التكاملات الحالية إلا إذا اختار المطور ذلك. وعند التفعيل، يظهر في نافذة الاتصال خيار "الاتصال باستخدام ملحقة Pera"، ويحدد تلقائيًا ملحقة متوافقة مثبتة من خلال مرحلة التحويل إلى رمز الاستجابة السريعة، ويستبدلها بـ QR أو Pera Web إذا لم يتم العثور على أي منها. ويدعم مسار الملحقة توقيع البيانات باستخدام ARC-60 — مع التحقق من نطاق الطلب مقابل مصدر الصفحة — ولكن ليس توقيع البيانات العشوائية القديم، الذي يسبب خطأ "عملية غير مدعومة". وشمل الإصدار نفسه مجموعة من الإصلاحات للامتثال لمواصفات ARC-60، ويوجد حاليًا إصدار 1.6.1-beta.0 على علامة "beta" في npm.

سجلت الحزمة 46,854 عملية تنزيل في الشهر الماضي، منها 11,724 في الأسبوع الماضي، وتعتمد عليها 46 حزمة أخرى مسجلة في npm. ويحتوي مستودع GitHub على 70 نجمة، وتم دفعه في 14 أغسطس الماضي مع تصحيحات لتدفق التوقيع في iOS Safari وأخطاء في تسمية بيانات التوقيع – وهي وتيرة صيانة تتوافق مع التوقيعات الخاصة بالمحفظة: تطبيق dApp النموذجي الذي يديره الفريق يختبر أكثر من مائة سيناريو توقيع، من المدفوعات الفردية إلى دفعات تضم 1,000 معاملة.

بقية المركز: البيانات، المقتنيات، الروابط العميقة

تتناول الأسطح الثلاثة الأخرى ما تحتاجه دApp حول تدفق التوقيع نفسه. تعيد واجهة برمجة التطبيقات العامة، التي يتم تقديمها من [mainnet](/glossary/mainnet "الشبكة العامة الرئيسية للبلوكتشين حيث يتم تسجيل المعاملات وتتمتع بقيمة حقيقية، على عكس شبكة الاختبار المستخدمة للتجريب.")، api.perawallet.app، بيانات التعريف الخاصة بأي [ASA](/glossary/asa "الأصل القياسي في Algorand: آلية طبقة 1 على بلوكتشين Algorand التي تتيح لأي شخص إصدار رمز مثل استقرار العملة أو NFT، يحمل قيمة") على الشبكة — الاسم، اسم الوحدة، عدد الأرقام العشرية، الإمداد الكلي، المبدع، الشعار، القيمة بالدولار الأمريكي — بالإضافة إلى طبقة التحقق من الموثوقية، الموثوق بها، غير الموثوق بها أو المشبوهة، مع تخزين الاستجابات لمدة خمس دقائق. تعيد نقاط النهاية المخصصة للأصول الموثوق بها والأسماء المحددة قوائم السماح في استجابة واحدة، ويربط المستندات بواجهة مستخدم Swagger ومواصفات OpenAPI قابلة للتنزيل. هناك تحذيران: إشعار بالاستخدام المقرر للنسخ في عام 2024 نقل نقاط النهاية إلى المسار /v1/public/ مع عمليات إعادة توجيه من 1 أغسطس من ذلك العام، ومتطلبات استخدام واجهة برمجة التطبيقات تشمل التزامات بالعلامة التجارية — يجب على المرخص إظهار "البيانات مقدمة من Pera" مع شعار Pera، وعلامات "موثوق" و"مشبوه" بجانب كل ASA، وربط الصفحة الخاصة بـ Pera Explorer الخاصة بالأصل الموثوق به بطلب "عرض على Pera Explorer" مرئي.

يُوضّح مواصفات "NFT parser" كيف يملأ "Pera" قاعدة بياناته من المقتنيات: تتكرر مهمة جارية باستمرار على كل أصل، حيث يتم استرداد البيانات الوصفية والوسائط عبر بوابة [IPFS](/glossary/ipfs "نظام تخزين ملفات لامركزي حيث يتم تخزين البيانات عبر أجهزة كمبيوتر متعددة، مما يجعله مقاومًا للرقابة أو الفقدان. غالبًا ما تستخدم NFTs IPFS")، وتصنف كائن JSON كـ NFT من نوع ARC3 (البيانات الوصفية) وصورة أو مقطع فيديو كـ NFT من نوع ARC69 (الوسائط). البيانات الوصفية لـ ARC69 قابلة للتغيير، لذا يعيد "Pera" تحليلها من آخر معاملة تكوين للأصل في كل دورة، بينما يتم استرداد الوسائط من نوع ARC69 مرة واحدة وتخزينها مؤقتًا؛ ويتم تجاهل الملفات التي تزيد سعتها عن 100 ميجابايت، ويتم إعادة محاولات الاسترداد الفاشلة ثلاث مرات. وتُكمّل مخططات URL للجوال المجموعة بوجود روابط "perawallet://" التي تفتح التطبيق في إجراء محدد — إضافته لحساب مراقبة، أو الاشتراك في أصل، أو تعبئة تحويل "ALGO" أو "ASA" مسبقًا بملاحظة — مع عرض المبالغ بالـ "microalgos".

المساوئ التي يورثها المطور

ما لا يبرزه المستندات هو مدى ارتباط هذه الأسطح بمورد واحد. فخطة الارتباط العميق لا تفتح سوى Pera، ونافذة الاتصال تحمل علامة Pera التجارية، وشروط واجهة برمجة التطبيقات العامة تتطلب عرض شعار Pera وشاراتها بدلاً من عرض البيانات بطريقة محايدة - وهذه الشارات هي من اختيار Pera الخاص، وليس سجلًا مستقلاً، إذ تنص شروطها على أن الشارة ليست تأييدًا. ولا تشير الوثائق ولا ملاحظات الإصدار إلى مراجعة أمنية من طرف ثالث للبرنامج، لذا تعتمد الفرق التي تعتمده على هندسة Pera وسجلها. هذا السجل حقيقي - فإعادة بناء المحفظة 7.0 ودورة الإصدار الشهرية للبرنامج يظهران صيانة نشطة - لكن هذا يعني أيضًا أن Pera، باعتبارها المحفظة الافتراضية للنظام البيئي، لديها مصلحة تجارية في كل تكامل تدعمه. وهناك حلان لتخفيف المخاطر للفرق التي ترغب في الابتعاد: يشير الملف use-wallet إلى المرفق المحافظة على الحياد، لدعم المحافظ المتعددة، وتتوجه أسئلة المطورين إلى قناة #dev-support في سيرفر Pera على Discord.

العلامة التجريبية هي التحذير الصريح: إن Pera ترسل إشارة توجيهية باستخدام ARC-27 بدلاً من أن تعد بإنهاء قصة التوسيع، كما أن بوابة الاختيار الاختياري تعني أن المستخدمين الأوائل يقومون بالاختبار وليسوا يعتمدون على ذلك. وبالنسبة للفريق الذي يشعر بالارتياح تجاه جعل Pera بنية تحتية لمحفظته، فإن SDK هو أسرع طريق من الصفر إلى زر Connect Wallet الذي يعمل؛ وبالنسبة للفريق الذي يريد البقاء محايداً في مجال محافظ Algorand، فإن طبقات التغليف توفر مخرجاً للطوارئ. وفي كلتا الحالتين، تُعد منصة الوثائق الآن الخريطة الأكثر وضوحاً لمسار تجربة المطورين التي تهدف إليه محفظة Pera الافتراضية.

المصدر

Source: https://docs.perawallet.app