ابْنِ عَرضَ عُروضٍ (QUOTE) للقراءة فقط قبل أن تبني مُبادَلة (SWAP)
معظم أدلّة الـ swap تتجه بسرعة نحو مرحلة التوقيع. الخطوة الأولى المفيدة هي بناء عارض Quote للقراءة فقط باستخدام TypeScript. ستتعلم كيف يتصرف Omniston في STONfi قبل أن تدخل الأموال في الصورة.
📡 العُرض (THE QUOTE) عبارة عن دَفق، وليس لقطة
إن استدعاء Omniston requestForQuote() ليس طلبًا REST عاديًا يعيد سعرًا واحدًا وينتهي. بل يقوم بفتح بثّ حي. يؤكد ack أن طلب RFQ قد تم فتحه، ويقوم quoteUpdated بتسليم الأسعار الحالية، ويعني noQuote أنه لا يوجد مصدر متصل يمكنه تنفيذ الطلب، و تعني unsubscribed أن البث قد انتهى.
الاقتباس/السعر الأول ليس تلقائيًا هو السعر النهائي. التحديثات اللاحقة تعكس تغيّرات السيولة، لذلك احتفظ دائمًا بآخر حدث. يجب على التطبيق عرض أحدث نتيجة بدلًا من تخزين أول نتيجة والتعامل معها على أنها دائمة.
🔢 الميتاداتا والوحدات جزء من الـ QUOTE
يعمل Omniston مع وحدات أساسية على البلوكشين، بينما يفكر المستخدمون في كميات الرموز بشكل طبيعي. توفر API الخاصة بـ STONfi ميتاداتا مثل الرموز والأرقام العشرية (decimals)، لكي يتمكن العارض من تحويل القيم بشكل صحيح.
الدقة ليست موحّدة. تشير الملاحظات إلى أن العديد من TON jettons تستخدم 9 decimals، بينما USDT على TON يستخدم 6. وفخ آخر: JavaScript Number. قد تفقد قيم وحدات الأساس الكبيرة الدقة بعد تجاوز 2^53. BigInt للعمليات الحسابية، وسلاسل نصية للنقل (transport) تحافظ على هذه القيم دقيقة.
🧠 لماذا هذا المشروع الصغير مهم
يمكن للعارض للقراءة فقط أن يصبح أساسًا عمليًا لواجهة الـ swap، أو لمراقبة الأسعار، أو لماسح فرص التحكيم (arbitrage)، أو لروبوت Telegram أو لتغذية بيانات. بمجرد فهم دورة حياة الـ quote وأنواع التسوية وتحويلات المبالغ، يصبح إضافة محفظة خطوة منفصلة.
معمارية هذا التدفق: يخبرك API الخاص بـ STONfi ما هي الأصول، بينما يعثر Omniston على تسعير قابل للتنفيذ عبر مسابح STONfi، وDEX أخرى على TON، ومحلّلات RFQ.
ابنِ طبقة القراءة فقط أولًا. أضف التنفيذ فقط بعد أن تصبح دورة حياة الـ quote واضحة.
NFA - DYOR
$BTC
معظم أدلّة الـ swap تتجه بسرعة نحو مرحلة التوقيع. الخطوة الأولى المفيدة هي بناء عارض Quote للقراءة فقط باستخدام TypeScript. ستتعلم كيف يتصرف Omniston في STONfi قبل أن تدخل الأموال في الصورة.
📡 العُرض (THE QUOTE) عبارة عن دَفق، وليس لقطة
إن استدعاء Omniston requestForQuote() ليس طلبًا REST عاديًا يعيد سعرًا واحدًا وينتهي. بل يقوم بفتح بثّ حي. يؤكد ack أن طلب RFQ قد تم فتحه، ويقوم quoteUpdated بتسليم الأسعار الحالية، ويعني noQuote أنه لا يوجد مصدر متصل يمكنه تنفيذ الطلب، و تعني unsubscribed أن البث قد انتهى.
الاقتباس/السعر الأول ليس تلقائيًا هو السعر النهائي. التحديثات اللاحقة تعكس تغيّرات السيولة، لذلك احتفظ دائمًا بآخر حدث. يجب على التطبيق عرض أحدث نتيجة بدلًا من تخزين أول نتيجة والتعامل معها على أنها دائمة.
🔢 الميتاداتا والوحدات جزء من الـ QUOTE
يعمل Omniston مع وحدات أساسية على البلوكشين، بينما يفكر المستخدمون في كميات الرموز بشكل طبيعي. توفر API الخاصة بـ STONfi ميتاداتا مثل الرموز والأرقام العشرية (decimals)، لكي يتمكن العارض من تحويل القيم بشكل صحيح.
الدقة ليست موحّدة. تشير الملاحظات إلى أن العديد من TON jettons تستخدم 9 decimals، بينما USDT على TON يستخدم 6. وفخ آخر: JavaScript Number. قد تفقد قيم وحدات الأساس الكبيرة الدقة بعد تجاوز 2^53. BigInt للعمليات الحسابية، وسلاسل نصية للنقل (transport) تحافظ على هذه القيم دقيقة.
🧠 لماذا هذا المشروع الصغير مهم
يمكن للعارض للقراءة فقط أن يصبح أساسًا عمليًا لواجهة الـ swap، أو لمراقبة الأسعار، أو لماسح فرص التحكيم (arbitrage)، أو لروبوت Telegram أو لتغذية بيانات. بمجرد فهم دورة حياة الـ quote وأنواع التسوية وتحويلات المبالغ، يصبح إضافة محفظة خطوة منفصلة.
معمارية هذا التدفق: يخبرك API الخاص بـ STONfi ما هي الأصول، بينما يعثر Omniston على تسعير قابل للتنفيذ عبر مسابح STONfi، وDEX أخرى على TON، ومحلّلات RFQ.
ابنِ طبقة القراءة فقط أولًا. أضف التنفيذ فقط بعد أن تصبح دورة حياة الـ quote واضحة.
NFA - DYOR
$BTC
