Nástroj AT-W40REV. 2026-A
Kontrola metadat NFT: zobrazuje tržiště vaše NFT správně?
Tržiště a peněženky čtou název, obrázek a vlastnosti NFT ze souboru JSON, na který chytrý kontrakt ukazuje pomocí tokenURI. Stačí # před barvou, číslo v uvozovkách nebo adresa gateway místo ipfs:// a pole chybí nebo obrázek jednou zmizí. Kontrolní nástroj přečte váš JSON nebo data:-URI, ověří jej podle ERC-721, ERC-1155, ERC-7572 a pravidel tržišť a zobrazí náhled.
- zdarma
- bez kryptopeněženky
- kontroluje v prohlížeči, nic nestahuje
01 / KONTROLA
Vložte metadata, přečtěte nálezy a náhled
Kontrolní nástroj · metadata NFT podle ERC-721, ERC-1155 a ERC-7572
Nástroj kontroluje to, co vložíte, podle ERC-721, ERC-1155, ERC-7572 a zdokumentovaných pravidel tržišť. Nic nestahuje: neověřuje, zda jsou obrázky a soubory za adresami skutečně dostupné.
Výsledek
Náhled, přibližně jako na tržišti
Zjištění
Adresy a úložiště
| Pole | Hodnocení | Adresa |
|---|
Nic se nestahuje. Kdo si chce soubor prohlédnout, otevře uvedenou adresu gateway v prohlížeči.
Opravená verze
Zobrazit JSON
Pravidla podle ERC-721, ERC-1155, ERC-7572, dokumentace OpenSea a návrhu ERC-8495, stav k 14. listopadu 2026. Zdroj je uveden u každého nálezu. Kolekci, která se všude zobrazuje správně, s vámi vytvoříme; napište nám přes kontaktní formulář.
Kontroluje ve vašem prohlížeči. Nic se neodesílá, neukládá ani nestahuje.
02 / PRŮBĚH
Jak tržiště získá název a obrázek
V chytrém kontraktu téměř nikdy není přímo obrázek. Chytrý kontrakt ERC-721 poskytuje pro každý token adresu pomocí funkce tokenURI, chytrý kontrakt ERC-1155 pomocí uri. Za touto adresou je malý dokument JSON s názvem, popisem a adresou obrázku. Tržiště tedy postupně načte dva soubory a každý z nich může chybět, být chybně zapsán nebo přesunut.
ERC-721 pro to stanovuje jen tři pole: name, description a image. Vše ostatní, co tržiště zobrazují, od videí po vlastnosti, vychází z konvence zdokumentované OpenSea v roce 2018. Protože OpenSea bylo tržištěm s nejvíce uživateli a největším obratem White a kol. 2022, řídí se podle něj ostatní. Od listopadu 2026 je tato konvence jako návrh ERC-8495; kontrolní nástroj bere obojí jako měřítko a u každého nálezu uvádí zdroj.
Chybná metadata nejsou kosmetická otázka. Kdo chybně uloží přiřazení tokenu k souboru, oddělí NFT od toho, co představuje, a v nejhorším případě ho znehodnotí Mell a Yaga 2024.
Pole metadat tokenu
| Pole | Původ | Co do ní patří |
|---|---|---|
| name | ERC-721, ERC-1155 | Název tokenu, čistý text. Pokud chybí, tržiště většinou zobrazí jen „#123“. |
| description | ERC-721, ERC-1155 | Popis. OpenSea čte Markdown, neupravené HTML nezobrazuje. |
| image | ERC-721, ERC-1155 | Obrázek pro seznamy a náhled. ERC-721 doporučuje šířku 320 až 1080 px, OpenSea alespoň 3000 × 3000 px. |
| animation_url | OpenSea, návrh ERC-8495 | Video, zvuk, 3D model nebo stránka HTML, zobrazené místo obrázku. Obrázek zůstává povinný jako náhrada. |
| external_url | OpenSea, návrh ERC-8495 | Odkaz z tržiště na vaši vlastní stránku, ideálně https. |
| background_color | OpenSea, návrh ERC-8495 | Barva pozadí za obrázkem: šest šestnáctkových číslic bez #, například E0F2FE. |
| attributes | OpenSea, návrh ERC-8495 | Vlastnosti jako seznam trait_type, value a volitelně display_type a max_value. Z nich vznikají filtry kolekce. |
| decimals | ERC-1155 | Počet desetinných míst pro zobrazení množství, celé číslo od 0. |
| properties | ERC-1155 | Libovolné dodatečné údaje jako objekt. Tržiště zobrazují vlastnosti jako filtry jen z attributes. |
| localization | ERC-1155 | Překlady: uri s {locale}, default a locales jsou povinné. |
| image_data | Zastaralé pole (OpenSea 2018) | Surové SVG místo image. Čte se už jen, pokud image chybí; již nepoužívejte. |
| youtube_url | Zastaralé pole (OpenSea 2018) | Video na YouTube místo animation_url. Již nepoužívejte. |
Žádné pole není povinné, ani v ERC-721. Pokud name nebo image chybí, tržiště přesto zobrazí jen číslo a zástupný obrázek. Stav pravidel k 14. listopadu 2026.
Obrázek si zaslouží zvláštní péči. Kolekce jsou vizuálně jednotné a kromě dosavadního prodejního vývoje vlastnosti obrázku nejlépe předpovídají cenu Nadini a kol. 2021. ERC-721 doporučuje šířku 320 až 1080 pixelů při poměru stran mezi 4:5 a 1,91:1, OpenSea však alespoň 3000 × 3000 pixelů. Pokud je obrázek v textu jako data:-URI, nástroj přečte formát a velikost přímo z bajtů.
03 / VLASTNOSTI
attributes: zapisujte vlastnosti tak, aby fungovaly filtry
Z attributes vznikají filtry kolekce a na mnoha stránkách i vzácnost NFT. Má to následky: ve 410 kolekcích s 3,7 milionu transakcí vzácnost vypočtená z vlastností výrazně souvisela s cenou a obchodováním Mekacher a kol. 2022. Jedna mezera navíc v „Farbe “ vytvoří ze stejného druhu vlastnosti dva a počítání už nesedí.
| Záznam v attributes | Zobrazení | Druh |
|---|---|---|
| {"trait_type":"Farbe","value":"Gold"} | Barva: zlatá | Text |
| {"trait_type":"Stufe","value":3,"max_value":5} | Úroveň: 3 z 5 | Číslo |
| {"display_type":"number","trait_type":"Punkte","value":12} | Body: 12 | Číslo |
| {"display_type":"boost_number","trait_type":"Ausdauer","value":40} | Výdrž: +40 | Bonus |
| {"display_type":"boost_percentage","trait_type":"Rabatt","value":10} | Sleva: +10 % | Bonus v % |
| {"display_type":"date","trait_type":"Gültig bis","value":1798761600} | Platí do: 01.01.2027 | Datum |
display_type: number, boost_number, boost_percentage, date, string, text. S jinými hodnotami se zachází, jako by pole chybělo.
- Číslo bez uvozovek. "value": "5" je text, "value": 5 je číslo. U number, boost_number, boost_percentage a date musí jít o číslo; OpenSea číslo v uvozovkách výslovně čte jako text.
- Datum v sekundách. Unixový čas jako block.timestamp, tedy 1798761600 pro 1. ledna 2027. Hodnoty od 1 000 000 000 000 jsou téměř vždy milisekundy: 1798761600000 by se jako sekundy četlo jako rok 58970.
- max_value jen u čísel. Bez max_value OpenSea použije nejvyšší hodnotu, kterou v kolekci vidělo. Je-li max_value menší než value, údaj je neplatný.
- Více hodnot, jeden název. Klobouk a šála: dvakrát trait_type „Zubehör“ s vlastním value. Hodnota jako seznam se ignoruje.
- Zápis zcela stejně. „Farbe“ a „farbe“ jsou pro tržiště dva filtry. Kontrolní nástroj takové dvojice hlásí.
04 / ÚLOŽIŠTĚ
data:, ipfs://, ar:// nebo https: kde by měly být obrázek a JSON
NFT je tak trvalé jako soubor, na který ukazuje. Ve studii osmi velkých tržišť nebylo 80,69 procent adres metadat na IPFS; u 2,89 procenta tokenů se adresa během tří měsíců změnila a obsah mimo IPFS mizel častěji Das a kol. 2022. U drahého umění to nevypadalo o mnoho lépe: 19 z 51 kontraktů změnilo adresu metadat alespoň jednou Balduf a kol. 2022.
| Zápis | Hodnocení | Proč |
|---|---|---|
data:application/json;base64,… | dobré | Uloženo přímo v chytrém kontraktu a může se změnit jen spolu s ním. Doporučeno pro malá metadata a obrázky SVG. |
ipfs://<CID>/… | dobré | Obsahová adresa: CID je hash obsahu. Dostupná, dokud alespoň jeden uzel data uchovává (pinning). |
ar://<Transaktions-ID> | dobré | Arweave, úložiště zaplacené natrvalo. ID má 43 znaků Base64URL. |
ar://<Name> | s opatrností | Název ArNS: ukazatel, který lze přesměrovat, tedy proměnlivý. |
https://… | s opatrností | Vlastní server nebo cloud. Obsah se může změnit nebo zmizet, jakmile za něj nikdo neplatí. |
https://<Gateway>/ipfs/<CID> | s opatrností | Váže obsah IPFS na jediného provozovatele. Lepší je uvést ipfs://<CID>. |
ipns://… | s opatrností | Proměnlivý název v IPFS. Jen pro obsah, který se má měnit. |
web3://…, onchain:… | s opatrností | Načtení přes volání kontraktu (ERC-4804, návrh ERC-8493). Čte jej OpenSea, ale zdaleka ne každá peněženka. |
http://… | chybné | Nešifrované; prohlížeče takové obrázky na stránkách https blokují. |
ipfs://ipfs/<CID> | chybné | Dvojité ipfs; někteří klienti to opraví, nespoléhejte na to. |
relativ, z. B. 1.png | chybné | Bez schématu žádný klient neví, kde soubor je. |
https: běžný případ, který není trvalý
Webová adresa je pohodlná, žije však jen tak dlouho jako server a smlouva s hostingem. Není to problém NFT: z více než milionu webových odkazů v odborných článcích vedl alespoň jeden u každého pátého článku do prázdna nebo na změněný obsah Klein a kol. 2014. Pro věci, které se mají záměrně měnit, například přístupový token s platností, je https přesto správně; taková dynamická NFT jsou dnes samostatným oborem výzkumu Guidi a Michienzi 2023. Chytrý kontrakt pak při každé změně odešle událost MetadataUpdate podle ERC-4906, jinak tržiště ještě dlouho ukazuje starý stav.
ipfs://: obsahová adresa, ale jen s pinningem
U IPFS je adresa hashem obsahu, CID Trautwein a kol. 2022. Změní-li se jediný pixel, změní se CID; obsah za adresou ipfs:// tedy nikdo nemůže potichu vyměnit. CIDv0 začíná Qm a má 46 znaků, CIDv1 většinou bafy. Kontrolní nástroj obojí dekóduje a ověří verzi, kodek a délku hashe, protože zkrácená CID vypadá na první pohled normálně.
Jenže IPFS samo nic neukládá. Soubor zůstává dostupný, dokud jej uchovává alespoň jeden uzel Daniel a Tschorsch 2022. Při měření více než čtyř milionů souborů IPFS, z nichž zhruba polovinu tvořily soubory NFT, se mnohé daly načíst až po několika pokusech a 50 poskytovatelů dodávalo 95 procent souborů Shi a kol. 2024. Síť je také celkově centralizovanější a více závislá na cloudu, než naznačuje její pověst Balduf a kol. 2023. A to, že tržiště obrázek zobrazuje, mnoho nedokazuje: často ukazuje vlastní kopii Guidi a kol. 2025.
| CIDv0 | QmbWqxBEKC3P8tqsKc98xmWNzrzDtRLMiMPL8wBuTGsMnR |
|---|---|
| CIDv1 | bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi |
Z toho vyplývají tři pravidla. Připněte obsah alespoň u dvou nezávislých poskytovatelů nebo na vlastním uzlu. Je-li soubor ve složce (ipfs://…/1.png), připněte celou složku, protože bez bloku složky soubor nikdo nenajde. A uvádějte ipfs://, nikdy adresu gateway.
Adresy gateway: nejčastější odstranitelná chyba
Mnoho smluv uvádí místo ipfs:// https://gateway.pinata.cloud/ipfs/… nebo https://ipfs.io/ipfs/…. Zobrazení pak závisí na jediném provozovateli a dostupnost i neporušenost klesají na úroveň obyčejného webového serveru Balduf a kol. 2022. Odpovědi gateway lze cestou dokonce vyměnit, aniž by si toho někdo všiml, pokud nikdo nepřepočítá CID Stöger a kol. 2023. Návrh ERC-8495 uvádí vlastní vzorek: 113 z 204 adres tokenů s gateway se nenačetlo. A gateway skutečně mizí; Cloudflare vypnul cloudflare-ipfs.com a cf-ipfs.com dne 14.08.2024. Nástroj rozpozná gateway v cestě i subdoméně a navrhne tvar ipfs://.
ar://: placeno na dlouhou dobu
Arweave sleduje jiný přístup. Za nahrání se jednorázově platí poplatek a síť má data uchovávat trvale Daniel a Tschorsch 2022. Adresa je ar:// s ID transakce o 43 znacích Base64URL, kde záleží na velkých a malých písmenech. Kratší název za ar:// je název ArNS: praktický, ale přesměrovatelný, a tedy proměnlivý.
05 / ONCHAIN
Metadata v chytrém kontraktu: data:-URI bez nástrah
Nejtrvalejší jsou metadata, která vrací přímo chytrý kontrakt. Výzkumníci, kteří zkoumali zvlášť draze obchodovaná umělecká NFT, doporučují právě to pro vše dostatečně malé Balduf a kol. 2022. tokenURI pak neposkytuje adresu, ale data:-URI s JSON uvnitř a obrázek je často rovnou jako SVG. Kolik to stojí gasu, spočítá Kalkulačka gasu.
- Base64 místo nekódovaného zápisu.
data:application/json;base64,…je doporučená forma. Nekódovaný zápis prohlížeč přeruší u prvního # a název jako „Pass #42“ nebo barva jako #fff v SVG dokument roztrhnou. - ;utf8 není parametr.
data:application/json;utf8,…je rozšířené a čte se, RFC 2397 však zná jen atribut=hodnota, tedy ;charset=utf-8. S Base64 tato otázka nevzniká. - SVG bez skriptů. SVG může obsahovat spustitelný kód Heiderich a kol. 2011. Při zobrazení SVG jako obrázku se skripty nespouštějí a externí písma ani obrázky se nenačítají a OpenSea SVG ukládá do mezipaměti jako PNG. Co je na tom závislé, v zobrazení chybí.
- Správný typ média. Do image patří image/svg+xml, image/png a podobně. U vložených dat porovná kontrolní nástroj údaj se skutečnými bajty.
Pro každý platný JSON vytvoří nástroj verzi Base64 ke zkopírování, po automatických úpravách, například odstranění # před barvou, převodu čísel v uvozovkách nebo úpravě adres gateway.
06 / ERC-1155
ERC-1155: {id}, názvy souborů a překlady
Chytrý kontrakt ERC-1155 často vrací pro všechny tokeny stejné uri, například ipfs://bafy…/{id}.json. Zástupný znak {id} klient nahradí ID tokenu, šestnáctkově, malými písmeny, bez 0x a doplněným nulami na 64 znaků. To platí také pro {id} v hodnotách JSON, například v image.
Nejčastější chyba je v názvu souboru: soubory se jmenují 1.json, 2.json a tržiště hledá 000…001.json. Zadejte do kontrolního nástroje ID tokenu a uvidíte úplnou adresu. U ERC-721 se {id} mimochodem nenahrazuje.
ERC-1155 navíc přináší tři vlastní pole: decimals pro dělitelné tokeny, properties pro libovolné dodatečné údaje a localization pro překlady. U localization jsou povinné uri, default a locales a uri obsahuje {locale}, které klient nahradí jazykovým kódem.
| ID tokenu | Nahrazení, 64 znaků |
|---|---|
| 1 | 0000000000000000000000000000000000000000000000000000000000000001 |
| 42 | 000000000000000000000000000000000000000000000000000000000000002a |
| 255 | 00000000000000000000000000000000000000000000000000000000000000ff |
| 314592 | 000000000000000000000000000000000000000000000000000000000004cce0 |
07 / KOLEKCE
contractURI: metadata celé kolekce
Název, banner a popis stránky kolekce pocházejí z vlastního souboru, na který ukazuje funkce contractURI. Popisuje je ERC-7572; standard je stále návrhem, OpenSea jej přesto čte. Povinné je pouze name. Pokud se soubor změní, chytrý kontrakt odešle ContractURIUpdated().
| Pole | Co do ní patří |
|---|---|
| name | Název kolekce. Jediné povinné pole. |
| symbol | Zkratka kolekce. |
| description | Popis kolekce. |
| image | Profilový obrázek kolekce. |
| banner_image | Bannerový obrázek nahoře na stránce kolekce. |
| featured_image | Obrázek pro zvýrazněné oblasti. |
| external_link | Váš web. Pozor: zde se pole jmenuje external_link, u tokenu external_url. |
| collaborators | Ethereum adresy, které smějí upravovat stránku kolekce na tržištích. |
Adresy v collaborators kontrolní nástroj ověří na formát a kontrolní součet podle EIP-55. Chybné použití velkých a malých písmen téměř vždy znamená překlep. Jednotlivé adresy porovnávejte znak po znaku pomocí Kontroly adresy Ethereum.
08 / VÝZKUM
Co říká výzkum o metadatech NFT
Hodnocení v kontrolním nástroji vychází z měření v ekosystému NFT a síti IPFS. Pět zjištění podporuje nejdůležitější rozhodnutí; úplný seznam s poznámkou k ověření je níže.
- Adresy metadat se mění a webový obsah mizí. Během tří měsíců se změnilo 2,89 procenta adres a obsah mimo IPFS se ztrácel častěji Das a kol. 2022. Proto nástroj hodnotí https jako proměnlivé.
- Adresy gateway dělají z IPFS webový server. Pevně zapsané gateway snižují dostupnost na úroveň cloudu Balduf a kol. 2022 a jejich odpovědi lze cestou změnit Stöger a kol. 2023. Nástroj hlásí každou adresu gateway i s náhradou.
- IPFS nedrží data samo. Mnoho souborů NFT vyžadovalo několik pokusů o načtení Shi a kol. 2024 a tržiště často zobrazují vlastní kopii Guidi a kol. 2025. Proto je u každé adresy ipfs:// upozornění na pinning.
- Vlastnosti ovlivňují ceny. Vzácnost z attributes souvisí s cenou a výnosem Mekacher a kol. 2022. Proto nástroj hlásí už mezeru na okraji.
- Chybná metadata oddělují token a obsah. Tak to popisuje zpráva NIST o slabinách NFT Mell a Yaga 2024; neplatné image je proto chyba, ne maličkost.
09 / POSTUP
Jak kolekci správně spustit
- Zvolte úložiště. Malá metadata a SVG jako data:-URI v chytrém kontraktu, větší obrázky a videa na IPFS nebo Arweave. https jen pro obsah, který se má měnit.
- Zkontrolujte soubor pro každý token. Vložte sem název, obrázek a vlastnosti, dokud nezmizí všechny chyby a varování. U ERC-1155 zadejte ID tokenu a porovnejte názvy souborů.
- Zajistěte dvojí pinning. U dvou nezávislých poskytovatelů nebo na vlastním uzlu, vždy pro celou složku.
- Napište soubor kolekce. contractURI s name, obrázkem, bannerem a external_link a zde jej znovu ověřte.
- Prohlédněte si ji na testnetu. Vytvořte jeden token a prohlédněte jej na testnetu tržiště a ve dvou peněženkách, než přijde na řadu hlavní síť.
- Oznamujte změny. Pokud se něco mění, odešlete MetadataUpdate (ERC-4906), URI (ERC-1155) nebo ContractURIUpdated().
Kde kontrola končí
- Nic nestahuje. Nevidí, zda je obrázek pod ipfs:// stále připnutý ani zda server odpovídá. Pro načtení uvádí adresu gateway jako text.
- Tržiště se liší. Kontroluje se podle standardů, dokumentace OpenSea a návrhu ERC-8495. Jednotlivé peněženky čtou méně, některá tržiště čtou vlastní dodatečná pole.
- Žádný úsudek o hodnotě ani pravosti. Název i obrázek lze libovolně kopírovat; padělky často používaly dokonce stejné adresy obrázků jako originál Das a kol. 2022. NFT poznáte podle adresy kontraktu a ID tokenu.
Další nástroje pro blockchainové projekty najdete v přehledu Nástroje pro Web3. Jak vytváříme kolekce, přístupové tokeny a související aplikace, popisuje stránka Vývoj pro Web3.
10 / PRO AI ASISTENTY
Jak tento nástroj použít z AI asistenta
Asistenti jako Claude nebo ChatGPT, kteří umějí Model Context Protocol (MCP), si mohou výpočet z této stránky zavolat přímo, místo aby ho napodobovali. Server je veřejný, nevyžaduje přihlášení a nic neukládá. Odpověď vždy obsahuje odkaz na tuto stránku, datum, ke kterému data platí, a meze výsledku.
- Endpoint
https://aureum-tech.com/mcp- Nástroj
werkzeug_nft_metadaten_pruefer- Přenos
- Streamable HTTP, jen pro čtení
| Název | Povinné | Význam |
|---|---|---|
metadaten | ano | Co se má kontrolovat: JSON metadat jako text, návratová hodnota tokenURI, uri nebo contractURI jako data:-URI (typ média application/json, Base64 nebo nekódované) nebo jen adresa (ipfs://, ar://, https://), která se pak zkontroluje, ale nestáhne. |
standard | ne | Podle kterého standardu: erc721 = metadata tokenu (tokenURI), erc1155 = metadata tokenu s {id} (uri), erc7572 = metadata kolekce (contractURI), auto = rozpoznat podle polí (standardně). |
token_id | ne | Jen ERC-1155: ID tokenu desítkově (314592) nebo šestnáctkově s 0x (0x4cce0), aby se nahradilo {id} a zobrazily očekávané názvy souborů. |
Otázky, při kterých by ho měl asistent zavolat
- „Jsou tato metadata NFT správná a zobrazuje OpenSea vlastnosti správně?“
- „Moje tokenURI vrací data:-URI s JSON v Base64. Je platná?“
- „Jak se musí jmenovat soubor pro token ERC-1155 314592, pokud URI obsahuje {id}.json?“
- „Je pro obrázek lepší ipfs://Qm… nebo adresa gateway od Pinata?“
Jak napojení funguje a co MCP zvládne ve vaší firmě, najdete na stránce Integrace MCP.
11 / ČASTÉ OTÁZKY
Časté otázky k metadatům NFT
Proč OpenSea nezobrazuje obrázek mého NFT?
Většinou je problém v adrese v image. Časté příčiny: pole chybí nebo se jmenuje image_url, adresa je relativní (jen „1.png“) nebo nešifrovaná (http), ukazuje na vypnutou gateway, například cloudflare-ipfs.com (od 14.08.2024), nebo nekódovaná data:-URI obsahuje #, od kterého prohlížeč vše ořízne. Pokud se změnil jen obrázek, často chybí událost MetadataUpdate podle ERC-4906; tržiště pak stále ukazuje starou verzi z mezipaměti.
ipfs:// nebo adresa gateway: co patří do metadat?
Zapisuje se ipfs://<CID>, například ipfs://bafy…/1.png. Adresa gateway, například https://gateway.pinata.cloud/ipfs/…, váže soubor na jediného provozovatele; pokud vypadne, obrázek se již nenačte, i když data v síti IPFS stále jsou. V návrhu ERC-8495 se nenačetlo 113 z 204 zkoumaných adres tokenů s gateway. Odkazy gateway vytváří samotné zobrazení; kontrolní nástroj pro každou adresu gateway navrhne podobu ipfs://.
Jak správně zapisovat čísla a data v attributes?
Čísla bez uvozovek: "value": 5, ne "value": "5". V uvozovkách je číslo považováno za text a filtry pak podle něj neřadí. U display_type number, boost_number, boost_percentage a date musí být value číslo. Datum se uvádí jako Unixový čas v sekundách; hodnota od 1 000 000 000 000 vypadá jako milisekundy. max_value je nepovinné a musí být alespoň tak velké jako value.
K čemu slouží {id} v ERC-1155?
Pokud je {id} v uri nebo v hodnotě metadat, klient jej nahradí ID tokenu: šestnáctkově, malými písmeny, bez 0x a doplněné nulami na 64 znaků. Token 314592 bude 000000000000000000000000000000000000000000000000000000000004cce0. Soubor tedy musí mít název 000000000000000000000000000000000000000000000000000000000004cce0.json; „314592.json“ klient, který dodržuje standard, nenajde.
Co patří do contractURI kolekce?
Podle ERC-7572 jde o JSON s name jako jediným povinným polem, dále symbol, description, image, banner_image, featured_image, external_link a collaborators. Pozor na web: v kolekci se pole jmenuje external_link, u jednotlivého tokenu external_url. collaborators jsou Ethereum adresy, které smějí upravovat stránku kolekce na tržištích. ERC-7572 je zatím návrh, OpenSea jej ale čte.
Base64 nebo ;utf8: která forma data:-URI je správně?
Čtou se obě, doporučuje se Base64. V nekódované data:-URI prohlížeče vše od # oříznou a název jako „Pass #42“ JSON rozbije. Navíc ;utf8 podle RFC 2397 vůbec není platný parametr, správně by bylo ;charset=utf-8. Kontrolní nástroj z každého platného JSON vytvoří verzi Base64 ke zkopírování.
Musí se background_color psát s #?
Ne, bez něj. Vyžaduje se přesně šest šestnáctkových číslic, například "E0F2FE". Někteří klienti znak # sami odstraní, jiní barvu zcela ignorují. Zkrácené tvary jako "fff", názvy barev ani rgb() se nečtou.
Kde končí kontrola metadat NFT?
Kontroluje text, který vložíte, podle ERC-721, ERC-1155, ERC-7572 a zdokumentovaných pravidel tržišť. Žádnou adresu nestahuje, a proto neví, zda je obrázek pod ipfs:// stále připnutý nebo zda server odpovídá. O hodnotě, pravosti ani právech k obsahu nic neříká. Jak spolu souvisejí chytrý kontrakt, metadata a uložení a kdo zajišťuje dlouhodobý pinning, s vámi rádi vyjasníme.
12 / STUDIE A ZDROJE
O co se nástroj opírá
Orientační hodnoty a poznámky výše vycházejí z těchto 15 vědeckých prací. Každou jsme ověřili přes její DOI, případně na stránkách vydavatele (naposledy 14. listopadu 2026): existuje, nebyla stažena a její závěry pro tuto otázku platí dodnes.
Das, D.; Bose, P.; Ruaro, N. a kol. (2022): Understanding Security Issues in the NFT Ecosystem. Sborník konference ACM SIGSAC Conference on Computer and Communications Security 2022 (CCS ’22), s. 667–681
Zjištění Studie osmi velkých NFT tržišť a milionů obchodovaných tokenů: 80,69 procenta adres metadat nebylo na IPFS, u 2,89 procenta se adresa během tří měsíců změnila a obsah mimo IPFS mizel častěji. Padělky často používaly stejné adresy obrázků jako originál.
V nástroji Nástroj hodnotí adresy https jako proměnlivé a připomíná, že NFT se pozná podle kontraktu a ID tokenu, ne podle názvu a obrázku.
doi.org/10.1145/3548606.3559342 · konferenční příspěvek
Balduf, L.; Florian, M.; Scheuermann, B. (2022): Dude, where's my NFT: distributed infrastructures for digital art. Sborník 3. mezinárodního workshopu o distribuované infrastruktuře pro společné dobro (DICG ’22), s. 1–6
Zjištění Z 51 kontraktů drahých uměleckých NFT jich 19 alespoň jednou změnilo adresu metadat. Mnohé uváděly pevnou adresu gateway místo ipfs:// a polovina obsahu IPFS měla během týdne méně než deset poskytovatelů. Autoři doporučují ukládání v chytrém kontraktu (data:) nebo obsahově adresované pomocí hashe.
V nástroji Nástroj hlásí adresy gateway jako varování včetně náhrady ipfs://; data:-URI považuje za nejlepší volbu; u CID složek upozorňuje, že složka i soubor musí zůstat dostupné.
doi.org/10.1145/3565383.3566106 · konferenční příspěvek
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, s. 182–199
Zjištění Téměř každé místo, kde NFT běží přes centralizované služby, lze narušit. Odpovědi IPFS gateway a blockchainových přístupů bylo možné při pokusu cestou zaměnit.
V nástroji Vysvětluje, proč nástroj vyžaduje ipfs:// namísto adresy gateway: pouze CID lze ověřit proti obsahu, bez ohledu na cestu, kterou přišel.
doi.org/10.1007/978-3-031-47751-5_11 · konferenční příspěvek
Guidi, B.; Michienzi, A.; Pasquale, L. (2025): On the impact of marketplaces on the availability of NFT assets on the IPFS network. Sympozium IEEE o počítačích a komunikaci 2025 (ISCC), s. 1–6
Zjištění Dva týdny pozorování souborů NFT z deseti kolekcí v síti IPFS: IPFS nezaručuje vysokou dostupnost a tržiště často zobrazují vlastní kopie namísto souboru ze kontraktu.
V nástroji Proto je ve výsledku upozornění: To, že tržiště obrázek zobrazuje, nedokazuje, že je soubor v síti stále dostupný.
doi.org/10.1109/iscc65549.2025.11326542 · konferenční příspěvek
Shi, R.; Cheng, R.; Han, B. a kol. (2024): A Closer Look into IPFS: Accessibility, Content, and Performance. Proceedings of the ACM on Measurement and Analysis of Computing Systems 8 (2), s. 1–31
Zjištění Měření více než čtyř milionů souborů v IPFS: zhruba polovina patří NFT, mnohé z nich lze načíst až po několika pokusech. 50 největších poskytovatelů, většinou cloudové uzly, dodává 95 procent souborů.
V nástroji Přináší upozornění na pinning: ipfs:// je dostupné jen tak, jak jsou dostupné uzly, které data uchovávají.
doi.org/10.1145/3656015 · odborný časopis
Balduf, L.; Korczyński, M.; Ascigil, O. a kol. (2023): The Cloud Strikes Back: Investigating the Decentralization of IPFS. Sborník konference ACM Internet Measurement Conference 2023 (IMC ’23), s. 391–405
Zjištění Rozsáhlé měření topologie, provozu a poskytovatelů v síti IPFS: výrazná centralizace a vysoký podíl uzlů v cloudu.
V nástroji Proto nástroj doporučuje připnout data NFT alespoň u dvou vzájemně nezávislých poskytovatelů, nikoli jen u jednoho.
doi.org/10.1145/3618257.3624797 · konferenční příspěvek
Trautwein, D.; Raman, A.; Tyson, G. aj. (2022): Design and evaluation of IPFS: a storage layer for the decentralized web. Proceedings of the ACM SIGCOMM 2022 Conference, s. 739–752
Zjištění Popisuje strukturu a měření IPFS: úložiště adresované obsahem přes síť peer-to-peer s uzly ve více než 2700 sítích a 152 zemích; zveřejňování a načítání je pro mnoho použití dost rychlé.
V nástroji Základ vysvětlení CID: adresa je hash obsahu, proto nástroj přesně kontroluje její strukturu.
doi.org/10.1145/3544216.3544232 · konferenční příspěvek
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), s. 31–52
Zjištění Srovnává IPFS, Swarm, Hypercore, SAFE, Storj a Arweave. IPFS drží data jen, dokud je uzly uchovávají dobrovolně nebo placeně (například přes Filecoin); Arweave chce data ukládat trvale a za nahrání účtuje poplatek.
V nástroji Vysvětluje rozdíl mezi ipfs:// a ar:// v poznámkách k místům uložení.
doi.org/10.1109/COMST.2022.3143147 · přehledová studie
Mell, P.; Yaga, D. (2024): Non-fungible token security. National Institute of Standards and Technology, NIST IR 8472
Zjištění Vysvětluje technologii NFT a uvádí 27 možných slabin. Chybně uložená metadata mohou NFT oddělit od jeho předmětu a učinit jej bezcenným; kdo ovládá externí mapovací tabulku, může tokeny přepojit.
V nástroji Vysvětluje, proč nástroj hlásí chybějící nebo neplatné adresy obrázků a metadat jako chybu a označuje proměnlivá místa uložení.
doi.org/10.6028/NIST.IR.8472 · výzkumná zpráva
Mekacher, A.; Bracci, A.; Nadini, M. aj. (2022): Heterogeneous rarity patterns drive price dynamics in NFT collections. Scientific Reports 12, čl. 13890
Zjištění 3,7 milionu transakcí ve 410 kolekcích: vzácnost vypočtená z čitelných vlastností NFT výrazně souvisí s cenou, četností obchodování a výnosem.
V nástroji Vlastnosti nejsou maličkost. Nástroj proto hlásí čísla v uvozovkách, mezery na okrajích a odlišné zápisy stejného druhu vlastnosti, protože zkreslují filtry i vzácnost.
doi.org/10.1038/s41598-022-17922-5 · odborný časopis
Nadini, M.; Alessandretti, L.; Di Giacinto, F. a kol. (2021): Mapování revoluce NFT: tržní trendy, obchodní sítě a vizuální prvky. Scientific Reports 11, čl. 20902
Zjištění Vyhodnocení 6,1 milionu prodejů 4,7 milionu NFT (2017 až 2021): kolekce jsou vizuálně jednotné a kromě průběhu prodeje cenu nejlépe předpovídají vlastnosti obrázku.
V nástroji Obrázek je to, co kupující vidí. Chybějící nebo nenačitatelný image proto nástroj hlásí jako varování, nikoli jako maličkost.
doi.org/10.1038/s41598-021-00053-8 · odborný časopis
White, B.; Mahanti, A.; Passi, K. (2022): Characterizing the OpenSea NFT Marketplace. Companion Proceedings of the Web Conference 2022 (WWW ’22), s. 488–496
Zjištění 5,25 milionu prodejů na OpenSea v letech 2019 až 2021, tržišti s nejvíce uživateli a nejvyšším obratem; růst táhne několik velmi aktivních uživatelů.
V nástroji Proto nástroj vedle standardů ERC kontroluje i pole dokumentovaná službou OpenSea: jsou to pravidla, podle nichž se řídí ostatní tržiště.
doi.org/10.1145/3487553.3524629 · konferenční příspěvek
Klein, M.; Van de Sompel, H.; Sanderson, R. aj. (2014): Scholarly Context Not Found: One in Five Articles Suffers from Reference Rot. PLoS ONE 9 (12), e115253
Zjištění Více než milion webových odkazů ze 3,5 milionu odborných článků: každý pátý článek je postižen nefunkčními odkazy nebo změněným obsahem, mezi články s webovými odkazy sedm z deseti.
V nástroji Dokládá upozornění u adres https: webové adresy časem mizí nebo mění obsah, i bez zlého úmyslu.
doi.org/10.1371/journal.pone.0115253 · odborný časopis
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), s. 239–250
Zjištění Soubory SVG nejsou pouhé obrázky, ale mohou obsahovat HTML, JavaScript a další spustitelné části; prohlížeče často s upravenými SVG zacházely chybně.
V nástroji Proto tržiště zobrazují SVG jen jako obrázek bez skriptů a nástroj varuje, pokud SVG obsahuje skripty, atributy událostí nebo externí odkazy, které tam nefungují.
doi.org/10.1145/2046707.2046735 · konferenční příspěvek
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), čl. 189
Zjištění Přehled přechodu od statických NFT, jejichž metadata jsou po vyražení pevně daná, k dynamickým NFT, která se mění; technické obtíže spočívají hlavně v metadatech a jejich změnách.
V nástroji Pro proměnlivá metadata nástroj uvádí událost z ERC-4906, případně URI z ERC-1155, aby tržiště změnu převzala.
doi.org/10.3390/fi15060189 · přehledová studie
Normy, úřady a údaje výrobců
- ERC-721: Non-Fungible Token Standard (Final) · Final, zkontrolováno 14.11.2026
- ERC-1155: Multi Token Standard, oddíl Metadata (Final) · Final, zkontrolováno 14.11.2026
- ERC-7572: Contract-level metadata via contractURI() (návrh) · Draft, zkontrolováno 14.11.2026
- ERC-4906: EIP-721 Metadata Update Extension (Final) · Final, zkontrolováno 14.11.2026
- ERC-8495: Token Metadata JSON Schema (návrh, Pull Request 2163) · Návrh, otevřen 10.11.2026, verze z 12.11.2026, dosud nepřijat; pravidla z něj pouze jako varování
- OpenSea Developer Docs: Media and traits, Metadata storage, Contract-level metadata · Stav k 12.11.2026
- RFC 2397: Schéma URL „data“ · 1998
- RFC 8259: Datový formát JavaScript Object Notation (JSON) · 2017
- multiformats/cid: Content Identifier, s tabulkou Multibase a Multicodec · zkontrolováno 14.11.2026
- IPFS Docs: Best Practices for Storing NFT Data using IPFS · zkontrolováno 14.11.2026
- Arweave HTTP API: pole id (Base64URL, SHA-256 podpisu) · zkontrolováno 14.11.2026
- Cloudflare blog: Veřejné brány IPFS společnosti Cloudflare a podpora Interplanetary Shipyard · 14.05.2024
- EIP-55: Mixed-case checksum address encoding · Final
13 / DALŠÍ NÁSTROJE
Máte ještě nějakou otázku?
- AT-W32 · Firmy
Test vhodnosti blockchainu
Potřebuje váš projekt opravdu blockchain, nebo stačí databáze? - AT-W33 · Firmy
Test MiCA
Spadá váš token pod nařízení MiCA a jaké povinnosti z toho plynou? - AT-W34 · Domácnosti a firmy
Kalkulačka gasu
Kolik stojí transakce v sítích Ethereum, Arbitrum, Optimism, Base nebo Polygon? - AT-W35 · Domácnosti a firmy
Kontrola adresy Ethereum
Je tato adresa Ethereum platná a správně zapsaná? Kontrolní součet podle EIP-55 a porovnání dvou adres. - AT-W36 · Firmy
Kalkulačka selektorů a topiců
Který selektor funkce nebo event topic patří k této signatuře v Solidity a naopak? - AT-W37 · Firmy
Dekodér calldata
Co tato transakce dělá? Převeďte calldata do čitelné podoby, než podepíšete.
Vydáváte kolekci nebo přístupové tokeny? Pošlete nám zkopírovaný výsledek. Sladíme chytrý kontrakt, metadata a úložiště tak, aby tržiště a peněženky vše zobrazovaly správně, a nastavíme pinning. Pracujeme z Rodewischu.
+49 3744 4399760[email protected]Po–Pá 8:00–17:00 · Straße der Jugend 5, 08228 Rodewisch