نادرًا ما تقتصر إضافة عمليات المبادلة إلى منتج EVM على الحصول على عرض سعر للتحويل من الرمز A إلى الرمز B.
عندما يتجاوز التطبيق مرحلة النموذج الأولي البسيط، يحتاج المطورون أيضًا إلى التفكير في كيفية العثور على المسارات، وكيفية إعداد المعاملات، وما الذي يحدث عند زيادة حركة المرور، والشبكات التي يمكن دعمها، والتكاليف التي ستُحمَّل للمستخدمين في نهاية المطاف.
يمكن لواجهة برمجة تطبيقات لمجمّع DEX أن تخفف جزءًا من عبء البنية التحتية، إذ تربط التطبيق بمصادر سيولة متعددة من خلال عملية تكامل واحدة. لكن قبل اختيارها، يحتاج المطورون عادةً إلى إجابات واضحة عن ثلاثة أسئلة:
ما مدى صعوبة دمجها؟ وما تكلفتها؟ وما الشبكات التي تدعمها؟
يتناول هذا الدليل واجهة KyberSwap Aggregator API من خلال هذه الأسئلة الثلاثة، ثم يستعرض بعض العوامل الإضافية المهمة قبل استخدامها في بيئة الإنتاج.
كيف يعمل التكامل مع KyberSwap Aggregator API؟
عادةً ما يكون أول ما يشغل المطوّر ليس عدد الميزات التي توفرها واجهة API، بل مقدار العمل الهندسي المطلوب بين إرسال الطلب الأول وإتاحة مبادلة عاملة داخل المنتج.
صُمّمت KyberSwap Aggregator API للتعامل مع اكتشاف السيولة والتوجيه، مع إبقاء واجهة التطبيق وتدفق التنفيذ تحت سيطرة التطبيق.
بدلًا من دمج منصات تداول لامركزية منفردة وإنشاء منطق توجيه منفصل لكل منصة، يمكن للتطبيق إرسال طلب تداول إلى KyberSwap. ويبحث Aggregator في السيولة المتاحة ويعيد مسارًا يمكن استخدامه بعد ذلك لإنشاء معاملة المبادلة.
كيف يبدو مسار التكامل الأساسي؟
تفصل KyberSwap بين اكتشاف المسار وإنشاء المعاملة.
عندما يحدد المستخدم زوجًا من الرموز ومبلغ التداول، يطلب التطبيق أولًا مسارًا. ويتضمن الرد معلومات مثل الناتج المتوقع وتفاصيل المسار وتقدير الغاز وعقد الموجّه الذي سيُستخدم للتنفيذ.
عندما يصبح المستخدم مستعدًا للتداول، يرسل التطبيق المسار المحدد مجددًا عبر نقطة نهاية الإنشاء، إلى جانب معلمات خاصة بالمعاملة، مثل المرسل والمستلم وحدّ تحمّل الانزلاق السعري والموعد النهائي.
بعد ذلك، يعيد KyberSwap بيانات المعاملة المشفّرة المطلوبة للتنفيذ.
أما بالنسبة إلى المطوّر، فالتدفق واضح:
اعثر على المسار ← أنشئ المعاملة ← دع المستخدم ينفّذها على السلسلة
يمنح فصل هذه المراحل التطبيق تحكمًا أكبر في توقيت التوجيه وفي وقت إعداد المعاملة النهائية. وهذا مهم لأن المسار المعروض للمستخدم قد يصبح قديمًا أثناء مراجعته للتداول أو تغييره للمبلغ.
والنتيجة نموذج تكامل بسيط نسبيًا، من دون إجبار التطبيق على التخلي عن التحكم في تجربة التداول الخاصة به.
ما الذي يحتاج إليه المطوّرون للوصول إلى واجهة API؟
إعداد الوصول مهم لأنه يحدد مدى سرعة بدء الفريق بالاختبار ومدى سلاسة توسيع نطاق التكامل لاحقًا.
توجّه وثائق KyberSwap الحالية المدمجين إلى بوابة Swap API على:
https://api.kyberswap.com/swap/
ينبغي أن تتضمن الطلبات المرسلة إلى هذه البوابة ترويسة X-Api-Key مع كل طلب. ويتعين على المطوّرين الحصول على مفتاح API من فريق KyberSwap أو قسم تطوير الأعمال.
لا يزال عنوان URL الأساسي الأقدم يعمل، لكنه يخضع لحدود على معدل الطلبات، وتوصي الوثائق بالانتقال إلى مسار البوابة. لذا، ينبغي اعتبار البوابة المسار الرئيسي لأي تكامل جديد، لا مجرد ترقية اختيارية.
وهذا يمنح المطوّرين مسارًا أوضح للإطلاق في بيئة الإنتاج منذ البداية.
ماذا يحدث عندما يزداد حجم الطلبات؟
قد يُصدر تطبيق تداول في بيئة الإنتاج طلبات عروض أسعار أكثر بكثير من عدد المبادلات المكتملة.
يغيّر المستخدمون كميات الرموز، ويقارنون بين الأزواج، ويحدّثون عروض الأسعار، أو يغادرون قبل إرسال معاملة. لذلك، قد تولّد المحفظة أو منصة التداول قدرًا كبيرًا من حركة المرور إلى واجهة API، حتى لو كان عدد الصفقات المنفّذة في النهاية أقل بكثير.
لهذا السبب، ينبغي للمطوّرين تقدير حجم طلبات الحصول على عروض الأسعار المتوقعة، لا حجم عمليات المبادلة المتوقعة فحسب.
مع KyberSwap، لا يقتصر السؤال العملي على ما إذا كانت واجهة API قادرة على إرجاع مسار صالح لتداول تجريبي واحد، بل يشمل أيضًا مدى توافق نمط حركة المرور في التطبيق مع الاستخدام المتوقع للبوابة بعد إطلاق المنتج.
بما أن الوثائق الحالية تعرض بوابة Swap API بوصفها المسار الرئيسي للتكامل، ينبغي للفرق التي تتوقع حركة مرور كبيرة في بيئة الإنتاج التخطيط للوصول إلى البوابة بالتنسيق المبكر مع KyberSwap. أما الاعتماد على عنوان URL الأساسي الأقدم، الخاضع لحدود على معدل الطلبات، فهو أنسب للاستخدام القديم منه لإعداد جديد في بيئة الإنتاج.
هل ينبغي استخدام Aggregator API أم KyberSwap Widget؟
لا يحتاج كل فريق إلى تحكّم مباشر في طلبات المسارات وإنشاء المعاملات.
إذا كان الهدف هو إضافة واجهة مبادلة جاهزة بسرعة، فإن أداة KyberSwap Widget توفر مسارًا أسرع مع عمل أقل على الواجهة الأمامية.
إذا كان المنتج يمتلك واجهة تداول خاصة به بالفعل، أو يحتاج إلى التحكم في اختيار الرموز أو طلبات التوجيه أو إنشاء المعاملات أو منطق الرسوم أو تدفق تجربة المستخدم المحيطة، فإن Aggregator API هي الخيار الأكثر مرونة.
يتوقف القرار على مقدار تجربة المبادلة التي يريد المنتج تولّي مسؤوليتها.
ما تكلفة KyberSwap Aggregator API؟
قد تبدو واجهة API غير مكلفة أثناء التطوير، لكنها قد تصبح مكلفة عندما يبدأ المستخدمون التداول على نطاق واسع.
من المفيد للمطوّرين التمييز بين تكلفة الوصول إلى واجهة API وتكلفة تنفيذ المبادلة.
لا تتطلب واجهات KyberSwap العامة اشتراكًا مدفوعًا مقدمًا للاستخدام العام المعتاد. كما أن رسوم المبادلة لدى KyberSwap تبلغ 0%.
لكن هذا لا يعني أن جميع أجزاء المعاملة مجانية.
تُحتسب رسوم الغاز للشبكة من سلسلة الكتل نفسها. أما رسوم مزوّدي السيولة، فقد تُفرض على المجمعات المُدرجة في المسار المحدد.
هذه التكاليف منفصلة عن رسوم Swap الخاصة بـKyberSwap.
هل يمكن للمطوّرين إضافة رسوم خاصة بالمُدمِج؟
تريد بعض المنتجات أن تكون المبادلات مجرد ميزة للمستخدم، بينما تريد منتجات أخرى أن يصبح نشاط التداول جزءًا من نموذج العمل.
تتيح KyberSwap Aggregator API للتطبيق الذي يدمجها ضبط رسوم المُدمِج.
يمكن للمطوّرين تحديد مقدار الرسوم وعنوان استلامها وكيفية تحصيلها ضمن مسار المبادلة. وإذا لم يضبط التطبيق رسومًا للمُدمِج، فلن تُضاف أي رسوم من هذا النوع.
يوفر ذلك للمحافظ وتطبيقات التداول وغيرها من منتجات Web3 وسيلة لتحقيق إيرادات من نشاط المبادلة، مع مواصلة استخدام KyberSwap للتوجيه وإنشاء المعاملات.
رسوم المُدمِج منفصلة عن رسوم المبادلة البالغة 0%.
ما سلاسل EVM التي يمكنك دعمها باستخدام KyberSwap Aggregator API؟
قد يحتاج تطبيق يُطلق اليوم على شبكة واحدة إلى عدة شبكات أخرى لاحقًا.
قد يبدأ مشروع على Base، ثم يتوسع إلى Ethereum وRobinhood Chain. وقد تحتاج المحفظة بعد ذلك إلى Arbitrum أو Optimism. وإذا تطلب كل توسع بنية جديدة بالكامل للمبادلات، فسيزداد عبء الصيانة بالتوازي مع نمو المنتج.
صُمّم KyberSwap Aggregator للعمل عبر شبكات EVM المدعومة باستخدام نموذج التكامل العام نفسه.
يحدد المطوّرون الشبكة المستهدفة في طلب واجهة API، بينما يبحث Aggregator في السيولة المتاحة على تلك الشبكة.
تدعم KyberSwap حاليًا منظومات EVM الرئيسية، بما فيها Ethereum وBase وBNB Chain وArbitrum وOptimism وRobinhood Chain وشبكات أخرى مدعومة.
لا تقتصر القيمة على عدد الشبكات المتاحة.
وتتمثل الفائدة الأكبر في إمكانية إعادة استخدام التطبيق للتدفق العام نفسه لاكتشاف المسارات وإنشاء المعاملات عند توسعه إلى سلاسل مدعومة إضافية.
هل يمكن إعادة استخدام عملية تكامل واحدة عبر عدة شبكات EVM؟
نعم، ما دامت الشبكات مدعومة من KyberSwap.
لنفترض أن تطبيقًا لامركزيًا أُطلق على Base ثم أضاف Ethereum لاحقًا. لن يحتاج التطبيق إلى استبدال طبقة التجميع بأكملها، بل يمكنه الإبقاء على بنية واجهة API العامة نفسها، مع تغيير الشبكة والتعامل مع الرموز والسيولة المتاحة عليها.
يقلّل ذلك مقدار البنية التحتية للتوجيه التي يحتاج الفريق إلى إعادة بنائها في كل مرة يتوسع فيها المنتج.
ينبغي للمطوّرين مع ذلك مراجعة أحدث قائمة بالشبكات المدعومة قبل الإطلاق، إذ قد تتغير تغطية الشبكات مع إضافة منظومات جديدة.
ما العوامل الأخرى التي ينبغي لمطوّري EVM تقييمها؟
يحدد التكامل والتكلفة ودعم الشبكات مدى ملاءمة واجهة API لبنية المنتج.
تحدد جودة التوجيه مدى نجاح هذا التكامل في توفير تجربة مبادلة جيدة للمستخدمين.
لا تكون واجهة API مجانية ذات قيمة كبيرة إذا كان المستخدمون يحصلون باستمرار على تنفيذ ضعيف.
السيولة في التمويل اللامركزي مجزأة بين منصات التداول اللامركزية والمجمعات ومصادر أخرى. وقد لا يكون المسار الأفضل لحجم تداول معين هو الأفضل لحجم آخر.
يبحث KyberSwap Aggregator في السيولة المتاحة بدلًا من إجبار التطبيق على اختيار منصة واحدة مسبقًا. ويمكنه أيضًا تقسيم التداولات عبر مصادر متعددة عندما يحقق المسار المجمّع نتيجة أفضل.
وبالنسبة إلى المستخدمين، يعني ذلك أنهم لا يحتاجون إلى مقارنة عدة منصات تداول لامركزية يدويًا قبل التداول.
بالنسبة إلى المطوّرين، تتمثل الخطوة المهمة في اختبار واجهة API باستخدام أزواج الرموز والشبكات وأحجام التداول الفعلية المتوقعة في المنتج. ويُعدّ العدد الكبير لمصادر السيولة معلومة مفيدة، لكن اختبار المسارات فعليًا يوفر قيمة أكبر لاتخاذ القرار.
هل تناسب KyberSwap Aggregator API تطبيقك المبني على EVM؟
تكون KyberSwap Aggregator API الأنسب عندما تتجاوز المشكلة مجرد إضافة مبادلة بسيطة واحدة.
قد يحتاج المطوّر إلى تجنب صيانة عمليات تكامل متعددة مع منصات تداول لامركزية، أو الإطلاق من دون دفع اشتراك مسبق لواجهة API، أو التوسع عبر شبكات EVM، أو الوصول إلى السيولة المجزأة، أو إنشاء نموذج إيرادات قائم على حجم المبادلات.
تلبي KyberSwap هذه الاحتياجات من خلال بنية Aggregator موحّدة، وتدفق تكامل للعثور على المسار وإنشائه، وإمكانية الوصول إلى واجهة API العامة، ورسوم مبادلة بنسبة 0%، ورسوم مُدمِج قابلة للضبط، ودعم عدة شبكات EVM.
ينبغي مع ذلك اختبار القرار النهائي في ضوء المتطلبات الفعلية للتطبيق.
انظر إلى الشبكات التي يحتاج إليها المنتج، والأزواج التي يُرجح أن يتداولها المستخدمون، وحجم طلبات عروض الأسعار المتوقع، وأحجام التداول المعتادة، ومقدار التحكم الذي يحتاج إليه التطبيق في تجربة المبادلة.
ليس السؤال المفيد مجرد ما إذا كانت KyberSwap Aggregator API تضم ميزات كافية، بل ما إذا كانت تقلل قدرًا كافيًا من أعمال التوجيه والتكامل في المنتج، مع توفير التحكم والجدوى الاقتصادية وتغطية الشبكات التي يحتاج إليها التطبيق.
الأسئلة الشائعة
هل دمج KyberSwap Aggregator API مجاني؟
نعم. يمكن للمطوّرين استخدام KyberSwap Aggregator API دون اشتراك مدفوع مقدمًا في واجهة API. كما أن رسوم المبادلة الخاصة بـKyberSwap Swap تبلغ 0%، مع احتمال استمرار تطبيق رسوم الغاز للشبكة والرسوم التي تفرضها مصادر السيولة الأساسية.
هل تتطلب KyberSwap Aggregator API مفتاح API؟
نعم. توجّه الوثائق الحالية المدمجين إلى بوابة Swap API، وينبغي أن تتضمن الطلبات ترويسة X-Api-Key. ويتعين على المطوّرين الحصول على هذا المفتاح من فريق KyberSwap أو قسم تطوير الأعمال.
لا يزال عنوان URL الأساسي الأقدم يعمل، لكنه يخضع لحدود على معدل الطلبات، وتوصي الوثائق بالانتقال إلى مسار البوابة.
ما شبكات EVM التي تدعمها KyberSwap Aggregator API؟
تدعم KyberSwap عدة شبكات EVM، بما فيها منظومات رئيسية مثل Ethereum وBase وBNB Chain وArbitrum وOptimism وRobinhood Chain. وينبغي للمطوّرين مراجعة أحدث قائمة بالشبكات المدعومة قبل الإطلاق، إذ قد تتوسع التغطية بمرور الوقت.
هل يمكنني استخدام عملية تكامل واحدة مع KyberSwap API عبر عدة شبكات EVM؟
نعم. يمكن إعادة استخدام التدفق العام نفسه لاكتشاف المسار وإنشاء المعاملة عبر شبكات EVM المدعومة، ما يقلل الحاجة إلى صيانة بنية منفصلة للمبادلات لكل سلسلة.