معيار ERC-1155 متعدد التوكنات

ما معيار ERC-1155 متعدد التوكنات؟

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

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

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

يُصنّف ERC-1155 معيارًا نهائيًا من Ethereum Request for Comments.

يُعرف عادةً باسم معيار Multi-Token لأن كل معرّف توكن داخل العقد الواحد يمكن أن يمثل أصلًا مشفرًا مستقلًا.

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

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

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

كانت نماذج التوكنات السابقة تتطلب عادةً عقودًا منفصلة للأصول القابلة للاستبدال المختلفة أو لمجموعات NFT.

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

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

يجمع ERC-1155 أنواعًا كثيرة من التوكنات في عقد واحد، ويطبق عليها نظامًا مشتركًا للتحويل والموافقة.

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

لذلك، يفيد هذا المعيار الألعاب والمقتنيات الرقمية وأنظمة العضوية والمخزونات المرمزة والمراكز المالية وبرامج المكافآت وغيرها من تطبيقات الكريبتو التي تتعامل مع فئات متعددة من الأصول.

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

آلية عمل ERC-1155

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

يمكن لعنوان واحد امتلاك 10 وحدات من التوكن ذي المعرّف 1، ووحدة واحدة من المعرّف 2، ولا شيء من المعرّف 3، ضمن العقد نفسه.

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

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

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

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

تنفذ عُقد Ethereum هذه القواعد وتتحقق من تغييرات الأرصدة الناتجة وفق شيفرة العقد المنشور.

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

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

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

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

قد يمثل المعرّف 25 موردًا قابلًا للاستبدال في لعبة ضمن عقد، ومقتنى فريدًا في عقد آخر.

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

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

ينبغي للتطبيقات الاستعلام عن بيانات موثوقة من العقد، لا تخمين معرّفات التوكنات الموجودة.

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

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

مثلًا، قد يمثل المعرّف 1 عملة داخل لعبة لها مليون وحدة متطابقة.

يملك كل حامل رصيدًا كميًا مرتبطًا بالمعرّف 1.

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

على خلاف ERC-20، لا تحدد الواجهة الأساسية لـ ERC-1155 دالة منفصلة لإجمالي العرض أو الرمز المختصر أو الاسم أو المنازل العشرية لكل معرّف توكن.

يتعين على المشاريع توفير معلومات العرض أو العرض البصري المطلوبة عبر الإضافات أو البيانات الوصفية أو الدوال المخصصة.

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

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

يُعد العنوان الذي يحمل تلك الوحدة مالكًا للتوكن.

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

مثلًا، قد يمثل المعرّف 1001 سيفًا واحدًا، بينما يمثل المعرّف 1002 قطعة أرض افتراضية واحدة.

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

يجب أن يفرض منطق سكّ العقد التفرد إذا كان المقصود أن يعمل المعرّف كـ NFT.

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

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

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

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

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

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

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

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

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

الدوال المطلوبة هي

و و و و و.

كما يشترط ERC-1155 اكتشاف الواجهات وفق ERC-165.

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

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

دالة balanceOf

تعيد دالة

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

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

يختلف ذلك عن ERC-20، حيث يمثل العقد عادةً نوعًا واحدًا من التوكن وتحتاج الدالة إلى عنوان الحساب فقط.

ويختلف أيضًا عن ERC-721، إذ تعرض

عدد NFTs المنفصلة التي يملكها العنوان في مجموعة.

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

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

دالة balanceOfBatch

تسترجع

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

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

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

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

يمكن للدالة الاستعلام عن عدة أصول لحساب واحد أو عن أصل واحد لدى عدة حسابات.

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

دالة safeTransferFrom

تنقل

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

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

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

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

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

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

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

.

دالة safeBatchTransferFrom

تنقل

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

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

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

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

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

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

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

بدلًا من حدث منفصل لكل معرّف.

أهمية التحويلات المجمعة

تتيح التحويلات المجمعة نقل عدة أنواع من الأصول عبر معاملة بلوكشين واحدة.

يمكن لمستخدم لعبة نقل العملة والمواد والدروع والعناصر المقتناة معًا.

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

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

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

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

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

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

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

تتيح

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

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

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

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

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

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

دالة isApprovedForAll

تعرض

ما إذا كان عنوان ما يملك صلاحية المشغّل على توكنات عنوان آخر.

تعيد الدالة

أو .

تسري الموافقة على عقد ERC-1155 الذي سُجلت فيه فقط.

ولا تمنح تلقائيًا صلاحية على توكنات ERC-20 أو NFTs من ERC-721 أو أصول عقد ERC-1155 آخر.

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

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

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

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

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

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

دعم هذه الإضافات اختياري ولا ينبغي افتراض توفره.

على المحافظ التمييز بوضوح بين السماح بكمية محدودة لمعرّف توكن وبين الموافقة القياسية على المجموعة كاملةً.

واجهة الاستقبال في ERC-1155

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

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

للتحويل الفردي و للتحويل المجمع.

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

.

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

ويجب أن يعيد قيمة القبول المتوقعة، وإلا يُلغى التحويل.

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

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

تُستدعى

بعد تحديث رصيد المستلِم في التحويل الفردي.

قيمة القبول المتوقعة هي

.

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

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

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

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

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

تعالج

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

قيمة القبول المتوقعة هي

.

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

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

تؤدي إعادة قيمة غير صحيحة أو إلغاء التنفيذ إلى فشل التحويل المجمع كاملًا.

يجب تصميم العقد المستلِم بعناية لأن معاملة واحدة قد تسلّمه أنواعًا متعددة من الأصول.

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

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

يمكن للعقد المستلِم استدعاء عقد التوكن أو تطبيق آخر أثناء الاستدعاء.

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

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

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

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

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

أحداث ERC-1155

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

و و و.

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

صُمم المعيار بحيث يمكن إعادة بناء أرصدة التوكنات وتغيرات العرض من أحداث التحويل.

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

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

حدث TransferSingle

يسجل

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

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

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

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

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

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

حدث TransferBatch

يسجل

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

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

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

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

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

حدث ApprovalForAll

يسجل

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

ويحدد المالك والمشغّل وحالة الموافقة.

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

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

لا يؤدي إلغاء مشغّل إلى عكس المعاملات التي اكتملت أثناء سريان الإذن.

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

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

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

.

يجب أن يعيد العقد المتوافق

عند استدعاء بهذه القيمة.

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

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

لكن العقد قد يدّعي الدعم كذبًا أو ينفذ الدوال على نحو غير صحيح؛ لذا لا تمثل الاستجابة الإيجابية ضمانًا أمنيًا كاملًا.

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

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

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

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

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

.

يشير الموقع عادةً إلى مستند JSON يتضمن معلومات مثل الاسم والوصف والصورة والسمات والموارد الخارجية.

على خلاف واجهات البيانات الوصفية لـ ERC-20 وERC-721، لا يشترط التصميم الأساسي لـ ERC-1155 وجود دالتي

أو على السلسلة.

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

استبدال {id} في البيانات الوصفية

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

.

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

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

.

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

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

حدث URI

يعلن حدث

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

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

ينبغي أن تعيد دالة

أحدث قيمة URI للمعرّف نفسه إذا صدر حدث بهذا الشأن.

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

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

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

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

قد يتغير المحتوى المستضاف على خادم أو يختفي.

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

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

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

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

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

ينشئ السكّ وحدات توكن ويخصصها لعنوان.

لا تحدد الواجهة الأساسية لـ ERC-1155 دالة سكّ عامة.

يحدد كل تنفيذ من يحق له السكّ، والمعرّفات التي يمكن إنشاؤها، وما إذا كانت هناك حدود للعرض.

يجب أن يصدر السكّ حدث

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

إذا سُكّت التوكنات إلى عقد ذكي، فتُطبق عادةً دالة الاستقبال المناسبة.

ينبغي للمستخدمين فحص صلاحيات السكّ بدل افتراض أن عرض المعرّف الشبيه بـ NFT محدود دائمًا.

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

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

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

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

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

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

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

إجمالي العرض في ERC-1155

لا يحدد معيار ERC-1155 الأساسي دالة

.

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

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

يتضمن مرجع تنفيذ ERC-1155 الحالي إضافة اختيارية تتعقب إجمالي العرض لكل معرّف توكن.

ينبغي ألا تفترض التطبيقات أن كل عقود ERC-1155 توفر دوال العرض نفسها.

تعداد ERC-1155

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

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

و و.

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

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

يمكن للعقود إضافة دوال تعداد مخصصة، لكنها غير متاحة في كل العقود.

إتاوات ERC-1155

لا يتضمن معيار ERC-1155 الأساسي إتاوات المنشئين.

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

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

ينقل معيار الإتاوات معلومات الدفع، لكنه لا يُلزم كل تطبيق بالدفع.

قد تتغير إعدادات الإتاوة إذا مُنح المسؤول هذه الصلاحية في التنفيذ.

الأخطاء الموحدة في 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-165 الصحيحة.

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

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

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

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

ثالثًا، افحص العرض الحالي وصلاحية السكّ وحدود العرض.

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

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

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

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

ثامنًا، تحقق من الحقوق أو المنفعة الفعلية التي يوفرها التوكن.

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

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

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

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

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

يستدعي تطبيق محفظتها

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

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

ثم يخفض أرصدتها ويزيد أرصدة Bob لكل معرّف مدرج.

يصدر العقد حدث

واحدًا يصف الحركة كاملةً.

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

.

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

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

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

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

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

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

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

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

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

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

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

ومنها اعتبار الإتاوات قابلة للتنفيذ تلقائيًا.

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

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

ما معنى ERC-1155؟

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

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

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

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

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

.

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

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

.

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

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

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

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

ما التوكن شبه القابل للاستبدال في ERC-1155؟

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

هل يمكن لعقد ERC-1155 واحد أن يحتوي على أنواع أصول متعددة؟

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

ماذا تعيد balanceOf؟

تعيد كمية معرّف ERC-1155 محدد يملكه حساب.

ما وظيفة balanceOfBatch؟

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

ما هي safeBatchTransferFrom؟

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

ما وظيفة setApprovalForAll؟

تمنح مشغّلًا صلاحية إدارة كل معرّفات التوكن التي يملكها المستدعي ضمن عقد 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 بنية تحتية مرنة وفعالة متعددة التوكنات، لكن التوافق التقني لا يضمن الأصالة أو الندرة أو القيمة المالية أو أمان العقد الذكي.