Pera Connect SDK نسخه ۱.۶.۰ امضای آزمایشی افزونه مرورگر روی ARC-27 را منتشر میکند
نگاهی به مرکز توسعهدهندگان Pera: بسته @perawallet/connect نسخه ۱.۶.۰ امضای اختیاری از طریق افزونه بر پایه ARC-27 را اضافه میکند، در کنار API عمومی داده ASA، مشخصات پارسر NFT و لینکهای عمیق اپ موبایل.

دروازه ورود توسعهدهندگان به کیف پول پیشفرض Algorand
وقتی یک اپلیکیشن وب روی Algorand از بازدیدکننده میخواهد کیف پولش را وصل کند، کیف پولی که معمولاً باز میشود Pera1 است. Pera بهعنوان کیف پول رسمی شبکه راهاندازی شد، در فوریه ۲۰۲۲ نام برندش را عوض کرد و همچنان انتخاب پیشفرض کاربران موبایل است — اپ iOS آن میانگین ۴.۸ ستاره از ۷,۹۵۲ رأی دارد — و تیم در ۱۱ اوت اعلام کرد که هر دو اپلیکیشن را از پایه روی یک کدبیس واحد React Native بازسازی میکند. دوازده روز پیش از آن اعلام، همین تیم نسخه ۱.۶.۰ از @perawallet/connect2 را روانه بازار کرد؛ SDK جاوااسکریپتی که به اپلیکیشنهای وب اجازه میدهد با کیف پول گفتوگو کنند. شاخصترین افزوده این انتشار — درخواست امضا از طریق افزونه مرورگر، در قالب استاندارد ARC-27 — آگاهانه محافظهکارانه است: پشت فلگ آزمایشیای عرضه شده که بهطور پیشفرض خاموش است.
این SDK در قلب مرکز مستندات فنی Pera3 نشسته است؛ مرکزی که چهار سطح یکپارچهسازی را برای توسعهدهندگان ثالث سازمان میدهد. هر سطح به یک پروژه اجازه میدهد بهجای ساختن از صفر، از زیرساختی که Pera از قبل برای محصولات خودش اجرا میکند قرض بگیرد.
| سطح یکپارچهسازی | چه چیزی را پوشش میدهد | پیامد در دنیای واقعی |
|---|---|---|
| Pera Connect SDK | کتابخانهای جاوااسکریپتی که اپلیکیشنهای وب را به Pera Wallet وصل میکند | کدی که پشت بیشتر دکمههای «اتصال کیف پول» در اپهای غیرمتمرکز Algorand است |
| Public API | نقاط پایانیای که فراداده و برچسبهای تأیید را برای هر دارایی استاندارد Algorand برمیگردانند | اپلیکیشنها نام توکن، لوگو، قیمت و نشانهای اعتماد Pera را بدون اجرای ایندکسر خودشان نمایش میدهند |
| مشخصات پارسر NFT | اینکه خط پردازش Pera چگونه NFTها را در مقیاس بزرگ کشف، واکشی و دستهبندی میکند | کیف پولها و کاوشگرها رسانه و ویژگیهای کلکسیبلها را رندر میکنند، بیآنکه هر پروژه پارسر خودش را بنویسد |
| طرحهای URL اپ موبایل | لینکهای عمیق perawallet:// که اپهای iOS و اندروید میپذیرند | هر صفحهای میتواند Pera را مستقیم در جریان ارسال، فعالسازی یا حساب تماشایی باز کند |
آنچه نسخه ۱.۶.۰ واقعاً اضافه میکند
Pera Connect روی پروتکل WalletConnect کار میکند؛ پروتکلی که به یک اپلیکیشن وب اجازه میدهد با اسکن یک کد QR به کیف پول وصل شود تا اپ بتواند آدرس کیف پول را بخواند و تراکنشهای امضاشده درخواست کند، بیآنکه هرگز کلید خصوصی را در دست بگیرد. متدهای اصلی این SDK اندکشمارند: connect() آدرس حسابها را برمیگرداند، signTransaction() تراکنشهای تکی یا گروههای اتمیک را امضا میکند — مجموعههایی که یا همه باید نهایی شوند یا هیچکدام — و signData() بایتهای دلبخواه را برای جریانهای احراز هویت و هویت امضا میکند.
نسخه ۱.۶.۰ که در ۳۰ ژوئیه منتشر شد، یک مسیر انتقال دوم برای امضا اضافه میکند: ARC-27، استانداردی در Algorand که به کیف پولِ افزونه مرورگر اجازه میدهد مستقیماً به درخواستهای یک dApp پاسخ دهد و رفتوبرگشت QR را حذف کند. چون این پشتیبانی پشت یک فلگ آزمایشی با مقدار پیشفرض false قرار دارد، برای یکپارچهسازیهای موجود هیچ چیز تغییر نمیکند مگر آنکه خود توسعهدهنده آن را فعال کند. پس از فعالسازی، مودال اتصال گزینهای با عنوان «Connect with Pera Extension» را فهرست میکند، از راه یک رفتوبرگشت کشف ARC-27 افزونه سازگار نصبشده را خودکار تشخیص میدهد و اگر چیزی پیدا نشد به QR یا Pera Web برمیگردد. مسیر افزونه امضای داده ARC-60 را پشتیبانی میکند — با بررسی دامنه درخواستکننده در برابر مبدأ صفحه — اما امضای دلبخواه داده قدیمی را نه، که خطای عملیات پشتیبانینشده پرتاب میکند. همین انتشار دستهای از اصلاحات انطباق با مشخصات ARC-60 را هم در برداشت و اکنون نسخه ۱.۶.۱-beta.0 روی تگ بتای npm نشسته است.
این پکیج در ماه گذشته ۴۶,۸۵۴ بار دانلود شده که ۱۱,۷۲۴ بارش در هفته آخر بود، و ۴۶ پکیج ثبتشده دیگر در npm به آن وابستهاند. مخزن گیتهاب4 ۷۰✓1 ستاره دارد و آخرین بار تا ۱۴ اوت با اصلاحاتی برای جریان امضای iOS Safari و پیامهای خطای برچسبغلط signData بهروز شده است — آهنگی از نگهداری که با خود کیف پول همخوان است: اپ نمونه5 که تیم نگه میدارد بیش از صد سناریوی امضا را میآزماید، از پرداختهای تکی تا دستههای ۱,۰۰۰✓2 تراکنشی.
باقی این مرکز: داده، کلکسیبلها، لینکهای عمیق
سه سطح دیگر به چیزهایی میپردازند که یک dApp پیرامون خود جریان امضا لازم دارد. Public API که از mainnet.api.perawallet.app سرو میشود، فراداده هر ASA روی شبکه را برمیگرداند — نام، نام واحد، اعشار، عرضه کل، سازنده، لوگو، ارزش دلاری — بههمراه یک سطح تأیید از میان trusted، verified، unverified یا suspicious، با پاسخهایی که پنج دقیقه کش میشوند. نقاط پایانی اختصاصی verified-assets و labeled-assets فهرستهای مجاز را در یک پاسخ واحد برمیگردانند و مستندات به یک Swagger UI و مشخصات OpenAPI قابل دانلود لینک میدهند. دو هشدار هم هست: یک اطلاعیه منسوخشدن به تاریخ ۲۰۲۴ نقاط پایانی را به مسیر /v1/public/ منتقل کرد و از ۱ اوت همان سال تغییرمسیر دارند؛ و الزامات استفاده از این API تعهدات برندینگ است — دارنده مجوز باید «Data provided by Pera» را با لوگوی Pera نشان دهد، نشانهای Verified و Suspicious را کنار هر ASA بگذارد و به صفحه همان ASA در Pera Explorer با فراخوان دیدنی «View on Pera Explorer» لینک بدهد.
مشخصات پارسر NFT توضیح میدهد که Pera بانک اطلاعاتی کلکسیبلهایش را چگونه پر میکند: یک وظیفه در حال اجرای پیوسته همه داراییها را میپیماید و فراداده و رسانه را از طریق یک دروازه اختصاصی IPFS واکشی میکند، و یک شیء JSON را NFT نوع ARC3 (فراداده) و یک تصویر یا ویدئو را NFT نوع ARC69 (رسانه) میشناسد. فراداده ARC69 تغییرپذیر است، پس خط پردازش در هر پاس آن را از آخرین تراکنش پیکربندی دارایی از نو تجزیه میکند، در حالی که رسانه ARC3 یک بار واکشی و بعد کش میشود؛ فایلهای بیش از ۱۰۰ مگابایت نادیده گرفته میشوند و واکشیهای ناموفق سه بار دوباره تلاش میشوند. طرحهای URL موبایل هم این مجموعه را با لینکهای perawallet:// کامل میکنند که اپ را در یک کنش مشخص باز میکنند — افزودن حساب تماشایی، فعالسازی یک دارایی، یا پیشپر کردن یک انتقال ALGO یا ASA همراه با یادداشت — با مبالغی که بر حسب میکروآلگو بیان میشوند.
بدهبستانهایی که توسعهدهنده به ارث میبرد
چیزی که مستندات روی آن تأکید نمیکنند این است که این سطوح تا چه اندازه یک پروژه را به یک فروشنده واحد گره میزنند. طرح لینک عمیق فقط Pera را باز میکند، مودال اتصال برند Pera را دارد، و شرایط Public API حکم میکند لوگو و نشانهای Pera نمایش داده شوند و داده بیطرف ارائه نشود — و آن نشانها حاصل کیوریشن خود Pera هستند، نه سابقهای مستقل، چون در همان شرایط آمده که یک نشان بهمعنای تأیید نیست. نه مستندات و نه یادداشتهای انتشار به هیچ ممیزی امنیتی از سوی شخص ثالث روی این SDK اشارهای نمیکنند، پس تیمهایی که آن را برمیگزینند به مهندسی و سابقه Pera تکیه میکنند. آن سابقه واقعی است — بازسازی نسخه ۷.۰ کیف پول و چرخه انتشار ماهانه SDK نشاندهنده نگهداری فعال است — اما در همان حال یعنی Pera، بهعنوان کیف پول پیشفرض اکوسیستم، در هر یکپارچهسازیای که پیش میبرد منافع تجاری دارد. برای تیمهایی که میخواهند فاصله بگیرند دو راه تخفیف وجود دارد: README به رَپر مستقل از کیف پول use-wallet6 برای پشتیبانی چندکیفپولی اشاره میکند، و پرسشهای توسعهدهندگان در کانال #dev-support دیسکورد Pera فرود میآید.
فلگ آزمایشی همان احتیاط صادقانه است: Pera با ARC-27 دارد جهت را نشان میدهد، نه روایتی تمامشده از افزونه را وعده میدهد، و دروازه اختیاریبودن یعنی پذیرندگان اولیه در حال آزمایشاند، نه تکیه کردن. برای تیمی که راحت است Pera را زیرساخت کیف پول خود کند، این SDK سریعترین مسیر از صفر تا یک دکمه کارآمد «اتصال کیف پول» است؛ برای تیمی که میخواهد در میان کیف پولهای Algorand بیطرف بماند، لایههای رَپر یک راه فرار ارائه میدهند. در هر دو حالت، این مرکز مستندات اکنون روشنترین نقشه از این است که کیف پول پیشفرض قصد دارد تجربه توسعهدهنده اکوسیستم را به کجا ببرد.
منبع
- مستندات Pera Wallet3
- @perawallet/connect در npm2
- perawallet/connect در گیتهاب4
- اپ نمونه Pera Wallet5
- docs.perawallet.app7
- docs.perawallet.app8
- Pera Connect | مستندات Pera Wallet9
- مشخصات پارسر NFT | مستندات Pera Wallet10
- طرحهای URL اپ موبایل | مستندات Pera Wallet11
- raw.githubusercontent.com12
- raw.githubusercontent.com13
- کاوشگر Pera Algorand14
- docs.perawallet.app15
- raw.githubusercontent.com16
- مقدمه | مستندات Pera Wallet17
- https://registry.npmjs.org/@perawallet/connect18
۲ رقم این گزارش بررسی شده است.دیدن همهٔ بررسیها
منابع
- 1Pera perawallet.app↩
- 2@perawallet/connect npmjs.com↩
- 3مرکز مستندات فنی Pera docs.perawallet.app↩
- 4مخزن گیتهاب 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 Wallet docs.perawallet.app↩
- 10مشخصات پارسر NFT | مستندات Pera Wallet docs.perawallet.app↩
- 11طرحهای URL اپ موبایل | مستندات Pera Wallet 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 Wallet docs.perawallet.app↩
- 18registry.npmjs.org/@perawallet/connect registry.npmjs.org↩