ابزار AT-W40REV. 2026-A
بررسی متادیتای NFT: آیا مارکیتپلیس NFT شما را درست نشان میدهد؟
مارکیتپلیسها و والتها نام، تصویر و ویژگیهای یک NFT را از یک فایل JSON میخوانند که قرارداد با tokenURI به آن اشاره میکند. یک # پیش از رنگ، یک عدد در علامۀ نقل قول یا یک آدرس Gateway به جای ipfs:// کافی است تا فیلدها گم شوند یا تصویر روزی ناپدید شود. بررسیکننده JSON یا data:-URI شما را میخواند، آن را طبق ERC-721، ERC-1155، ERC-7572 و قواعد مارکیتپلیسها بررسی میکند و یک پیشنمایش نشان میدهد.
- رایگان
- بدون والت
- در براوزر بررسی میکند، چیزی را از انترنت نمیگیرد
01 / ابزار بررسی
متادیتا را وارد کنید، یافتهها و پیشنمایش را ببینید
بررسیکننده · متادیتای NFT طبق ERC-721، ERC-1155 و ERC-7572
این ابزار آنچه را وارد میکنید طبق ERC-721، ERC-1155، ERC-7572 و قواعد مستند مارکیتپلیسها بررسی میکند. چیزی را از انترنت نمیگیرد: این که تصاویر و فایلهای پشت آدرسها واقعاً در دسترس هستند یا نه، را بررسی نمیکند.
نتیجه
پیشنمایش، تقریباً مانند یک مارکیتپلیس
یافتهها
آدرسها و محلهای ذخیره
| فیلد | ارزیابی | آدرس |
|---|
چیزی از انترنت گرفته نمیشود. اگر میخواهید فایل را خودتان ببینید، آدرس Gateway دادهشده را در براوزر باز کنید.
نسخۀ اصلاحشده
دیدن JSON
قواعد طبق ERC-721، ERC-1155، ERC-7572، مستندات OpenSea و پیشنویس ERC-8495، به تاریخ 14 نومبر 2026. منبع کنار هر یافته نوشته شده است. کلکسیونی را که در همه جا درست نشان داده شود همراه شما میسازیم؛ از طریق فورم تماس به ما بنویسید.
در براوزر شما بررسی میکند. هیچ چیزی فرستاده، ذخیره یا از انترنت گرفته نمیشود.
02 / روش کار
مارکیتپلیس چطور به نام و تصویر میرسد
در قرارداد تقریباً هیچ وقت خود تصویر نیست. یک قرارداد ERC-721 برای هر توکن از طریق تابع tokenURI یک آدرس میدهد، یک قرارداد ERC-1155 از طریق uri. پشت این آدرس یک سند کوچک JSON با نام، توضیحات و آدرس تصویر است. پس مارکیتپلیس دو فایل را پشت سر هم میگیرد، و هر کدام ممکن است نباشد، غلط نوشته شده باشد یا جابهجا شده باشد.
ERC-721 برای این کار فقط سه فیلد تعیین میکند: 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 | ویدیو، صدا، مدل 3D یا صفحۀ HTML که به جای تصویر نشان داده میشود. تصویر به عنوان جایگزین همچنان حتمی است. |
| external_url | OpenSea، پیشنویس ERC-8495 | لینک از مارکیتپلیس به صفحۀ خود شما، بهتر است https باشد. |
| background_color | OpenSea، پیشنویس ERC-8495 | رنگ پسزمینه پشت تصویر: شش رقم Hex بدون #، مثلاً E0F2FE. |
| attributes | OpenSea، پیشنویس ERC-8495 | ویژگیها به شکل لستی از trait_type، value و به طور اختیاری display_type و max_value. فلترهای کلکسیون از همین ساخته میشوند. |
| decimals | ERC-1155 | تعداد ارقام اعشاری برای نمایش مقدار، عدد صحیح از 0 به بالا. |
| properties | ERC-1155 | معلومات اضافی دلخواه به شکل یک Object. مارکیتپلیسها فقط ویژگیهای 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: ویژگیها را طوری بنویسید که فلترها درست باشند
فلترهای یک کلکسیون، و در بسیاری صفحات کمیابی یک NFT، از attributes ساخته میشوند. این نتیجه دارد: در 410 کلکسیون با 3,7 میلیون معامله، کمیابیِ حسابشده از ویژگیها به طور واضح با قیمت و معامله ارتباط داشت Mekacher و همکاران 2022. یک فاصلۀ اضافی در «رنگ » از یک نوع ویژگی دو نوع میسازد، و دیگر شمارش درست نیست.
| نوشته در attributes | نمایش | نوع |
|---|---|---|
| {"trait_type":"رنگ","value":"طلایی"} | رنگ: طلایی | متن |
| {"trait_type":"درجه","value":3,"max_value":5} | درجه: 3 از 5 | عدد |
| {"display_type":"number","trait_type":"امتیاز","value":12} | امتیاز: 12 | عدد |
| {"display_type":"boost_number","trait_type":"استقامت","value":40} | استقامت: +40 | بونس |
| {"display_type":"boost_percentage","trait_type":"تخفیف","value":10} | تخفیف: +10 % | بونس به % |
| {"display_type":"date","trait_type":"معتبر تا","value":1798761600} | معتبر تا: 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 «لوازم» هر کدام با یک value. مقداری که به شکل لست باشد نادیده گرفته میشود.
- نوشتن دقیقاً یکسان. «Farbe» و «farbe» برای مارکیتپلیس دو فلتر هستند. بررسیکننده چنین جفتهایی را گزارش میدهد.
04 / محلهای ذخیره
data:، ipfs://، ar:// یا https: تصویر و JSON کجا باشند
یک NFT به همان اندازه پایدار است که فایلی که به آن اشاره میکند. در تحقیقی روی هشت مارکیتپلیس بزرگ، 80,69 فیصد آدرسهای متادیتا روی IPFS نبودند؛ در 2,89 فیصد توکنها آدرس در ظرف سه ماه تغییر کرد، و محتوای بیرون از IPFS بیشتر ناپدید شد Das و همکاران 2022. در هنر گرانقیمت هم وضع چندان بهتر نبود: 19 از 51 قرارداد آدرس متادیتا را دستکم یک بار تغییر داده بودند Balduf و همکاران 2022.
| شکل نوشتن | ارزیابی | چرا |
|---|---|---|
data:application/json;base64,… | خوب | در خود قرارداد است و فقط همراه آن تغییر میکند. برای متادیتای کوچک و تصاویر SVG پیشنهاد میشود. |
ipfs://<CID>/… | خوب | آدرس محتوا: CID یک Hash از محتوا است. تا وقتی در دسترس است که دستکم یک نود معلومات را نگه دارد (Pinning). |
ar://<Transaktions-ID> | خوب | Arweave، ذخیرهسازی که برای مدت طولانی پرداخته شده است. ID آن 43 کرکتر Base64URL دارد. |
ar://<Name> | با احتیاط | نام ArNS: یک اشارهگر که قابل تغییر است، پس ثابت نیست. |
https://… | با احتیاط | سرور خودی یا Cloud. محتوا ممکن است تغییر کند یا ناپدید شود، همین که کسی دیگر پول ندهد. |
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 | غلط | بدون scheme هیچ کلاینتی نمیداند فایل کجاست. |
https: حالت عادی که دایمی نیست
آدرس ویب راحت است، اما فقط تا وقتی زنده است که سرور و قرارداد با هاستر باشد. این مشکل خاص NFT نیست: از بیش از یک میلیون لینک ویب در مقالههای علمی، در هر پنجمین مقاله دستکم یک لینک به جایی نمیرسید یا به محتوای تغییریافته میرسید Klein و همکاران 2014. برای چیزهایی که عمداً باید تغییر کنند، مثلاً یک توکن دسترسی با مدت اعتبار، https با این هم درست است؛ چنین NFTهای پویا (dynamic) اکنون یک رشتۀ تحقیقی جداگانه هستند Guidi و Michienzi 2023. در آن صورت قرارداد با هر تغییر رویداد MetadataUpdate طبق ERC-4906 را میفرستد، وگرنه مارکیتپلیس تا مدت زیادی وضعیت کهنه را نشان میدهد.
ipfs://: آدرس محتوا، اما فقط با Pinning
در IPFS آدرس یک Hash از محتوا است، یعنی CID Trautwein و همکاران 2022. اگر یک پیکسل تغییر کند، CID هم تغییر میکند؛ پس هیچ کس نمیتواند محتوای پشت یک آدرس ipfs:// را پنهانی عوض کند. یک CIDv0 با Qm شروع میشود و 46 کرکتر دارد، یک CIDv1 اغلب با bafy. بررسیکننده هر دو را رمزگشایی میکند و نسخه، Codec و طول Hash را بررسی میکند، زیرا یک CID بریدهشده در نگاه اول عادی به نظر میرسد.
اما IPFS به خودی خود چیزی را ذخیره نمیکند. یک فایل تا وقتی در دسترس میماند که دستکم یک نود آن را نگه دارد Daniel و Tschorsch 2022. در اندازهگیریای روی بیش از چهار میلیون فایل IPFS، که حدود نیمی از آنها مربوط به NFT بود، بسیاری فقط پس از چند بار کوشش دریافت شدند، و 50 ارائهکننده 95 فیصد فایلها را میدادند Shi و همکاران 2024. در کل هم این شبکه بیشتر از آنچه شهرتش نشان میدهد متمرکز و وابسته به Cloud است Balduf و همکاران 2023. و این که یک مارکیتپلیس تصویر را نشان میدهد، چیز زیادی را ثابت نمیکند: اغلب کاپی خودش را نشان میدهد Guidi و همکاران 2025.
| CIDv0 | QmbWqxBEKC3P8tqsKc98xmWNzrzDtRLMiMPL8wBuTGsMnR |
|---|---|
| CIDv1 | bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi |
از این سه قاعده به دست میآید. نزد دستکم دو ارائهکنندۀ مستقل یا روی نود خودتان pin کنید. اگر فایل در یک فولدر باشد (ipfs://…/1.png)، کل فولدر را pin کنید، زیرا بدون بلاک فولدر هیچ کس فایل را پیدا نمیکند. و ipfs:// بنویسید، هرگز آدرس Gateway.
آدرسهای Gateway: رایجترین خطایی که میشود از آن جلوگیری کرد
بسیاری قراردادها https://gateway.pinata.cloud/ipfs/… یا https://ipfs.io/ipfs/… را به جای ipfs:// مینویسند. به این ترتیب نمایش به دقیقاً یک گرداننده وابسته میشود، و دسترسی و سالم ماندن تا سطح یک سرور ویب عادی پایین میآید Balduf و همکاران 2022. حتی جوابهای یک Gateway را میشود در مسیر عوض کرد بدون آن که کسی متوجه شود، تا وقتی کسی CID را دوباره حساب نکند Stöger و همکاران 2023. پیشنویس ERC-8495 یک نمونهگیری خودش را ذکر میکند: 113 از 204 آدرس توکن با Gateway بار نشدند. و Gatewayها واقعاً از بین میروند؛ Cloudflare در 14.08.2024 cloudflare-ipfs.com و cf-ipfs.com را خاموش کرد. بررسیکننده Gatewayهای مسیری و Subdomain را تشخیص میدهد و شکل ipfs:// را پیشنهاد میکند.
ar://: پرداختشده برای مدت طولانی
Arweave راه دیگری را میرود. آپلود کردن یک بار فیس دارد، و شبکه قرار است معلومات را به طور دایمی نگه دارد Daniel و Tschorsch 2022. آدرس ar:// با یک ID تراکنش از 43 کرکتر Base64URL است که در آن حروف بزرگ و کوچک فرق دارند. یک نام کوتاهتر پشت ar:// یک نام ArNS است: کاربردی، اما قابل تغییر و بنابراین ثابت نیست.
05 / onchain
متادیتا در قرارداد: 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 فقط attribute=value را میشناسد، یعنی ;charset=utf-8. با Base64 این سوال پیش نمیآید. - SVG بدون اسکریپت. SVG میتواند کود قابل اجرا داشته باشد Heiderich و همکاران 2011. به همین دلیل مارکیتپلیسها آن را فقط به شکل تصویر نشان میدهند: اسکریپتها اجرا نمیشوند، فونتها و تصاویر بیرونی بار نمیشوند، و OpenSea SVG را به شکل PNG ذخیرۀ موقت میکند. هر چیزی که به اینها وابسته باشد در نمایش دیده نمیشود.
- نوع رسانۀ مناسب. در image باید image/svg+xml، image/png و مانند آن باشد. بررسیکننده این معلومات را با بایتهای واقعی مقایسه میکند.
برای هر JSON معتبر، بررسیکننده نسخۀ Base64 را برای کاپی کردن میسازد، پس از اصلاحات بیخطر مانند # پیش از رنگ، اعداد در علامۀ نقل قول یا آدرسهای Gateway.
06 / ERC-1155
ERC-1155: {id}، نام فایلها و ترجمهها
یک قرارداد ERC-1155 اغلب برای همۀ توکنها یک uri یکسان برمیگرداند، مثلاً ipfs://bafy…/{id}.json. کلاینت جاینگهدار {id} را با ID توکن جایگزین میکند، آن هم به شکل هگزادسیمال، با حروف کوچک، بدون 0x و تا 64 کرکتر پر شده. این برای {id} در مقادیر JSON هم صدق میکند، مثلاً در image.
رایجترین خطا در نام فایل است: فایلها 1.json، 2.json نام دارند، و مارکیتپلیس 000…001.json را میجوید. ID توکن را در بررسیکننده بنویسید، آن وقت آدرس کامل را میبینید. راستی، در ERC-721 {id} جایگزین نمیشود.
ERC-1155 علاوه بر آن سه فیلد خاص خود را دارد: decimals برای توکنهای قابل تقسیم، properties برای معلومات اضافی دلخواه و localization برای ترجمهها. در localization، uri، default و locales حتمی هستند، و uri شامل {locale} است که کلاینت آن را با کود زبان جایگزین میکند.
| ID توکن | جایگزینی، 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 را از نظر فارمت و Checksum طبق EIP-55 بررسی میکند. حروف بزرگ و کوچک غلط تقریباً همیشه نشانۀ اشتباه تایپی است. آدرسهای جداگانه را حرف به حرف با بررسی آدرس Ethereum مقایسه کنید.
08 / تحقیق
تحقیقات علمی دربارۀ متادیتای NFT چه میگوید
ارزیابیهای بررسیکننده بر اندازهگیریها در اکوسیستم NFT و شبکۀ IPFS تکیه دارند. پنج یافته مهمترین تصمیمها را پشتیبانی میکنند؛ لست کامل با یادداشت بررسی پایینتر آمده است.
- آدرسهای متادیتا تغییر میکنند و محتوای ویب ناپدید میشود. 2,89 فیصد آدرسها در سه ماه تغییر کردند، محتوای بیرون از IPFS بیشتر از بین رفت Das و همکاران 2022. به همین دلیل بررسیکننده https را قابل تغییر ارزیابی میکند.
- آدرسهای Gateway از IPFS یک سرور ویب میسازند. Gatewayهای ثابتنوشتهشده دسترسی را تا سطح Cloud پایین میآورند Balduf و همکاران 2022، و جوابهای آنها را میشود در مسیر تغییر داد Stöger و همکاران 2023. بررسیکننده هر آدرس Gateway را با جایگزین گزارش میدهد.
- IPFS معلومات را خودبهخود نگه نمیدارد. بسیاری از فایلهای NFT به چند بار کوشش برای دریافت نیاز داشتند Shi و همکاران 2024، و مارکیتپلیسها اغلب کاپی خود را نشان میدهند Guidi و همکاران 2025. به همین دلیل کنار هر آدرس ipfs:// نکتۀ Pinning آمده است.
- ویژگیها قیمتها را حرکت میدهند. کمیابیِ حاصل از attributes با قیمت و بازده ارتباط دارد Mekacher و همکاران 2022. به همین دلیل بررسیکننده حتی یک فاصله در کنار متن را گزارش میدهد.
- متادیتای خراب توکن و محتوا را از هم جدا میکند. گزارش NIST دربارۀ نقاط ضعف NFT همین را شرح میدهد Mell و Yaga 2024؛ به همین دلیل یک image نامعتبر خطا است، نه یک چیز کوچک.
09 / روش کار
یک کلکسیون را این طور درست راهاندازی کنید
- محل ذخیره را تعیین کنید. متادیتای کوچک و SVG به شکل data:-URI در قرارداد، تصاویر و ویدیوهای بزرگتر روی IPFS یا Arweave. https فقط برای محتوایی که باید تغییر کند.
- برای هر توکن یک فایل بررسی کنید. نام، تصویر و ویژگیها را این جا وارد کنید تا وقتی که دیگر خطا و هشداری نیاید. در ERC-1155 ID توکن را بنویسید و نام فایلها را مقایسه کنید.
- Pinning را دوگانه انجام دهید. نزد دو ارائهکنندۀ مستقل یا روی نود خودتان، کل فولدر را.
- فایل کلکسیون را بنویسید. contractURI با name، تصویر، بنر و external_link، و این جا دوباره بررسی کنید.
- در شبکۀ آزمایشی ببینید. یک توکن mint کنید و آن را در شبکۀ آزمایشی یک مارکیتپلیس و در دو والت ببینید، پیش از آن که نوبت شبکۀ اصلی برسد.
- تغییرات را اعلام کنید. وقتی چیزی تغییر میکند، MetadataUpdate (ERC-4906)، URI (ERC-1155) یا ContractURIUpdated() را بفرستید.
کار ابزار بررسی تا کجاست
- چیزی را از انترنت نمیگیرد. این که تصویری زیر ipfs:// هنوز pin شده است یا یک سرور جواب میدهد، را نمیبیند. برای دریافت، آدرس Gateway را به شکل متن میدهد.
- مارکیتپلیسها با هم فرق دارند. بررسی طبق معیارها، مستندات OpenSea و پیشنویس ERC-8495 انجام میشود. بعضی والتها کمتر میخوانند، بعضی مارکیتپلیسها فیلدهای اضافی خود را میخوانند.
- هیچ قضاوتی دربارۀ ارزش یا اصل بودن نیست. نام و تصویر را میشود به دلخواه کاپی کرد؛ جعلیها اغلب حتی همان آدرسهای تصویر اصلی را به کار میبردند Das و همکاران 2022. یک NFT را از روی آدرس قرارداد و ID توکن میشناسید.
ابزارهای دیگر برای پروژههای بلاکچین در فهرست ابزارهای 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: ID توکن به شکل اعشاری (314592) یا هگزادسیمال با 0x (0x4cce0)، تا {id} جایگزین شود و نام فایلهای مورد انتظار نشان داده شوند. |
سوالهایی که دستیار باید با آنها این ابزار را صدا بزند
- «آیا این متادیتای NFT درست است و OpenSea ویژگیها را درست نشان میدهد؟»
- «tokenURI من یک data:-URI با JSON به شکل Base64 برمیگرداند. آیا این معتبر است؟»
- «وقتی URI شامل {id}.json است، فایل توکن 314592 در ERC-1155 باید چه نام داشته باشد؟»
- «برای تصویر، ipfs://Qm… بهتر است یا آدرس Gateway از Pinata؟»
اینکه اتصال چطور کار میکند و MCP در شرکت خود شما چه کرده میتواند، در صفحۀ ادغام MCP نوشته شده است.
11 / سوالهای رایج
سوالهای رایج دربارۀ متادیتای NFT
چرا OpenSea تصویر NFT مرا نشان نمیدهد؟
بیشتر وقتها مشکل از آدرس در image است. علتهای رایج: فیلد وجود ندارد یا نامش image_url است، آدرس نسبی است (فقط «1.png») یا رمزگذارینشده (http)، به یک Gateway خاموششده مانند cloudflare-ipfs.com اشاره میکند (از 14.08.2024)، یا یک data:-URI کدگذارینشده علامۀ # دارد که براوزر از همان جا متن را قطع میکند. اگر فقط تصویر تغییر کرده باشد، اغلب رویداد MetadataUpdate طبق ERC-4906 فرستاده نشده است؛ در آن صورت مارکیتپلیس هنوز نسخۀ کهنه را از حافظۀ موقت خود نشان میدهد.
ipfs:// یا آدرس Gateway: کدام یک در متادیتا نوشته شود؟
باید ipfs://<CID> نوشته شود، مثلاً ipfs://bafy…/1.png. یک آدرس Gateway مانند https://gateway.pinata.cloud/ipfs/… فایل را به یک گردانندۀ واحد وابسته میسازد؛ اگر آن از کار بیفتد، تصویر دیگر بار نمیشود، با آن که معلومات هنوز در شبکۀ IPFS موجود است. در پیشنویس ERC-8495، از 204 آدرس توکن با Gateway که بررسی شد، 113 آدرس بار نشد. لینکهای Gateway را خود نمایشدهنده میسازد؛ بررسیکننده برای هر آدرس Gateway شکل 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 یا در یکی از مقادیر متادیتا باشد، کلاینت آن را با ID توکن جایگزین میکند: به شکل هگزادسیمال، با حروف کوچک، بدون 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 است. بررسیکننده از هر JSON معتبر نسخۀ Base64 را برای کاپی کردن میسازد.
آیا background_color باید با # نوشته شود؟
نخیر، بدون آن. دقیقاً شش رقم Hex لازم است، مثلاً "E0F2FE". اگر # باشد، بعضی کلاینتها خودشان آن را حذف میکنند و بعضی دیگر رنگ را کلاً نادیده میگیرند. شکلهای کوتاه مانند "fff"، نام رنگها یا rgb() خوانده نمیشوند.
کار بررسیکنندۀ متادیتای NFT کجا تمام میشود؟
متنی را که شما وارد میکنید طبق ERC-721، ERC-1155، ERC-7572 و قواعد مستند مارکیتپلیسها بررسی میکند. هیچ آدرسی را باز نمیکند و به همین دلیل نمیداند که آیا تصویری زیر ipfs:// هنوز pin شده است یا یک سرور جواب میدهد. دربارۀ ارزش، اصل بودن یا حقوق محتوا چیزی نمیگوید. این که قرارداد، متادیتا و محل ذخیره چطور با هم جور میآیند و چه کسی به طور دایمی pin میکند، را با کمال میل همراه شما روشن میسازیم.
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
یافته تحقیق روی هشت مارکیتپلیس بزرگ NFT و میلیونها توکن معاملهشده: 80,69 فیصد آدرسهای متادیتا روی IPFS نبودند، در 2,89 فیصد آدرس در ظرف سه ماه تغییر کرد، و محتوای بیرون از IPFS بیشتر ناپدید شد. جعلیها اغلب همان آدرسهای تصویر اصلی را به کار میبردند.
در ابزار ابزار آدرسهای https را قابل تغییر ارزیابی میکند و یادآوری میکند که یک NFT از روی قرارداد و ID توکن شناخته میشود، نه از روی نام و تصویر.
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 قرارداد دستکم یک بار آدرس متادیتا را تغییر دادند. بسیاری یک آدرس Gateway ثابت را به جای ipfs:// نوشته بودند، و نیمی از محتوای IPFS در ظرف یک هفته کمتر از ده ارائهکننده داشت. نویسندگان ذخیره در قرارداد (data:) یا ذخیرۀ مبتنی بر محتوا با Hash را پیشنهاد میکنند.
در ابزار ابزار آدرسهای Gateway را به شکل هشدار همراه با جایگزین 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ها از طریق خدمات مرکزی میگذرند، قابل دور زدن است. در آزمایش، جوابهای Gatewayهای IPFS و دسترسیهای بلاکچین در مسیر عوض شدند.
در ابزار دلیل این را میگوید که چرا ابزار ipfs:// را به جای آدرس Gateway میخواهد: فقط 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 از ده کلکسیون در شبکۀ 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
یافته اندازهگیری روی بیش از چهار میلیون فایل در IPFS: حدود نیمی از آنها به NFTها مربوط است، و بسیاری از آنها فقط پس از چند بار کوشش دریافت میشوند. 50 ارائهکنندۀ بزرگ، بیشتر نودهای Cloud، 95 فیصد فایلها را میدهند.
در ابزار نکتۀ Pinning را با خود دارد: 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: تمرکز واضح و سهم بالای نودها در Cloud.
در ابزار به همین دلیل ابزار توصیه میکند معلومات NFT را نزد دستکم دو ارائهکنندۀ مستقل از هم pin کنید، نه نزد یک ارائهکننده.
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. Proceedings of the ACM SIGCOMM 2022 Conference، ص 739–752
یافته ساختار و اندازهگیری IPFS را شرح میدهد: ذخیرهسازی مبتنی بر محتوا از طریق یک شبکۀ Peer-to-Peer با نودهایی در بیش از 2700 شبکه و 152 کشور؛ نشر و دریافت برای بسیاری از کاربردها به اندازۀ کافی سریع است.
در ابزار اساس توضیح CID: آدرس یک Hash از محتوا است، به همین دلیل ابزار ساختار آن را دقیق بررسی میکند.
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. National Institute of Standards and Technology, 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, Art. 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, Art. 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. Companion Proceedings of the Web Conference 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 اسکریپت، Attributeهای رویداد یا ارجاعهای بیرونی داشته باشد که آن جا کار نمیکنند.
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), Art. 189
یافته مروری بر گذار از NFTهای ثابت، که متادیتای آنها پس از mint تغییر نمیکند، به NFTهای پویا که تغییر میکنند؛ مشکلات تخنیکی بیشتر در متادیتا و تغییر آن است.
در ابزار برای متادیتای قابل تغییر، ابزار رویداد ERC-4906 یا URI از ERC-1155 را نام میبرد تا مارکیتپلیسها تغییر را بگیرند.
doi.org/10.3390/fi15060189 · مقالۀ مروری
معیارها، ادارات و معلومات تولیدکنندگان
- ERC-721: Non-Fungible Token Standard (Final) · Final، بررسیشده در 14.11.2026
- ERC-1155: Multi Token Standard، بخش Metadata (Final) · Final، بررسیشده در 14.11.2026
- ERC-7572: Contract-level metadata via contractURI() (پیشنویس) · Draft، بررسیشده در 14.11.2026
- ERC-4906: EIP-721 Metadata Update Extension (Final) · Final، بررسیشده در 14.11.2026
- ERC-8495: Token Metadata JSON Schema (پیشنویس، Pull Request 2163) · پیشنویس، باز شده در 10.11.2026، نسخۀ 12.11.2026، هنوز پذیرفته نشده؛ قواعد آن فقط به شکل هشدار
- OpenSea Developer Docs: Media and traits, Metadata storage, Contract-level metadata · تاریخ معلومات 12.11.2026
- RFC 2397: The "data" URL scheme · 1998
- RFC 8259: The JavaScript Object Notation (JSON) Data Interchange Format · 2017
- multiformats/cid: Content Identifier، با جدول Multibase و Multicodec · بررسیشده در 14.11.2026
- IPFS Docs: Best Practices for Storing NFT Data using IPFS · بررسیشده در 14.11.2026
- Arweave HTTP API: فیلد id (Base64URL، SHA-256 امضا) · بررسیشده در 14.11.2026
- بلاگ Cloudflare: Cloudflare's public IPFS gateways and supporting Interplanetary Shipyard · 14.05.2024
- EIP-55: Mixed-case checksum address encoding · Final
13 / ابزارهای دیگر
هنوز سوالی دارید؟
- AT-W32 · شرکتها
بررسی مناسب بودن بلاکچین
آیا کار شما واقعاً به بلاکچین ضرورت دارد، یا یک دیتابیس بس است؟ - AT-W33 · شرکتها
بررسی MiCA
آیا توکن شما زیر MiCA میآید، و از آن چه مکلفیتهایی پیدا میشود؟ - AT-W34 · شخصی و شرکتها
حسابگر Gas
یک معامله روی Ethereum، Arbitrum، Optimism، Base یا Polygon چند تمام میشود؟ - AT-W35 · شخصی و شرکتها
بررسی آدرس Ethereum
آیا این آدرس Ethereum درست است و درست نوشته شده؟ Checksum مطابق EIP-55 و مقایسۀ دو آدرس. - AT-W36 · شرکتها
حسابگر Selector و Topic
کدام Function Selector یا Event Topic به این امضای Solidity تعلق دارد، و برعکس؟ - AT-W37 · شرکتها
رمزگشای Calldata
این معامله چه میکند؟ Calldata را پیش از امضا خوانا بسازید.
یک کلکسیون یا توکنهای دسترسی منتشر میکنید؟ نتیجۀ کاپیشده را برای ما بفرستید. ما قرارداد، متادیتا و محل ذخیره را طوری با هم جور میکنیم که مارکیتپلیسها و والتها همه چیز را درست نشان دهند، و Pinning را راهاندازی میکنیم، از رودویش (Rodewisch).
+49 3744 4399760[email protected]دوشنبه تا جمعه، ساعت 8 تا 17 · Straße der Jugend 5, 08228 Rodewisch