ابزار 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 برای این کار فقط سه فیلد تعیین میکند: 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 | رنگ پسزمینه پشت تصویر: شش رقم هگز بدون #، مثلاً 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 هش محتواست. تا وقتی دستکم یک نود دادهها را نگه دارد در دسترس است (پین کردن). |
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 نیست: از کمی بیش از یک میلیون ارجاع وب در مقالات علمی، در هر پنج مقاله دستکم یک ارجاع به جایی نمیرسید یا به محتوای تغییریافته میرسید Klein و همکاران 2014. برای چیزهایی که عمداً باید تغییر کنند، مثلاً توکن دسترسی با تاریخ اعتبار، https با این حال درست است؛ چنین NFTهای پویایی امروز یک حوزه پژوهشی مستقلاند Guidi و Michienzi 2023. در این صورت قرارداد با هر تغییر رویداد MetadataUpdate را طبق ERC-4906 ارسال میکند، وگرنه مارکتپلیس تا مدتها وضعیت قدیمی را نشان میدهد.
ipfs://: آدرس محتوایی، ولی فقط با پین کردن
در IPFS آدرس، هش محتواست، یعنی CID Trautwein و همکاران 2022. اگر یک پیکسل تغییر کند، CID هم تغییر میکند؛ پس هیچکس نمیتواند محتوای پشت یک آدرس ipfs:// را بیصدا عوض کند. CIDv0 با Qm شروع میشود و 46 کاراکتر دارد، CIDv1 معمولاً با bafy. ابزار هر دو را رمزگشایی میکند و نسخه، کدک و طول هش را بررسی میکند، چون یک CID بریدهشده در نگاه اول عادی به نظر میرسد.
اما: IPFS خودش چیزی را نگه نمیدارد. یک فایل تا وقتی در دسترس است که دستکم یک نود آن را نگه دارد Daniel و Tschorsch 2022. در اندازهگیری روی بیش از چهار میلیون فایل IPFS، که حدود نیمی از آنها مربوط به NFT بود، بسیاری فقط پس از چند تلاش دریافت شدند و 50 ارائهدهنده 95 درصد فایلها را تحویل میدادند Shi و همکاران 2024. کل شبکه هم متمرکزتر و وابستهتر به فضای ابری است از آنچه شهرتش نشان میدهد Balduf و همکاران 2023. و اینکه مارکتپلیس تصویر را نشان میدهد چیز زیادی را ثابت نمیکند: اغلب نسخهای از خودش را نشان میدهد Guidi و همکاران 2025.
| CIDv0 | QmbWqxBEKC3P8tqsKc98xmWNzrzDtRLMiMPL8wBuTGsMnR |
|---|---|
| CIDv1 | bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi |
از این سه قاعده نتیجه میشود. نزد دستکم دو ارائهدهنده مستقل یا روی نود خودتان پین کنید. اگر فایل داخل یک پوشه است (ipfs://…/1.png)، کل پوشه را پین کنید، چون بدون بلوک پوشه هیچکس فایل را پیدا نمیکند. و ipfs:// بنویسید، هرگز آدرس گیتوی.
آدرسهای گیتوی: رایجترین خطای قابلاجتناب
بسیاری از قراردادها به جای ipfs:// آدرس https://gateway.pinata.cloud/ipfs/… یا https://ipfs.io/ipfs/… مینویسند. با این کار نمایش فقط به یک ارائهدهنده وابسته میشود و دسترسپذیری و سلامت داده تا سطح یک وبسرور معمولی پایین میآید Balduf و همکاران 2022. پاسخهای یک گیتوی حتی در مسیر قابل تعویضاند بدون آنکه کسی متوجه شود، تا وقتی کسی CID را دوباره محاسبه نکند Stöger و همکاران 2023. پیشنویس ERC-8495 یک نمونهگیری خودش را ذکر میکند: از 204 آدرس توکن با گیتوی، 113 مورد بارگذاری نشد. و گیتویها واقعاً از بین میروند؛ 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 فقط attribute=value را میشناسد، یعنی ;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 میگردد. شناسه توکن را در ابزار وارد کنید تا آدرس کامل را ببینید. ضمناً در ERC-721 جای {id} چیزی گذاشته نمیشود.
ERC-1155 سه فیلد مخصوص خودش هم دارد: 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 را از نظر قالب و checksum طبق EIP-55 بررسی میکند. حروف بزرگ و کوچک نادرست تقریباً همیشه نشانه غلط تایپی است. آدرسها را تکتک و کاراکتر به کاراکتر با بررسی آدرس Ethereum مقایسه کنید.
08 / پژوهش
پژوهشها درباره متادیتای NFT چه میگویند
ارزیابیهای ابزار بر اندازهگیریهایی در اکوسیستم NFT و شبکه IPFS تکیه دارند. پنج یافته مهمترین تصمیمها را پشتیبانی میکنند؛ فهرست کامل با یادداشت بررسی پایینتر آمده است.
- آدرسهای متادیتا تغییر میکنند و محتوای وب از بین میرود. 2.89 درصد آدرسها ظرف سه ماه تغییر کردند و محتوای خارج از 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) کار میکنند، میتوانند محاسبه این صفحه را مستقیم فراخوانی کنند، بهجای آنکه خودشان آن را بازسازی کنند. سرور عمومی است، ثبتنام لازم ندارد و چیزی ذخیره نمیکند. پاسخ همیشه لینک این صفحه، تاریخ بهروزرسانی دادهها و محدودیتهای نتیجه را در بر دارد.
- نقطه اتصال
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 برمیگرداند. آیا معتبر است؟»
- «اگر URI شامل {id}.json باشد، فایل توکن 314592 در ERC-1155 باید چه نامی داشته باشد؟»
- «برای تصویر، 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، از 204 آدرس توکنِ بررسیشده با گیتوی، 113 مورد بارگذاری نشد. لینک گیتوی را خودِ نمایشدهنده میسازد؛ ابزار برای هر آدرس گیتوی شکل 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 است. ابزار از هر JSON معتبر نسخه Base64 را برای کپی میسازد.
آیا background_color باید با # نوشته شود؟
نه، بدون #. دقیقاً شش رقم هگز لازم است، مثلاً "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
یافته بررسی هشت مارکتپلیس بزرگ NFT و میلیونها توکن معاملهشده: 80.69 درصد آدرسهای متادیتا روی IPFS نبودند، در 2.89 درصد آدرس ظرف سه ماه تغییر کرد و محتوای خارج از 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 ظرف یک هفته کمتر از ده ارائهدهنده داشت. نویسندگان ذخیره داخل قرارداد (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 از ده کالکشن در شبکه 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 ارائهدهنده بزرگ، که بیشترشان نودهای ابریاند، 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. Proceedings of the ACM SIGCOMM 2022 Conference، ص. 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. 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، مقاله 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 اسکریپت، ویژگیهای رویداد یا ارجاع خارجی داشته باشد که آنجا کار نمیکنند.
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های ایستا، که متادیتایشان پس از مینت ثابت است، به NFTهای پویا که تغییر میکنند؛ دشواریهای فنی بیشتر در متادیتا و تغییر آن است.
در ابزار برای متادیتای تغییرپذیر، ابزار رویداد ERC-4906 یا URI از ERC-1155 را ذکر میکند تا مارکتپلیسها تغییر را اعمال کنند.
doi.org/10.3390/fi15060189 · مقاله مروری
استانداردها، نهادهای دولتی و اطلاعات سازندگان
- ERC-721: Non-Fungible Token Standard (Final) · نهایی، بررسیشده در 14.11.2026
- ERC-1155: Multi Token Standard، بخش Metadata (Final) · نهایی، بررسیشده در 14.11.2026
- ERC-7572: Contract-level metadata via contractURI() (پیشنویس) · Draft، بررسیشده در 14.11.2026
- ERC-4906: EIP-721 Metadata Update Extension (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-Blog: Cloudflare's public IPFS gateways and supporting Interplanetary Shipyard · 14.05.2024
- EIP-55: Mixed-case checksum address encoding · نهایی
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 را پیش از امضا خوانا کنید.
کالکشن یا توکن دسترسی منتشر میکنید؟ نتیجه کپیشده را برایمان بفرستید. ما قرارداد، متادیتا و محل ذخیره را طوری کنار هم قرار میدهیم که مارکتپلیسها و کیف پولها همهچیز را درست نشان دهند، و پین کردن را راهاندازی میکنیم، از رودویش (Rodewisch).
+49 3744 4399760[email protected]دوشنبه تا جمعه 8 تا 17 · Straße der Jugend 5, 08228 Rodewisch