الأداة AT-W40REV.‎ 2026-A

فحص بيانات NFT الوصفية: هل يعرض السوق NFT الخاص بكم بشكل صحيح؟

تقرأ الأسواق والمحافظ اسم NFT وصورته وخصائصه من ملف JSON يشير إليه العقد عبر tokenURI.‎ يكفي وجود # قبل اللون، أو رقم بين علامتي اقتباس، أو عنوان بوابة بدلاً من ipfs:// لتختفي حقول أو تتوقف الصورة عن الظهور لاحقاً. يقرأ الفاحص JSON أو data:-URI الخاص بكم، ويفحصه وفق ERC-721 وERC-1155 وERC-7572 وقواعد الأسواق، ثم يعرض معاينة.

  • مجاني
  • دون محفظة رقمية
  • يفحص في المتصفح، ولا يجلب أي شيء

ألصقوا البيانات الوصفية واطّلعوا على النتائج والمعاينة

فاحص · بيانات NFT الوصفية وفق ERC-721 وERC-1155 وERC-7572

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

الخطوة 1ما الذي تفحصونه؟
الخطوة 2لصق البيانات الوصفية

JSON من ملف بياناتكم الوصفية، أو القيمة التي يعيدها tokenURI أو uri على شكل data:application/json;base64,…، أو عنوان مثل ipfs://… (يُفحص فقط ولا يُجلب).

النتيجة

غير محدَّدألصقوا بيانات وصفية بصيغة JSON، أو data:-URI، أو عنواناً.

القواعد وفق ERC-721 وERC-1155 وERC-7572 وتوثيق OpenSea ومسودة ERC-8495، بتاريخ 14 تشرين الثاني/نوفمبر 2026. يظهر المصدر بجانب كل نتيجة. نبني معكم مجموعة تظهر بشكل صحيح في كل مكان؛ راسلونا عبر نموذج التواصل.

يجري الفحص في متصفحكم. لا يُرسل أي شيء ولا يُخزّن ولا يُجلب.

كيف يحصل السوق على الاسم والصورة

نادراً ما يحتوي العقد على الصورة نفسها. يعيد عقد ERC-721 عنواناً لكل رمز عبر الدالة tokenURI، ويعيده عقد ERC-1155 عبر uri.‎ يوجد خلف هذا العنوان مستند JSON صغير يحتوي على الاسم والوصف وعنوان الصورة. لذلك يجلب السوق ملفين بالتتابع، وقد يكون أيّ منهما مفقوداً أو مكتوباً بشكل خاطئ أو منقولاً إلى مكان آخر.

يحدّد ERC-721 لهذا الغرض 3 حقول فقط: name وdescription وimage.‎ وكل ما تعرضه الأسواق غير ذلك، من الفيديوهات إلى الخصائص، يتبع عرفاً وثّقته OpenSea عام 2018. ولأن OpenSea كان السوق صاحب أكبر عدد من المستخدمين وأعلى حجم مبيعات White وآخرون 2022، تتبعه الأسواق الأخرى. منذ تشرين الثاني/نوفمبر 2026، أصبح هذا العرف متاحاً في مسودة ERC-8495؛ ويعتمد الفاحص كليهما مرجعاً ويذكر المصدر عند كل نتيجة.

أخطاء البيانات الوصفية ليست مسألة شكلية. فتخزين الربط بين الرمز والملف بشكل خاطئ يفصل NFT عما يمثّله، وقد يجعله بلا قيمة في أسوأ الحالات Mell وYaga 2024.

الجلبالعقدTOKENURIبيانات JSON الوصفيةIMAGEعنوان الصورةالعرض فيالسوقمكان التخزينDATA: داخلالعقدIPFS:// مع CIDAR:// ARWEAVEHTTPS سيرفر ويبالجلبالعقد TOKENURIبيانات JSON الوصفيةIMAGE عنوان الصورةالعرض في السوقمكان التخزينDATA: داخل العقدIPFS:// مع CIDAR:// ARWEAVEHTTPS سيرفر ويب
الشكل 1 · من العقد إلى العرضاللون الذهبي = ما تفحصه هذه الأداة

حقول البيانات الوصفية للرمز

الحقول في الملف المشار إليه عبر tokenURI أو uri
الحقلالمنشأماذا يجب أن يتضمن
nameERC-721, ERC-1155اسم الرمز، كنص عادي. عند غيابه، تعرض الأسواق غالباً «#123» فقط.
descriptionERC-721, ERC-1155الوصف. يقرأ OpenSea تنسيق Markdown، ولا يعرض HTML الخام.
imageERC-721, ERC-1155صورة للقوائم والمعاينة. يوصي ERC-721 بعرض من 320 إلى 1080 px، بينما يوصي OpenSea بأبعاد لا تقل عن 3000 × 3000 px.‎
animation_urlOpenSea، مسودة ERC-8495فيديو أو صوت أو نموذج ثلاثي الأبعاد أو صفحة HTML، يُعرض بدلاً من الصورة. تبقى الصورة إلزامية كبديل احتياطي.
external_urlOpenSea، مسودة ERC-8495رابط من السوق إلى صفحتكم الخاصة، ويفضّل أن يكون https.‎
background_colorOpenSea، مسودة ERC-8495لون الخلفية وراء الصورة: 6 خانات ست عشرية دون #، مثل E0F2FE.‎
attributesOpenSea، مسودة ERC-8495خصائص على شكل قائمة تضم trait_type وvalue، واختيارياً display_type وmax_value.‎ تُنشأ منها عوامل تصفية المجموعة.
decimalsERC-1155عدد المنازل العشرية لعرض الكمية، ويكون عدداً صحيحاً ابتداءً من 0.
propertiesERC-1155معلومات إضافية من أي نوع على شكل كائن. لا تعرض الأسواق كعوامل تصفية إلا الخصائص الواردة في attributes.‎
localizationERC-1155الترجمات: الحقول uri مع {locale}، وdefault وlocales إلزامية.
image_dataحقل قديم (OpenSea 2018)SVG خام بدلاً من image.‎ لا يُقرأ الآن إلا عند غياب image؛ لا تستخدموه بعد الآن.
youtube_urlحقل قديم (OpenSea 2018)فيديو YouTube بدلاً من animation_url.‎ لا تستخدموه بعد الآن.

لا يوجد حقل إلزامي، حتى في ERC-721. لكن عند غياب name أو image، لا يعرض السوق سوى رقم وصورة بديلة. القواعد بتاريخ 14 تشرين الثاني/نوفمبر 2026.

تستحق الصورة عناية خاصة. تتسم المجموعات بمظهر متناسق، وإلى جانب سجل المبيعات السابق، تُعدّ خصائص الصورة أفضل ما يساعد على توقّع السعر Nadini وآخرون 2021. يوصي ERC-721 بعرض من 320 إلى 1080 بكسل، وبنسبة أبعاد بين 4:5 و1.91:1، بينما يوصي OpenSea بأبعاد لا تقل عن 3000 × 3000 بكسل. إذا كانت الصورة داخل النص بصيغة data:-URI، يقرأ الفاحص تنسيقها وحجمها مباشرة من البايتات.

attributes: كتابة الخصائص بحيث تعمل عوامل التصفية بشكل صحيح

تُنشأ من attributes عوامل تصفية المجموعة، وتُحسب منها ندرة NFT في كثير من المواقع. ولهذا أثر: في 410 مجموعات شملت 3.7 مليون معاملة، ارتبطت الندرة المحسوبة من الخصائص بوضوح بالسعر والتداول Mekacher وآخرون 2022. مسافة زائدة في «Farbe » تجعل نوعاً واحداً من الخصائص نوعين، فيصبح العدّ غير صحيح.

طريقة الكتابة وطريقة العرض التقريبية في السوق
الإدخال في attributesالعرضالنوع
{"trait_type":"Farbe","value":"Gold"}بالألمانية: Farbe: Gold (اللون: ذهبي)النص
{"trait_type":"Stufe","value":3,"max_value":5}بالألمانية: Stufe: 3 von 5 (المستوى: 3 من 5)رقم
{"display_type":"number","trait_type":"Punkte","value":12}بالألمانية: Punkte: 12 (النقاط: 12)رقم
{"display_type":"boost_number","trait_type":"Ausdauer","value":40}بالألمانية: Ausdauer: +40 (التحمّل: +40)زيادة
{"display_type":"boost_percentage","trait_type":"Rabatt","value":10}بالألمانية: Rabatt: +10 % (الخصم: +10 %)زيادة بالنسبة %
{"display_type":"date","trait_type":"Gültig bis","value":1798761600}بالألمانية: Gültig bis: 01.01.2027 (صالح حتى: 01.01.2027)التاريخ

display_type: number, boost_number, boost_percentage, date, string, text.‎ تُعامل القيم الأخرى كما لو كان الحقل غير موجود.

  • الرقم دون علامتي اقتباس. "value": "5" نص، أما "value": 5 فهو رقم. مع number وboost_number وboost_percentage وdate يجب أن تكون القيمة رقماً؛ ويقرأ OpenSea الرقم بين علامتي اقتباس صراحةً كنص.
  • التاريخ بالثواني. توقيت Unix مثل block.timestamp، أي 1798761600 ليوم 1 كانون الثاني/يناير 2027. القيم ابتداءً من 1,000,000,000,000 تكون دائماً تقريباً بالميلي ثانية: فقراءة 1798761600000 على أنه ثوانٍ تعني سنة 58970.
  • max_value للأرقام فقط. دون max_value، يستخدم OpenSea أعلى قيمة رآها في المجموعة. إذا كانت max_value أصغر من value، تكون المعلومة غير صالحة.
  • قيم متعددة، اسم واحد. قبعة ووشاح: يُكتب trait_type «Zubehör» مرتين، لكل منهما value واحدة. تُتجاهل القيمة إذا كانت قائمة.
  • الكتابة متطابقة تماماً. يُعدّ «Farbe» و«farbe» عاملَي تصفية مختلفين في السوق. يُبلغ الفاحص عن هذه الحالات.

data: أو ipfs:// أو ar:// أو https: أين ينبغي تخزين الصورة وJSON؟

دوام NFT مرتبط بدوام الملف الذي يشير إليه. في دراسة شملت 8 أسواق كبيرة، لم تكن 80.69 بالمئة من عناوين البيانات الوصفية على IPFS؛ وتغيّر العنوان لدى 2.89 بالمئة من الرموز خلال 3 أشهر، واختفى المحتوى خارج IPFS بمعدل أعلى Das وآخرون 2022. ولم يكن وضع الأعمال الفنية مرتفعة السعر أفضل بكثير: غيّر 19 من أصل 51 عقداً عنوان البيانات الوصفية مرة واحدة على الأقل Balduf وآخرون 2022.

كيف يصنّف الفاحص العناوين
طريقة الكتابةالتصنيفالسبب
data:application/json;base64,…جيدمخزّن داخل العقد نفسه، ولا يتغيّر إلا معه. يُنصح به للبيانات الوصفية الصغيرة وصور SVG.‎
ipfs://<CID>/…جيدعنوان قائم على المحتوى: CID هو بصمة تجزئة للمحتوى. يبقى متاحاً ما دامت عقدة واحدة على الأقل تحتفظ بالبيانات وتتيحها (التثبيت، Pinning).
ar://<Transaktions-ID>جيدArweave، تخزين مدفوع على المدى الطويل. يتكوّن المعرّف من 43 محرفاً بترميز Base64URL.‎
ar://<Name>بحذراسم ArNS: مؤشّر يمكن تغيير وجهته، ولذلك فهو قابل للتغيير.
https://…بحذرسيرفر خاص أو سحابة. قد يتغيّر المحتوى أو يختفي بمجرد توقف الدفع.
https://<Gateway>/ipfs/<CID>بحذريربط محتوى IPFS بمشغّل واحد. الأفضل إدخال ipfs://<CID>.
ipns://…بحذراسم قابل للتغيير في IPFS.‎ للمحتوى المراد تغييره فقط.
web3://…, onchain:…بحذرجلب عبر استدعاء عقد (ERC-4804، مسودة ERC-8493). يقرأه OpenSea، لكن كثيراً من المحافظ لا تقرؤه.
http://…خاطئغير مشفّر؛ تحجب المتصفحات هذه الصور على صفحات https.‎
ipfs://ipfs/<CID>خاطئتكرار ipfs؛ تصحّحه بعض البرامج العميلة، لكن لا ينبغي أن تعتمدوا على ذلك.
relativ, z. B. 1.pngخاطئدون مخطط عنوان، لا يعرف أي برنامج عميل مكان الملف.

https: الخيار المعتاد الذي لا يدوم

عنوان الويب مريح، لكنه لا يبقى إلا ما دام السيرفر وعقد الاستضافة قائمين. وهذه ليست مشكلة خاصة بـ NFT: في أكثر بقليل من مليون رابط ويب ضمن مقالات علمية، احتوى مقال واحد من كل 5 مقالات على رابط واحد على الأقل لا يؤدي إلى شيء أو يؤدي إلى محتوى متغيّر Klein وآخرون 2014. مع ذلك، يُعدّ https مناسباً للأشياء المقصود أن تتغيّر، مثل رمز وصول له مدة صلاحية؛ وقد أصبحت رموز NFT الديناميكية هذه مجالاً بحثياً مستقلاً Guidi وMichienzi 2023. عندها يرسل العقد الحدث MetadataUpdate وفق ERC-4906 مع كل تغيير، وإلا يواصل السوق عرض الحالة القديمة لفترة طويلة.

ipfs://: عنوان قائم على المحتوى، لكن مع التثبيت فقط

في IPFS، يكون العنوان بصمة تجزئة للمحتوى، وهي CID Trautwein وآخرون 2022. إذا تغيّر بكسل واحد، تتغيّر CID؛ لذلك لا يستطيع أحد استبدال المحتوى خلف عنوان ipfs:// خفيةً. يبدأ CIDv0 بـ Qm ويتكوّن من 46 محرفاً، بينما يبدأ CIDv1 غالباً بـ bafy.‎ يفك الفاحص ترميز النوعين ويفحص الإصدار وCodec وطول بصمة التجزئة، لأن CID المبتور قد يبدو طبيعياً للوهلة الأولى.

لكن IPFS لا يخزّن شيئاً من تلقاء نفسه. يبقى الملف متاحاً ما دامت عقدة واحدة على الأقل تحتفظ به وتتيحه Daniel وTschorsch 2022. في قياس شمل أكثر من 4 ملايين ملف IPFS، نحو نصفها مرتبط بـ NFT، لم يمكن جلب كثير منها إلا بعد محاولات متعددة، وكان 50 مزوّداً يقدّمون 95 بالمئة من الملفات Shi وآخرون 2024. والشبكة عموماً أكثر مركزية واعتماداً على السحابة مما توحي به سمعتها Balduf وآخرون 2023. كما أن عرض السوق للصورة لا يثبت الكثير: فهو غالباً يعرض نسخة خاصة به Guidi وآخرون 2025.

الملف نفسه، بصيغتي كتابة
CIDv0QmbWqxBEKC3P8tqsKc98xmWNzrzDtRLMiMPL8wBuTGsMnR
CIDv1bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

تنتج عن ذلك 3 قواعد. ثبّتوا الملفات لدى مزوّدَين مستقلَّين على الأقل أو على عقدة خاصة بكم. إذا كان الملف داخل مجلد (ipfs://…/1.png)، فثبّتوا المجلد كله، لأن الملف لا يمكن العثور عليه دون كتلة بيانات المجلد. وأدخلوا ipfs://، ولا تستخدموا عنوان بوابة أبداً.

عناوين البوابات: أكثر الأخطاء القابلة للتجنّب شيوعاً

تُدرج عقود كثيرة https://gateway.pinata.cloud/ipfs/… أو https://ipfs.io/ipfs/… بدلاً من ipfs://. وبذلك يصبح العرض معتمداً على مشغّل واحد بالضبط، وينخفض توفّر المحتوى وسلامته إلى مستوى سيرفر ويب عادي Balduf وآخرون 2022. ويمكن حتى استبدال ردود البوابة أثناء النقل دون اكتشاف ذلك، ما دام لا أحد يعيد حساب CID Stöger وآخرون 2023. تذكر مسودة ERC-8495 عيّنة خاصة بها: لم يُحمّل 113 من أصل 204 عناوين رموز تستخدم بوابات. والبوابات تختفي فعلاً؛ فقد أوقفت Cloudflare النطاقين cloudflare-ipfs.com وcf-ipfs.com في 14.08.2024. يتعرّف الفاحص على البوابات القائمة على المسار أو النطاق الفرعي، ويقترح صيغة ipfs://.

ar://: دفع مقابل التخزين لمدة طويلة

يتبع Arweave نهجاً آخر. تُدفع رسوم الرفع مرة واحدة، ويُفترض أن تحتفظ الشبكة بالبيانات بشكل دائم Daniel وTschorsch 2022. يتكوّن العنوان من ar:// ومعرّف معاملة من 43 محرفاً بترميز Base64URL، مع التمييز بين الأحرف الكبيرة والصغيرة. الاسم الأقصر بعد ar:// هو اسم ArNS: عملي، لكن يمكن تغيير وجهته، ولذلك فهو قابل للتغيير.

البيانات الوصفية داخل العقد: استخدام data:-URI دون أخطاء شائعة

البيانات الوصفية الأكثر دواماً هي التي يعيدها العقد نفسه. ويوصي باحثون درسوا رموز NFT الفنية المتداولة بأسعار مرتفعة جداً بهذا الخيار تحديداً لكل ما كان حجمه صغيراً بما يكفي Balduf وآخرون 2022. عندها لا يعيد tokenURI عنواناً، بل data:-URI يحتوي على JSON، وغالباً تكون الصورة مضمنة معه بصيغة SVG.‎ تحسب حاسبة رسوم Gas تكلفة ذلك من Gas.‎

  • Base64 بدلاً من النص غير المرمّز. الصيغة الموصى بها هي data:application/json;base64,…. دون ترميز، يتوقف المتصفح عند أول #، فيُفسد المستند اسم مثل «Pass #42» أو لون مثل #fff داخل SVG.‎
  • ;utf8 ليس معاملاً. الصيغة data:application/json;utf8,… شائعة ويمكن قراءتها، لكن RFC 2397 لا يعرّف إلا صيغة سمة=قيمة، أي ;charset=utf-8. مع Base64 لا تُطرح هذه المسألة.
  • SVG دون سكربتات. يمكن أن يحتوي SVG على شيفرة قابلة للتنفيذ Heiderich وآخرون 2011. لذلك تعرضه الأسواق كصورة فقط: لا تعمل السكربتات، ولا تُحمّل الخطوط والصور الخارجية، ويخزّن OpenSea نسخة SVG مؤقتاً بصيغة PNG.‎ وكل ما يعتمد على هذه العناصر يغيب عن العرض.
  • نوع وسائط مناسب. يُستخدم في image نوع مثل image/svg+xml أو image/png وما شابه. يقارن الفاحص النوع المذكور بالبايتات الفعلية.

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

ERC-1155: ‏{id} وأسماء الملفات والترجمات

غالباً يعيد عقد ERC-1155 قيمة uri نفسها لجميع الرموز، مثل ipfs://bafy…/{id}.json.‎ يستبدل البرنامج العميل العنصر النائب {id} بمعرّف الرمز، بالنظام الست عشري، وبأحرف صغيرة، ودون 0x، مع إكماله إلى 64 محرفاً. وينطبق هذا أيضاً على {id} داخل قيم JSON، مثل image.‎

أكثر الأخطاء شيوعاً يكون في اسم الملف: تُسمّى الملفات 1.json و2.json، بينما يبحث السوق عن 000…001.json.‎ أدخلوا معرّف الرمز في الفاحص لتروا العنوان الكامل. وبالمناسبة، لا يُستبدل {id} في ERC-721.

يضيف ERC-1155 أيضاً 3 حقول خاصة به: decimals للرموز القابلة للتجزئة، وproperties للمعلومات الإضافية من أي نوع، وlocalization للترجمات. داخل localization، تُعدّ uri وdefault وlocales إلزامية، وتحتوي uri على {locale} الذي يستبدله البرنامج العميل برمز اللغة.

إلى ماذا يتحوّل {id}
معرّف الرمزالقيمة البديلة، 64 محرفاً
10000000000000000000000000000000000000000000000000000000000000001
42000000000000000000000000000000000000000000000000000000000000002a
25500000000000000000000000000000000000000000000000000000000000000ff
314592000000000000000000000000000000000000000000000000000000000004cce0

contractURI: البيانات الوصفية للمجموعة كاملة

يأتي اسم صفحة المجموعة وصورتها العلوية ووصفها من ملف منفصل تشير إليه الدالة contractURI.‎ يصفه ERC-7572؛ ولا يزال المعيار مسودة، لكن OpenSea يقرأه. الحقل الإلزامي الوحيد هو name.‎ وعند تغيّر الملف، يرسل العقد ContractURIUpdated().

الحقول في الملف المشار إليه عبر contractURI
الحقلماذا يجب أن يتضمن
nameاسم المجموعة. الحقل الإلزامي الوحيد.
symbolالاختصار الدال على المجموعة.
descriptionوصف المجموعة.
imageصورة الملف التعريفي للمجموعة.
banner_imageصورة الشريط العلوي في صفحة المجموعة.
featured_imageصورة للأقسام البارزة.
external_linkموقعكم. انتبهوا: اسم الحقل هنا external_link، وفي الرمز external_url.‎
collaboratorsعناوين Ethereum المسموح لها بتعديل صفحة المجموعة في الأسواق.

يفحص الفاحص تنسيق العناوين في collaborators ومجموع التحقق وفق EIP-55. ويشير الاستخدام الخاطئ للأحرف الكبيرة والصغيرة دائماً تقريباً إلى خطأ مطبعي. يمكنكم مقارنة العناوين الفردية محرفاً بمحرف باستخدام فاحص عناوين Ethereum.

ماذا تقول الأبحاث عن بيانات NFT الوصفية

تستند تصنيفات الفاحص إلى قياسات في منظومة NFT وشبكة IPFS.‎ تدعم 5 نتائج أهم القرارات؛ وتجدون القائمة الكاملة مع ملاحظة التحقق أدناه.

  • عناوين البيانات الوصفية تتغيّر، ومحتوى الويب يختفي. تغيّرت 2.89 بالمئة من العناوين خلال 3 أشهر، وفُقد المحتوى خارج IPFS بمعدل أعلى Das وآخرون 2022. لذلك يصنّف الفاحص https على أنه قابل للتغيير.
  • عناوين البوابات تحوّل IPFS إلى سيرفر ويب. البوابات المدرجة بشكل ثابت تخفّض التوفّر إلى مستوى السحابة Balduf وآخرون 2022، ويمكن تعديل ردودها أثناء النقل Stöger وآخرون 2023. يُبلغ الفاحص عن كل عنوان بوابة ويقدّم بديلاً له.
  • IPFS لا يحتفظ بالبيانات من تلقاء نفسه. احتاجت ملفات NFT كثيرة إلى محاولات جلب متعددة Shi وآخرون 2024، وغالباً تعرض الأسواق نسخة خاصة بها Guidi وآخرون 2025. لذلك تظهر ملاحظة التثبيت بجانب كل عنوان ipfs://.
  • الخصائص تؤثّر في الأسعار. ترتبط الندرة المستنتجة من attributes بالسعر والعائد Mekacher وآخرون 2022. لذلك يُبلغ الفاحص حتى عن مسافة زائدة في البداية أو النهاية.
  • أخطاء البيانات الوصفية تفصل الرمز عن المحتوى. هكذا يصفها تقرير NIST عن نقاط ضعف NFT Mell وYaga 2024؛ ولذلك يُعدّ image غير الصالح خطأً، وليس أمراً بسيطاً.

كيف تطلقون مجموعة بشكل سليم

  1. حدّدوا مكان التخزين. البيانات الوصفية الصغيرة وSVG داخل العقد بصيغة data:-URI، والصور والفيديوهات الأكبر على IPFS أو Arweave.‎ استخدموا https فقط للمحتوى المراد تغييره.
  2. افحصوا ملفاً لكل رمز. ألصقوا الاسم والصورة والخصائص هنا، وصحّحوها حتى تختفي الأخطاء والتحذيرات. مع ERC-1155، أدخلوا معرّف الرمز وقارنوا أسماء الملفات.
  3. وفّروا التثبيت بشكل مزدوج. لدى مزوّدَين مستقلَّين أو على عقدة خاصة بكم، مع تثبيت المجلد كله.
  4. اكتبوا ملف المجموعة. contractURI مع name والصورة والصورة العلوية وexternal_link، وافحصوه هنا.
  5. تحقّقوا من العرض على شبكة الاختبار. اسكّوا رمزاً واعرضوه على شبكة الاختبار الخاصة بأحد الأسواق وفي محفظتَين قبل الانتقال إلى الشبكة الرئيسية.
  6. أبلغوا عن التغييرات. أرسلوا MetadataUpdate ‏(ERC-4906) أو URI ‏(ERC-1155) أو ContractURIUpdated() عند حدوث تغيير.

أين تنتهي حدود الفاحص

  • لا يجلب أي شيء. لا يعرف ما إذا كانت صورة تحت ipfs:// لا تزال مثبّتة أو ما إذا كان السيرفر يستجيب. ويذكر عنوان البوابة كنص لاستخدامه في الجلب.
  • تختلف الأسواق فيما بينها. يجري الفحص وفق المعايير وتوثيق OpenSea ومسودة ERC-8495. تقرأ بعض المحافظ حقولاً أقل، وتستخدم بعض الأسواق حقولاً إضافية خاصة بها.
  • لا يحكم على القيمة أو الأصالة. يمكن نسخ الاسم والصورة بحرية؛ وقد استخدمت النسخ المزوّرة غالباً عناوين الصور نفسها التي يستخدمها الأصل Das وآخرون 2022. يمكنكم تحديد NFT من عنوان العقد ومعرّف الرمز.

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

استخدام هذه الأداة من داخل مساعد ذكاء اصطناعي

المساعدات مثل Claude أو ChatGPT التي تدعم بروتوكول Model Context Protocol (MCP) تستطيع أن تستدعي حساب هذه الصفحة مباشرة بدل أن تعيد بناءه. السيرفر عام، لا يحتاج إلى تسجيل ولا يحفظ شيئاً. ويتضمن الجواب دائماً رابط هذه الصفحة وتاريخ البيانات وحدود النتيجة.

نقطة الاتصال (Endpoint)
https://aureum-tech.com/mcp
الأداة
werkzeug_nft_metadaten_pruefer
بروتوكول النقل
Streamable HTTP، للقراءة فقط
المدخلات
الاسمإلزاميالمعنى
metadatenنعمما يُراد فحصه: البيانات الوصفية بصيغة JSON كنص، أو القيمة التي يعيدها tokenURI أو uri أو contractURI بصيغة data:-URI (نوع الوسائط application/json، بترميز Base64 أو دون ترميز)، أو عنوان فقط (ipfs:// أو ar:// أو https://)، وعندها يُفحص دون جلبه.
standardلاالمعيار المطلوب للفحص: erc721 = بيانات الرمز الوصفية (tokenURI)، erc1155 = بيانات الرمز الوصفية مع {id} ‏(uri)، erc7572 = بيانات المجموعة الوصفية (contractURI)، auto = التعرّف من الحقول (الافتراضي).
token_idلافقط ERC-1155: معرّف الرمز بالنظام العشري (314592) أو الست عشري مع 0x ‏(0x4cce0)، لاستبدال {id} وعرض أسماء الملفات المتوقّعة.

أسئلة يُفترض أن يستدعي المساعد الأداة عندها

  • «هل بيانات NFT الوصفية هذه صحيحة، وهل يعرض OpenSea الخصائص بشكل صحيح؟»
  • «يعيد tokenURI الخاص بي قيمة data:-URI تحتوي على JSON بترميز Base64. هل هذا صالح؟»
  • «ما اسم الملف المطلوب لرمز ERC-1155 ذي المعرّف 314592 إذا كان URI يحتوي على {id}.json؟»
  • «هل ipfs://Qm… أم عنوان بوابة Pinata هو الخيار الأفضل للصورة؟»

كيف يتم الربط، وما الذي يمكن أن يقدمه MCP في شركتكم: تجدون ذلك في صفحة تكاملات MCP.

أسئلة شائعة عن بيانات NFT الوصفية

لماذا لا يعرض OpenSea صورة NFT الخاص بي؟

غالباً يكون السبب في العنوان داخل image.‎ من الأسباب الشائعة: الحقل مفقود أو اسمه image_url، أو العنوان نسبي (مجرد «1.png») أو غير مشفّر (http)، أو يشير إلى بوابة أُغلقت مثل cloudflare-ipfs.com (منذ 14.08.2024)، أو يحتوي data:-URI غير مرمّز على # يقطع المتصفح النص عنده. وإذا تغيّرت الصورة فقط، فغالباً لم يُرسل الحدث MetadataUpdate وفق ERC-4906؛ وعندها يواصل السوق عرض النسخة القديمة من ذاكرته المؤقتة.

ipfs:// أم عنوان بوابة: أيهما يوضع في البيانات الوصفية؟

يُكتب ipfs://<CID>، مثل ipfs://bafy…/1.png.‎ عنوان بوابة مثل https://gateway.pinata.cloud/ipfs/… يربط الملف بمشغّل واحد؛ فإذا تعطّل، تتوقف الصورة عن التحميل رغم بقاء البيانات في شبكة IPFS.‎ في مسودة ERC-8495، لم يُحمّل 113 من أصل 204 عناوين رموز تستخدم بوابات وشملها الفحص. جهة العرض تنشئ روابط البوابات بنفسها؛ ويقترح الفاحص صيغة ipfs:// لكل عنوان بوابة.

كيف أكتب الأرقام والتواريخ بشكل صحيح في attributes؟

تُكتب الأرقام دون علامتي اقتباس: "value": 5، وليس "value": "5". داخل علامتي الاقتباس يُعدّ الرقم نصاً، فلا ترتّب عوامل التصفية النتائج بحسبه. عندما يكون display_type هو number أو boost_number أو boost_percentage أو date، يجب أن تكون value رقماً. يُكتب التاريخ بتوقيت Unix بالثواني؛ والقيمة ابتداءً من 1,000,000,000,000 تبدو كأنها بالميلي ثانية. الحقل max_value اختياري، ويجب أن تكون قيمته مساوية لقيمة value على الأقل.

إلى ماذا يتحوّل {id} في ERC-1155؟

إذا ورد {id} في uri أو في إحدى قيم البيانات الوصفية، يستبدله البرنامج العميل بمعرّف الرمز: بالنظام الست عشري، وبأحرف صغيرة، ودون 0x، مع إضافة أصفار حتى يبلغ 64 محرفاً. يتحوّل الرمز 314592 إلى 000000000000000000000000000000000000000000000000000000000004cce0. لذلك يجب أن يكون اسم الملف 000000000000000000000000000000000000000000000000000000000004cce0.json؛ فالبرنامج العميل الملتزم بالمعيار لن يجد «314592.json».

ما الذي يوضع في contractURI للمجموعة؟

وفق ERC-7572، ملف JSON يكون فيه name الحقل الإلزامي الوحيد، إلى جانب symbol وdescription وimage وbanner_image وfeatured_image وexternal_link وcollaborators.‎ انتبهوا إلى الموقع: اسم الحقل في المجموعة هو external_link، وفي الرمز الفردي external_url.‎ يحتوي collaborators على عناوين Ethereum المسموح لها بتعديل صفحة المجموعة في الأسواق. لا يزال ERC-7572 مسودة، لكن OpenSea يقرأه.

Base64 أم ;utf8: ما الصيغة الصحيحة لـ data:-URI؟

تُقرأ الصيغتان، لكن يُنصح باستخدام Base64. في data:-URI غير مرمّز، تقطع المتصفحات كل ما يبدأ من #، واسم مثل «Pass #42» يُفسد JSON.‎ كذلك فإن ;utf8 ليس معاملاً صالحاً أصلاً وفق RFC 2397؛ والصحيح هو ;charset=utf-8. ينشئ الفاحص نسخة Base64 قابلة للنسخ من كل JSON صالح.

هل يجب كتابة background_color مع #؟

لا، يُكتب دونه. المطلوب 6 خانات ست عشرية بالضبط، مثل "E0F2FE". عند وجود # تزيله بعض البرامج العميلة تلقائياً، بينما تتجاهل أخرى اللون بالكامل. لا تُقرأ الصيغ المختصرة مثل "fff" أو أسماء الألوان أو rgb().

أين تنتهي حدود فاحص بيانات NFT الوصفية؟

يفحص النص الذي تلصقونه وفق ERC-721 وERC-1155 وERC-7572 والقواعد الموثّقة للأسواق. لا يجلب أي عنوان، ولذلك لا يعرف ما إذا كانت الصورة تحت ipfs:// لا تزال مثبّتة أو ما إذا كان السيرفر يستجيب. ولا يقيّم قيمة المحتوى أو أصالته أو الحقوق المتعلقة به. يسعدنا أن نوضّح معكم كيفية توافق العقد والبيانات الوصفية والتخزين، ومن يتولّى التثبيت الدائم.

على ماذا تستند الأداة

القيم التقريبية والملاحظات أعلاه تستند إلى هذه الأبحاث العلمية الـ 15. وقد تحققنا من كل بحث عبر رقم DOI الخاص به أو عبر صفحة الناشر (آخر مرة في 14 تشرين الثاني/نوفمبر 2026): البحث موجود، ولم يُسحب، وما توصل إليه ما زال صالحاً للإجابة عن السؤال اليوم.

  1. Das, D.; Bose, P.; Ruaro, N.‎ وآخرون (2022): Understanding Security Issues in the NFT Ecosystem. Proceedings of the 2022 ACM SIGSAC Conference on Computer and Communications Security (CCS ’22)، ص. 667–681

    النتيجة دراسة شملت 8 أسواق NFT كبيرة وملايين الرموز المتداولة: لم تكن 80.69 بالمئة من عناوين البيانات الوصفية على IPFS، وتغيّر العنوان لدى 2.89 بالمئة خلال 3 أشهر، واختفى المحتوى خارج IPFS بمعدل أعلى. واستخدمت النسخ المزوّرة غالباً عناوين الصور نفسها التي يستخدمها الأصل.

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

  2. Balduf, L.; Florian, M.; Scheuermann, B.‎ (2022): Dude, where's my NFT: distributed infrastructures for digital art. Proceedings of the 3rd International Workshop on Distributed Infrastructure for the Common Good (DICG ’22)، ص. 1–6

    النتيجة من أصل 51 عقداً لرموز NFT الفنية مرتفعة السعر، غيّر 19 عنوان البيانات الوصفية مرة واحدة على الأقل. أدرج كثير منها عنوان بوابة ثابتاً بدلاً من ipfs://، وأصبح نصف محتوى IPFS متاحاً لدى أقل من 10 مزوّدين خلال أسبوع. يوصي المؤلفون بالتخزين داخل العقد (data:) أو باستخدام عنوان قائم على بصمة تجزئة المحتوى.

    في الأداة تُظهر الأداة تحذيراً لعناوين البوابات مع بديل ipfs://؛ وتُعدّ data:-URI الخيار الأفضل؛ وعند وجود معرّفات CID للمجلدات، تنبّه إلى ضرورة بقاء المجلد والملف متاحين.

  3. Stöger, F.; Zhou, A.; Duan, H.; Perrig, A.‎ (2023): Demystifying Web3 Centralization: The Case of Off-Chain NFT Hijacking. Financial Cryptography and Data Security (FC 2023), Lecture Notes in Computer Science، ص. 182–199

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

    في الأداة يوضّح هذا سبب طلب الأداة ipfs:// بدلاً من عنوان بوابة: وحده CID يمكن التحقق من مطابقته للمحتوى، أياً كان مسار وصوله.

  4. Guidi, B.; Michienzi, A.; Pasquale, L.‎ (2025): On the impact of marketplaces on the availability of NFT assets on the IPFS network. 2025 IEEE Symposium on Computers and Communications (ISCC)، ص. 1–6

    النتيجة متابعة لمدة أسبوعَين لملفات NFT من 10 مجموعات في شبكة IPFS: لا يضمن IPFS توفّراً عالياً، وغالباً تعرض الأسواق نسخاً خاصة بها بدلاً من الملف المشار إليه في العقد.

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

  5. Shi, R.; Cheng, R.; Han, B.‎ وآخرون (2024): A Closer Look into IPFS: Accessibility, Content, and Performance. Proceedings of the ACM on Measurement and Analysis of Computing Systems 8 (2)، ص. 1–31

    النتيجة قياس شمل أكثر من 4 ملايين ملف في IPFS: نحو نصفها مرتبط بـ NFT، ولا يمكن جلب كثير منها إلا بعد محاولات متعددة. يقدّم أكبر 50 مزوّداً، وهم غالباً عقد سحابية، 95 بالمئة من الملفات.

    في الأداة يدعم ملاحظة التثبيت: توفّر ipfs:// يعتمد على توفّر العقد التي تحتفظ بالبيانات وتتيحها.

  6. Balduf, L.; Korczyński, M.; Ascigil, O.‎ وآخرون (2023): The Cloud Strikes Back: Investigating the Decentralization of IPFS. Proceedings of the 2023 ACM Internet Measurement Conference (IMC ’23)، ص. 391–405

    النتيجة قياس واسع لبنية شبكة IPFS وحركة البيانات ومزوّدي الخدمات فيها: مركزية واضحة ونسبة مرتفعة من العُقد في السحابة.

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

  7. Trautwein, D.; Raman, A.; Tyson, G.‎ وآخرون. (2022): Design and evaluation of IPFS: a storage layer for the decentralized web. وقائع مؤتمر ACM SIGCOMM 2022، ص. 739–752

    النتيجة يصف بنية IPFS وقياسها: تخزين تُحدَّد عناوينه بحسب المحتوى عبر شبكة نظير إلى نظير، بعُقد في أكثر من 2700 شبكة و152 دولة؛ والنشر والاسترجاع سريعان بما يكفي للعديد من التطبيقات.

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

  8. Daniel, E.; Tschorsch, F.‎ (2022): IPFS and Friends: A Qualitative Comparison of Next Generation Peer-to-Peer Data Networks. IEEE Communications Surveys & Tutorials 24 (1)، ص. 31–52

    النتيجة يقارن بين IPFS وSwarm وHypercore وSAFE وStorj وArweave.‎ يحتفظ IPFS بالبيانات فقط ما دامت العُقد تحتفظ بها طوعاً أو مقابل أجر (مثلاً عبر Filecoin)؛ أما Arweave فيهدف إلى تخزين البيانات بشكل دائم ويفرض رسوماً على رفعها.

    في الأداة يشرح الفرق بين ipfs:// وar:// في الملاحظات المتعلقة بمواقع التخزين.

  9. Mell, P.; Yaga, D.‎ (2024): Non-fungible token security. المعهد الوطني للمعايير والتكنولوجيا، NIST IR 8472

    النتيجة يشرح تقنية NFT ويذكر 27 نقطة ضعف محتملة. قد يؤدي تخزين البيانات الوصفية بشكل خاطئ إلى فصل NFT عن الشيء الذي يمثّله وجعله بلا قيمة؛ ومن يتحكم في جدول ربط خارجي يستطيع إعادة ربط الرموز بأشياء أخرى.

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

  10. Mekacher, A.; Bracci, A.; Nadini, M.‎ وآخرون. (2022): Heterogeneous rarity patterns drive price dynamics in NFT collections. Scientific Reports 12، المقالة 13890

    النتيجة 3.7 مليون معاملة في 410 مجموعات: ترتبط الندرة، المحسوبة من السمات المقروءة لرمز NFT، ارتباطاً واضحاً بالسعر وتكرار التداول والعائد.

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

  11. Nadini, M.; Alessandretti, L.; Di Giacinto, F.‎ وآخرون (2021): Mapping the NFT revolution: market trends, trade networks, and visual features. Scientific Reports 11، المقالة 20902

    النتيجة تحليل 6.1 مليون عملية بيع لـ 4.7 مليون رمز NFT (من 2017 إلى 2021): تتميّز المجموعات بتجانس بصري، وتُعدّ خصائص الصور، إلى جانب سجل المبيعات، أفضل مؤشرات توقّع السعر.

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

  12. White, B.; Mahanti, A.; Passi, K.‎ (2022): Characterizing the OpenSea NFT Marketplace. الوقائع المصاحبة لمؤتمر الويب 2022 (WWW ’22)، ص. 488–496

    النتيجة 5.25 مليون عملية بيع على OpenSea من 2019 إلى 2021، وهو السوق الذي يضم أكبر عدد من المستخدمين وأعلى حجم مبيعات؛ يقود النمو عدد قليل من المستخدمين شديدي النشاط.

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

  13. Klein, M.; Van de Sompel, H.; Sanderson, R.‎ وآخرون. (2014): Scholarly Context Not Found: One in Five Articles Suffers from Reference Rot. PLoS ONE 9 (12), e115253

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

    في الأداة يدعم الملاحظة الخاصة بعناوين https: تختفي عناوين الويب أو يتغيّر محتواها مع مرور الوقت، حتى من دون سوء نية.

  14. Heiderich, M.; Frosch, T.; Jensen, M.; Holz, T.‎ (2011): Crouching tiger - hidden payload: security risks of scalable vectors graphics. Proceedings of the 18th ACM Conference on Computer and Communications Security (CCS ’11)، ص. 239–250

    النتيجة ملفات SVG ليست مجرد صور، بل يمكن أن تحتوي على HTML وJavaScript وأجزاء أخرى قابلة للتنفيذ؛ وكثيراً ما تعاملت المتصفحات بشكل خاطئ مع ملفات SVG أُعدّت خصيصاً للاستغلال.

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

  15. Guidi, B.; Michienzi, A.‎ (2023): From NFT 1.0 to NFT 2.0: A Review of the Evolution of Non-Fungible Tokens. Future Internet 15 (6)، المقالة 189

    النتيجة نظرة عامة على الانتقال من رموز NFT الثابتة، التي تستقر بياناتها الوصفية بعد السكّ، إلى رموز NFT ديناميكية تتغيّر؛ وتكمن الصعوبات التقنية أساساً في البيانات الوصفية وتغييرها.

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

معايير وجهات رسمية وبيانات الشركات المصنِّعة

الاثنين–الجمعة، 8:00–17:00

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

+49 3744 4399760[email protected]

الاثنين–الجمعة، 8:00–17:00 · Straße der Jugend 5, 08228 Rodewisch

ناقشوا معنا مشروع NFT
+49 3744 4399760الاثنين–الجمعة، 8:00–17:00
اتصلوا بنانتصل بكم

قائمة المكوّنات · صفحة 1/1

ممَّ تتكوّن هذه الصفحة

القيم مقيسة عند بناء الصفحة، ومع تفعيل JavaScript يعيد متصفحكم القياس مباشرة.

رقمالمكوّنالنوعالحجم
01index.htmlمستند≈ 29 كيلوبايت
02styles.cssورقة أنماط≈ 20 كيلوبايت
03scripts.jsسكربت≈ 13 كيلوبايت
04archivo-variable.woff2خط≈ 58 كيلوبايت
05ibm-plex-mono.woff2خط≈ 30 كيلوبايت
06favicon.svgرسمأقل من 1 كيلوبايت

ملفات ارتباط (Cookies) للإعلانات أو التحليل: لا يوجد. من دون موافقتكم لا تحمّل الصفحة شيئاً من سيرفرات خارجية، ما عدا خدمة التوزيع Cloudflare التي نستخدمها. الخطوط والسكربتات والرسوم محفوظة عندنا. وبالطريقة نفسها نبني أنظمتكم.

خارج أوقات الدوام

اتصلوا مع ذلك ولا تترددوا

دوامنا المعتاد في المكتب من الاثنين إلى الجمعة، من 8:00 إلى 17:00.

في المساء وفي عطلة نهاية الأسبوع يُحوَّل الاتصال إلينا أيضاً، وكثيراً ما يرد أحدنا. لكننا لا نستطيع أن نعدكم بذلك.

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

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

اتصلوا الآن+49 3744 4399760

تفضّلون الكتابة؟ راسلونا عبر نموذج التواصل أو على [email protected]. نقرأ الرسالة في يوم العمل التالي.

تشخيص · AT-K2

بماذا نساعدكم؟

↵ اختيارESC إغلاقللاتصال: ‎+49 3744 4399760

إعدادات مخصّصة

أي الخدمات تسمحون بتحميلها؟

ضرورية تقنياً

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