ERC-1155

ما ERC-1155؟

ERC-1155 معيار توكنات على Ethereum يتيح لعقد ذكي واحد إدارة أنواع عديدة ومختلفة من التوكنات.

يمكن لعقد ERC-1155 واحد أن يضم توكنات قابلة للاستبدال أو غير قابلة للاستبدال أو شبه قابلة للاستبدال، أو مزيجًا من هذه الأصول.

تحدد مواصفات ERC-1155 الرسمية قواعد مشتركة للأرصدة والتحويلات والعمليات المجمعة والموافقات واستدعاءات الاستقبال والأحداث والبيانات الوصفية واكتشاف الواجهات.

يُعرف ERC-1155 عادةً باسم معيار Multi-Token.

يُحدد كل نوع توكن بمعرّف، ويمكن أن يكون له عرضه وبياناته الوصفية وغرضه وندرته وخصائصه الاقتصادية الخاصة.

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

يفيد ERC-1155 خصوصًا ألعاب البلوكشين والمقتنيات الرقمية والعضويات وتذاكر الفعاليات وأنظمة المكافآت والمخزونات المرمزة والتطبيقات التي تدير أصولًا مترابطة متعددة.

يعزز اتباع المعيار قابلية التشغيل البيني، لكنه لا يضمن أصالة التوكن أو قيمته أو ندرته أو أمانه.

لماذا أُنشئ ERC-1155؟

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

لذلك، قد يحتاج مشروع يضم مئات العملات وعناصر الألعاب والتذاكر والمقتنيات إلى عقود منفصلة كثيرة.

يزيد كل عقد إضافي تكاليف النشر وتكرار الشيفرة والعمل الإداري وتعقيد التكامل.

يتيح ERC-1155 جمع هذه الأنواع من التوكنات في عقد واحد ونظام تحويل مشترك.

كما يدعم العمليات المجمعة التي تستعلم عن عدة معرّفات توكنات أو تنقلها في استدعاء واحد.

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

صُمم المعيار لأنظمة التوكنات الكبيرة، لكنه لا يقتصر على ألعاب البلوكشين.

آلية عمل ERC-1155

يسجل عقد ERC-1155 رصيدًا منفصلًا لكل مجموعة من عنوان حساب ومعرّف توكن.

مثلًا، قد تملك محفظة واحدة 500 وحدة من المعرّف 1، وثلاث وحدات من المعرّف 2، ووحدة واحدة من المعرّف 3.

قد يمثل المعرّف 1 عملة قابلة للاستبدال، والمعرّف 2 عنصرًا محدود الإصدار، والمعرّف 3 NFT فريدًا.

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

عند تحويل التوكنات، يخفض العقد رصيد المرسل ويزيد رصيد المستلِم للمعرّفات المحددة.

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

عندما يكون المستلِم عقدًا ذكيًا، ينفذ ERC-1155 استدعاء استقبال للتأكد من قبول العقد للتوكنات.

ما معرّف توكن ERC-1155؟

معرّف التوكن عدد صحيح غير موقّع يحدد نوعًا واحدًا من التوكنات داخل عقد ERC-1155.

قد يظهر المعرّف نفسه في عقد آخر من دون أن يمثل الأصل المشفر نفسه.

لذلك، يُحدد أصل ERC-1155 باجتماع شبكة البلوكشين وعنوان العقد ومعرّف التوكن.

قد يمثل المعرّف 100 موردًا في لعبة ضمن عقد، وتذكرة فعالية ضمن عقد آخر.

لا يشترط المعيار أن تبدأ المعرّفات من الصفر أو أن تزيد بترتيب بسيط.

يستطيع المطورون تعيين المعرّفات وفق تصميم التطبيق.

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

توكنات ERC-1155 القابلة للاستبدال

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

مثلًا، قد تصدر لعبة مليون وحدة من المعرّف 10 كعملة داخل اللعبة.

يكون لكل حامل رصيد كمي مرتبط بالمعرّف 10.

تتمتع وحدات المعرّف نفسه عادةً بخصائص متطابقة يحددها العقد.

لا تحدد الواجهة الأساسية لـ ERC-1155 رمزًا أو عدد منازل عشرية أو اسمًا منفصلًا لكل معرّف توكن.

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

توكنات ERC-1155 غير القابلة للاستبدال

يمكن أن يعمل معرّف توكن كـ NFT إذا اقتصر عرضه على وحدة واحدة.

يُعد العنوان الذي يحمل تلك الوحدة مالكًا فعليًا للأصل الفريد الذي يمثله المعرّف.

يمكن لمعرّف آخر في العقد نفسه أن يمثل عنصرًا فريدًا مختلفًا.

على خلاف ERC-721، لا يشترط ERC-1155 تلقائيًا أن يكون عرض كل معرّف وحدة واحدة.

يجب أن يفرض منطق السكّ في العقد التفرد عندما يوصف المعرّف بأنه غير قابل للاستبدال.

ينبغي للمستخدمين التحقق من ضوابط العرض الفعلية قبل الوثوق بادعاء أن عنصر ERC-1155 فريد.

توكنات ERC-1155 شبه القابلة للاستبدال

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

تذاكر الفعاليات مثال شائع؛ فقد تكون عدة تذاكر للقسم نفسه قابلة للتبادل قبل الفعالية.

بعد الفعالية، قد تصبح كل تذكرة مستخدمة مقتنى مرتبطًا بتجربة محددة.

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

لا يصنف ERC-1155 معرّف التوكن رسميًا إلى قابل للاستبدال أو غير قابل للاستبدال أو شبه قابل للاستبدال.

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

الدوال الأساسية في ERC-1155

تتضمن واجهة ERC-1155 الأساسية دوال فحص الأرصدة وتحويل التوكنات وإدارة صلاحيات المشغّلين.

أهم الدوال هي

و و و و و.

يشترط ERC-1155 أيضًا دعم اكتشاف الواجهات وفق ERC-165.

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

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

دالة balanceOf

تعيد

كمية معرّف توكن واحد يملكه حساب واحد.

وتتطلب عنوان الحساب ومعرّف التوكن.

يختلف ذلك عن ERC-20، لأن عقد ERC-20 واحدًا يمثل عادةً نوعًا واحدًا من التوكن.

ويختلف عن ERC-721 لأن رصيد ERC-721 يحصي عدد NFTs الفريدة التي يملكها العنوان ضمن المجموعة.

قد يكون رصيد معرّف ERC-1155 صفرًا أو واحدًا أو عددًا صحيحًا أكبر.

يشترط المعيار فشل الاستعلام عن رصيد العنوان الصفري.

دالة balanceOfBatch

تسترجع

عدة أرصدة في استدعاء واحد.

يرسل المستدعي مصفوفة عناوين حسابات ومصفوفة معرّفات توكنات.

يقترن كل حساب بمعرّف التوكن الموجود في الموضع نفسه.

يجب أن يتساوى طول المصفوفتين.

يمكن للدالة الاستعلام عن عدة معرّفات لحساب واحد أو عن معرّف واحد لعدة حسابات.

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

دالة safeTransferFrom

تنقل

كمية من معرّف توكن واحد بين عنوانين.

يجب أن يكون المستدعي حامل التوكن أو مشغّلًا وافق عليه الحامل.

ينبغي أن يملك المرسل وحدات كافية من المعرّف المحدد.

لا يمكن أن يكون المستلِم هو العنوان الصفري.

تقبل الدالة أيضًا حقل bytes يمكن أن يتضمن بيانات خاصة بالتطبيق.

يصدر عن التحويل الفردي الناجح حدث

.

إذا كان المستلِم عقدًا ذكيًا، فيجب اجتياز تحقق القبول المطلوب في ERC-1155.

دالة safeBatchTransferFrom

تنقل

عدة معرّفات توكنات وكميات في معاملة واحدة.

يرسل المستدعي مصفوفة معرّفات توكنات ومصفوفة مقابلة لكميات التحويل.

تُطبق كل كمية على المعرّف الموجود في الموضع نفسه.

يجب أن يتساوى طول المصفوفتين.

ينبغي أن يملك المرسل وحدات كافية من كل توكن في الدفعة.

إذا فشل أي تحويل مطلوب، تُلغى المعاملة كاملةً عادةً.

يصدر عن العملية الناجحة حدث واحد

.

فوائد التحويلات المجمعة

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

يمكن للاعب نقل العملة والمواد والمعدات والمقتنيات في معاملة واحدة.

يمكن لعقد المكافآت توزيع أنواع متعددة من التوكنات على مستلِم واحد بعملية واحدة.

قد يبسط التجميع أيضًا المبادلات الذرية، إذ تنتقل مجموعة الأصول كاملةً أو تفشل المعاملة.

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

قد تتجاوز الدفعات الكبيرة جدًا حدود الغاز أو تنشئ مخاطر حجب الخدمة.

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

موافقات مشغّلي ERC-1155

يستخدم ERC-1155 موافقات مشغّلين تشمل المجموعة كاملةً.

تتيح

لحامل التوكن تفويض مشغّل أو إلغاء تفويضه.

يمكن للمشغّل المعتمد تحويل كل معرّفات ERC-1155 التي يملكها الحامل ضمن العقد.

قد يشمل الإذن التوكنات التي يتلقاها الحامل لاحقًا من العقد نفسه أيضًا.

لا يتيح المعيار الأساسي الموافقة على معرّف واحد أو كمية محدودة فقط.

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

يمكن لمشغّل خبيث سحب كل التوكنات المشمولة ما دامت الموافقة سارية.

دالة isApprovedForAll

تعرض

ما إذا كان للمشغّل صلاحية على أرصدة ERC-1155 التي يملكها عنوان آخر.

وتعيد إما

أو .

تسري الموافقة ضمن العقد الذي مُنحت فيه فقط.

ولا تشمل تلقائيًا أصول عقد ERC-1155 آخر أو توكنات تستخدم معيارًا آخر.

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

لا يؤدي فصل المحفظة عن موقع إلكتروني إلى إزالة الموافقة المسجلة على البلوكشين.

إضافات الموافقة المحددة

قد لا يناسب نموذج المشغّل الواسع حاملًا يريد تفويض معرّف واحد أو كمية محدودة فقط.

تحدد إضافة ERC-5216 للحدود المسموح بها المقترحة موافقات أكثر تحديدًا بحسب معرّف التوكن والكمية.

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

ينبغي للمحافظ توضيح ما إذا كانت المعاملة تمنح صلاحية على المجموعة كاملةً أم إذنًا محدودًا.

استدعاءات الاستقبال في ERC-1155

يجب على العقد الذكي الذي يتلقى توكنات ERC-1155 عبر تحويل آمن قياسي تنفيذ استدعاء الاستقبال الصحيح.

استدعاء التحويل الفردي هو

.

واستدعاء التحويل المجمع هو

.

يمكن للمستلِم فحص المشغّل والحامل السابق ومعرّفات التوكنات والكميات والبيانات المرفقة.

ويقبل التوكنات بإعادة القيمة المطلوبة.

إذا أعاد قيمة خاطئة أو ألغى التنفيذ، يُلغى تحويل التوكن كاملًا.

يحد هذا التصميم من التحويلات غير المقصودة إلى عقود ذكية لا تستطيع معالجة أصول ERC-1155.

معرّفات واجهة الاستقبال وقيم الإعادة

معرّف واجهة استقبال ERC-1155 هو

.

قيمة الإعادة المتوقعة لـ

هي .

وقيمة الإعادة المتوقعة لـ

هي .

ينبغي للعقد المستلِم التحقق من عقد ERC-1155 الذي بدأ الاستدعاء.

قد يؤدي قبول بيانات الاستدعاء دون التحقق من المستدعي إلى تمكين عقد خبيث من إنشاء سجلات إيداع زائفة.

ولا يضمن اجتياز فحص الاستقبال وجود آلية سحب مستقبلية آمنة في العقد المستلِم.

استدعاءات الاستقبال ومخاطر إعادة الدخول

تنفذ استدعاءات الاستقبال في ERC-1155 شيفرة عقد خارجي قبل اكتمال المعاملة الأصلية.

قد يستدعي المستلِم الخبيث دالة أخرى أثناء استمرار التحويل الأصلي.

ينشئ هذا السلوك مسارًا محتملًا لإعادة الدخول.

تشترط مواصفات ERC-1155 إجراء تغييرات الأرصدة وإصدار أحداث التحويل قبل استدعاء دالة الاستقبال.

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

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

يحذر توثيق تنفيذ ERC-1155 الحالي أيضًا من أن التحويل إلى العقود قد ينطوي على مخاطر إعادة الدخول.

أحداث ERC-1155

يحدد المعيار الأساسي أحداث

و و و.

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

صُمم ERC-1155 بحيث يمكن إعادة بناء سجل العرض والأرصدة من أحداث التحويل الصادرة وفق القواعد.

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

قد يصدر عقد خبيث أحداثًا بأسماء مألوفة من دون أن يمثل مشروعًا أصيلًا.

حدث TransferSingle

يسجل

المشغّل والمرسل والمستلِم ومعرّف التوكن والكمية.

يتضمن التحويل العادي عنوانَي مرسل ومستلم غير صفريين.

يستخدم السكّ العنوان الصفري مرسلًا.

ويستخدم الحرق العنوان الصفري مستلِمًا.

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

حدث TransferBatch

يسجل

عدة معرّفات توكنات وكميات نُقلت في عملية واحدة.

تُخزن المعرّفات والقيم في مواضع متطابقة من المصفوفتين.

يحدد الحدث أيضًا المشغّل والمرسل والمستلِم.

يستخدم السكّ المجمع العنوان الصفري مرسلًا.

ويستخدم الحرق المجمع العنوان الصفري مستلِمًا.

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

حدث ApprovalForAll

يسجل

ما إذا كان المالك قد فعّل مشغّلًا أو عطّله.

ويحتوي على المالك والمشغّل وحالة الموافقة.

لا ينقل الحدث أي توكنات بحد ذاته.

بل يغير قدرة المشغّل على بدء تحويلات مستقبلية من المالك.

لا يؤدي إلغاء الموافقة إلى عكس التحويلات التي تمت أثناء سريان التفويض.

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

يشترط ERC-1155 اكتشاف الواجهات باستخدام ERC-165.

معرّف واجهة ERC-1155 الأساسية هو

.

ينبغي للعقد المتوافق إعادة

عند استدعاء بهذا المعرّف.

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

يساعد اكتشاف الواجهات التطبيقات على تجنب استدعاء دوال غير مدعومة.

لا تثبت الاستجابة الإيجابية وحدها تنفيذ كل دالة بصورة صحيحة أو آمنة.

البيانات الوصفية في ERC-1155

يتضمن ERC-1155 إضافة اختيارية لمعرّف البيانات الوصفية URI.

تضيف هذه الإضافة دالة

تعيد موقع البيانات الوصفية لمعرّف توكن.

معرّف واجهتها هو

.

يشير URI عادةً إلى مستند JSON يتضمن اسمًا ووصفًا وصورة وسمات ومعلومات أخرى عن التوكن.

لا يشترط المعيار الأساسي دوالًا منفصلة على السلسلة من نوع

أو أو لكل معرّف توكن.

يمكن للمشاريع إضافة هذه الحقول عبر البيانات الوصفية أو واجهات مخصصة.

العنصر النائب {id} للبيانات الوصفية

قد يتضمن URI البيانات الوصفية في ERC-1155 العنصر النائب

.

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

يجب أن تتكون القيمة المنسقة من 64 محرفًا ست عشريًا، بما في ذلك الأصفار البادئة.

ويجب ألا تتضمن السابقة

.

تتيح هذه الطريقة لـ URI أساسي واحد تحديد مواقع بيانات وصفية لمعرّفات توكنات كثيرة.

قد يسترجع التطبيق الذي ينفذ الاستبدال بصورة خاطئة بيانات وصفية لأصل غير صحيح.

مخاطر تخزين البيانات الوصفية

يمكن تخزين بيانات ERC-1155 الوصفية على خادم ويب أو شبكة ذات عناوين مرتبطة بالمحتوى أو مباشرةً على السلسلة.

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

قد يحسن التخزين المرتبط بالمحتوى سلامة البيانات، لكن يجب أن يظل المحتوى متاحًا.

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

قد يتيح URI قابل للتغيير للمسؤول تعديل الأسماء والصور والأوصاف والسمات بعد حصول المستخدمين على التوكنات.

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

سكّ توكنات ERC-1155

ينشئ السكّ وحدات جديدة من معرّف توكن ERC-1155.

لا يحدد المعيار الأساسي دالة سكّ عامة ولا يقرر من يحق له إنشاء التوكنات.

يمكن للتنفيذ قصر السكّ على مسؤول أو عقد ذكي أو عملية حوكمة أو دور آخر مصرح له.

يصدر عن السكّ الفردي حدث

من العنوان الصفري.

ويصدر عن السكّ المجمع حدث

من العنوان الصفري.

يؤدي السكّ إلى عقد ذكي عادةً إلى استدعاء دالة الاستقبال المناسبة.

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

حرق توكنات ERC-1155

يزيل الحرق وحدات التوكن من التداول وفق قواعد العقد.

لا يشترط المعيار الأساسي توفير دالة حرق عامة.

قد يسمح العقد للحاملين أو المشغّلين المعتمدين أو المسؤولين أو منطق البروتوكول بحرق التوكنات.

يصدر الحرق حدث تحويل يكون فيه العنوان الصفري هو المستلِم.

لا يمنع حرق كل الوحدات الحالية لمعرّف واحد بالضرورة إعادة سكّ ذلك المعرّف.

تعتمد النتيجة على ضوابط السكّ والعرض في التنفيذ.

إجمالي العرض والتعداد

لا تتضمن واجهة ERC-1155 الأساسية دالة

.

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

يمكن للتنفيذ إضافة امتداد اختياري لتتبع العرض يعرض إجمالي العرض لكل معرّف.

تتضمن مكتبة عقود ERC-1155 الحالية إضافات لتتبع العرض والحرق والإيقاف وتخزين URI.

ولا يحدد ERC-1155 دالة أساسية لسرد كل معرّفات التوكنات أو الحاملين الموجودين.

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

إتاوات ERC-1155

إتاوات المنشئين ليست جزءًا من معيار ERC-1155 الأساسي.

يتيح معيار الإتاوات الاختياري ERC-2981 للعقد الإبلاغ عن مستلِم الإتاوة والمبلغ المقترح.

يُحسب مبلغ الإتاوة باستخدام سعر بيع مقدم.

ينقل ERC-2981 معلومات الإتاوة، لكنه لا يفرض دفعها تلقائيًا عند كل تحويل.

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

ينبغي للمستخدمين التحقق مما إذا كان بإمكان المسؤول تغيير إعدادات الإتاوة.

الأخطاء الموحدة في ERC-1155

لا تحدد مواصفات ERC-1155 الأصلية أخطاء Solidity المخصصة الحديثة.

يحدد معيار الأخطاء النهائي ERC-6093 أسماء أخطاء شائعة لعقود ERC-1155.

تشمل هذه الأخطاء عدم كفاية الأرصدة، والمرسلين والمستلِمين غير الصالحين، وغياب موافقة المشغّل، والمشغّلين غير الصالحين، وعدم تطابق أطوال المصفوفات.

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

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

مقارنة ERC-1155 وERC-20

يمثل ERC-20 عادةً نوعًا واحدًا من التوكنات القابلة للاستبدال لكل عقد.

يمكن لـ ERC-1155 تمثيل أنواع عديدة من التوكنات في عقد واحد.

يستخدم ERC-20 حدود إنفاق رقمية للمستفيدين، بينما يستخدم ERC-1155 الأساسي موافقة مشغّل على مستوى المجموعة كاملةً.

يتضمن ERC-1155 تحويلات مجمعة واستدعاءات استقبال إلزامية للمستلِمين من العقود الذكية.

لا يتضمن معيار ERC-20 الأساسي هذه الميزات.

قد يظل ERC-20 أبسط عندما يحتاج المشروع إلى أصل مشفر واحد قابل للاستبدال فقط.

مقارنة ERC-1155 وERC-721

صُمم ERC-721 لمعرّفات توكنات غير قابلة للاستبدال يملك كلًا منها مالك منفرد.

لكل معرّف صالح في ERC-721 مالك واحد.

يخزن ERC-1155 رصيدًا كميًا لكل مجموعة من حساب ومعرّف توكن.

يتيح ذلك وجود وحدات كثيرة قابلة للتبادل لمعرّف، ووحدة واحدة لمعرّف آخر في العقد نفسه.

يدعم ERC-1155 التحويلات المجمعة الموحدة أيضًا، بينما ينقل ERC-721 عادةً NFT واحدًا في كل مرة.

قد يوفر ERC-721 نموذجًا أبسط عندما يكون كل أصل فريدًا.

استخدامات ERC-1155 الشائعة

يمكن لألعاب البلوكشين إدارة العملات والمواد والأسلحة والشخصيات والأراضي عبر عقد ERC-1155 واحد.

يمكن لأنظمة الفعاليات إصدار فئات وكميات مختلفة من التذاكر ضمن معرّفات توكن منفصلة.

يمكن لمشاريع العضوية إنشاء مستويات وصول أو حزم مزايا متعددة.

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

يمكن للتطبيقات المالية استخدام معرّفات التوكن لتحديد تواريخ الاستحقاق أو المطالبات أو فئات المراكز أو مجموعات المخاطر.

يمكن لأنظمة المكافآت توزيع أنواع متعددة من النقاط أو عناصر الإنجاز عبر معاملة مجمعة واحدة.

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

مخاطر موافقات ERC-1155

يمثل التصيد الاحتيالي لموافقات المشغّلين خطرًا كبيرًا على حاملي ERC-1155.

قد يطلب موقع خبيث تنفيذ

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

بعد الموافقة، قد ينقل المشغّل كل توكنات ERC-1155 التي يملكها المستخدم في ذلك العقد.

قد تظل الصلاحية نشطة إلى أن يلغيها المالك.

ينبغي للمستخدمين التحقق من الشبكة وعقد التوكن وعنوان المشغّل ونوع الصلاحية قبل التوقيع.

لا تلزم عبارة استرداد المحفظة أو المفتاح الخاص لإلغاء موافقة مشغّل.

مخاطر العمليات المجمعة

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

يجب أن يؤدي عدم التطابق بين معرّفات التوكن والكميات إلى فشل المعاملة.

قد يؤدي الفهرس الخاطئ إلى تحويل كمية غير صحيحة من الأصل.

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

ينبغي للعقد المستلِم التحقق من كل معرّف وكمية قبل قبول الدفعة.

ينبغي للمطورين اختبار المصفوفات الفارغة والمعرّفات المكررة والأطوال غير المتطابقة والدفعات الكبيرة ومعرّفات الأصول غير المدعومة.

مخاطر العرض والأصالة

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

ومع ذلك، قد يظل حساب معتمد قادرًا على سكّ وحدات إضافية لاحقًا.

يمكن لعقد آخر نسخ اسم التوكن أو معرّفه أو صورته أو بياناته الوصفية.

عنوان العقد والشبكة عنصران أساسيان في هوية توكن ERC-1155.

ينبغي للمستخدمين فحص أدوار السكّ وحدود العرض وصلاحيات الترقية وضوابط البيانات الوصفية.

لا يثبت التوافق مع ERC-1155 الأصالة أو الندرة أو وجود ضمانات أو قيمة استثمارية.

مخاطر العقود القابلة للترقية

قد يعمل عقد ERC-1155 عبر وكيل قابل للترقية.

قد يستطيع مسؤول معتمد تغيير السكّ والتحويلات والموافقات والبيانات الوصفية والرسوم أو سلوكًا آخر.

قد تصلح الترقيات الثغرات، لكنها قد تُدخل منطقًا ضارًا أيضًا.

قد يعرض اختراق مفتاح الترقية كل معرّفات التوكن التي يديرها العقد للخطر.

ينبغي للمستخدمين مراجعة صلاحية الترقية والتأخيرات الزمنية وضوابط التوقيع المتعدد وصلاحيات الطوارئ.

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

كيفية تنفيذ ERC-1155 للمطورين

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

يشرح دليل تطوير ERC-1155 الحالي الأرصدة متعددة التوكنات والعمليات المجمعة وفحوص الاستقبال والإضافات الشائعة.

ينبغي استخدام ضوابط وصول واضحة لدوال السكّ والإدارة.

يجب فرض قيود العرض في شيفرة العقد، لا الاكتفاء بذكرها في وثائق المشروع.

يجب على التنفيذات إصدار جميع أحداث التحويل والموافقة المطلوبة.

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

ينبغي للمطورين أيضًا التحقق من معرّفات ERC-165 الصحيحة لكل إضافة مدعومة.

كيفية تقييم المستخدم لتوكن ERC-1155

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

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

والثالثة فحص العرض الحالي وصلاحيات السكّ وأي حد أقصى للعرض.

والرابعة مراجعة موافقات المشغّلين النشطة المرتبطة بالمحفظة.

والخامسة معرفة كيفية تخزين البيانات الوصفية وما إذا كان يمكن تغييرها.

والسادسة تحديد صلاحيات المسؤول والإيقاف والتجميد والإتاوات والترقية.

والسابعة فحص الشيفرة المصدرية وعمليات التدقيق وسجل الحوادث دون اعتبارها ضمانات.

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

والتاسعة التحقق من أن العقود المستلِمة توفر آلية سحب موثوقة.

والعاشرة اختبار العقد غير المألوف بمبلغ صغير قبل نقل أصول قيّمة.

مثال على تحويل مجمع في ERC-1155

لنفترض أن Alice تملك 100 وحدة من المعرّف 1، وخمس وحدات من المعرّف 2، ووحدة واحدة من المعرّف 3.

تريد إرسال 10 وحدات من المعرّف 1 إلى Bob، ووحدتين من المعرّف 2، ووحدة واحدة من المعرّف 3.

تستدعي محفظتها

بمصفوفتين تتضمنان المعرّفات الثلاثة وكمياتها المقابلة.

يتحقق العقد من أرصدة Alice ومن صلاحية المستدعي.

يخفض العقد أرصدة Alice ويزيد أرصدة Bob لكل معرّف.

ويصدر حدث

واحدًا يصف التحويل.

إذا كان Bob عقدًا ذكيًا، يستدعي عقد التوكن

.

تكتمل المعاملة إذا أعاد المستلِم القيمة الصحيحة.

إذا فشل أي تحقق من الرصيد أو التفويض أو المصفوفات أو المستلِم، تُلغى المعاملة كاملةً.

أخطاء شائعة في ERC-1155

من الأخطاء الشائعة افتراض أن كل معرّف ERC-1155 يمثل NFT.

ومنها افتراض أن المعرّف الذي يضم وحدة واحدة حاليًا له حد أقصى دائم قدره وحدة واحدة.

ومنها منح موافقة للمشغّل من دون إدراك أنها تشمل كل معرّفات التوكن في العقد.

ومنها الاعتقاد بأن فصل المحفظة يلغي الموافقة على السلسلة.

ومنها استخدام توفر البيانات الوصفية دليلًا على سكّ التوكن.

ومنها افتراض أن كل عقد يوفر دالة إجمالي العرض.

ومنها معالجة المصفوفات المجمعة من دون التحقق من أطوالها ومواضع عناصرها.

ومنها تجاهل استدعاءات الاستقبال ومخاطر إعادة الدخول.

ومنها افتراض أن الإتاوات المبلغ عنها تُفرض تلقائيًا.

ومنها اعتبار التوافق مع الواجهة دليلًا على الأصالة أو الندرة أو الأمان.

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

ما معنى ERC-1155؟

ERC-1155 هو معيار Ethereum متعدد التوكنات لإدارة أنواع عديدة من التوكنات القابلة للاستبدال وغير القابلة للاستبدال وشبه القابلة للاستبدال في عقد واحد.

هل ERC-1155 عملة مشفرة؟

ERC-1155 معيار تقني، ويمكن للعقود التي تنفذه إنشاء أنواع مختلفة من الأصول المشفرة.

ما معرّف واجهة ERC-1155؟

معرّف واجهة ERC-1155 الأساسية هو

.

ما معرّف واجهة الاستقبال في ERC-1155؟

معرّف واجهة الاستقبال هو

.

هل يمكن لـ ERC-1155 إنشاء توكنات قابلة للاستبدال؟

نعم، يمكن لمعرّف واحد تمثيل وحدات كثيرة قابلة للتبادل وموزعة على حسابات متعددة.

هل يمكن لـ ERC-1155 إنشاء NFTs؟

نعم، يمكن أن يعمل معرّف توكن كـ NFT إذا حصر العقد عرضه في وحدة واحدة.

ما التوكن شبه القابل للاستبدال؟

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

هل يمكن لعقد ERC-1155 واحد أن يضم أصولًا كثيرة؟

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

ماذا تعيد balanceOf؟

تعيد كمية معرّف توكن محدد يملكه حساب.

ما وظيفة balanceOfBatch؟

تعيد أرصدة عدة أزواج من الحسابات ومعرّفات التوكن في استدعاء واحد.

ما هي safeBatchTransferFrom؟

تنقل عدة معرّفات توكنات وكميات في معاملة واحدة، وتتحقق من الاستقبال عندما يكون المستلِم عقدًا ذكيًا.

ما وظيفة setApprovalForAll؟

تمنح مشغّلًا صلاحية إدارة كل معرّفات التوكن التي يملكها المستدعي ضمن عقد ERC-1155 واحد.

هل يمكن للمستخدمين الموافقة على معرّف توكن واحد فقط؟

ليس عبر دالة الموافقة الأساسية في ERC-1155، لكن قد توفر الإضافات الاختيارية صلاحيات أضيق.

هل تنتهي موافقة ERC-1155 تلقائيًا؟

لا، تظل موافقة المشغّل القياسية نشطة إلى أن يلغيها المالك أو يغير منطق مخصص أثرها.

هل يشترط ERC-1155 فحوص المستلِم؟

نعم، يجب أن تتبع التحويلات الآمنة القياسية إلى العقود الذكية قواعد استدعاء الاستقبال الفردي أو المجمع المناسبة.

هل يمكن للعقد المستلِم رفض توكنات ERC-1155؟

نعم، يمكنه إلغاء التنفيذ أو إعادة قيمة قبول خاطئة، ما يؤدي إلى فشل التحويل.

هل يدعم ERC-1155 البيانات الوصفية؟

نعم، يتضمن إضافة اختيارية لمعرّف البيانات الوصفية URI، ومعرّف واجهتها

.

هل لكل توكن ERC-1155 اسم ورمز؟

لا، لا يشترط المعيار الأساسي دوالًا منفصلة للاسم أو الرمز على السلسلة لكل معرّف توكن.

هل يحدد ERC-1155 المنازل العشرية؟

لا، ينبغي الحصول على معلومات فئات الوحدات من البيانات الوصفية أو منطق المشروع عند الحاجة.

هل يتضمن ERC-1155 دالة totalSupply؟

لا، يتطلب إجمالي العرض فهرسة الأحداث أو إضافة اختيارية لتتبع العرض.

هل يمكن تغيير بيانات ERC-1155 الوصفية؟

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

هل يفرض ERC-1155 دفع الإتاوات؟

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

هل توفر التحويلات المجمعة في ERC-1155 رسوم الغاز؟

نعم، قد يقلل جمع عدة تحويلات للتوكنات في معاملة واحدة من التكاليف المتكررة.

هل قد تسبب استدعاءات ERC-1155 إعادة الدخول؟

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

هل يجعل التوافق مع ERC-1155 التوكن آمنًا؟

لا، فقد يتضمن العقد المتوافق شيفرة غير آمنة أو صلاحيات مفرطة أو بيانات وصفية قابلة للتغيير أو ضوابط عرض ضعيفة أو ادعاءات احتيالية.

الخلاصة

ERC-1155 معيار Ethereum لإدارة أنواع كثيرة من التوكنات عبر عقد ذكي واحد.

يمكن لكل معرّف توكن تمثيل أصل قابل للاستبدال أو NFT فريد أو عنصر شبه قابل للاستبدال أو أصل مشفر آخر قائم على الكمية.

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

قد تقلل العمليات المجمعة تكاليف المعاملات عندما يلزم الاستعلام عن أصول متعددة أو نقلها معًا.

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

لا يحدد المعيار الأساسي السكّ أو الحرق العامين أو إجمالي العرض أو المنازل العشرية أو الإتاوات أو البيانات الوصفية الدائمة أو حدود الإنفاق الفردية للتوكنات.

تعتمد هذه الخصائص على الإضافات الاختيارية وتنفيذ العقد المحدد.

ينبغي للمستخدمين التحقق من الشبكة وعنوان العقد ومعرّف التوكن وضوابط العرض وموافقات المشغّلين ونظام البيانات الوصفية وصلاحيات المسؤول.

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

يوفر ERC-1155 بنية تحتية مرنة متعددة التوكنات، لكن التوافق التقني لا يضمن الأصالة أو الندرة أو القيمة المالية أو أمان العقد الذكي.