البدء

مجموعة واجهات برمجة تطبيقات 0x هي الطريقة الأبسط لتمكين التداول الأسرع، والأسعار الأفضل، وتجربة مستخدم متفوقة في تطبيقك. للبدء، ستحتاج إلى إعداد حساب للوصول إلى لوحة تحكم 0x لإنشاء مفاتيح API للمشاريع الجديدة، ومراقبة وإدارة التكاملات، والحصول على واجهات برمجة تطبيقات جديدة والاستفادة من مزيد من موارد المطورين.

اتبع هذه الخطوات للبدء، في أقل من 5 دقائق!

1. إنشاء حساب 0x​

لإنشاء حساب على لوحة تحكم 0x، انقر على التسجيل، وأدخل اسمك وعنوان بريدك الإلكتروني وكلمة المرور، ثم انقر على متابعة

2. إنشاء فريق​

بمجرد التحقق، سيُطلب منك إنشاء فريق على 0x. اختر اسم الفريق وحدد نوع المشروع الذي تقوم ببنائه. يمكنك مشاركة هذا الحساب مع أعضاء فريقك.

3. جولة في لوحة التحكم​

3.1 مفتاح API للاختبار​

بمجرد إنشاء الفريق، ستنتقل إلى لوحة تحكم 0x حيث يمكنك إنشاء وإدارة مفاتيح API الحية، والبحث عن موارد البناء، وتقديم طلبات الدعم.

لاستكشاف قائمة بجميع الشبكات التي يدعمها 0x، راجع ورقة غش 0x.

تأتي لوحة التحكم الخاصة بك مع مفتاح API للاختبار يمكنك استخدامه لإجراء طلبات تجريبية. جربه عن طريق إدراجه في طلب curl وتشغيله من سطر الأوامر الخاص بك لرؤية طلب سعر تبادل حي من Swap API:

// استبدل مفتاح API في الرأس بمفتاحك التجريبي curl —location —request GET ‘https://api.0x.org/swap/v1/quote?buyToken=DAI&sellToken=ETH&sellAmount=100000&excludedSources=Kyber’ —header ‘0x-api-key: [api-key]’

3.2 إنشاء تطبيق​

انقر على إنشاء تطبيق للحصول على مفتاح API حي يمكنه الوصول إلى منتجات 0x المتعددة.

من النافذة المنبثقة، أدخل اسم تطبيقك وتحديد منتجات 0x (Swap API، Orderbook API) التي يجب تمكينها لهذا المفتاح، ثم انقر على متابعة.

ملاحظة: ستظل قادرًا على تحديث منتجات 0x التي يمكن لهذا المفتاح فتحها حتى بعد إنشاء التطبيق.

3.3 إضافة وسم 0x Explorer​

في الشاشة التالية، يمكنك إضافة وسم فريد يمكن استخدامه لتحديد بيانات المعاملات من تطبيقك على 0x Explorer. يمكنك استخدام نفس الوسم لجميع تطبيقاتك، أو إنشاء وسم منفصل لكل منها.

يوفر 0x Explorer بيانات حول معاملات ERC-20 الموجهة عبر 0x API. إنه أداة موثوقة وشفافة لمساعدة المطورين والمستخدمين على التحقق من المعاملات وتحليل النشاط على السلسلة بشكل سهل ودون احتكاك.

اعرف المزيد عن أوصاف 0x Explorer.

يمكنك التخطي الآن وإضافة الوسم لاحقًا.

3.4 الكشف عن مفتاح API​

في الشاشة الأخيرة، انسخ مفتاح API الخاص بك! هذا المفتاح فريد ومربوط بتطبيقك. لا تشاركه. يمكنك أيضًا إنشاء مفاتيح API إضافية للتطبيق إذا احتجت إليها.

ستسمح لك مفاتيح API بالتحقق من الطلبات على 0x. تذكر تحديد المفتاح في طلباتك عبر معلمات رأس 0x-api-key:

// استبدل مفتاح API في الرأس بمفتاحك التجريبي curl —location —request GET ‘https://api.0x.org/swap/v1/quote?buyToken=DAI&sellToken=ETH&sellAmount=100000&excludedSources=Kyber’ —header ‘0x-api-key: [api-key]’

4. إدارة تطبيقك​

من شاشة لوحة التحكم الرئيسية، يمكنك رؤية جميع التطبيقات التي أنشأتها:

انقر على تطبيق لفتح تفاصيله.

لكل تطبيق، يمكنك رؤية ما يلي:

1. رؤية منتجات 0x الممكّنة لمفتاح API الخاص بك - Swap API و/أو Orderbook API.

2. من مفتاح API، رؤية جميع مفاتيح API المرتبطة بهذا التطبيق وإنشاء أو حذف المفاتيح. من الإعدادات، تغيير منتجات 0x الممكّنة لهذا التطبيق. تعيين وسم 0x Explorer الخاص بك. تغيير اسم التطبيق.

3. إذا قمت بإعداد وسم 0x Explorer، يمكنك عرض بياناتك على السلسلة والمعاملات المتعلقة بهذا التطبيق.

4. عرض موارد البناء.

5. إدارة حسابك​

يمكنك العثور على إعدادات إضافية لإدارة حسابك من صورة حسابك الشخصية في الزاوية العلوية اليمنى.

• الإعدادات - يمكنك رؤية اسمك الكامل، واسم الفريق، وبريد حسابك الإلكتروني، بالإضافة إلى تغيير كلمة المرور.

• التواصل مع الدعم - لديك سؤال؟ تواصل مع فريق دعم المطورين لدينا.

• التوثيق - انتقل إلى توثيق المطورين الخاص بنا وابدأ البناء.

• المساعدة - تحتاج مساعدة؟ راجع الأسئلة الشائعة ومركز المساعدة الخاص بنا.

• 0x Explorer - إذا قمت بإعداد وسم 0x Explorer، يمكنك بسهولة تحليل نشاط تطبيقك على السلسلة والمعاملات. اعرف المزيد عن وسم 0x Explorer.

6. لديك سؤال؟​

إذا كنت مسجلاً الدخول إلى لوحة تحكم 0x، لديك خط مباشر إلى فريقنا عبر ماسنجر Intercom لدعم المطورين في الزاوية السفلية اليمنى من لوحة التحكم.

7. ابدأ البناء​

الآن لديك مفتاح API حي، اغمر نفسك في موارد البناء الخاصة بنا وابدأ البناء!

مقدمة عن 0x

نصيحة

تفضل مشاهدة فيديو بدلاً من ذلك؟ انتقل إلى فيديوهات مفاهيم 0x.

ما هو 0x؟​

0x هو المتجر الشامل للمطورين لبناء منتجات مالية على بنية عملات مشفرة. تمكّن 0x مئات المطورين بأدوات web3 الأساسية لتمكين التداول الأسرع، والأسعار الأفضل، وتجربة مستخدم متفوقة. معالجت مجموعة واجهات برمجة التطبيقات الخاصة بنا أكثر من 52 مليون معاملة و125 مليار دولار من الحجم من أكثر من 6 مليون مستخدم يتداولون على تطبيقات مثل Coinbase Wallet وRobinhood Wallet وMetamask وZerion وZapper والمزيد.

نصيحة

ELI5 0x (اشرح 0x كما لو أنني في الخامسة من عمري)​

0x مثل ملعب كبير حيث يمكن للناس تبادل أشياء مختلفة مثل الألعاب والحلوى والملصقات. لكن بدلاً من الألعاب والحلوى، يتداولون أشياء رقمية مثل العملات المشفرة. هناك نوعان من الناس في هذا الملعب: أولئك الذين يجلبون أشياء للتبادل (نسميهم المصنعين) وأولئك الذين يريدون التبادل من أجل تلك الأشياء (نسميهم المستهلكين). يساعد 0x هؤلاء الأشخاص على إيجاد بعضهم البعض وإجراء صفقات بطريقة آمنة وعادلة. إنه مثل وجود شخص بالغ يراقب الملعب للتأكد من أن الجميع يلعب بشكل جيد.

نظام 0x البيئي​

حزمة تقنيات 0x​

واجهات برمجة التطبيقات الاحترافية من 0x مبنية على بروتوكول 0x، وهو مجموعة من العقود الذكية الآمنة والمدققة. التطبيقات التي تبني على هذه الأدوات هي جزء من نظام 0x البيئي.

يوضح الرسم البياني أدناه نظرة عامة على نظام 0x البيئي، والذي يشمل التطبيقات التي توفر السيولة (المصنعين)، والتطبيقات التي تطلب السيولة (المستهلكين).

المصنعون والمستهلكون​

ضمن نظام 0x البيئي، هناك جانبان - المصنعون والمستهلكون:

العرض (أو المصنعين)​

هذه الكيان الذي ينشئ طلبات 0x ويوفر السيولة في النظام لجانب الطلب (المستهلكين) للاستهلاك. يجمع 0x السيولة من مصادر متعددة بما في ذلك:

• السيولة على السلسلة - DEXs، AMMs (مثل Uniswap، Curve، Bancor)

• السيولة خارج السلسلة - صانعو سوق محترفون، شبكة دفتر أوامر 0x المفتوح

• التوثيق ذات الصلة:

• صانعو السوق - صنع سوق احترافي باستخدام أوامر الحد

• Orderbook API - مشاركة أوامر الحد

• أوامر الحد (المتداولون المتقدمون) - تنفيذ وإدارة أوامر الحد

الطلب (أو المستهلكين)​

هذا الكيان الذي يريد أصل المصنّع. يوافق المستهلكون على تبادل أصلهم مقابل أصل المصنّع؛ بعبارة أخرى، هم يستهلكون سيولة 0x. تشمل الأمثلة مشاريع مثل MetaMask وCoinbase وdydx.

• التوثيق ذات الصلة:

• Swap API - أكثر مجمع سيولة كفاءة لرموز ERC20 من خلال واجهة برمجة تطبيقات واحدة.

كيف يعمل 0x؟​

دعنا ننظر إلى كيفية تنفيذ طلب 0x.

1. ينشئ المصنّع طلب 0x وهو كائن json يتوافق مع تنسيق رسالة طلب قياسي (انظر قائمة بجميع أنواع طلبات 0x هنا). يشير إلى نوع الأصل الذي يلتزم المصنّع بتبادله. يمكن أن تشمل الأصول الرموز القابلة للاستبدال (ERC20)، أو الرموز غير القابلة للاستبدال (ERC721)، أو حزم الأصول (ERC1155).

2. يتم تجزئة الطلب، ويوقع المصنّع الطلب لالتزام تشفيري بالطلب الذي كتبه.

3. يتم مشاركة الطلب مع الأطراف المقابلة.

4. إذا كان مصنّع طلب 0x يعرف بالفعل طرفه المقابل المطلوب، يمكنه إرسال الطلب مباشرة (عبر البريد الإلكتروني أو الدردشة أو منصة خارج البورصة).

5. إذا لم يعرف المصنّع طرفًا مقابلًا مستعدًا لاتخاذ الصفقة، يمكنه تقديم الطلب إلى دفتر الأوامر.

6. تجمع واجهة برمجة تطبيقات 0x السيولة عبر جميع مصادر العرض لعرض أفضل سعر للطلب للمستهلك. يساعد 0x المتداولين على إيجاد وملء طلبات 0x من خلال نموذج الإعادة خارج السلسلة والتسوية على السلسلة. هذا يعني أن 0x لا يخزن الطلبات على السلسلة؛ بدلاً من ذلك، يتم تخزين الطلبات خارج السلسلة، ولا تحدث تسوية الصفقات إلا على السلسلة. هذه الميزة الفريدة تجعل 0x بروتوكول DEX مرنًا وموفرًا للغاز للمطورين للبناء عليه.

7. يملأ المستهلك طلب 0x عن طريق تقديم الطلب والمبلغ الذي سيمليه إلى السلسلة.

8. تتحقق منطقية التسوية في بروتوكول 0x من التوقيع الرقمي للمصنّع وأن جميع شروط الصفقة مستوفاة. إذا كان كذلك، يتم تبديل الذرات بين المصنّع والمستهلك. إذا لم يكن كذلك، يتم عكس الصفقة.

ما الذي يمكنني بناؤه على 0x؟​

أدناه قائمة غير شاملة للمشاريع التي تم بناؤها على 0x. لاحظ أنه يمكن أيضًا دمج 0x في أي تطبيق موجود حيث لا يكون التبادل هو الغرض الأساسي من التطبيق. لمزيد من الأمثلة راجع هذه المقالة.

الطلب (المستهلكون)​

• المنصات

• منصة تبادل لعملة X في سوق Y

• سوق شبيه بـ Ebay للسلع الرقمية

• مكتب تداول خارج البورصة (OTC)

• المحافظ

• محافظ رقمية تريد مستخدموها تبادل الرموز

• منصات الخيارات والمشتقات

• بروتوكول DeFi يحتاج إلى السيولة والتبادل للعمل (مثل مشتقات أو اقتراض أو بروتوكول خيارات)

• مديرو المحافظ

• أسواق التنبؤ

• منصة تبادل الرموز غير القابلة للاستبدال (NFT)

• سوق NFT

• ألعاب بها عملات أو عناصر داخل اللعبة

• استراتيجيات الاستثمار (مثل صناديق مؤشرات DeFi، تطبيقات DCA)

• البيانات

• بوابة تحليلات 0x متعددة السلاسل

• لوحة صفقات حية مع أغلفة GraphQL

العرض (المصنعون)​

• نماذج دفتر الأوامر

• نماذج صناع السوق التلقائيين (AMM)

• صناع السوق

• روبوت تداول صناعة سوق أو مراجحة

الأدلة

تسرد هذه الصفحة أكثر الأدلة شيوعًا للبدء في البناء مع 0x بناءً على حالة الاستخدام الخاصة بك

Swap API​

أضف تجميع السيولة بسهولة إلى تطبيقك من خلال واجهة برمجة تطبيقات واحدة. الوصول إلى أكثر من 100 منصة تبادل وآلاف الرموز مع Swap API.

أمثلة الكود​

• (Next.js) تطبيق 0x تجريبي - مثال على تطبيق تبادل ERC20 تم إنشاؤه باستخدام 0x Swap API وNext.js وConnectKit

• (HTML, CSS, Javascript) تطبيق 0x تجريبي

• https://github.com/0xProject/0x-starter-project - مشروع يعرض بروتوكول 0x v4 من خلال مجموعة من الأمثلة القابلة للتشغيل.

الدروس​

• كيفية استخدام Swap API - سيعلمك هذا الدليل كيفية تنفيذ صفقة رمز ERC20 برمجيًا.

• بناء تطبيق تبادل رموز مع Next.js و0x وConnectKit - فيديو يشرح المفاهيم الأساسية للمطورين المهمة عند بناء أي تطبيق تبادل رموز.

• كيفية بناء تطبيق تبادل رموز مع 0x API - محتوى مكتوب وفيديو حول كيفية بناء تطبيق تبادل رموز (تطبيق Matcha.xyz بسيط) باستخدام Swap API. يجمع هذا التطبيق السيولة عبر نظام Dex الأوسع ويعرض أفضل سعر للمستخدم.

• استخدام سيولة 0x API في عقودك الذكية - سيعلمك هذا الدليل كيفية استهلاك اقتراحات تبادل 0x API من داخل عقد ذكي.

• العمل في شبكة الاختبار - تعلم طريقتين لاختبار تبادل رموز ERC20 باستخدام 0x API - إما باستخدام شبكة اختبار Goerli أو نسخ شبكة Ethereum الرئيسية إلى شبكتك الخاصة للاختبار. يتضمن مثالًا قابلًا للتشغيل.