ABI (واجهة التطبيق الثنائية)

ما ABI في عالم العملات المشفرة؟

ABI اختصار لـ Application Binary Interface، وفي عالم العملات المشفرة يشير عادةً إلى التنسيق المعياري الذي يتيح للمحافظ والتطبيقات اللامركزية والبرامج النصية والعقود الذكية فهم كيفية التفاعل مع عقد ذكي على البلوكشين.

يشبه ABI دليل تعليمات مقروءًا للتواصل مع العقود الذكية.

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

يصف توثيق Solidity الرسمي ABI العقد بأنه الطريقة المعيارية للتفاعل مع العقود في منظومة Ethereum، سواء من خارج البلوكشين أو عند التفاعل بين العقود.

يمكنك مراجعة المصدر التقني في مواصفات Solidity Contract ABI.

ببساطة، ABI هو حلقة وصل بين شيفرة العقد الذكي المقروءة للبشر وبيانات معاملات البلوكشين المقروءة آليًا.

من دون ABI، قد تعرف واجهة المستخدم عنوان العقد، لكنها لن تعرف الأزرار أو النماذج أو المدخلات أو استدعاءات الوظائف التي ينبغي إتاحتها.

يكتسب ABI أهميته لمستخدمي العملات المشفرة لأنه يساعد التطبيقات اللامركزية على عرض إجراءات العقود، مثل التحويل والموافقة والتخزين (Staking) والسك والمطالبة والإيداع والسحب والتصويت والمبادلة.

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

أهمية ABI للعقود الذكية

العقد الذكي برنامج مخزّن على عنوان في البلوكشين، ويتفاعل المستخدمون معه بإرسال بيانات معاملات منسقة على نحو صحيح.

توضح Ethereum أن العقد الذكي برنامج يعمل على عنوان ويحتوي على بيانات ووظائف تُنفذ عند تلقي المعاملات.

يمكنك قراءة الشرح الرسمي في دليل Ethereum حول بنية العقود الذكية.

لا يحتاج البلوكشين نفسه إلى واجهة مستخدم جميلة لتنفيذ وظيفة.

بل يحتاج فقط إلى بيانات مرمزة على نحو صحيح تطابق الوظيفة التي يريد المستخدم استدعاءها.

يساعد ABI البرامج على إنشاء هذه البيانات المرمزة بصورة صحيحة.

فعلى سبيل المثال، قد يتضمن عقد توكن وظيفة تحويل تتطلب عنوان المستلم وكمية التوكن.

يوضح ABI للمحفظة أو التطبيق أن هذه الوظيفة موجودة، وأن المدخل الأول يجب أن يكون عنوانًا، والثاني عددًا صحيحًا غير موقّع.

بعد ذلك، يستطيع التطبيق إنشاء معاملة يفهمها العقد.

ولهذا يُعد ABI من أهم المفاهيم الكامنة وراء واجهات مستخدمي العملات المشفرة.

آلية عمل ABI

يعمل ABI عبر تعريف الواجهة الخارجية للعقد الذكي بتنسيق منظم.

تُكتب معظم واجهات ABI على نمط Ethereum في صورة مصفوفات JSON.

يصف كل كائن في المصفوفة عنصرًا من عناصر العقد، مثل وظيفة أو مُنشئ أو حدث أو وظيفة receive أو وظيفة fallback أو خطأ مخصص.

قد يتضمن ABI الخاص بوظيفة ما اسم الوظيفة وأنواع المدخلات وأنواع المخرجات وقابلية تغيير الحالة.

توضح قابلية تغيير الحالة ما إذا كانت الوظيفة تقرأ البيانات أو تغيرها أو تستقبل عملات أصلية أو تتبع سلوكًا تنفيذيًا آخر.

وقد يتضمن ABI الخاص بحدث ما اسم الحدث والحقول المفهرسة وغير المفهرسة وما إذا كان الحدث مجهولًا.

أما ABI الخاص بخطأ مخصص، فقد يتضمن اسم الخطأ ومعلماته التي توضح سبب تراجع المعاملة.

يتيح هذا الوصف المنظم للبرامج خارج السلسلة تحويل الأوامر الواضحة إلى بيانات استدعاء منخفضة المستوى.

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

ترميز ABI

ترميز ABI هو عملية تحويل استدعاءات الوظائف ومعاملاتها إلى بيانات ثنائية يمكن للآلة الافتراضية لـ Ethereum فهمها.

توضح مواصفات Solidity ABI أن بيانات ABI تُرمّز وفقًا للنوع، وأن الترميز لا يشرح بنيته بنفسه، لذا يلزم مخطط لفك ترميزه.

وهذا المخطط هو ABI.

هذه النقطة مهمة جدًا لأن بيانات المعاملة الخام لا توضح معناها بجلاء.

فقد تمثل سلسلة من البيانات الست عشرية تحويل توكن أو إيداع سيولة أو سك NFT أو تصويتًا في الحوكمة.

يساعد ABI البرامج على تفسير تلك البيانات تفسيرًا صحيحًا.

عندما ينقر المستخدم زرًا في تطبيق لامركزي، يستخدم التطبيق ABI لترميز الوظيفة المحددة ومعاملاتها.

بعد ذلك، تعرض المحفظة طلب المعاملة، ويستطيع المستخدم توقيعه إذا بدت التفاصيل صحيحة.

بعد إرسال المعاملة، ينفذ البلوكشين التعليمات المرمزة على العقد.

وهكذا تنتقل إجراءات كثيرة شائعة في عالم العملات المشفرة من صفحة ويب إلى معاملة فعلية على السلسلة.

محددات الوظائف

محدد الوظيفة هو أول أربعة بايتات من البيانات المرمزة، ويُستخدم لتحديد وظيفة العقد الذكي المطلوب استدعاؤها.

في العقود على نمط Ethereum، يُنشأ محدد الوظيفة من هاش Keccak-256 للتوقيع المعياري للوظيفة.

يتضمن توقيع الوظيفة المعياري اسم الوظيفة وأنواع المعاملات، مثل transfer(address,uint256).

يساعد ABI البرامج على معرفة هذا التوقيع وإنشاء بيانات الاستدعاء الصحيحة.

على سبيل المثال، لا يرسل تحويل التوكنات إلى البلوكشين عبارة «حوّل هذا التوكن».

بل يرسل حمولة مختصرة بصيغة ست عشرية تبدأ بمحدد الوظيفة، ثم تتبعها المعاملات المرمزة.

يقرأ العقد المستلِم المحدد ويوجه التنفيذ إلى الوظيفة المطابقة.

إذا لم يطابق المحدد أي وظيفة متاحة، فقد يستخدم العقد وظيفة fallback أو يرفض الاستدعاء.

يجعل هذا النظام التفاعل مع العقود الذكية فعالًا، لكنه يجعل ABI ضروريًا لفهمه بلغة مقروءة للبشر.

ABI وعناوين العقود

يخبر عنوان العقد البرامج بمكان وجود العقد الذكي على السلسلة.

أما ABI فيوضح للبرامج كيفية التواصل مع ذلك العقد.

عادةً ما تكون القطعتان ضروريتين لتوفير تجربة استخدام جيدة.

إذا لم يكن لدى المطور سوى العنوان، فيمكنه إرسال بيانات معاملات خام، لكنه قد لا يعرف بسهولة الوظائف المتاحة.

وإذا لم يكن لديه سوى ABI من دون عنوان، فسيعرف الواجهة لكنه لن يعرف العقد المنشور الذي ينبغي استدعاؤه.

يتيح عنوان العقد وABI معًا للتطبيق إنشاء مثيلات للعقد باستخدام مكتبات Web3 الشائعة.

بعد ذلك، يمكن استخدام مثيل العقد لاستدعاء وظائف القراءة وتقدير رسوم الغاز وتجهيز المعاملات والاستماع إلى الأحداث.

ولهذا تطلب دروس المطورين في كثير من الأحيان عنوانًا وABI قبل شرح التفاعل مع عقد منشور.

ABI ووظائف القراءة

وظائف القراءة هي وظائف في العقود الذكية تسترجع المعلومات من دون تغيير حالة البلوكشين.

غالبًا ما تُعرّف هذه الوظائف في Solidity بأنها view أو pure.

يمكن لتطبيق لامركزي استخدام ABI لاستدعاء وظائف القراءة وعرض بيانات مثل أرصدة التوكنات وإجمالي العرض وعناوين المالكين وصفقات التخزين ومعلمات المجمع أو تفاصيل مقترحات الحوكمة.

تُعالج استدعاءات القراءة عادةً عبر أساليب RPC للعقد، ولا تتطلب من المستخدمين دفع رسوم الغاز عندما يقتصر الأمر على الاستعلام عن البيانات محليًا عبر عقدة.

يوضح توثيق JSON-RPC من Ethereum كيف تتواصل التطبيقات مع عقد Ethereum عبر أساليب RPC معيارية.

يمكنك مراجعة المرجع الرسمي في توثيق Ethereum JSON-RPC API.

يساعد ABI التطبيق على ترميز طلب القراءة وفك ترميز الاستجابة المستلمة.

من دون ABI، قد تظهر الاستجابة في صورة بيانات ست عشرية خام فقط.

ABI ووظائف الكتابة

وظائف الكتابة هي وظائف العقود الذكية التي يمكنها تغيير حالة البلوكشين.

تشمل الأمثلة تحويل التوكنات، والموافقة على إنفاقها، وسك الأصول، والمطالبة بالمكافآت، وتخزين العملات، وإنشاء المقترحات، أو تغيير إعدادات البروتوكول.

بما أن وظائف الكتابة تغير الحالة، فإنها تتطلب عادةً معاملة موقعة ورسومًا للشبكة.

يساعد ABI المحفظة أو التطبيق اللامركزي على إعداد بيانات المعاملة الصحيحة لاستدعاء الوظيفة.

عندما يوقع المستخدم المعاملة، تبثها المحفظة إلى شبكة البلوكشين.

بعد ذلك، يُدرج المدققون المعاملة في كتلة إذا كانت صالحة ودُفعت رسومها على نحو صحيح.

لا يحدد ABI ما إذا كانت المعاملة آمنة أو مربحة.

إنه يصف فقط بنية الاستدعاء التي يتوقعها العقد.

ما زال على المستخدمين التحقق مما يوقعونه، لا سيما عند الموافقة على مخصصات التوكنات أو التفاعل مع عقود غير مألوفة.

ABI والأحداث

الأحداث إشارات تصدرها العقود الذكية لمساعدة التطبيقات على تتبع ما حدث أثناء المعاملة.

فعلى سبيل المثال، قد يصدر عقد توكن حدث Transfer عند انتقال التوكنات من عنوان إلى آخر.

وقد يصدر عقد إقراض أحداثًا عندما يودع المستخدمون الأصول أو يقترضونها أو يسددونها أو يسحبونها.

وقد يصدر عقد NFT أحداثًا عند سك التوكنات أو تحويلها أو الموافقة عليها.

يصف ABI أسماء الأحداث وأنواع معاملاتها كي تتمكن البرامج من فك ترميز السجلات وتحويلها إلى بيانات مقروءة.

وهذا مهم لأن محافظ العملات المشفرة ولوحات المعلومات وأدوات التحليلات والمفهرسات وأدوات تتبع المحافظ تستخدم سجلات البلوكشين على نطاق واسع.

الأحداث مفيدة للبشر ولغيرهم.

فهي تساعد الأنظمة الخلفية أيضًا على متابعة النشاط من دون قراءة كل تغيير داخلي في التخزين مباشرةً.

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

ABI ومعايير التوكنات

تعتمد معايير التوكنات بدرجة كبيرة على واجهات متوقعة.

على سبيل المثال، تستخدم عقود التوكنات القابلة للاستبدال عادةً وظائف معيارية مثل totalSupply وbalanceOf وtransfer وallowance وapprove وtransferFrom.

يحدد معيار ERC-20 واجهة مشتركة للتوكنات القابلة للاستبدال على الشبكات الشبيهة بـ Ethereum.

يمكنك مراجعة المعيار مباشرةً في معيار التوكنات EIP-20.

بما أن كثيرًا من التوكنات تستخدم أسماء وظائف وأنواع معاملات معيارية مشتركة، يمكن للمحافظ والتطبيقات اللامركزية دعمها بسهولة أكبر.

يجعل ABI هذا الدعم عمليًا، إذ تستطيع البرامج استدعاء الوظائف المتوقعة وفك ترميز الأحداث المتوقعة.

تعتمد معايير التوكنات غير القابلة للاستبدال والتوكنات المتعددة أيضًا على واجهات محددة.

وهذا أحد أسباب قدرة منظومات العملات المشفرة على إنشاء محافظ وأسواق ومستكشفات وأدوات تحليلات قابلة لإعادة الاستخدام.

تقلل الواجهات المعيارية الحاجة إلى تكاملات مخصصة وتحسن قابلية التشغيل البيني بين التطبيقات.

ABI واكتشاف الواجهات ERC-165

يوضح ABI للبرامج كيفية التفاعل مع العقد، لكن بعض العقود تدعم أيضًا اكتشاف الواجهات.

ERC-165 معيار يتيح للعقود الإعلان عن دعمها لواجهات محددة.

يذكر مقترح ERC-165 الرسمي أنه يوحد مفهوم الواجهات وطرق تحديدها.

يمكنك قراءة المعيار في معيار اكتشاف الواجهات ERC-165.

يكتسب ذلك أهميته لأن التطبيق قد يحتاج إلى معرفة ما إذا كان العقد يدعم معيار توكنات معينًا أو مجموعة ميزات محددة.

فعلى سبيل المثال، قد يتحقق تطبيق NFT من دعم العقد لواجهة NFT محددة قبل عرض الميزات المتقدمة.

يرتبط ABI وERC-165، لكنهما ليسا الشيء نفسه.

يصف ABI الوظائف والأحداث القابلة للاستدعاء، بينما يوفر ERC-165 طريقة معيارية للتحقق وقت التشغيل من الواجهات المدعومة.

تنسيق ABI JSON

أكثر تنسيقات ABI شيوعًا هو ملف JSON أو مصفوفة JSON ينشئها مُصرّف العقد الذكي.

يتضمن إدخال ABI النموذجي حقولًا مثل type وname وinputs وoutputs وstateMutability وanonymous.

يحدد حقل type ما إذا كان عنصر ABI وظيفة أو حدثًا أو مُنشئًا أو وظيفة receive أو وظيفة fallback أو خطأ.

يسرد حقل inputs المعاملات التي يتوقعها العقد.

ويسرد حقل outputs القيم التي يعيدها العقد.

يصف حقل stateMutability ما إذا كانت الوظيفة view أو pure أو payable أو nonpayable.

ينطبق حقل anonymous على الأحداث ويؤثر في طريقة تسجيل الحدث.

قد تدعم مكتبات المطورين أيضًا تنسيقات ABI مقروءة للبشر لتسهيل الاستخدام.

فعلى سبيل المثال، توثق ethers.js طرقًا متعددة لتمثيل أجزاء ABI في توثيق ABI.

ABI في التطبيقات اللامركزية

يستخدم التطبيق اللامركزي ABI لربط واجهته الأمامية بالعقود الذكية.

قد تبدو الواجهة الأمامية كأي موقع عادي، لكن أزرارها غالبًا ما تستدعي قراءة العقود أو الكتابة إليها.

عندما يفتح المستخدم صفحة تخزين، قد يستخدم التطبيق ABI لقراءة رصيد المستخدم المخزن حاليًا.

وعندما ينقر المستخدم زر التخزين، قد يستخدم التطبيق ABI لترميز معاملة التخزين.

وعند اكتمال المعاملة، قد يستخدم التطبيق واجهات ABI الخاصة بالأحداث لتحديث سجل النشاط المعروض.

هذا الإجراء شائع في التمويل اللامركزي وNFTs والألعاب والهوية اللامركزية والحوكمة والمكافآت على السلسلة.

لذلك يُعد ABI جزءًا أساسيًا لكنه خفي من تجربة المستخدم.

لا يرى معظم المستخدمين ABI مباشرةً، لكنهم يعتمدون عليه كلما عرض تطبيق لامركزي وظائف العقد بطريقة واضحة.

ABI في المحافظ

تستخدم المحافظ معلومات ABI لتوضيح ما قد تفعله المعاملة للمستخدمين.

قد تعرض المحفظة القادرة على فك ترميز بيانات المعاملة اسم الوظيفة ومعاملاتها بدلًا من البيانات الست عشرية الخام فقط.

يجعل ذلك التوقيع أكثر أمانًا، إذ يساعد المستخدمين على فهم ما إذا كانوا يوافقون على توكنات أو يحولون أصولًا أو يسكّون NFTs أو يتفاعلون مع وحدة عقد.

لكن موثوقية البيانات المفكوكة تظل مرتبطة بموثوقية ABI وطريقة تفسير المحفظة لها.

قد تضلل واجهة ضارة المستخدمين قبل ظهور مطالبة المحفظة.

كما قد يجعل عقد غامض وظيفةً ما تبدو غير ضارة بينما تؤدي إلى آثار غير متوقعة.

ينبغي للمستخدمين التعامل مع فك ترميز ABI بوصفه طبقة أمان مفيدة، لا ضمانًا كاملًا.

في المعاملات عالية القيمة، ينبغي للمستخدمين التحقق من العقد والوظيفة والمستلم وكمية التوكنات ونطاق الموافقة قبل التوقيع.

ABI في مستكشفات البلوكشين

غالبًا ما تستخدم مستكشفات البلوكشين واجهات ABI لتسهيل قراءة صفحات العقود.

عند التحقق من العقد، يمكن لمستكشف البلوكشين عرض وظائف العقد المقروءة والمعاملات المفكوكة الترميز وسجلات الأحداث.

يساعد ذلك المستخدمين على فحص تحويلات التوكنات واستدعاءات العقود الذكية وإعدادات الملكية وعلاقات البروكسي ونشاط الحوكمة.

من دون معلومات ABI، قد لا يعرض مستكشف البلوكشين سوى بيانات الإدخال الخام والسجلات منخفضة المستوى.

قد تظل تلك البيانات الخام مفيدة للباحثين المتقدمين، لكنها أصعب فهمًا لمعظم المستخدمين.

تساعد واجهات ABI المدققين والمحللين وأفراد المجتمع أيضًا على مراجعة طريقة عمل البروتوكول على السلسلة.

في عالم العملات المشفرة، لا تعتمد الشفافية على البيانات العامة وحدها، بل أيضًا على الأدوات التي تفك ترميزها بشكل صحيح.

يُعد ABI من الأدوات الأساسية التي تجعل شفافية البلوكشين عملية.

ABI والتحقق من العقود

التحقق من العقد هو عملية مطابقة البايت كود المنشور مع الشيفرة المصدرية المنشورة وإعدادات المُصرّف.

عند التحقق من عقد ذكي، يمكن للمستخدمين في كثير من الأحيان فحص الشيفرة المصدرية وABI معًا.

يعزز ذلك الثقة، إذ يستطيع المستخدمون معرفة ما إذا كان ABI يطابق الواجهة الفعلية للعقد بعد تصريفه.

لكن التحقق لا يجعل العقد آمنًا تلقائيًا.

فقد يحتوي العقد الموثق على أخطاء أو صلاحيات سيئة أو ضوابط ترقية محفوفة بالمخاطر أو تعليمات ضارة.

مع ذلك، يمنح التحقق المستخدمين والباحثين معلومات أكثر مما يمنحهم عقد غير موثق.

يكتسب ABI أهمية خاصة بعد التحقق، لأنه يتيح للواجهات ومستكشفات البلوكشين عرض تفاعلات العقود بطريقة منظمة.

ينبغي للمستخدمين تفضيل العقود الموثقة متى أمكن، مع الاستمرار في مراجعة الصلاحيات وعمليات التدقيق والملكية والسلوك على السلسلة.

ABI والبايت كود

يرتبط ABI والبايت كود ارتباطًا وثيقًا، لكنهما مختلفان تمامًا.

البايت كود هو الشيفرة الآلية المُصرّفة التي تعمل على الآلة الافتراضية للبلوكشين.

أما ABI فهو وصف الواجهة الذي يوضح للبرامج كيفية استدعاء ذلك البايت كود من الخارج.

يمكن أن يوجد عقد ذكي على السلسلة في صورة بايت كود حتى لو لم يكن ABI متاحًا للعامة.

في هذه الحالة، قد يظل المستخدمون المتقدمون قادرين على التفاعل مع العقد عبر إنشاء بيانات الاستدعاء يدويًا.

يحتاج معظم المستخدمين والتطبيقات إلى ABI للتفاعل مع العقد بسهولة وأمان.

البايت كود هو ما ينفذه البلوكشين.

أما ABI، فتستخدمه الأدوات الخارجية لفهم طريقة التواصل مع تلك الشيفرة التنفيذية.

ABI وعقود البروكسي

تضيف عقود البروكسي طبقة أخرى من التعقيد إلى استخدام ABI.

عقد البروكسي عقد يوجّه الاستدعاءات إلى عقد آخر يحتوي على المنطق الأساسي.

يُستخدم هذا النمط غالبًا للعقود الذكية القابلة للترقية.

قد يظل عنوان البروكسي كما هو بينما يتغير عقد التنفيذ.

في هذا الإعداد، قد يحتاج المستخدمون إلى ABI الخاص بعقد التنفيذ بدلًا من ABI الأساسي للبروكسي وحده.

إذا استُخدم ABI غير صحيح، فقد تعرض الواجهة وظائف مفقودة أو غير صحيحة أو بيانات معاملات مربكة.

ولهذا تحاول كثير من مستكشفات البلوكشين وأدوات المطورين اكتشاف علاقات البروكسي.

ينبغي للمستخدمين الانتباه أكثر إلى العقود القابلة للترقية، إذ قد يتغير منطق العقد إذا سمحت الحوكمة أو صلاحيات المسؤول بالترقيات.

ABI والأخطاء المخصصة

يمكن لعقود Solidity الحديثة استخدام أخطاء مخصصة لتوضيح سبب تراجع المعاملة.

تكون الأخطاء المخصصة في كثير من الحالات أكثر كفاءة من حيث استهلاك الغاز مقارنةً برسائل التراجع الطويلة.

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

على سبيل المثال، قد تعرض معاملة فاشلة رسالة خطأ توضح أن المستدعي غير مخول أو أن كمية الإدخال منخفضة جدًا.

من دون دعم ABI، قد لا يرى المستخدم سوى قيمة خطأ ست عشرية مربكة.

قد تساعد الأخطاء المخصصة المفكوكة الترميز المطورين على تصحيح العقود، كما تساعد المستخدمين على فهم المعاملات الفاشلة.

وهذا مثال آخر على دور ABI في تحسين سهولة استخدام أنظمة البلوكشين.

لا تلغي عملية فك الترميز المحسنة المخاطر، لكنها تساعد الناس على فهم ما حدث.

مخاطر أمان ABI

لا يكون ABI نفسه عادةً مصدر مخاطر العقود الذكية، لكن معلومات ABI الخاطئة أو المضللة قد تسبب ارتباكًا خطيرًا.

قد يجعل ABI مزيف تفاعل العقد يبدو مختلفًا عما ينفذه فعليًا.

قد يخفي ABI قديم وظائف جديدة أو يعرض سلوكًا قديمًا لم يعد يطابق التنفيذ المنشور.

وقد يمنع ABI غير المكتمل المستخدمين من رؤية كل الوظائف أو الأحداث المتاحة.

قد يستخدم تطبيق لامركزي ضار ABI حقيقيًا، لكنه يعرض واجهة مستخدم مضللة.

وقد يجعل عقد البروكسي تفسير ABI أصعب إذا تغير التنفيذ بمرور الوقت.

ينبغي للمستخدمين عدم افتراض أن أسماء الوظائف المقروءة تعني تلقائيًا أن المعاملة آمنة.

بل ينبغي لهم التحقق من عناوين العقود والرجوع إلى مصادر موثوقة وقراءة مطالبات المحفظة بعناية والحد من موافقات التوكنات وتجنب توقيع المعاملات التي لا يفهمونها.

حالات الاستخدام الشائعة لـ ABI

يستخدم المطورون واجهات ABI لإنشاء تطبيقات لامركزية تستدعي وظائف العقود الذكية.

وتستخدمها المحافظ لفك ترميز طلبات المعاملات وتحسين وضوح التوقيع.

كما تستخدمها مستكشفات البلوكشين لعرض استدعاءات العقود وسجلات الأحداث بطريقة مقروءة.

وتستخدمها المفهرسات لجمع بيانات السلسلة وتنظيمها لأغراض التحليلات.

ويستخدمها المدققون لفهم واجهات العقود الخارجية واختبار التفاعلات.

وتستخدمها روبوتات التداول وبرامج الأتمتة النصية لاستدعاء وظائف العقود برمجيًا.

وتستخدمها لوحات الحوكمة لقراءة المقترحات والتصويتات وإعدادات النصاب وحالة التنفيذ.

وتستخدمها أدوات المحافظ لقراءة الأرصدة والصفقات والمكافآت والنشاط التاريخي.

في كل هذه الحالات، يجعل ABI ترميز بيانات العقود وفك ترميزها وعرضها واستخدامها أسهل.

مثال مبسط على ABI

تخيل آلة بيع تقبل رموز أزرار محددة.

قد تدعم الآلة إجراءات مثل شراء وجبة خفيفة، والتحقق من المخزون، وإعادة تعبئة منتج، وجمع الأموال.

لا يريد الشخص العادي إرسال أوامر ثنائية على مستوى الآلة يدويًا.

بل يريد قائمة واضحة تعرض الإجراءات المتاحة والمدخلات المطلوبة.

يؤدي ABI دورًا مشابهًا للعقود الذكية.

فهو يوضح للبرامج الإجراءات المتاحة والمعلومات التي يتطلبها كل إجراء.

بعد ذلك، يستطيع البرنامج تحويل اختيار المستخدم إلى البيانات المرمزة الدقيقة التي يتوقعها العقد.

ولهذا يُوصف ABI غالبًا بأنه واجهة التواصل الخاصة بالعقد.

ABI مقابل API

يبدو ABI وAPI متشابهين، لكنهما ليسا الشيء نفسه.

API اختصار لـ Application Programming Interface، ويصف عادةً كيفية تواصل الأنظمة البرمجية على مستوى أعلى.

أما ABI، فهو اختصار لـ Application Binary Interface، ويصف كيفية تواصل البرامج على مستوى البيانات الثنائية.

في عالم العملات المشفرة، قد يتيح API للتطبيق طلب أسعار التوكنات أو الأرصدة أو سجل المعاملات من خدمة ما.

بينما يتيح ABI للتطبيق ترميز التفاعلات المباشرة مع العقود الذكية وفك ترميزها.

قد يستخدم التطبيق اللامركزي API وABI في الوقت نفسه.

فعلى سبيل المثال، قد يستخدم التطبيق API لبيانات السوق وABI لمعاملات التخزين على السلسلة.

يساعد API على تدفق المعلومات، بينما يساعد ABI على تنفيذ العقود وفك ترميزها.

كيفية الحصول على ABI لعقد

يحصل المطورون عادةً على ABI من مخرجات مُصرّف العقد الذكي.

عند تصريف عقد Solidity، يمكن للمُصرّف إنشاء كل من البايت كود وبيانات ABI.

يُنشر البايت كود على البلوكشين.

ويُحفظ ABI لتستخدمه التطبيقات التي تحتاج إلى التفاعل مع العقد المنشور.

قد يجد المستخدمون واجهات ABI أيضًا في صفحات العقود الموثقة أو مستودعات المشروع الرسمية أو توثيق المطورين أو إصدارات الحزم.

غالبًا ما يكون المصدر الأكثر أمانًا هو توثيق المشروع الرسمي أو سجل عقد موثق يطابق العنوان والشبكة المحددين.

ينبغي للمستخدمين الحذر عند نسخ ملفات ABI من مواقع عشوائية أو محادثات أو مصادر غير موثقة.

قد يؤدي ABI غير الصحيح إلى فشل المعاملات أو عرض معلومات مضللة أو فك ترميز البيانات على نحو خاطئ.

كيف يستخدم المطورون ABI

يستورد المطور عادةً ABI إلى مكتبة Web3 ويجمعه مع عنوان العقد.

بعد ذلك، تنشئ المكتبة كائن عقد يتيح استدعاء الوظائف المطابقة لـ ABI.

يمكن للمطور استخدام هذا الكائن لقراءة حالة العقد وإرسال المعاملات وتقدير رسوم الغاز والاستماع إلى الأحداث.

هذا الإجراء شائع في بيئات تطوير البلوكشين باستخدام JavaScript وTypeScript وPython وRust وGo وغيرها.

يستخدم المطورون واجهات ABI في الاختبارات أيضًا للتحقق من عمل العقود كما ينبغي.

وتستخدمها الخدمات الخلفية لمراقبة الأحداث وتحديث قواعد البيانات عند وقوع نشاط على السلسلة.

أما تطبيقات الواجهة الأمامية فتستخدمها لعرض الأزرار والنماذج ومطالبات المعاملات.

في أنظمة الإنتاج، تكتسب إدارة إصدارات ABI أهميتها لأن ترقيات العقود قد تغير الوظائف والأحداث المتاحة.

أخطاء شائعة في استخدام ABI

من الأخطاء الشائعة استخدام ABI لإصدار غير صحيح من العقد.

ومنها أيضًا استخدام ABI الصحيح مع عنوان عقد خاطئ.

الخطأ الثالث هو استخدام ABI من شبكة ما عند التفاعل مع عقد على شبكة أخرى.

والخطأ الرابع هو تجاهل عقود البروكسي واستخدام ABI الخاص بالبروكسي عندما تكون هناك حاجة إلى ABI الخاص بالتنفيذ.

والخطأ الخامس هو الوثوق بواجهة المستخدم دون التحقق من مطالبة المحفظة الفعلية.

والخطأ السادس هو افتراض أن اسم الوظيفة المفكوك ترميزه يشرح كل إجراء داخلي قد ينفذه العقد.

والخطأ السابع هو الموافقة على إنفاق غير محدود للتوكنات من دون فهم ما يستطيع العقد المعتمَد فعله.

توضح هذه الأخطاء فائدة معرفة ABI حتى للمستخدمين غير المطورين.

أهمية ABI لأمان العملات المشفرة

تساعد معرفة ABI المستخدمين على فهم ما تعرضه المحافظ والتطبيقات اللامركزية.

عندما تعرض المحفظة وظيفة مفكوكة الترميز، يكون ABI غالبًا جزءًا من عملية فك الترميز.

يستطيع المستخدم الذي يفهم ABI إدراك سبب ظهور بعض تفاعلات العقود أحيانًا في صورة بيانات خام.

قد يقلل ذلك من القلق عندما يصعب فك ترميز عقد مشروع.

وقد يزيد الحذر أيضًا عندما تعرض مطالبة المعاملة موافقة خطيرة أو وظيفة غير مألوفة.

تكون معرفة ABI مفيدة خصوصًا في التمويل اللامركزي، لأن كثيرًا من الإجراءات تتضمن صلاحيات العقود الذكية.

ينبغي للمستخدمين الانتباه إلى الموافقات والمشغلين واستدعاءات التفويض والعقود القابلة للترقية والعقود ذات صلاحيات الإدارة.

قد يساعد ABI على كشف نطاق التفاعل، لكن الأمان يظل معتمدًا على جودة الشيفرة والصلاحيات والتدقيقات وحكم المستخدم.

الأسئلة الشائعة

ما معنى ABI في عالم العملات المشفرة؟

ABI اختصار لـ Application Binary Interface، ويصف في عالم العملات المشفرة كيفية ترميز وظائف العقود الذكية وأحداثها واستدعائها وفك ترميزها بواسطة البرامج.

ما استخدام ABI؟

تستخدم المحافظ والتطبيقات اللامركزية والبرامج النصية ومستكشفات البلوكشين وأدوات المطورين ABI للتفاعل مع العقود الذكية بطريقة منظمة.

هل ABI هو نفسه العقد الذكي؟

لا. العقد الذكي هو البرنامج الموجود على السلسلة، بينما ABI وصف الواجهة الذي يوضح للبرامج كيفية التواصل مع ذلك البرنامج.

هل ABI هو نفسه البايت كود؟

لا. البايت كود هو شيفرة العقد التنفيذية، أما ABI فهو تنسيق واجهة مقروء يُستخدم لترميز التفاعلات مع هذه الشيفرة وفك ترميزها.

لماذا تحتاج التطبيقات اللامركزية إلى ABI؟

تحتاج التطبيقات اللامركزية إلى ABI لعرض وظائف العقود وجمع مدخلات المستخدمين وإنشاء بيانات المعاملات واستدعاء وظائف القراءة وفك ترميز استجابات العقود.

هل يمكن أن يعمل العقد من دون ABI عام؟

نعم، يمكن للعقد العمل من دون ABI عام، لكن معظم المستخدمين والتطبيقات يحتاجون إلى ABI للتفاعل معه بسهولة وأمان.

أين يمكنني العثور على ABI لعقد؟

يمكنك عادةً العثور على ABI لعقد في مخرجات المُصرّف أو مستودعات المشروع الرسمية أو توثيق المطورين أو صفحات العقود الموثقة في مستكشفات البلوكشين.

هل يمكن أن يكون ABI مزيفًا؟

نعم، فقد يكون ABI غير صحيح أو قديمًا أو غير مكتمل أو مضللًا إذا أُخذ من مصدر غير موثوق.

هل يحمي ABI المستخدمين من عمليات الاحتيال؟

لا. قد يساعد ABI على فك ترميز تفاعلات العقود، لكنه لا يثبت أن العقد آمن أو مدقق أو جدير بالثقة.

لماذا تعرض محفظتي بيانات ست عشرية خامًا؟

قد تعرض المحفظة بيانات ست عشرية خامًا عندما لا يتوفر لديها ABI الصحيح أو معلومات فك الترميز اللازمة للتفاعل مع العقد.

ما ترميز ABI؟

ترميز ABI هو عملية تحويل أسماء الوظائف ومعاملاتها إلى التنسيق الثنائي الذي يستطيع العقد الذكي فهمه.

ما فك ترميز ABI؟

فك ترميز ABI هو عملية تحويل بيانات البلوكشين الخام إلى استدعاءات وظائف أو قيم معادة أو أحداث أو أخطاء مقروءة.

الخلاصة

يُعد ABI من أهم المكونات الأساسية الخفية في منظومات العقود الذكية.

فهو يتيح للمحافظ والتطبيقات اللامركزية وأدوات المطورين ومستكشفات البلوكشين وأنظمة التحليلات فهم كيفية التواصل مع العقود الذكية.

يمكن للمبتدئين فهم ABI بوصفه دليل تعليمات يشرح الوظائف القابلة للاستدعاء في العقد والمدخلات والمخرجات المتوقعة والأحداث والأخطاء.

أما للمطورين، فهو واجهة منظمة تجعل دمج العقود واختبارها ومراقبتها وأتمتتها ممكنًا.

ويهم ABI مستخدمي العملات المشفرة عمومًا لأنه يساعد المحافظ والتطبيقات على تحويل بيانات البلوكشين الخام إلى إجراءات مقروءة.

قد يجعل ABI الصحيح التفاعل مع العقود الذكية أوضح وأكثر أمانًا وأسهل فهمًا.

أما ABI الخاطئ أو المضلل فقد يسبب ارتباكًا ويزيد مخاطر المعاملات.

أفضل نهج هو استخدام واجهات ABI من مصادر رسمية أو موثقة، والتحقق بعناية من عناوين العقود، وقراءة مطالبات المحفظة، وتجنب توقيع المعاملات غير الواضحة.

في عالم العملات المشفرة، ABI ليس العقد نفسه، بل هو دليل اللغة الذي يساعد البشر والبرامج على التواصل مع العقد بصورة صحيحة.