Pera का स्वैप विजेट दूसरे Algorand ऐप्स के भीतर चलने वाला ट्रेड बॉक्स देता है

ऐप के भीतर ही रहने वाला ट्रेड बॉक्स

Pera स्वैप विजेट एक ऐसा ट्रेड बॉक्स है जिसे कोई Algorand ऐप अपनी स्क्रीन के अंदर रख सकता है: विज़िटर वॉलेट जोड़ता है, दो एसेट चुनता है, दर देखता है और हस्ताक्षर करता है — पेज से बाहर कदम ही नहीं रखता। इसके पीछे P.E.R.A. है, वही रूटिंग इंजन जिसे Pera Wallet¹ अपने ऐप में स्वैप्स के लिए इस्तेमाल करता है; अब यह बाहरी डेवलपर्स को एक पैकेज के रूप में दिया जा रहा है, जिसे वे पूरा एम्बेड कर सकते हैं या अपना इंटरफ़ेस बनाते हुए API की तरह कॉल कर सकते हैं।

इसे अपनाने के दो रास्ते हैं। तेज़ रास्ता है Pera के होस्टेड विजेट² की ओर इशारा करता एक iframe, जिसे उसके URL से कॉन्फ़िगर किया जाता है: नेटवर्क, थीम, भीतर जाने वाला एसेट (जब तक कुछ और न कहा जाए, ALGO) और बाहर आने वाला एसेट (डिफ़ॉल्ट रूप से USDC)। पूरा रास्ता यह है कि स्वैप API पर अपनी स्वैप स्क्रीन बनाई जाए; पैकेज का README³ इस चुनाव को यों रखता है — विजेट को 'iframe में एम्बेड करना, चाहें तो अपने ही वॉलेट से लेन-देन पर हस्ताक्षर करना⁴', या 'Pera स्वैप API (कोट्स, लेन-देन, एसेट) के ऊपर अपना स्वैप UI बनाना'।

हस्ताक्षर ही वह हिस्सा है जो तय करता है कि वॉलेट कहाँ रहेगा। पैरेंट साइनिंग चालू होने पर विजेट अपना कोई वॉलेट कनेक्शन नहीं खोलता और हस्ताक्षर के लिए होस्ट पेज से कहता है; README के मुताबिक Pera API उन लेन-देन पर पहले ही हस्ताक्षर कर चुका होता है जो उपयोगकर्ता के खाते से नहीं हैं, इसलिए होस्ट पेज केवल अपने हस्ताक्षर लौटाता है।

इस व्यवस्था में रूटिंग एक ऐसी सुविधा बन जाती है जिसे ऐप कॉल करता है, न कि कोई ऐसी जगह जहाँ उपयोगकर्ता जाता है। ऐप कभी एक्सचेंज नहीं बनता और जिस एसेट का कारोबार हो रहा है उसे कभी अपने पास नहीं रखता; उसे बस वह जगह होना है जहाँ उपयोगकर्ता पहले से मौजूद है। यही ढाँचा हर वहाँ दोहराया जाता है जहाँ कोई on-chain सेवा मुख्यतः रूटिंग का काम करती है, और इससे दूसरी तरफ़ बैठा बिल्डर ही ग्राहक बन जाता है।

इसे आज़माना, और यह उपयोगकर्ता से क्या माँगता है

डेवलपर्स एक डेमो साइट⁵ से शुरुआत करते हैं, जो चार जोड़ने के तरीके दिखाती है: विजेट URL बनाना, कोड में iframe रचना, स्वैप API को सीधे कॉल करना, या हस्ताक्षर पैरेंट पेज को सौंप देना। कोट्स बिना कुछ रखे भी माँगे जा सकते हैं, लेकिन ट्रेड तैयार करने के लिए फंड वाला खाता चाहिए: बिना ALGO वाले पते के लिए लेन-देन माँगने पर 'Algo balance is insufficient' लौटा और कुछ भी नहीं बना।

आम उपयोगकर्ता कुछ भी इंस्टॉल नहीं करता। उसे यह बॉक्स उसी ऐप के अंदर मिलता है जिसने इसे एम्बेड किया है; वह वॉलेट जोड़ता है और कारोबार करता है। अगर खरीदा जा रहा टोकन उसके खाते के लिए नया है, तो स्वैप के हिस्से के रूप में वॉलेट उसे इसे स्वीकार करने का संकेत देता है।

स्वैप पर कितना खर्च होता है, और शुल्क की पंक्ति क्या कहती है

Pera का सहायता केंद्र⁶ बताता है कि वॉलेट स्वैप्स पर 1⁷% तक शुल्क लेता है, जो 'from' एसेट के मूल्य पर गिना जाता है और हस्ताक्षर से पहले कोट स्क्रीन पर Pera Fee के रूप में दिखता है। उसी पेज के अनुसार वेन्यू का अपना पूल शुल्क आम तौर पर 0.25⁸–0.3% होता है, जो उसके मुताबिक लिक्विडिटी प्रदाताओं को जाता है; यह दर पूल की अपनी परंपरा है, नेटवर्क की तय की हुई कोई चीज़ नहीं, और वेन्यू के हिसाब से बदलती है। Algorand का सपाट न्यूनतम 0.001 ALGO प्रति लेन-देन है; Pera का पेज नेटवर्क शुल्क को $0.01⁹ से कम बताता है और कहता है कि यह स्वैप सफल हो या असफल, दोनों हालत में लगता है, और एक स्वैप एक समूह में कई लेन-देन हो सकता है।

शुल्क की पंक्ति किस एसेट में गिनी जाती है, इससे उसका अर्थ बदल जाता है। विजेट की अपनी समीक्षा स्क्रीन Pera Fee को ALGO इकाई के साथ छापती है, और वहाँ पहुँचने के लिए मूल राशि को दस लाख से भाग देती है।

डेमो का पैनल उसी संख्या को अलग नाम देता है। 5 नवंबर के उसके कोट्स में 1 ALGO के उस स्वैप पर Pera Fee 0.01 था जो 0.097522 USDC लौटाता है, और 100 ALGO के उस स्वैप पर Pera Fee 1.00 था जो 9.748322 USDC लौटाता है — दोनों पर 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 तथा स्व-होस्टेड बताता है: चाबियाँ और एसेट उपयोगकर्ता के डिवाइस पर ही रहते हैं, और कंपनी कहती है कि वह रिकवरी वाक्यांश संग्रहीत या पुनर्प्राप्त नहीं करती। इसकी शुरुआत आधिकारिक Algorand Wallet के रूप में हुई थी और फरवरी 2022 में इसका नाम बदला गया; अगस्त में इसने अपने मोबाइल ऐप्स का 7.0¹¹ वाला पूरा पुनर्निर्माण जारी किया (वह खबर), और जनवरी में अपने पुराने on-ramp की जगह वॉलेट-नेटिव फंडिंग प्रवाह Pera Fund लाया।

डेवलपर API की घोषणा Pera के ब्लॉग पर¹² 9 अक्टूबर 2025 को हुई थी, जिसमें P.E.R.A. को Pera Ecosystem Routing Aggregator बताया गया और npm पैकेज तथा एक डेमो ऐप पेश किया गया। पैकेज¹³ 14 अगस्त 2025 से npm पर था; मौजूदा संस्करण 1.0.0¹⁴-beta.5 28 अक्टूबर 2026 को प्रकाशित हुआ, यानी अपने पिछले संस्करण के करीब एक साल बाद। 4 नवंबर तक के तीस दिनों में इसे 466 बार डाउनलोड किया गया¹⁵, और रिपॉज़िटरी³ पर चार स्टार हैं, जिसमें आखिरी बार 2 नवंबर को पुश हुआ। डाउनलोड में लोगों के साथ-साथ स्वचालित इंस्टॉल और मिरर भी गिने जाते हैं, इसलिए इनमें से कोई भी आँकड़ा यह नहीं बताता कि कितने ऐप्स में यह बॉक्स मौजूद है।

लॉन्च पोस्ट इंटीग्रेटरों से 'Stable fee revenue — Earn swap fees in USDC or any preferred stable asset¹⁶' का वादा भी करता है। यह राजस्व कैसे तय होता है, कैसे बँटता है या कैसे वसूला जाता है, यह पैकेज के आसपास प्रकाशित किसी भी सामग्री में नहीं दिखता: क्लाइंट के पास इसके लिए एकमात्र विकल्प एक वैकल्पिक रेफ़रर URL है, जो एट्रिब्यूशन के लिए दस्तावेज़ित है। हो सकता है यह सर्वर-साइड से तय होता हो, या किसी ऐसे फ़ील्ड से जो README में नहीं दिखाया गया।

विकल्प Tinyman का अपना स्वैप विजेट¹⁷ है, जिसे Tinyman की मुख्य टीम दस्तावेज़ित और अनुरक्षित करती है और जो स्वैप्स को Tinyman स्वैप राउटर से गुज़ारता है — कई वेन्यू की खरीदारी की सैर नहीं, बल्कि एक ही वेन्यू का राउटर।

क्या-क्या गड़बड़ हो सकता है

Pera की शर्तें कारोबार को किसी और के ज़िम्मे रखती हैं: उनमें कहा गया है कि Pera 'स्वैप लेन-देन संचालित, नियंत्रित, निष्पादित या निपटाता नहीं है¹⁸' और मूल्य-निर्धारण, निष्पादन तथा रूटिंग पूरी तरह किसी तीसरे पक्ष के प्रोवाइडर से आते हैं, इसलिए गलत तरीके से भरा गया ऑर्डर उपयोगकर्ता और उसे भरने वाले वेन्यू के बीच का मामला है। शुल्क की पंक्ति इससे अलग है: विजेट का अपना शुल्क, जिसे Pera का सहायता केंद्र वॉलेट के विकास और रखरखाव के लिए 1¹⁹% तक बताता है, पूल के हिस्से के ऊपर लगता है।

शर्तों में संयुक्त राज्य अमेरिका, कनाडा, चीन और इज़राइल को भी उन जगहों में गिना गया है जहाँ ALGO का कारोबार प्रतिबंधित हो सकता है, और क्षेत्र के आधार पर पहुँच रोकने का अधिकार सुरक्षित रखा गया है। वहाँ के उपयोगकर्ताओं तक विजेट पहुँचाना एक ऐसा फ़ैसला है जो बिल्डर उस पेज को सामने रखकर लेता है।

पुष्ट हो चुका स्वैप निपट चुका होता है। अगर वह स्क्रीन पर दिखाई दर से खराब दर पर भरता है, उपयोगकर्ता द्वारा अनुमत slippage के भीतर, तो भरा हुआ ऑर्डर वैसा ही रहता है। असफल स्वैप पर भी उसके लिए भेजे गए लेन-देन का शुल्क लगता है — एक स्वैप एक समूह में कई हो सकते हैं — और एसेट वॉलेट में ही रहते हैं।

1.0.0-beta.5 रिलीज़ ने एम्बेड किए गए विजेट और उसके आसपास के पेज के बीच बातचीत की एक खामी बंद की। चेंजलॉग के मुताबिक इससे पहले कोई भी पेज या फ़्रेम हस्ताक्षर का अनुरोध भेज सकता था, वॉलेट का संकेत चला सकता था और हस्ताक्षरित लेन-देन प्राप्त कर सकता था। अब कंट्रोलर केवल Pera के विजेट ओरिजिन से आए संदेश स्वीकार करता है और बाकी को एक बार दिखने वाली कंसोल चेतावनी के साथ अनदेखा कर देता है, और जो कोई विजेट कहीं और होस्ट करता है उसे वह ओरिजिन स्पष्ट रूप से बताना होगा। पुराने संस्करण npm पर बने हुए हैं, इसलिए बिल्डर कौन-सा संस्करण पिन करता है, यही तय करता है कि यह सुरक्षा मौजूद है या नहीं।

डिफ़ॉल्ट नेटवर्क दूसरा जाल है, और डिफ़ॉल्ट दो हैं। विजेट पेज खुद testnet पर डिफ़ॉल्ट है, इसलिए हाथ से लिखा गया ऐसा iframe जिसमें नेटवर्क पैरामीटर नहीं है, विज़िटरों को ऐसी चेन पर पहुँचा देता है जहाँ सिक्कों का कोई मूल्य नहीं। पैकेज के हेल्पर अब हमेशा नेटवर्क भेजते हैं और उसे डिफ़ॉल्ट रूप से mainnet रखते हैं, इसलिए उनके ज़रिए बना विजेट जब तक कुछ और न कहा जाए, mainnet पर खुलता है।

और Pera का अपना दस्तावेज़ केंद्र²⁰ इनमें से किसी का ज़िक्र नहीं करता: वहाँ Pera Connect, एसेट डेटा के लिए एक API, NFT पार्सिंग स्पेक्स और ऐप URL स्कीम्स की सूची है, लेकिन स्वैप API या विजेट की कोई प्रविष्टि नहीं। खोज README, एक ब्लॉग पोस्ट और डेमो के ज़रिए ही होती है।

तो बिल्डर जिस चीज़ पर फ़ैसला ले रहा है वह एक निर्भरता है: साल में लगभग एक बार आने वाला बीटा, जो बदलते ही टूट जाता है, और कोड में पेज से छोटी रूटिंग सूची। जो पाठक यह बॉक्स किसी के ऐप के अंदर देखता है, उसके लिए हस्ताक्षर से पहले स्क्रीन पर जो दिखता है वही मायने रखता है — प्रोवाइडर, न्यूनतम प्राप्ति, price impact, और शुल्क की पंक्ति, उसकी इकाई जाँचते हुए।

स्रोत

• 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)¹⁵