Base URI

ما هو Base URI في عالم العملات المشفرة؟

‏Base URI هو المسار المشترك الذي يبدأ منه العقد الذكي لإنشاء الرابط الكامل للبيانات الوصفية الخاصة بتوكنات مجموعة ما.

في أنظمة البيانات الوصفية الخاصة بـ NFT والتوكنات، يحدد URI للمحافظ ومستكشفات البلوكشين والتطبيقات مكان العثور على بيانات JSON الوصفية التي تصف التوكن.

يعرّف معيار ERC-721 الرسمي الدالة tokenURI بأنها دالة تُرجع معرّف مورد موحدًا (URI) مميزًا لأصل معين.

غالبًا ما يُدمج Base URI مع معرّف التوكن لإنشاء tokenURI الكامل.

على سبيل المثال، قد يكون Base URI هو ipfs://exampleCID/، وقد يؤدي معرّف التوكن 25 إلى المسار ipfs://exampleCID/25.

وفي تصميم آخر، قد يتضمن مسار البيانات الوصفية الكامل امتداد ملف، مثل ipfs://exampleCID/25.json.

تعتمد النتيجة الدقيقة على طريقة إنشاء العقد الذكي لقيمة tokenURI.

توضح وثائق ERC-721 من OpenZeppelin أن الدالة _baseURI تُستخدم لحساب ERC721.tokenURI، وأن URI الناتج قد يكون حاصل دمج baseURI مع tokenId.

يجعل ذلك Base URI أداة عملية لتوفير رسوم الغاز وتنظيم البيانات الوصفية وتسهيل إدارة مجموعات NFT الكبيرة.

يهم Base URI مستخدمي العملات المشفرة لأنه يؤثر في مصادر تحميل صور NFT وسماتها وأوصافها وغيرها من البيانات الوصفية.

لماذا يُعد Base URI مهمًا؟

تكمن أهمية Base URI في أن ملكية التوكن وبياناته الوصفية لا تُخزَّن دائمًا في المكان نفسه.

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

أما الصورة والاسم والوصف والسمات والرسوم المتحركة والوسائط الخارجية، فعادةً ما تُخزَّن خارج البلوكشين.

يشكل Base URI حلقة الوصل بين التوكن على السلسلة وموقع البيانات الوصفية خارج السلسلة أو اللامركزي.

إذا كان Base URI صحيحًا، فستتمكن المحافظ والتطبيقات من عرض التوكن بشكل سليم.

أما إذا كان Base URI خاطئًا أو معطّلًا أو مركزيًا أو عُدّل بطريقة خبيثة، فقد تظهر للتوكن صور مفقودة أو سمات خاطئة أو معلومات مضللة.

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

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

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

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

لذلك يؤثر Base URI في تجربة المستخدم وسلامة البيانات الوصفية والثقة بالمجموعة وإمكانية قراءة الأصول على المدى الطويل.

آلية عمل Base URI

يعمل Base URI عادةً عبر تخزين بادئة مشتركة داخل عقد التوكن أو إرجاعها منه.

ثم يضيف العقد قيمة خاصة بالتوكن، غالبًا معرّف التوكن، لإنشاء URI الكامل للبيانات الوصفية.

على سبيل المثال، إذا كان Base URI هو ipfs://bafyExampleCollection/ وكان معرّف التوكن 100، فقد يصبح tokenURI النهائي ipfs://bafyExampleCollection/100.

إذا أضاف العقد لاحقة JSON، فقد يصبح tokenURI النهائي ipfs://bafyExampleCollection/100.json.

تخزّن بعض العقود Base URI في متغير حالة يمكن لعنوان مخوّل تحديثه.

وتثبت بعض العقود Base URI في الشيفرة بشكل دائم عند النشر.

وتُرجع بعض العقود قيم Base URI مختلفة بحسب حالة الكشف عن التوكن أو نوعه أو معرّف الشبكة أو منطق مخصص.

لا تستخدم بعض العقود Base URI إطلاقًا، بل تخزّن URI كاملًا وفريدًا لكل توكن.

ليس Base URI متطلبًا عامًا في كل عقد NFT.

لكنه نمط شائع للتنفيذ يُستخدم لإنشاء مسارات البيانات الوصفية للتوكنات بكفاءة.

Base URI وtokenURI

‏tokenURI هو URI الكامل الذي يُرجع لتوكن محدد.

أما Base URI فهو البادئة القابلة لإعادة الاستخدام، والتي يمكن أن تساعد في إنشاء العديد من قيم tokenURI.

في عقود ERC-721، يُعد tokenURI جزءًا من امتداد البيانات الوصفية الاختياري.

وينص معيار ERC-721 على أن tokenURI قد يشير إلى ملف JSON يتبع مخطط البيانات الوصفية لـ ERC-721.

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

لا يمثل Base URI بيانات JSON الوصفية نفسها.

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

قد يُنشئ عقد بسيط tokenURI من خلال دمج Base URI مع معرّف التوكن.

وقد يُرجع عقد أكثر تعقيدًا URI مخصصًا بالكامل لكل توكن.

وقد يُنشئ عقد NFT ديناميكي قيمة tokenURI من حالة على السلسلة بدلًا من استخدام Base URI ثابت.

ينبغي للمستخدمين التركيز على القيمة التي يُرجعها tokenURI، لأنها الموقع الفعلي للبيانات الوصفية الذي تستخدمه التطبيقات.

Base URI في NFTs من معيار ERC-721

‏ERC-721 هو معيار التوكنات الأكثر شيوعًا لرموز NFT الفريدة ذات معرّفات التوكنات المميزة.

يملك كل توكن ERC-721 معرّفًا فريدًا ضمن عقد محدد.

ويحدد عنوان العقد ومعرّف التوكن معًا NFT بشكل فريد على تلك البلوكشين.

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

يساعد Base URI العقد على تجنب تخزين URI كامل لكل توكن.

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

فبدلًا من تخزين 10,000 رابط كامل للبيانات الوصفية، يمكن للمجموعة تخزين Base URI واحد واستخدام معرّفات التوكنات لإنشاء روابط فردية.

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

على سبيل المثال، يمكن للتوكنات 1 و2 و3 مشاركة Base URI نفسه، مع إشارة كل منها إلى ملف بيانات وصفية مختلف.

يحافظ Base URI المشترك على بساطة البنية وقابليتها للتوقع.

Base URI في توكنات ERC-1155

‏ERC-1155 هو معيار متعدد التوكنات يدعم التوكنات القابلة للاستبدال وشبه القابلة للاستبدال وNFTs ضمن عقد واحد.

يتعامل ERC-1155 مع البيانات الوصفية بطريقة تختلف عن كثير من تطبيقات ERC-721.

ينص معيار ERC-1155 الرسمي على أن قيمة URI تسمح للعملاء باستبدال المعرّف عندما تظهر السلسلة {id} ضمن URI.

ويجب على العملاء استبدال {id} بمعرّف التوكن الفعلي بصيغة hexadecimal صغيرة الأحرف، مع إكماله إلى 64 خانة عند الضرورة.

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

على سبيل المثال، قد يبدو URI بهذا الشكل: https://example.com/metadata/{id}.json.

ويستبدل العميل أو التطبيق {id} بمعرّف التوكن المنسق للعثور على ملف JSON الصحيح.

يشبه هذا Base URI من حيث الغرض، إذ يتيح إنشاء روابط كثيرة للبيانات الوصفية للتوكنات انطلاقًا من نمط مشترك واحد.

لكن ERC-1155 يستخدم قاعدة استبدال محددة بدلًا من نمط Base URI مع معرّف التوكن البسيط الذي يظهر في كثير من عقود ERC-721.

ينبغي للمطورين عدم افتراض أن مسارات البيانات الوصفية في ERC-721 وERC-1155 تُنشأ بالطريقة نفسها.

Base URI والبيانات الوصفية لـ NFT

بيانات NFT الوصفية هي معلومات منظمة توضح للمستخدمين ما يمثله التوكن.

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

يتضمن مخطط بيانات ERC-721 الوصفية حقولًا أساسية مثل الاسم والوصف والصورة.

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

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

إذا خُزّنت البيانات الوصفية في ملفات JSON، فعادةً ما يقابل كل معرّف توكن ملف JSON واحد.

إذا كانت البيانات الوصفية ديناميكية، فقد يشير Base URI إلى نقطة نهاية API تُرجع JSON مختلفًا بمرور الوقت.

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

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

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

Base URI وIPFS

‏IPFS نظام تخزين لامركزي شائع الاستخدام للبيانات الوصفية والوسائط الخاصة بـ NFT.

يوصي دليل بيانات NFT الرسمي من IPFS باستخدام URIs الخاصة بـ IPFS لربط العقود الذكية ببيانات NFT الخارجية المخزنة على IPFS.

يبدأ URI الخاص بـ IPFS عادةً بـ ipfs:// ويتضمن معرّفًا للمحتوى يُعرف أيضًا باسم CID.

قد يبدو Base URI الذي يستخدم IPFS بهذا الشكل: ipfs://bafyExampleCID/.

بعد ذلك، يمكن تخزين ملف البيانات الوصفية لكل توكن داخل مجلد IPFS هذا.

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

إذا تغير المحتوى، يتغير CID أيضًا.

يساعد ذلك المستخدمين على اكتشاف أي تعديل في البيانات الوصفية.

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

يعزز استخدام Base URI على IPFS سلامة البيانات، لكنه لا يلغي الحاجة إلى التخطيط للتخزين طويل الأجل.

Base URI وروابط HTTP

يمكن أيضًا أن يستخدم Base URI رابط HTTPS عاديًا.

على سبيل المثال، قد تستخدم مجموعة ما https://example.com/metadata/ بوصفه Base URI.

عندئذ قد يصبح tokenURI للتوكن 100 هو https://example.com/metadata/100.json.

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

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

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

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

وإذا تعرض حساب مسؤول المشروع للاختراق، فقد تقدم نقطة نهاية البيانات الوصفية أو Base URI محتوى خبيثًا أو مضللًا.

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

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

Base URI والتخزين على نمط Arweave

تستخدم بعض مشاريع NFT أنظمة تخزين دائم للبيانات الوصفية والوسائط.

في هذه الأنظمة، قد تتم الإشارة إلى البيانات الوصفية عبر معرّف معاملة أو مسار محتوى دائم.

يمكن أن يشير Base URI إلى بوابة تخزين دائم أو مسار بيان ينظم ملفات بيانات وصفية كثيرة للتوكنات.

قد يقلل هذا النهج خطر اختفاء خادم ويب عادي.

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

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

فليس عنوان URL للبوابة دائمًا هو نفسه معرّف المحتوى الدائم الذي يكمن وراءه.

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

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

ينبغي أن يسهل تصميم Base URI تدقيق موقع البيانات طويل الأجل.

Base URI والبيانات الوصفية على السلسلة

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

يمكن إرجاع البيانات الوصفية على السلسلة بصيغة data URI تتضمن JSON مشفرًا مباشرةً من العقد الذكي.

في هذا التصميم، قد يُرجع tokenURI سلسلة تبدأ بـ data:application/json بدلًا من ipfs:// أو https://.

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

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

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

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

لذلك تستخدم مشاريع كثيرة Base URI للبيانات الوصفية الخارجية، وتقتصر على البيانات الوصفية الكاملة على السلسلة في حالات استخدام خاصة.

لا يوجد نموذج واحد هو الأفضل لكل مشروع.

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

Base URI وكشف البيانات الوصفية

تستخدم مجموعات NFT كثيرة Base URI أثناء عملية الكشف.

قبل الكشف، قد تُرجع جميع التوكنات بيانات وصفية مؤقتة متماثلة.

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

بعد الكشف، يحدّث المشروع Base URI لتشير كل توكن إلى ملف بياناته الوصفية النهائي.

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

لكن تصميمات الكشف تتطلب الثقة.

إذا كان المشروع يتحكم في Base URI، فقد يتمكن من تغيير البيانات الوصفية بعد سك التوكنات.

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

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

ينبغي للمستخدمين معرفة ما إذا كان Base URI للمجموعة مؤقتًا أو مكشوفًا أو قابلًا للتغيير أو مقفلًا بشكل دائم.

Base URI قابل للتغيير

Base URI القابل للتغيير هو Base URI يمكن تغييره بعد نشر العقد.

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

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

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

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

وقد يؤدي اختراق مفتاح المسؤول إلى النتيجة نفسها حتى لو كان الفريق الأصلي نزيهًا.

ينبغي للمستخدمين التحقق مما إذا كان لا يزال بالإمكان تغيير Base URI.

وعليهم أيضًا التحقق ممن يملك صلاحية تغييره.

ينطوي Base URI القابل للتغيير والخاضع لمحفظة واحدة مملوكة خارجيًا على مخاطر أكبر من عملية تحديث محكومة بعناية.

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

Base URI غير قابل للتغيير

Base URI غير القابل للتغيير هو Base URI لا يمكن تغييره بعد النشر أو بعد تنفيذ إجراء القفل النهائي.

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

يشيع استخدام Base URI غير القابل للتغيير في المشاريع التي تسعى إلى ضمان استمرارية المقتنيات على المدى الطويل.

وتزداد قوته خصوصًا عند دمجه مع التخزين المعرّف بالمحتوى، مثل CIDs الخاصة بـ IPFS.

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

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

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

ينبغي للمطورين اختبار مسارات البيانات الوصفية بعناية قبل قفل Base URI.

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

فالخطأ الدائم يظل دائمًا.

Base URI وتحديثات البيانات الوصفية وفق ERC-4906

‏ERC-4906 امتداد لتحديث البيانات الوصفية في توكنات ERC-721.

يضيف معيار ERC-4906 الرسمي الحدثين MetadataUpdate وBatchMetadataUpdate للإشارة إلى تغييرات البيانات الوصفية.

تكتسب هذه الميزة أهميتها لأن المحافظ ومفهرسات البيانات والتطبيقات غالبًا ما تخزّن البيانات الوصفية مؤقتًا.

إذا تغير Base URI ولم تحدّث التطبيقات ذاكرة التخزين المؤقت، فقد يواصل المستخدمون رؤية البيانات الوصفية القديمة.

يوفر ERC-4906 للعقود طريقة معيارية لإبلاغ الأنظمة الخارجية بتغير بيانات التوكن الوصفية.

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

لكن المعيار لا يجعل تغييرات البيانات الوصفية آمنة بحد ذاته.

فهو يساعد فقط في الإشارة إلى حدوث تغيير.

وتظل ضوابط الصلاحيات المرتبطة بتغييرات البيانات الوصفية مهمة.

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

Base URI والبيانات الوصفية المتعددة وفق ERC-7160

‏ERC-7160 امتداد لـ ERC-721 يدعم عدة URIs للبيانات الوصفية لكل توكن.

يصف معيار ERC-7160 الرسمي نظامًا يمكن أن يحتوي فيه التوكن على عدة URIs للبيانات الوصفية، مع URI أساسي مثبت.

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

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

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

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

وقد تتضمن NFT تعاونية بيانات وصفية من عدة منشئين.

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

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

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

Base URI وكفاءة رسوم الغاز

يُستخدم Base URI كثيرًا لخفض رسوم الغاز.

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

يتيح Base URI مشترك للعقد تخزين معلومات أقل.

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

يفيد ذلك خصوصًا المجموعات الكبيرة التي تضم معرّفات توكنات كثيرة.

على سبيل المثال، يمكن لمجموعة تضم 10,000 توكن استخدام Base URI واحد و10,000 ملف JSON تحمل أسماء معرّفات التوكنات.

ولا يحتاج العقد إلا إلى منطق يكفي لدمج Base URI مع معرّف التوكن.

يوفر هذا التصميم تكاليف التخزين، لكنه يقلل المرونة مقارنةً بتخزين URI مخصص لكل توكن.

على المطورين الموازنة بين توفير رسوم الغاز ومرونة البيانات الوصفية.

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

Base URI وتسميات الملفات

تكتسب تسمية الملفات أهميتها لأن إنشاء tokenURI يجب أن يتطابق مع ملفات البيانات الوصفية الفعلية.

إذا أعاد العقد ipfs://CID/1، فينبغي أن يتضمن موقع التخزين ملفًا أو عنصرًا باسم 1.

إذا احتوى موقع التخزين على 1.json بينما أعاد العقد 1 فقط، فقد تعجز بعض التطبيقات عن تحميل البيانات الوصفية.

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

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

ينبغي للمطورين تحديد طريقة تسمية الملفات قبل النشر.

وعليهم اختبار مخرجات tokenURI مقابل ملفات بيانات وصفية فعلية على شبكات الاختبار.

كما ينبغي اختبار عدة معرّفات للتوكنات، بما فيها المعرّفات المنخفضة والمرتفعة وغير المتسلسلة.

وينبغي أيضًا اختبار طريقة تفسير المحافظ ومفهرسات البيانات للبيانات الوصفية.

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

Base URI والشرطة المائلة الختامية

الشرطة المائلة الختامية هي الشرطة الموجودة في نهاية Base URI.

وقد تحدد ما إذا كان tokenURI النهائي صالحًا.

على سبيل المثال، يؤدي جمع ipfs://CID/ مع معرّف التوكن 1 إلى ipfs://CID/1.

أما من دون الشرطة، فيؤدي جمع ipfs://CID مع معرّف التوكن 1 إلى ipfs://CID1، وقد يكون ذلك خطأ.

وقد تحدث المشكلة نفسها مع مسارات HTTPS.

يؤدي جمع https://example.com/metadata/ مع 1.json إلى مسار ملف واضح.

أما جمع https://example.com/metadata مع 1.json فيؤدي إلى https://example.com/metadata1.json، وهو مسار قد لا يكون موجودًا.

ينبغي للمطورين التعامل مع الشرطات واللواحق باتساق داخل العقد.

قد لا يتمكن المستخدمون دائمًا من ملاحظة هذه المشكلة عند عرض NFT في سوق.

عندما لا تُحمّل البيانات الوصفية، غالبًا ما يكون أول ما ينبغي التحقق منه هو سلسلة tokenURI الدقيقة التي يُرجعها العقد.

Base URI والتخزين المؤقت للبيانات الوصفية

تخزّن محافظ وأسواق ومستكشفات وخدمات فهرسة كثيرة البيانات الوصفية لـ NFT مؤقتًا.

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

لكن التخزين المؤقت قد يجعل تغييرات Base URI مربكة.

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

وهذا أحد أسباب فائدة أحداث تحديث البيانات الوصفية.

وُضع ERC-4906 ليمنح العقود طريقة معيارية للإشارة إلى تغييرات البيانات الوصفية.

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

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

ولا يعني ذلك دائمًا أن ملكية التوكن قد تغيرت أو أن التوكن تعطّل.

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

Base URI ومخاطر المركزية

قد ينشئ Base URI مخاطر مركزية عندما يشير إلى خادم أو نطاق يتحكم فيه طرف واحد.

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

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

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

وهذا مهم لأن كثيرًا من المستخدمين يظنون أن امتلاك NFT يعني أن الأصل بأكمله مخزن بشكل دائم على السلسلة.

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

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

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

ومع ذلك، يحتاج كل مشروع إلى خطة تخزين طويلة الأجل.

قد يتحول NFT جميل إلى رابط معطّل إذا أُدير Base URI بطريقة سيئة.

Base URI وعنونة المحتوى

تعني عنونة المحتوى أن المعرّف يستند إلى المحتوى نفسه.

تُعد CIDs الخاصة بـ IPFS مثالًا شائعًا في البيانات الوصفية للعملات المشفرة.

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

وهذا يجعل اكتشاف التلاعب أسهل.

لذلك قد يمنح Base URI الذي يتضمن CID المستخدمين ثقة أكبر بأن الملفات المشار إليها لم تتغير دون علمهم.

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

لا تعني عنونة المحتوى أن المحتوى مخزّن تلقائيًا إلى الأبد.

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

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

إنها تساعد فقط في التحقق من بقاء المحتوى المرتبط بذلك المعرّف كما هو.

Base URI وNFTs الديناميكية

‏NFTs الديناميكية هي توكنات قد تتغير بياناتها الوصفية استنادًا إلى الأحداث أو الوقت أو إجراءات المستخدم أو حالة اللعبة أو بيانات Oracle أو منطق العقد.

قد تستخدم NFTs الديناميكية Base URI يشير إلى API أو خدمة بيانات وصفية ديناميكية.

وقد تنشئ أيضًا بيانات وصفية على السلسلة استنادًا إلى حالة متغيرة.

يمكن لـ Base URI الديناميكي جعل NFTs أكثر تفاعلية وفائدة.

على سبيل المثال، قد يرتقي مستوى NFT لشخصية في لعبة وتظهر سمات جديدة.

وقد يتغير مظهر NFT للعضوية عندما يبلغ المستخدم مستوى معينًا.

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

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

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

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

Base URI والأمان

يعتمد أمان Base URI على التخزين وضوابط الوصول ومنطق العقد وتوقعات المستخدمين.

إذا أمكن تحديث Base URI، فيجب أن تخضع وظيفة التحديث لضوابط صلاحيات قوية.

إذا كان مفتاح خاص واحد يتحكم في Base URI، يصبح هذا المفتاح هدفًا عالي القيمة.

إذا كانت محفظة متعددة التوقيعات تتحكم في Base URI، فيعتمد الأمان على كفاءة الموقّعين وقواعد العتبة.

إذا تحكمت الحوكمة في Base URI، فيعتمد الأمان على توزيع الأصوات وإجراءات الترقية.

إذا كان Base URI يشير إلى خادم، يصبح أمان الخادم والنطاق مهمًا.

وإذا أشار إلى IPFS، تصبح عمليات التثبيت وتوفر المحتوى مهمة.

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

لا يوجد نموذج أمني واحد يناسب كل Base URI.

والسؤال الأهم دائمًا هو: ما الذي يمكن تغييره، ومن يستطيع تغييره، وكيف يمكن للمستخدمين التحقق منه؟

Base URI وترقيات العقود الذكية

يمكن للعقود الذكية القابلة للترقية تغيير طريقة حساب tokenURI.

وهذا يعني أن منطق Base URI قد يتغير حتى إن بدا متغير Base URI الظاهر مستقرًا.

قد يتيح عقد NFT قابل للترقية للمطورين إصلاح الأخطاء أو إضافة ميزات.

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

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

كما ينبغي التحقق ممن يتحكم في الترقيات وما إذا كانت هناك مهلة زمنية أو عملية حوكمة.

تكون دلالة قفل Base URI محدودة إذا أمكن لترقية ما استبدال دالة tokenURI بالكامل.

لضمانات أقوى بشأن البيانات الوصفية، ينبغي مراجعة Base URI ومسار ترقية العقد معًا.

على المطورين الإفصاح بوضوح عن قابلية الترقية، لأنها تؤثر في الثقة.

ولا ينبغي للمستخدمين تقييم استمرارية البيانات الوصفية استنادًا إلى Base URI وحده.

Base URI والتحقق من التوكن

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

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

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

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

يمكن لـ Base URI إظهار وجهة البيانات الوصفية، لكنه لا يثبت وحده أن التوكن أصلي.

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

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

ينبغي للمطورين جعل مخرجات tokenURI قابلة للتوقع وسهلة الفحص.

يساعد تصميم Base URI الواضح على التحقق، لكنه لا يغني عن التحقق من العقد.

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

Base URI والبيانات الوصفية للمجموعة

يشير Base URI عادةً إلى مسارات البيانات الوصفية على مستوى التوكن.

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

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

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

ينبغي عدم الخلط بين Base URI الخاص بالتوكن وURI البيانات الوصفية للمجموعة.

يساعد Base URI الخاص بالتوكن على إنشاء بيانات وصفية لمعرّفات التوكنات الفردية.

أما URI البيانات الوصفية للمجموعة فيصف المجموعة بأكملها.

يمكن أن يؤثر كلاهما في طريقة عرض المحافظ والتطبيقات للمشروع.

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

ينبغي للمستخدمين معرفة URI الذي يتحكم في بيانات كل توكن والآخر الذي يتحكم في بيانات عرض المجموعة.

Base URI وتجميد البيانات الوصفية

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

قد يجمّد المشروع البيانات الوصفية بإزالة إمكانية تحديث Base URI.

وقد يجمّدها أيضًا عبر تعيين Base URI إلى مسار تخزين معرّف بالمحتوى والتنازل عن صلاحية التحديث.

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

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

فالوعد أضعف من القفل على مستوى العقد.

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

يتطلب تجميد البيانات الوصفية فعليًا مراجعة كل المسارات التي قد تغير نتائج tokenURI.

قد يعزز التجميد ثقة هواة جمع المقتنيات عندما تكون الاستمرارية مهمة.

لكن تجميد البيانات مبكرًا جدًا قد يثبت الأخطاء بحيث يتعذر إصلاحها لاحقًا.

Base URI وتجربة المستخدم

يؤثر Base URI في تجربة المستخدم لأن التطبيقات تستخدم البيانات الوصفية لإظهار ما يملكه المستخدمون.

إذا حُمّل Base URI بسرعة، عُرضت NFTs بسلاسة.

أما إذا كان بطيئًا أو غير متاح أو محجوبًا، فقد تعرض المحافظ صورًا فارغة أو عناصر مؤقتة عامة.

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

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

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

غالبًا ما يحكم المستخدمون على المجموعات من خلال ما يرونه في محافظهم.

لذلك ينبغي للمطورين اعتبار تصميم Base URI جزءًا من جودة المنتج.

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

قد يبدو العقد الذكي القوي معطّلًا إذا أُدير Base URI والبيانات الوصفية الخاصة به بطريقة سيئة.

أمثلة على Base URI

قد يبدو Base URI بسيط على IPFS بهذا الشكل: ipfs://bafyExampleCID/.

إذا أضاف العقد معرّف التوكن 7 واللاحقة .json، فقد يصبح tokenURI الكامل ipfs://bafyExampleCID/7.json.

وقد يبدو Base URI بسيط عبر HTTPS بهذا الشكل: https://example.com/api/token/.

إذا أضاف العقد معرّف التوكن 7، فقد يصبح tokenURI الكامل https://example.com/api/token/7.

وقد يبدو قالب URI الخاص بـ ERC-1155 بهذا الشكل: https://example.com/metadata/{id}.json.

في هذه الحالة، يستبدل العملاء المتوافقون {id} بمعرّف التوكن المنسق.

وقد يبدأ data URI على السلسلة بـ data:application/json;base64, بدلًا من استخدام Base URI.

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

عادةً ما تستعلم التطبيقات من دالة tokenURI في العقد.

ولا يكون Base URI مفيدًا إلا إذا أنتج نتائج tokenURI صالحة ومتاحة.

فوائد استخدام Base URI

الفائدة الأولى من Base URI هي كفاءة رسوم الغاز.

يمكن لبادئة مشتركة تقليل كمية البيانات المخزنة على السلسلة.

والفائدة الثانية هي سهولة تنظيم المجموعة.

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

والفائدة الثالثة هي تبسيط سك التوكنات للمجموعات الكبيرة.

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

والفائدة الرابعة هي سهولة إدارة الكشف.

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

والفائدة الخامسة هي التوافق.

اعتادت المحافظ ومستكشفات البلوكشين والتطبيقات قراءة tokenURI ومسارات البيانات الوصفية بنمط URI.

والفائدة السادسة هي المرونة.

يمكن لـ Base URI دعم IPFS أو HTTPS أو روابط التخزين الدائم أو نقاط نهاية API أو التصميمات الهجينة.

مخاطر استخدام Base URI

الخطر الأول هو تعطل البيانات الوصفية.

قد يؤدي Base URI خاطئ إلى تعطيل جميع التوكنات في مجموعة.

والخطر الثاني هو المركزية.

يعتمد Base URI الذي يشير إلى خادم عادي على ذلك الخادم والنطاق ومشغّله.

والخطر الثالث هو التحديثات الخبيثة.

إذا استطاع مسؤول تغيير Base URI، فقد يتمكن من تغيير ما تعرضه جميع التوكنات.

والخطر الرابع هو قابلية التغيير غير الواضحة.

قد يعتقد المستخدمون أن البيانات الوصفية دائمة بينما يظل Base URI قابلًا للتحرير.

والخطر الخامس هو الالتباس الناتج عن التخزين المؤقت.

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

والخطر السادس هو توفر التخزين.

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

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

قد يغير تحديث العقد سلوك tokenURI حتى عندما يبدو Base URI مقفلًا.

كيفية التحقق من Base URI

يمكن للمستخدمين التحقق من عمل Base URI باستدعاء دالة tokenURI لمعرّف توكن محدد.

ينبغي لهم مقارنة URI المُعاد بما يعلنه المشروع رسميًا عن بياناته الوصفية.

وعليهم التحقق مما إذا كان URI يبدأ بـ ipfs:// أو https:// أو data: أو ar:// أو مخطط آخر.

كما ينبغي لهم اختبار تحميل ملف البيانات الوصفية وإرجاعه JSON صالحًا.

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

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

كما ينبغي مراجعة العقد لمعرفة ما إذا كان بالإمكان تغيير Base URI.

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

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

ولا ينبغي افتراض أن التوكن آمن لمجرد ظهوره بشكل صحيح في محفظة واحدة.

أفضل الممارسات للمطورين

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

وعليهم اختيار ما إذا كان Base URI سيكون غير قابل للتغيير أو قابلًا للتغيير أو قائمًا على الكشف أو ديناميكيًا أو بالكامل على السلسلة.

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

كما ينبغي اختبار مخرجات tokenURI لعدد كبير من معرّفات التوكنات قبل الإطلاق.

وعليهم الحفاظ على اتساق تسمية الملفات واللواحق والشرطات المائلة الختامية.

ينبغي حماية وظائف تحديث Base URI بضوابط وصول قوية.

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

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

وعلى المطورين الاحتفاظ بنسخ احتياطية وخطط استضافة طويلة الأجل لجميع البيانات الوصفية والوسائط.

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

أفضل الممارسات للمستخدمين

ينبغي للمستخدمين التحقق من عنوان العقد قبل الوثوق بالبيانات الوصفية.

وعليهم فحص tokenURI لتوكن حقيقي بدلًا من الوثوق بلقطات الشاشة.

ينبغي تفضيل المشاريع التي تشرح بوضوح مكان تخزين البيانات الوصفية.

وعلى المستخدمين معرفة ما إذا كان لا يزال بالإمكان تغيير Base URI.

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

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

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

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

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

ينبغي التعامل مع البيانات الوصفية المعطلة أو المثيرة للريبة باعتبارها مؤشرًا على وجود مخاطر.

مفاهيم خاطئة شائعة حول Base URI

من المفاهيم الخاطئة الشائعة أن Base URI يخزّن NFT نفسه.

عادةً ما يشير Base URI إلى البيانات الوصفية، بينما يتتبع العقد الذكي الملكية.

ومن المفاهيم الخاطئة الأخرى أن صورة NFT مخزنة دائمًا على السلسلة.

تُخزَّن صور NFT كثيرة خارج السلسلة أو في تخزين لامركزي، ويُشار إليها عبر البيانات الوصفية.

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

يحسن IPFS سلامة المحتوى، لكن لا يزال على جهة ما إتاحته.

والاعتقاد الخاطئ الرابع هو أن قفل Base URI يضمن الملكية القانونية للأصل الظاهر في البيانات الوصفية.

استمرارية البيانات الوصفية والحقوق القانونية مسألتان مختلفتان.

والاعتقاد الخاطئ الخامس هو أن كل تغيير في Base URI سيئ.

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

أما الاعتقاد الخاطئ السادس فهو أن العرض الصحيح في تطبيق واحد يثبت أمان Base URI.

قد يخفي التخزين المؤقت المشكلات، وينبغي للمستخدمين فحص tokenURI الفعلي كلما أمكن ذلك.

مصطلحات العملات المشفرة ذات الصلة

‏URI هو اختصار لمعرّف المورد الموحد، وهو سلسلة نصية تُستخدم لتحديد مورد مثل ملف بيانات وصفية.

‏tokenURI هي دالة ERC-721 التي تُرجع URI البيانات الوصفية لمعرّف توكن محدد.

‏ERC-721 معيار شائع لتوكنات Ethereum غير القابلة للاستبدال.

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

بيانات NFT الوصفية هي بيانات JSON أو بيانات منظمة تصف اسم التوكن وصورته وسماته وخصائصه الأخرى.

‏IPFS اختصار لنظام الملفات بين الكواكب، وهو شبكة تخزين معرّفة بالمحتوى تُستخدم كثيرًا لبيانات NFT.

‏CID هو معرّف المحتوى، وهو مرجع معرّف بالمحتوى يستخدمه IPFS.

‏Data URI هو URI يضمّن البيانات مباشرةً داخل سلسلة URI.

كشف البيانات الوصفية هو عملية تحويل التوكنات من بيانات مؤقتة إلى بيانات نهائية.

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

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

ما المقصود بـ Base URI في NFTs؟

Base URI هو المسار المشترك الذي يبدأ منه العقد الذكي لإنشاء URI الكامل للبيانات الوصفية لكل NFT.

هل Base URI هو نفسه tokenURI؟

لا، عادةً ما يكون Base URI هو البادئة المشتركة، بينما tokenURI هو URI الكامل للبيانات الوصفية الذي يُرجع لتوكن محدد.

كيف يعمل Base URI في ERC-721؟

في كثير من عقود ERC-721، يُدمج Base URI مع معرّف التوكن لإنشاء tokenURI النهائي لذلك الـ NFT.

كيف يعمل Base URI في ERC-1155؟

يستخدم ERC-1155 غالبًا قالب URI واحدًا مع استبدال {id}، حيث يستبدل العملاء {id} بمعرّف التوكن المنسق.

هل يمكن تغيير Base URI؟

نعم، يمكن تغيير Base URI إذا تضمن العقد وظيفة تحديث ولا يزال حساب مخوّل يتحكم فيها.

هل ينطوي Base URI القابل للتغيير على مخاطر؟

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

هل Base URI غير القابل للتغيير أفضل دائمًا؟

قد يعزز Base URI غير القابل للتغيير الثقة، لكنه قد يثبت الأخطاء نهائيًا أيضًا إذا كانت مسارات البيانات الوصفية خاطئة عند الإطلاق.

لماذا تستخدم مشاريع NFT ‏IPFS لـ Base URI؟

تستخدم المشاريع IPFS لأن CIDs الخاصة به معرّفة بالمحتوى، وتساعد المستخدمين على التحقق من أن البيانات الوصفية المشار إليها لم تتغير دون علمهم.

هل يضمن IPFS بقاء بيانات NFT الوصفية متاحة على الإنترنت إلى الأبد؟

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

لماذا لا تظهر صورة NFT رغم أنني أملك التوكن؟

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

ما المقصود بكشف البيانات الوصفية؟

كشف البيانات الوصفية هو انتقال المشروع بالتوكنات من بيانات مؤقتة إلى بيانات نهائية، غالبًا عبر تحديث Base URI أو منطق tokenURI.

كيف يمكنني التحقق من أمان Base URI الخاص بـ NFT؟

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

الخلاصة

‏Base URI مفهوم أساسي للبيانات الوصفية في عقود NFT والتوكنات المشفرة.

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

في كثير من مجموعات ERC-721، يُدمج Base URI مع معرّف التوكن لإنشاء tokenURI.

أما في ERC-1155، فيؤدي غرضًا مشابهًا عادةً قالب URI يستخدم استبدال {id}.

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

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

إذا أشار Base URI إلى خوادم مركزية، يعتمد المستخدمون على تلك الخوادم ومشغّليها.

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

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

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

ينبغي للمطورين تصميم منطق Base URI بعناية قبل الإطلاق، واختبار مسارات الملفات بدقة، وحماية صلاحيات التحديث، والإفصاح بوضوح عن قابلية تغيير البيانات الوصفية.

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

أهم ما ينبغي تذكره هو أن ملكية NFT وبيانات NFT الوصفية مرتبطتان، لكنهما ليستا الشيء نفسه.

يثبت العقد الذكي ملكية التوكن، بينما يساعد Base URI التطبيقات على العثور على البيانات التي توضح ما يمثله التوكن.

يجعل تصميم Base URI القوي هذه الصلة مستقرة وشفافة وسهلة التحقق.

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