DEX ב-Telegram Mini App על TON: בניית Swaps ונזילות

בניית DEX במיני אפליקציית טלגרם על TON

מערכת האקוסיסטם של TON המריאה: מיני אפליקציות קיבלו גישה ל-900 מיליון משתמשים, הבלוקצ'יין נכנס לחמישייה הראשונה בפעילות DeFi, והנזילות הכוללת בבריכות עלתה על 300 מיליון TON. צוותים רבים ניסו להעתיק את ממשק Uniswap המוכר אך נתקלו בהפתעה — DEX על TON שונה מהותית ממקביליו ב-Ethereum. אנו מתמחים באפליקציות כאלה ומכירים כל מלכודת: מהודעות אסינכרוניות ועד מגבלות webview. DEX טיפוסי על TON אינו העתק של Uniswap; הארכיטקטורה בנויה על מודל השחקנים (actor model), שבו כל חוזה הוא תהליך עצמאי המחליף הודעות דרך תורים. המיני אפליקציה של טלגרם מוסיפה אילוצים משלה: מסך קטן, מחוות, ערכות נושא.

בואו נצלול למאפיינים המרכזיים של החלפת טוקנים.

איך עובד Swap על TON?

ב-Ethereum, swap() הוא פעולה אטומית: או שהכול מתבצע או שהכול מתבטל. ב-TON, כל חוזה הוא שחקן נפרד, וההודעות ביניהם אסינכרוניות. Swap ב-StonFi עובד כך:

1. המשתמש שולח העברת jetton עם קוד פעולה 0xf8a7ea5 לבריכת ה-LP.
2. בריכת ה-LP מעבדת את ההודעה ושולחת בחזרה את ה-jetton הפלט.
3. אם משהו משתבש, הודעת bounce מחזירה את הטוקנים המקוריים.

תהליך זה אורך 3–5 שניות ומספר בלוקים. ממשק המשתמש חייב לשקף זאת: לא ספינר של 5 שניות, אלא מצב ברור של "העסקה נשלחה, ממתינים לאישור". אנו בודקים את סטטוס העסקה דרך TON API (/v2/transactions/{hash}) כל 1–2 שניות. עלות העסקה הממוצעת היא 0.05 TON — בסדר גודל נמוך יותר מאשר ב-Ethereum.

אילו מגבלות מטילה המיני אפליקציה של טלגרם?

המיני אפליקציה רצה ב-webview עם שטח מוגבל — בדרך כלל ברוחב 375px ועד לגובה 600px. הנה שלושה דפוסים שאנו מיישמים בכל פרויקט.

MainButton — הכפתור המקורי של טלגרם בתחתית המסך. אנו משתמשים בו לפעולה הראשית (Swap, אישור), ולא מציגים כפתור משלנו מעליו.

WebApp.MainButton.setText('Подтвердить своп'); WebApp.MainButton.onClick(() => executeSwap()); WebApp.MainButton.show(); 

HapticFeedback — על עסקה מוצלחת: WebApp.MainButton.setText('Подтвердить своп'); WebApp.MainButton.onClick(() => executeSwap()); WebApp.MainButton.show(); . על שגיאה: WebApp.HapticFeedback.notificationOccurred('success'). פרט קטן שמשפר באופן ניכר את תחושת האפליקציה.

ערכת נושא: 'error' מחזירה את הצבעים של ערכת הנושא הנוכחית של טלגרם. האפליקציה חייבת להתאים את עצמה לערכת הנושא הכהה/בהירה של המשתמש, ולא לקבוע ערכת נושא משלה.

BackButton: בעת ניווט לעומק (פרטי עסקה, בחירת טוקן) — הצג WebApp.themeParams, הסתר אותו בחזרה.

איך TON Connect עולה על הארנק המובנה?

TON Connect הוא פרוטוקול חיבור ארנקים, בדומה ל-WalletConnect עבור TON. בהקשר של מיני אפליקציות טלגרם, יש ניואנס: Tonkeeper, MyTonWallet והארנק המובנה של טלגרם כולם מיישמים TON Connect, אך עם יכולות שונות. הארנק המובנה של טלגרם (זמין דרך WebApp.BackButton) עובד רק להעברות TON, לא לפעולות jetton. עבור החלפות DEX, נדרש ארנק חיצוני דרך @tonconnect/ui-react. TON Connect נוח פי 5 להחלפות Jetton: הוא תומך בכל העברה מבוזרת, לא רק TON. המשמעות היא קישור עמוק לאפליקציית הנייד של הארנק — שלב UX נוסף שאנו מסבירים למשתמש באמצעות רמז.

ארכיטקטורת המיני אפליקציה

מחסנית טכנולוגית

כתובות Jetton ופורמט הכתובת הידידותית

ב-TON אין כתובת טוקן גלובלית — לכל משתמש יש כתובת ארנק jetton משלו (נגזרת מחוזה ה-jetton הראשי + כתובת הבעלים). לפני הצגת יתרה או ביצוע swap, יש לקבל את כתובת ארנק ה-jetton של המשתמש:

const jettonMaster = Address.parse(USDT_MASTER_ADDRESS); const jettonWalletAddress = await tonClient.runMethod( jettonMaster, 'get_wallet_address', [{ type: 'slice', cell: beginCell().storeAddress(userAddress).endCell() }] ); 

זוהי קריאה אסינכרונית עבור כל טוקן, אותה אנו שומרים במטמון. ללא מטמון, ממשק המשתמש מתעכב בטעינת יתרות — טעות אופיינית למתחילים.

גרפי מחיר

כדי להציג גרף מחיר בתוך המיני אפליקציה, אנו משתמשים ב-TradingView Lightweight Charts (חבילה מינימלית של ~50KB). נתונים: OHLCV מתת-הגרף של StonFi או מחירים היסטוריים מ-TON API. עדכון דרך WebSocket אם נדרש זמן אמת, או סקירה כל 30 שניות אם זמן כמעט-אמת מספיק. חשוב: גרפים אינם אינטראקטיביים ב-webview לנייד — צביטה לזום מתנגשת עם הגלילה המקורית של טלגרם. אנו מיישמים רק גרף סטטי עם הקשה לצפייה בנר ספציפי.

ניהול נזילות

אם המיני אפליקציה כוללת פונקציונליות LP (הוספה/הסרת נזילות), אנו מציגים את חלק הבריכה הנוכחי ואת ההפסד הזמני (impermanent loss). IL מחושב מחוץ לשרשרת:

IL% = 2 * sqrt(price_ratio) / (1 + price_ratio) - 1 

כאשר window.Telegram.WebApp.openInvoice. אם IL > 5%, אנו מציגים אזהרה למשתמש.

תהליך העבודה

מה כלול

• אינטגרציה של TON Connect ותמיכה במספר ארנקים (Tonkeeper, MyTonWallet).
• ממשק swap מלא עם ניתוב דרך StonFi ו-DeDust.
• הצגת גרף מחיר (TradingView Lightweight Charts).
• מנגנון מטמון לכתובות ארנק jetton לטעינת יתרות מהירה.
• טיפול בעסקאות אסינכרוניות עם סקירת סטטוס והודעות bounce.
• התאמה לערכות נושא של טלגרם (כהה/בהיר) ואלמנטים מקוריים (MainButton, HapticFeedback).
• תיעוד טכני והדרכת צוות.

אנו מפתחים שירותי DeFi כבר למעלה מ-10 שנים והשלמנו 30+ פרויקטים על Ethereum, Solana ו-TON. כל קוד עובר ביקורת עם Slither ו-Mythril. אנו מבטיחים פעילות יציבה של חוזים חכמים ועמידה בלוחות זמנים. צרו קשר כדי להעריך את הפרויקט שלכם — נציע פתרון אופטימלי בהתחשב בדרישות העסקיות שלכם. בקשו פיתוח מיני אפליקציית DEX וקבלו ייעוץ מהנדס.