الأداة AT-W40REV. 2026-A
فحص بيانات NFT الوصفية: هل يعرض السوق NFT الخاص بكم بشكل صحيح؟
تقرأ الأسواق والمحافظ اسم NFT وصورته وخصائصه من ملف JSON يشير إليه العقد عبر tokenURI. يكفي وجود # قبل اللون، أو رقم بين علامتي اقتباس، أو عنوان بوابة بدلاً من ipfs:// لتختفي حقول أو تتوقف الصورة عن الظهور لاحقاً. يقرأ الفاحص JSON أو data:-URI الخاص بكم، ويفحصه وفق ERC-721 وERC-1155 وERC-7572 وقواعد الأسواق، ثم يعرض معاينة.
- مجاني
- دون محفظة رقمية
- يفحص في المتصفح، ولا يجلب أي شيء
01 / الفاحص
ألصقوا البيانات الوصفية واطّلعوا على النتائج والمعاينة
فاحص · بيانات NFT الوصفية وفق ERC-721 وERC-1155 وERC-7572
تفحص الأداة ما تلصقونه وفق ERC-721 وERC-1155 وERC-7572 والقواعد الموثّقة للأسواق. وتعمل دون جلب أي بيانات، لذا لا تتحقق مما إذا كانت الصور والملفات المشار إليها في العناوين متاحة فعلاً.
النتيجة
معاينة تقريبية كما تظهر في السوق
نتائج الفحص
العناوين وأماكن التخزين
| الحقل | التصنيف | العنوان |
|---|
لا يُجلب أي شيء. لعرض الملف بأنفسكم، افتحوا عنوان البوابة المذكور في المتصفح.
النسخة المصحّحة
عرض JSON
القواعد وفق ERC-721 وERC-1155 وERC-7572 وتوثيق OpenSea ومسودة ERC-8495، بتاريخ 14 تشرين الثاني/نوفمبر 2026. يظهر المصدر بجانب كل نتيجة. نبني معكم مجموعة تظهر بشكل صحيح في كل مكان؛ راسلونا عبر نموذج التواصل.
يجري الفحص في متصفحكم. لا يُرسل أي شيء ولا يُخزّن ولا يُجلب.
02 / الخطوات
كيف يحصل السوق على الاسم والصورة
نادراً ما يحتوي العقد على الصورة نفسها. يعيد عقد 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.
حقول البيانات الوصفية للرمز
| الحقل | المنشأ | ماذا يجب أن يتضمن |
|---|---|---|
| name | ERC-721, ERC-1155 | اسم الرمز، كنص عادي. عند غيابه، تعرض الأسواق غالباً «#123» فقط. |
| description | ERC-721, ERC-1155 | الوصف. يقرأ OpenSea تنسيق Markdown، ولا يعرض HTML الخام. |
| image | ERC-721, ERC-1155 | صورة للقوائم والمعاينة. يوصي ERC-721 بعرض من 320 إلى 1080 px، بينما يوصي OpenSea بأبعاد لا تقل عن 3000 × 3000 px. |
| animation_url | OpenSea، مسودة ERC-8495 | فيديو أو صوت أو نموذج ثلاثي الأبعاد أو صفحة HTML، يُعرض بدلاً من الصورة. تبقى الصورة إلزامية كبديل احتياطي. |
| external_url | OpenSea، مسودة ERC-8495 | رابط من السوق إلى صفحتكم الخاصة، ويفضّل أن يكون https. |
| background_color | OpenSea، مسودة ERC-8495 | لون الخلفية وراء الصورة: 6 خانات ست عشرية دون #، مثل E0F2FE. |
| attributes | OpenSea، مسودة ERC-8495 | خصائص على شكل قائمة تضم trait_type وvalue، واختيارياً display_type وmax_value. تُنشأ منها عوامل تصفية المجموعة. |
| decimals | ERC-1155 | عدد المنازل العشرية لعرض الكمية، ويكون عدداً صحيحاً ابتداءً من 0. |
| properties | ERC-1155 | معلومات إضافية من أي نوع على شكل كائن. لا تعرض الأسواق كعوامل تصفية إلا الخصائص الواردة في attributes. |
| localization | ERC-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، يقرأ الفاحص تنسيقها وحجمها مباشرة من البايتات.
03 / الخصائص
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» عاملَي تصفية مختلفين في السوق. يُبلغ الفاحص عن هذه الحالات.
04 / أماكن التخزين
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.
| CIDv0 | QmbWqxBEKC3P8tqsKc98xmWNzrzDtRLMiMPL8wBuTGsMnR |
|---|---|
| CIDv1 | bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi |
تنتج عن ذلك 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: عملي، لكن يمكن تغيير وجهته، ولذلك فهو قابل للتغيير.
05 / على البلوك تشين
البيانات الوصفية داخل العقد: استخدام 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 قابلة للنسخ، بعد إجراء التصحيحات الآمنة، مثل إزالة # قبل اللون، وتصحيح الأرقام بين علامتي اقتباس أو عناوين البوابات.
06 / ERC-1155
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} الذي يستبدله البرنامج العميل برمز اللغة.
| معرّف الرمز | القيمة البديلة، 64 محرفاً |
|---|---|
| 1 | 0000000000000000000000000000000000000000000000000000000000000001 |
| 42 | 000000000000000000000000000000000000000000000000000000000000002a |
| 255 | 00000000000000000000000000000000000000000000000000000000000000ff |
| 314592 | 000000000000000000000000000000000000000000000000000000000004cce0 |
07 / المجموعة
contractURI: البيانات الوصفية للمجموعة كاملة
يأتي اسم صفحة المجموعة وصورتها العلوية ووصفها من ملف منفصل تشير إليه الدالة contractURI. يصفه ERC-7572؛ ولا يزال المعيار مسودة، لكن OpenSea يقرأه. الحقل الإلزامي الوحيد هو name. وعند تغيّر الملف، يرسل العقد ContractURIUpdated().
| الحقل | ماذا يجب أن يتضمن |
|---|---|
| name | اسم المجموعة. الحقل الإلزامي الوحيد. |
| symbol | الاختصار الدال على المجموعة. |
| description | وصف المجموعة. |
| image | صورة الملف التعريفي للمجموعة. |
| banner_image | صورة الشريط العلوي في صفحة المجموعة. |
| featured_image | صورة للأقسام البارزة. |
| external_link | موقعكم. انتبهوا: اسم الحقل هنا external_link، وفي الرمز external_url. |
| collaborators | عناوين Ethereum المسموح لها بتعديل صفحة المجموعة في الأسواق. |
يفحص الفاحص تنسيق العناوين في collaborators ومجموع التحقق وفق EIP-55. ويشير الاستخدام الخاطئ للأحرف الكبيرة والصغيرة دائماً تقريباً إلى خطأ مطبعي. يمكنكم مقارنة العناوين الفردية محرفاً بمحرف باستخدام فاحص عناوين Ethereum.
08 / الأبحاث
ماذا تقول الأبحاث عن بيانات 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 غير الصالح خطأً، وليس أمراً بسيطاً.
09 / طريقة العمل
كيف تطلقون مجموعة بشكل سليم
- حدّدوا مكان التخزين. البيانات الوصفية الصغيرة وSVG داخل العقد بصيغة data:-URI، والصور والفيديوهات الأكبر على IPFS أو Arweave. استخدموا https فقط للمحتوى المراد تغييره.
- افحصوا ملفاً لكل رمز. ألصقوا الاسم والصورة والخصائص هنا، وصحّحوها حتى تختفي الأخطاء والتحذيرات. مع ERC-1155، أدخلوا معرّف الرمز وقارنوا أسماء الملفات.
- وفّروا التثبيت بشكل مزدوج. لدى مزوّدَين مستقلَّين أو على عقدة خاصة بكم، مع تثبيت المجلد كله.
- اكتبوا ملف المجموعة. contractURI مع name والصورة والصورة العلوية وexternal_link، وافحصوه هنا.
- تحقّقوا من العرض على شبكة الاختبار. اسكّوا رمزاً واعرضوه على شبكة الاختبار الخاصة بأحد الأسواق وفي محفظتَين قبل الانتقال إلى الشبكة الرئيسية.
- أبلغوا عن التغييرات. أرسلوا MetadataUpdate (ERC-4906) أو URI (ERC-1155) أو ContractURIUpdated() عند حدوث تغيير.
أين تنتهي حدود الفاحص
- لا يجلب أي شيء. لا يعرف ما إذا كانت صورة تحت ipfs:// لا تزال مثبّتة أو ما إذا كان السيرفر يستجيب. ويذكر عنوان البوابة كنص لاستخدامه في الجلب.
- تختلف الأسواق فيما بينها. يجري الفحص وفق المعايير وتوثيق OpenSea ومسودة ERC-8495. تقرأ بعض المحافظ حقولاً أقل، وتستخدم بعض الأسواق حقولاً إضافية خاصة بها.
- لا يحكم على القيمة أو الأصالة. يمكن نسخ الاسم والصورة بحرية؛ وقد استخدمت النسخ المزوّرة غالباً عناوين الصور نفسها التي يستخدمها الأصل Das وآخرون 2022. يمكنكم تحديد NFT من عنوان العقد ومعرّف الرمز.
تجدون أدوات أخرى لمشاريع البلوك تشين في صفحة أدوات Web3. وتشرح صفحة تطوير Web3 كيف نبني المجموعات ورموز الوصول والتطبيقات المرتبطة بها.
10 / لمساعدي الذكاء الاصطناعي
استخدام هذه الأداة من داخل مساعد ذكاء اصطناعي
المساعدات مثل 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.
11 / الأسئلة الشائعة
أسئلة شائعة عن بيانات 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:// لا تزال مثبّتة أو ما إذا كان السيرفر يستجيب. ولا يقيّم قيمة المحتوى أو أصالته أو الحقوق المتعلقة به. يسعدنا أن نوضّح معكم كيفية توافق العقد والبيانات الوصفية والتخزين، ومن يتولّى التثبيت الدائم.
12 / دراسات ومصادر
على ماذا تستند الأداة
القيم التقريبية والملاحظات أعلاه تستند إلى هذه الأبحاث العلمية الـ 15. وقد تحققنا من كل بحث عبر رقم DOI الخاص به أو عبر صفحة الناشر (آخر مرة في 14 تشرين الثاني/نوفمبر 2026): البحث موجود، ولم يُسحب، وما توصل إليه ما زال صالحاً للإجابة عن السؤال اليوم.
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 يكون من العقد ومعرّف الرمز، وليس من الاسم والصورة.
doi.org/10.1145/3548606.3559342 · ورقة مؤتمر
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 للمجلدات، تنبّه إلى ضرورة بقاء المجلد والملف متاحين.
doi.org/10.1145/3565383.3566106 · ورقة مؤتمر
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 يمكن التحقق من مطابقته للمحتوى، أياً كان مسار وصوله.
doi.org/10.1007/978-3-031-47751-5_11 · ورقة مؤتمر
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 توفّراً عالياً، وغالباً تعرض الأسواق نسخاً خاصة بها بدلاً من الملف المشار إليه في العقد.
في الأداة لذلك تظهر الملاحظة في النتيجة: عرض السوق للصورة لا يثبت أن الملف لا يزال متاحاً في الشبكة.
doi.org/10.1109/iscc65549.2025.11326542 · ورقة مؤتمر
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:// يعتمد على توفّر العقد التي تحتفظ بالبيانات وتتيحها.
doi.org/10.1145/3656015 · مجلة علمية
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 لدى مزوّدَين مستقلَّين على الأقل بدلاً من مزوّد واحد.
doi.org/10.1145/3618257.3624797 · ورقة مؤتمر
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: العنوان هو بصمة تجزئة للمحتوى، لذلك تفحص الأداة بنيته بدقة.
doi.org/10.1145/3544216.3544232 · ورقة مؤتمر
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:// في الملاحظات المتعلقة بمواقع التخزين.
doi.org/10.1109/COMST.2022.3143147 · دراسة مراجعة
Mell, P.; Yaga, D. (2024): Non-fungible token security. المعهد الوطني للمعايير والتكنولوجيا، NIST IR 8472
النتيجة يشرح تقنية NFT ويذكر 27 نقطة ضعف محتملة. قد يؤدي تخزين البيانات الوصفية بشكل خاطئ إلى فصل NFT عن الشيء الذي يمثّله وجعله بلا قيمة؛ ومن يتحكم في جدول ربط خارجي يستطيع إعادة ربط الرموز بأشياء أخرى.
في الأداة يوضّح لماذا تُبلِغ الأداة عن عناوين الصور والبيانات الوصفية المفقودة أو غير الصالحة باعتبارها أخطاء، وتُبيّن مواقع التخزين القابلة للتغيير.
doi.org/10.6028/NIST.IR.8472 · تقرير بحثي
Mekacher, A.; Bracci, A.; Nadini, M. وآخرون. (2022): Heterogeneous rarity patterns drive price dynamics in NFT collections. Scientific Reports 12، المقالة 13890
النتيجة 3.7 مليون معاملة في 410 مجموعات: ترتبط الندرة، المحسوبة من السمات المقروءة لرمز NFT، ارتباطاً واضحاً بالسعر وتكرار التداول والعائد.
في الأداة السمات ليست أمراً ثانوياً. لذلك تُبلِغ الأداة عن الأرقام بين علامات اقتباس، والمسافات عند الأطراف، والكتابات المختلفة لنوع السمة نفسه، لأنها تشوّه نتائج التصفية وحساب الندرة.
doi.org/10.1038/s41598-022-17922-5 · مجلة علمية
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 أو تعذّر تحميله بتحذير، ولا تعتبره أمراً بسيطاً.
doi.org/10.1038/s41598-021-00053-8 · مجلة علمية
White, B.; Mahanti, A.; Passi, K. (2022): Characterizing the OpenSea NFT Marketplace. الوقائع المصاحبة لمؤتمر الويب 2022 (WWW ’22)، ص. 488–496
النتيجة 5.25 مليون عملية بيع على OpenSea من 2019 إلى 2021، وهو السوق الذي يضم أكبر عدد من المستخدمين وأعلى حجم مبيعات؛ يقود النمو عدد قليل من المستخدمين شديدي النشاط.
في الأداة لذلك تفحص الأداة، إلى جانب معايير ERC، الحقول الموثّقة لدى OpenSea: فهي القواعد التي تتبعها الأسواق الأخرى.
doi.org/10.1145/3487553.3524629 · ورقة مؤتمر
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: تختفي عناوين الويب أو يتغيّر محتواها مع مرور الوقت، حتى من دون سوء نية.
doi.org/10.1371/journal.pone.0115253 · مجلة علمية
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 على سكربتات أو سمات أحداث أو مراجع خارجية لن تعمل هناك.
doi.org/10.1145/2046707.2046735 · ورقة مؤتمر
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، كي تعتمد الأسواق التغيير.
doi.org/10.3390/fi15060189 · دراسة مراجعة
معايير وجهات رسمية وبيانات الشركات المصنِّعة
- ERC-721: معيار الرموز غير القابلة للاستبدال (نهائي) · نهائي، تم التحقق في 14.11.2026
- ERC-1155: معيار الرموز المتعددة، قسم البيانات الوصفية (نهائي) · نهائي، تم التحقق في 14.11.2026
- ERC-7572: البيانات الوصفية على مستوى العقد عبر contractURI() (مسودة) · مسودة، تم التحقق في 14.11.2026
- ERC-4906: امتداد تحديث البيانات الوصفية لـ EIP-721 (نهائي) · نهائي، تم التحقق في 14.11.2026
- ERC-8495: مخطط JSON للبيانات الوصفية للرموز (مسودة، طلب دمج 2163) · مسودة، فُتحت في 10.11.2026، النسخة بتاريخ 12.11.2026، لم تُعتمد بعد؛ تُستخدم قواعدها للتحذير فقط
- وثائق OpenSea للمطوّرين: الوسائط والسمات، تخزين البيانات الوصفية، البيانات الوصفية على مستوى العقد · بتاريخ 12.11.2026
- RFC 2397: مخطط عناوين URL من نوع "data" · 1998
- RFC 8259: تنسيق تبادل البيانات بترميز كائنات JavaScript (JSON) · 2017
- multiformats/cid: معرّف المحتوى، مع جدولَي Multibase وMulticodec · تم التحقق في 14.11.2026
- وثائق IPFS: أفضل الممارسات لتخزين بيانات NFT باستخدام IPFS · تم التحقق في 14.11.2026
- واجهة Arweave HTTP API: الحقل id (Base64URL، بصمة SHA-256 للتوقيع) · تم التحقق في 14.11.2026
- مدوّنة Cloudflare: بوابات IPFS العامة التابعة لـ Cloudflare ودعم Interplanetary Shipyard · 14.05.2024
- EIP-55: ترميز العناوين بمجموع تحقق باستخدام الأحرف الكبيرة والصغيرة · نهائي
13 / أدوات أخرى
بقي عندكم سؤال؟
- AT-W32 · للشركات
فحص ملاءمة البلوك تشين
هل يحتاج مشروعكم فعلاً إلى بلوك تشين، أم تكفي قاعدة بيانات؟ - AT-W33 · للشركات
فحص MiCA
هل يخضع الـ Token الخاص بكم لقانون MiCA، وما الالتزامات المترتبة على ذلك؟ - AT-W34 · للأفراد والشركات
حاسبة رسوم Gas
كم تكلف المعاملة على Ethereum أو Arbitrum أو Optimism أو Base أو Polygon؟ - AT-W35 · للأفراد والشركات
فاحص عناوين Ethereum
هل عنوان Ethereum هذا صالح ومكتوب بشكل صحيح؟ فحص المجموع الاختباري وفق EIP-55 ومقارنة عنوانين. - AT-W36 · للشركات
حاسبة Selector و Topic
أي Selector للدالة أو Topic للحدث يقابل توقيع Solidity هذا، والعكس؟ - AT-W37 · للشركات
مفكِّك Calldata
ماذا تفعل هذه المعاملة؟ حوّلوا Calldata إلى نص مقروء قبل أن توقّعوا.
هل تُطلقون مجموعة أو رموز وصول؟ أرسلوا إلينا النتيجة المنسوخة. ننسّق العقد والبيانات الوصفية وموقع التخزين بحيث تعرض الأسواق والمحافظ كل شيء بشكل صحيح، ونُعدّ تثبيت البيانات، من مقرّنا في روديفيش (Rodewisch).
+49 3744 4399760[email protected]الاثنين–الجمعة، 8:00–17:00 · Straße der Jugend 5, 08228 Rodewisch