د Pera د Swap ویجټ د نورو Algorand اپلیکیشنونو دننه د سوداګرۍ فعاله بکس ځای پر ځای کوي

یو د سوداګرۍ بکس چې د اپلیکیشن دننه پاتې کېږي

د Pera Swap ویجټ یو د سوداګرۍ بکس دی چې یو Algorand اپلیکیشن کولای شي خپلو سکرینونو ته دننه یې کړي: یو لیدونکی بټوه نښلوي، دوه شتمنۍ ټاکي، نرخ لولي او لاسلیک کوي، او هېڅکله له پاڼې ونه وځي. د دې شاته P.E.R.A. دی، هغه د لارښوونې انجن چې Pera Wallet¹ په خپل اپلیکیشن کې د تبادلو لپاره کاروي او اوس بهرنیو پراختیا کونکو ته د یوې بستې په توګه وړاندې کېږي چې دوی یې بشپړ دننه کولای شي یا یې د API په توګه رابللای شي او خپله خپل انټرفیس جوړ کړای شي.

دوه لارې د ترلاسه کولو لپاره. ژرترژره لاره یو iframe دی چې د Pera کوربه شوې ویجټ² ته اشاره کوي او د هغې د URL له لارې تنظیمېږي: شبکه، بڼه، هغه شتمني چې داخلېږي (ALGO، ترڅو چې بل ډول ونه ویل شي) او هغه چې راوځي (په ډیفالټ ډول USDC). بشپړه لاره دا ده چې د swap API پر سر خپل د تبادلې سکرین جوړ کړئ؛ د بستې README³ دا انتخاب داسې بیانوي چې ویجټ 'په iframe کې دننه کړئ، په اختیاري ډول د خپلې بټوې سره معاملې لاسلیک کړئ⁴'، یا 'د Pera Swap API (نرخونه، معاملې، شتمنۍ) پر سر خپل د تبادلې UI جوړ کړئ'.

لاسلیک هغه برخه ده چې دا ټاکي چې بټوه چېرې ده. کله چې د مورني لاسلیک (parent signing) اختیار فعال وي، ویجټ خپله هېڅ د بټوې نښلون نه پرانیزي او پرځای یې کوربه پاڼه د لاسلیک کولو غوښتنه کوي؛ README وایي چې Pera API لا دمخه هغه معاملې لاسلیک کړې دي چې د کاروونکي له حساب څخه نه دي، نو کوربه پاڼه یوازې خپل لاسلیکونه بېرته ورکوي.

په دې ترتیب کې، لارښوونه هغه فعالیت ګرځي چې یو اپلیکیشن یې رابولي، نه هغه ځای چې کاروونکی ورته ځي. اپلیکیشن هېڅکله تبادله نه ګرځي او هغه شتمني نه ساتي چې سوداګري پرې کېږي؛ یوازې دا اړتیا لري چې هغه ځای وي چې کاروونکی لا دمخه هلته دی. دا بڼه هر چېرې تکرارېږي چې یو on-chain خدمت ډېری لارښوونه وي، او بل اړخ ته جوړونکی پیرودونکی ګرځوي.

ازموینه یې، او له کاروونکي څه غواړي

پراختیا کونکي له یو ډیمو سایټ⁵ پیل کوي چې څلور نښلونې ښیي: د ویجټ URL جوړول، په کوډ کې iframe جوړول، د swap API مستقیم رابلل، یا لاسلیک مورنۍ پاڼې ته سپارل. نرخونه پرته له دې چې څه ولرئ غوښتل کېدای شي، خو د سوداګرۍ چمتو کول یو تمویل شوی حساب غواړي: هغه غوښتنه چې د یوې پته لپاره چې ALGO نه لري معاملې غواړي، 'Algo balance is insufficient' پیغام راوګرځاوه او هېڅ یې تولید نه کړ.

یو عادي کاروونکی هېڅکله هېڅ شی نه نصبوي. دوی بکس په هغه اپلیکیشن کې ویني چې دننه یې کړی دی، بټوه نښلوي او سوداګري کوي. که هغه ټوکن چې دوی یې اخلي د دوی حساب لپاره نوی وي، بټوه دوی هڅوي چې د تبادلې د یوې برخې په توګه د هغې غړیتوب ومني.

یوه تبادله څه لګښت لري، او د فیس کرښه څه وایي

د Pera مرستې مرکز⁶ وایي چې بټوه پر تبادلو تر 1⁷% پورې فیس اخلي، چې د 'له' شتمنۍ پر ارزښت محاسبه کېږي او د لاسلیک دمخه د نرخ په سکرین کې د Pera Fee په توګه ښودل کېږي. همدا پاڼه د ځای خپل د حوض فیس معمولاً 0.25⁸–0.3% بولي، چې وایي د اوبو برابرونکو ته ځي؛ دا کچه د حوض یو کنوانسیون دی نه هغه څه چې شبکه یې ټاکي، او د ځای له مخې توپیر لري. د Algorand ثابت لږترلږه فیس هرې معاملې لپاره 0.001 ALGO دی؛ د Pera پاڼه د شبکې فیس له $0.01⁹ کم بولي او یادونه کوي چې دا پلي کېږي که تبادله بریالۍ شي یا ناکامه، او یوه تبادله کولای شي په یوه ګروپ کې څو معاملې وي.

چې د فیس کرښه په کومه شتمني حسابېږي، د هغې معنا بدلوي. د ویجټ خپل د بیاکتنې سکرین د Pera Fee سره د ALGO واحد چاپوي او خام مقدار پر یو ملیون وېشي ترڅو هغه ته ورسېږي.

د ډیمو پینل همدا شمېره بل ډول نښانوي. د ۵ نومبر پر نرخونو یې د 1 ALGO تبادلې لپاره چې 0.097522 USDC راګرځوي، Pera Fee 0.01 ښودله، او د 100 ALGO تبادلې لپاره چې 9.748322 USDC راګرځوي، Pera Fee 1.00 ښودله، دواړه د USDC په نښان سره. هغه نمونه کوډ چې د دې پینل شاته دی، فیس د وتونکې شتمنۍ د اعشاري رقمونو او د واحد نوم سره بڼه ورکوي، چې د USDC نښان له همدې ځایه راځي. شمېره په هر حالت کې د هغه څه 1% ده چې کاروونکي دننه کړي — د 1 ALGO 0.01، د 100 ALGO 1.00 — خو که د USDC په توګه ولولل شي، د سوداګرۍ شاوخوا لسمه برخه به وي، چې د Pera پاڼې بیان کړي تر 1% پورې فیس څخه بهر دی. نو د ویجټ ALGO نښان هغه دی چې له خپاره شوي فیس سره سمون لري، او د ډیمو USDC نښان په یوه نمونه کې د بڼې تېروتنې په توګه لولل کېږي؛ چې یو لاسي جوړ شوی انټرفیس څه چاپوي، هغه د هغه چا پورې اړه لري چې جوړوي یې.

هغه ځایونه چې د یوه نرخ شاته دي

د Pera مرستې مرکز¹⁰ د اګریګیټر شاته څلور پلیټ فارمونه نوموي: Vestige، Tinyman، Folks Finance او Deflex (TxnLabs). خپره شوې بسته درې د عرضه کوونکي نومونه تعریفوي چې رابلونکی یې غوښتنه کولای شي — tinyman، tinyman-swap-router او vestige-v4 — او د Folks Finance یا Deflex لپاره هېڅ ارزښت نه لري. یو جوړونکی چې د محصول توضیحات لولي، څلور ځایونه تمه کوي؛ کوډ درې مني.

څوک یې جوړوي، او حال یې څنګه دی

Pera Wallet د Pera Wallet, Lda محصول دی او ځان non-custodial او self-hosted بولي: کیلي او شتمنۍ د کاروونکي پر وسیله پاتې کېږي، او شرکت وایي چې د بیا رغونې عبارات نه ذخیره کوي او نه یې بېرته رغوي. دا د Algorand رسمي Wallet په توګه پیل شو او په فبروري 2022 کې بیا نومول شو، په اګست کې یې د خپلو موبایل اپلیکیشنونو بشپړ 7.0¹¹ بیا جوړون وړاندې کړ (هغه کیسه)، او په جنوري کې یې خپل زوړ on-ramp د بټوې اصلي تمویل بهیر، Pera Fund، سره بدل کړ.

د پراختیا کونکو API په د Pera بلاګ کې¹² د ۲۰۲۵ کال د اکتوبر پر ۹ اعلان شو، چې P.E.R.A. د Pera Ecosystem Routing Aggregator په توګه بیانوي او npm بسته او یو ډیمو اپلیکیشن وړاندې کوي. بسته¹³ له ۲۰۲۵ کال د اګست له ۱۴ راهیسې پر npm وه؛ 1.0.0¹⁴-beta.5، اوسنی نسخه، د ۲۰۲۶ کال د اکتوبر پر ۲۸ خپره شوه، چې د مخکیني نسخې څخه نږدې یو کال وروسته ده. د نومبر تر ۴ پورې په دېرشو ورځو کې 466 ځله ډاونلوډ شوه¹⁵، او مخزن³ څلور ستوري ښیي، چې وروستی فشار د نومبر پر ۲ شوی. ډاونلوډونه اتوماتیک نصبونه او عکسونه هماغسې شمېري لکه خلک، نو هېڅ یوه شمېره نه ښیي چې څو اپلیکیشنونه بکس لري.

د پیل پوسټ همدارنګه نښلوونکو ته 'ثابت د فیس عاید — د تبادلې فیسونه په USDC یا هر غوره شوي سټېبل شتمني کې ترلاسه کړئ¹⁶' ژمنه کوي. چې دا عاید څنګه ټاکل کېږي، وېشل کېږي یا راټولېږي، د بستې شاوخوا خپاره شوي موادو کې هېڅ نه ښکاري: د کلاینټ یوازینی لاسغونډی د هغې لپاره یو اختیاري referrer URL دی چې د نسبت لپاره مستند شوی. دا ممکن د سرور په اړخ ترتیب شوی وي، یا د هغه فیلډ له لارې چې README نه ښیي.

بدیل د Tinyman خپله Swap ویجټ¹⁷ ده، چې د Tinyman اصلي ټیم لخوا مستند او ساتل کېږي او تبادلې د Tinyman Swap Router له لارې لارښوونه کوي — د یوه ځای روټر نه د څو ځایونو ترمنځ د پیرودلو سفر.

څه شی کېدای شي غلط شي

د Pera شرایط خوده سوداګري بل چا ته سپاري: دوی وایي چې Pera 'د تبادلې معاملې نه چلوي، نه کنټرولوي، نه اجرا کوي او نه تصفیه کوي¹⁸' او دا چې نرخ، اجرا او لارښوونه یوازې د دریمې ډلې عرضه کوونکي څخه راځي، نو یوه ناسمه ډکونه د کاروونکي او هغه ځای ترمنځ خبره ده چې ډکه کړې یې ده. د فیس کرښه جلا ده: د ویجټ خپل لګښت، چې د Pera مرستې مرکز یې تر 1¹⁹% پورې بولي ترڅو د بټوې پراختیا او ساتنه تمویل کړي، د حوض پر برخې سربېره پلي کېږي.

شرایط همدارنګه متحده ایالات، کاناډا، چین او اسرائیل هغو ځایونو کې نوموي چېرې چې د ALGO سوداګري ممکن منعه وي، او د سیمې له مخې د لاسرسي بندولو حق خپلوي. ویجټ هغو کاروونکو ته رسول د جوړونکي هغه پرېکړه ده چې هغه پاڼه پرانیستې لري.

یوه تایید شوې تبادله تصفیه شوې ده. که دا له هغه نرخ څخه چې سکرین ښودلی و، په بدتره کچه ډکه شي، د هغې slippage په دننه کې چې کاروونکي اجازه ورکړې وه، ډکونه پاتې کېږي. هغه تبادله چې ناکامه شي، بیا هم د هغې لپاره سپارل شوو معاملو فیسونه لګوي — یوه تبادله کولای شي په یوه ګروپ کې څو وي — او شتمنۍ په بټوه کې پاتې کېږي.

د 1.0.0-beta.5 خپرېدنه د دې په اړه یوه سوري بنده کړه چې دننه شوې ویجټ څنګه له خپلې شاوخوا پاڼې سره خبرې کوي. د هغې دمخه، changelog وایي، هر پاڼه یا فریم کولای شو د لاسلیک غوښتنه ولېږي، د بټوې یو غوښتنلیک راوپاروي او لاسلیک شوې معاملې ترلاسه کړي. کنټرولر اوس یوازې د Pera د ویجټ اصلي سرچینې څخه پیغامونه مني او نور په یو ځلې کنسول خبرداری سره ناګله پرېږدي، او هر څوک چې ویجټ بل چېرې کوربه کوي باید هغه اصلي سرچینه په ښکاره نوم کړي. زاړه نسخې پر npm پاتې دي، نو هغه نسخه چې جوړونکی یې ټاکي، دا ټاکي چې ساتنه شته که نه.

ډیفالټ شبکه بله نښه ده، او دوه ډیفالټونه شته. د ویجټ پاڼه پخپله testnet ته ډیفالټ کېږي، نو یو لاسي لیکل شوی iframe چې د شبکې پیرامیټر پریږدي، لیدونکي په هغه ځنځیر کې ږدي چې سکې یې هېڅ ارزښت نه لري. د بستې مرستندویان اوس تل شبکه لېږي او mainnet ته یې ډیفالټ کوي، نو د دوی له لارې جوړ شوی ویجټ، ترڅو چې بل ډول ونه ویل شي، پر mainnet پرانیستل کېږي.

او د Pera خپل د مستنداتو مرکز²⁰ د دې هېڅ یادونه نه کوي: دا Pera Connect، د شتمنیو معلوماتو لپاره یو API، د NFT تحلیل مشخصات او د اپلیکیشن URL سکیمونه لیستوي، خو د swap API یا ویجټ لپاره هېڅ ننوتنه نه لري. موندنه د README، یو بلاګ پوسټ او ډیمو له لارې ترسره کېږي.

نو یو جوړونکی چې پرېکړه پرې کوي، د یوې تړاوې پورې اړه لري: یوه بیټا چې شاوخوا کال کې یو ځل خپرېږي او کله چې بدلون وکړي ماتېږي، او یو د لارښوونې لیست چې په کوډ کې له پاڼې څخه لنډ دی. د هغه لوستونکي لپاره چې بکس د چا په اپلیکیشن کې ویني، هغه څه مهم دي چې د لاسلیک دمخه پر سکرین دي — عرضه کوونکی، ترلاسه شوې لږترلږه اندازه، د نرخ اغېزه، او د فیس کرښه چې واحد یې بیاکتل شوی وي.

سرچینې

• Swap (registry.npmjs.org)¹³
• Breaking Changes³
• Pera Wallet – How to Swap Tokens in Pera Wallet¹⁰
• Pera Wallet – Understanding Swap Fees and Slippage in Pera⁶
• Introducing the P.E.R.A. API: Seamless Swap Integration | by Joseph Cecala | Pera Wallet¹²
• Pera Swap Widget Examples⁵
• Swap Widget | Tinyman Docs¹⁷
• Pera Wallet – Terms of Service²¹
• Pera swap (github.com)³
• Swap (api.npmjs.org)¹⁵