Narzędzie AT-W40REV. 2026-A
Sprawdzanie metadanych NFT: czy marketplace poprawnie wyświetla Państwa NFT?
Marketplace’y i portfele odczytują nazwę, obraz i cechy NFT z pliku JSON, na który umowa wskazuje przez tokenURI. Wystarczy # przed kolorem, liczba w cudzysłowie albo adres gatewaya zamiast ipfs://, aby pól brakowało lub obraz kiedyś zniknął. Narzędzie odczytuje Państwa JSON albo data:-URI, sprawdza go według ERC-721, ERC-1155, ERC-7572 i zasad marketplace’ów oraz pokazuje podgląd.
- bezpłatnie
- bez portfela kryptowalutowego
- sprawdza w przeglądarce, niczego nie pobiera
01 / WALIDATOR
Wklej metadane, odczytaj wyniki i podgląd
Narzędzie · metadane NFT według ERC-721, ERC-1155 i ERC-7572
Narzędzie sprawdza to, co Państwo wklejają, według ERC-721, ERC-1155, ERC-7572 i udokumentowanych zasad marketplace’ów. Niczego nie pobiera: nie sprawdza, czy obrazy i pliki pod wskazanymi adresami są rzeczywiście dostępne.
Wynik
Podgląd, w przybliżeniu jak na marketplace’ie
Wyniki
Adresy i miejsca przechowywania
| Pole | Ocena | Adres |
|---|
Nic nie jest pobierane. Aby samodzielnie obejrzeć plik, należy otworzyć podany adres gatewaya w przeglądarce.
Poprawiona wersja
Zobacz JSON
Zasady według ERC-721, ERC-1155, ERC-7572, dokumentacji OpenSea i projektu ERC-8495, stan na 14 listopada 2026. Źródło podano przy każdym wyniku. Pomożemy Państwu stworzyć kolekcję, która wszędzie wyświetla się poprawnie; proszę napisać przez formularz kontaktowy.
Sprawdza w Państwa przeglądarce. Nic nie jest wysyłane, zapisywane ani pobierane.
02 / PRZEBIEG
Jak marketplace otrzymuje nazwę i obraz
W umowie prawie nigdy nie ma samego obrazu. Umowa ERC-721 udostępnia dla każdego tokenu adres przez funkcję tokenURI, a umowa ERC-1155 przez uri. Pod tym adresem znajduje się mały dokument JSON z nazwą, opisem i adresem obrazu. Marketplace pobiera więc kolejno dwa pliki, a każdego może brakować, może być błędnie zapisany lub przeniesiony.
ERC-721 określa do tego tylko trzy pola: name, description i image. Wszystko inne, co pokazują marketplace’y — od filmów po cechy — wynika z konwencji udokumentowanej przez OpenSea w 2018 roku. Ponieważ OpenSea był marketplace’em z największą liczbą użytkowników i najwyższym obrotem White i in. 2022, inni się do niej dostosowują. Od listopada 2026 konwencja ta jest projektem ERC-8495; narzędzie stosuje oba jako punkt odniesienia i podaje źródło przy każdym wyniku.
Błędne metadane to nie kwestia wyglądu. Błędne zapisanie powiązania tokenu z plikiem odłącza NFT od tego, co reprezentuje, a w najgorszym razie czyni je bezwartościowym Mell i Yaga 2024.
Pola metadanych tokenu
| Pole | Pochodzenie | Co powinna zawierać |
|---|---|---|
| name | ERC-721, ERC-1155 | Nazwa tokenu, zwykły tekst. Gdy jej brakuje, marketplace’y zwykle pokazują tylko „#123”. |
| description | ERC-721, ERC-1155 | Opis. OpenSea odczytuje Markdown, surowy HTML nie jest wyświetlany. |
| image | ERC-721, ERC-1155 | Obraz do list i podglądu. ERC-721 zaleca szerokość od 320 do 1080 px, OpenSea co najmniej 3000 × 3000 px. |
| animation_url | OpenSea, projekt ERC-8495 | Film, dźwięk, model 3D albo strona HTML wyświetlane zamiast obrazu. Obraz nadal musi być dostępny jako zastępczy. |
| external_url | OpenSea, projekt ERC-8495 | Link z marketplace’a do Państwa własnej strony, najlepiej https. |
| background_color | OpenSea, projekt ERC-8495 | Kolor tła za obrazem: sześć cyfr szesnastkowych bez #, na przykład E0F2FE. |
| attributes | OpenSea, projekt ERC-8495 | Cechy jako lista z trait_type, value oraz opcjonalnie display_type i max_value. Na ich podstawie powstają filtry kolekcji. |
| decimals | ERC-1155 | Liczba miejsc po przecinku do wyświetlania ilości, liczba całkowita od 0. |
| properties | ERC-1155 | Dowolne dodatkowe dane jako obiekt. Marketplace’y pokazują cechy jako filtry tylko z attributes. |
| localization | ERC-1155 | Tłumaczenia: uri z {locale}, default i locales są obowiązkowe. |
| image_data | Starsze pole (OpenSea 2018) | Surowe SVG zamiast image. Odczytywane już tylko, gdy brakuje image; nie używać. |
| youtube_url | Starsze pole (OpenSea 2018) | Film z YouTube zamiast animation_url. Nie używać. |
Żadne pole nie jest obowiązkowe, także w ERC-721. Gdy brakuje name lub image, marketplace pokazuje tylko numer i symbol zastępczy. Stan zasad na 14 listopada 2026.
Obraz wymaga szczególnej staranności. Kolekcje są spójne wizualnie, a obok dotychczasowego przebiegu sprzedaży cechy obrazu najlepiej pozwalają przewidzieć cenę Nadini i in. 2021. ERC-721 zaleca szerokość od 320 do 1080 pikseli przy proporcjach od 4:5 do 1,91:1, natomiast OpenSea co najmniej 3000 × 3000 pikseli. Gdy obraz jest data:-URI w tekście, narzędzie odczytuje format i rozmiar bezpośrednio z bajtów.
03 / CECHY
attributes: zapis cech tak, aby filtry działały poprawnie
Z attributes powstają filtry kolekcji, a na wielu stronach także rzadkość NFT. Ma to konsekwencje: w 410 kolekcjach z 3,7 miliona transakcji rzadkość obliczona na podstawie cech wyraźnie wiązała się z ceną i handlem Mekacher i in. 2022. Jedna spacja za dużo w „Farbe ” tworzy dwa rodzaje cech i liczenie przestaje się zgadzać.
| Wpis w attributes | Wyświetlanie | Rodzaj |
|---|---|---|
| {"trait_type":"Farbe","value":"Gold"} | Kolor: złoty | Tekst |
| {"trait_type":"Stufe","value":3,"max_value":5} | Poziom: 3 z 5 | Liczba |
| {"display_type":"number","trait_type":"Punkte","value":12} | Punkty: 12 | Liczba |
| {"display_type":"boost_number","trait_type":"Ausdauer","value":40} | Wytrzymałość: +40 | Bonus |
| {"display_type":"boost_percentage","trait_type":"Rabatt","value":10} | Rabat: +10 % | Bonus w % |
| {"display_type":"date","trait_type":"Gültig bis","value":1798761600} | Ważne do: 01.01.2027 | Data |
display_type: number, boost_number, boost_percentage, date, string, text. Inne wartości są traktowane tak, jakby pola nie było.
- Liczba bez cudzysłowów. "value": "5" jest tekstem, a "value": 5 liczbą. Przy number, boost_number, boost_percentage i date musi to być liczba; OpenSea wyraźnie odczytuje liczbę w cudzysłowie jako tekst.
- Data w sekundach. Czas Unix jak block.timestamp, czyli 1798761600 dla 1 stycznia 2027. Wartości od 1 000 000 000 000 są prawie zawsze milisekundami: 1798761600000 odczytane jako sekundy oznaczałoby rok 58970.
- max_value tylko przy liczbach. Bez max_value OpenSea przyjmuje najwyższą wartość, jaką widziało w kolekcji. Jeśli max_value jest mniejsze niż value, informacja jest nieprawidłowa.
- Wiele wartości, jedna nazwa. Kapelusz i szalik: dwa razy trait_type „Zubehör”, każdy z własnym value. Wartość jako lista jest ignorowana.
- Identyczna pisownia. „Farbe” i „farbe” to dla marketplace’a dwa filtry. Narzędzie zgłasza takie pary.
04 / MIEJSCA PRZECHOWYWANIA
data:, ipfs://, ar:// czy https: gdzie powinny znajdować się obraz i JSON
NFT jest tak trwałe, jak plik, na który wskazuje. W badaniu ośmiu dużych marketplace’ów 80,69 procent adresów metadanych nie znajdowało się w IPFS; w przypadku 2,89 procent tokenów adres zmienił się w ciągu trzech miesięcy, a treści poza IPFS znikały częściej Das i in. 2022. W przypadku dzieł sztuki o wysokiej wartości sytuacja była niewiele lepsza: 19 z 51 umów zmieniło adres metadanych przynajmniej raz Balduf i in. 2022.
| Zapis | Ocena | Dlaczego |
|---|---|---|
data:application/json;base64,… | dobry | Znajduje się w samej umowie, zmienia się tylko razem z nią. Zalecane dla małych metadanych i obrazów SVG. |
ipfs://<CID>/… | dobry | Adres treści: CID jest hashem treści. Dostępne, dopóki co najmniej jeden węzeł przechowuje dane (pinning). |
ar://<Transaktions-ID> | dobry | Arweave, przechowywanie opłacone na stałe. ID ma 43 znaki Base64URL. |
ar://<Name> | ostrożnie | Nazwa ArNS: wskaźnik, który można przestawić, więc jest zmienny. |
https://… | ostrożnie | Własny serwer albo chmura. Treść może się zmienić albo zniknąć, gdy nikt już nie płaci. |
https://<Gateway>/ipfs/<CID> | ostrożnie | Wiąże treść IPFS z jednym operatorem. Lepiej wpisać ipfs://<CID>. |
ipns://… | ostrożnie | Zmienna nazwa w IPFS. Tylko dla treści, które mają się zmieniać. |
web3://…, onchain:… | ostrożnie | Pobranie przez wywołanie umowy (ERC-4804, projekt ERC-8493). Odczytuje je OpenSea, lecz nie każdy portfel. |
http://… | błędny | Nieszyfrowany; przeglądarki blokują takie obrazy na stronach https. |
ipfs://ipfs/<CID> | błędny | Podwójne ipfs; niektórzy klienci to poprawiają, ale nie należy na tym polegać. |
relativ, z. B. 1.png | błędny | Bez schematu żaden klient nie wie, gdzie znajduje się plik. |
https: zwykły przypadek, który nie jest trwały
Adres WWW jest wygodny, ale działa tylko tak długo, jak serwer i umowa z hostingodawcą. To nie problem wyłącznie NFT: spośród około miliona odsyłaczy internetowych w publikacjach naukowych co piąty artykuł miał co najmniej jeden prowadzący donikąd lub do zmienionej treści Klein i in. 2014. Dla rzeczy, które mają się świadomie zmieniać, na przykład tokenu dostępu z terminem ważności, https jest jednak właściwe; takie dynamiczne NFT są już osobnym obszarem badań Guidi i Michienzi 2023. Wtedy umowa przy każdej zmianie wysyła zdarzenie MetadataUpdate według ERC-4906, w przeciwnym razie marketplace długo pokazuje stary stan.
ipfs://: adres treści, ale tylko z pinningiem
W IPFS adres jest hashem treści, czyli CID Trautwein i in. 2022. Zmiana jednego piksela zmienia CID; nikt nie może więc po cichu podmienić treści pod adresem ipfs://. CIDv0 zaczyna się od Qm i ma 46 znaków, CIDv1 zwykle od bafy. Narzędzie dekoduje oba i sprawdza wersję, kodek oraz długość hasha, ponieważ skrócony CID na pierwszy rzut oka wygląda normalnie.
Jednak IPFS niczego nie przechowuje samo z siebie. Plik pozostaje dostępny, dopóki co najmniej jeden węzeł go udostępnia Daniel i Tschorsch 2022. W pomiarze ponad czterech milionów plików IPFS, z których około połowa dotyczyła NFT, wiele dało się pobrać dopiero po kilku próbach, a 50 dostawców dostarczało 95 procent plików Shi i in. 2024. Cała sieć jest też bardziej scentralizowana i oparta na chmurze, niż sugeruje jej reputacja Balduf i in. 2023. A fakt, że marketplace wyświetla obraz, niewiele dowodzi: często pokazuje własną kopię Guidi i in. 2025.
| CIDv0 | QmbWqxBEKC3P8tqsKc98xmWNzrzDtRLMiMPL8wBuTGsMnR |
|---|---|
| CIDv1 | bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi |
Z tego wynikają trzy zasady. Należy przypinać dane u co najmniej dwóch niezależnych dostawców albo na własnym węźle. Gdy plik leży w folderze (ipfs://…/1.png), trzeba przypiąć cały folder, bo bez bloku folderu nikt nie znajdzie pliku. Należy też wpisywać ipfs://, nigdy adres gatewaya.
Adresy gatewayów: najczęstszy błąd, którego można uniknąć
Wiele umów zawiera https://gateway.pinata.cloud/ipfs/… albo https://ipfs.io/ipfs/… zamiast ipfs://. Wtedy wyświetlanie zależy od jednego operatora, a dostępność i integralność spadają do poziomu zwykłego serwera WWW Balduf i in. 2022. Odpowiedzi gatewaya można nawet podmienić po drodze bez zauważenia, dopóki nikt nie sprawdzi CID Stöger i in. 2023. Projekt ERC-8495 podaje własną próbę: nie ładowało się 113 z 204 adresów tokenów z gatewayem. Gatewaye rzeczywiście znikają; Cloudflare wyłączył cloudflare-ipfs.com i cf-ipfs.com 14.08.2024. Narzędzie rozpoznaje gatewaye ścieżkowe i subdomenowe oraz proponuje formę ipfs://.
ar://: opłacone na długi czas
Arweave stosuje inne podejście. Wysłanie danych kosztuje jednorazową opłatę, a sieć ma przechowywać je trwale Daniel i Tschorsch 2022. Adres ma postać ar:// z ID transakcji złożonym z 43 znaków Base64URL, gdzie wielkość liter ma znaczenie. Krótsza nazwa po ar:// to nazwa ArNS: praktyczna, lecz możliwa do przestawienia, a więc zmienna.
05 / ONCHAIN
Metadane w umowie: data:-URI bez pułapek
Najtrwalsze są metadane zwracane przez samą umowę. Badacze analizujący szczególnie drogie artystyczne NFT zalecają właśnie to dla wszystkiego, co jest wystarczająco małe Balduf i in. 2022. tokenURI nie zwraca wtedy adresu, lecz data:-URI z JSON-em w środku, a obraz często jest od razu osadzony jako SVG. Koszt gazu można obliczyć w Kalkulatorze opłat gas.
- Base64 zamiast niezakodowanego.
data:application/json;base64,…to zalecana forma. W wersji niezakodowanej przeglądarka przerywa przy pierwszym #, a nazwa taka jak „Pass #42” lub kolor jak #fff w SVG rozrywa dokument. - ;utf8 nie jest parametrem.
data:application/json;utf8,…jest powszechne i odczytywane, lecz RFC 2397 zna tylko attribut=wert, czyli ;charset=utf-8. Przy Base64 ten problem nie występuje. - SVG bez skryptów. SVG może zawierać wykonywalny kod Heiderich i in. 2011. Dlatego marketplace’y wyświetlają je tylko jako obraz: skrypty nie działają, zewnętrzne czcionki i obrazy nie są ładowane, a OpenSea przechowuje SVG w pamięci podręcznej jako PNG. Wszystko, co od tego zależy, nie pojawi się w widoku.
- Właściwy typ mediów. W image należy podać image/svg+xml, image/png i tak dalej. Narzędzie porównuje deklarację z rzeczywistymi bajtami.
Dla każdego poprawnego JSON-u narzędzie tworzy wersję Base64 do skopiowania, po bezpiecznych poprawkach, takich jak # przed kolorem, liczby w cudzysłowach albo adresy gatewayów.
06 / ERC-1155
ERC-1155: {id}, nazwy plików i tłumaczenia
Umowa ERC-1155 często zwraca ten sam uri dla wszystkich tokenów, na przykład ipfs://bafy…/{id}. Klient zastępuje symbol zastępczy {id} identyfikatorem tokenu — szesnastkowo, małymi literami, bez 0x i dopełnionym zerami do 64 znaków. Dotyczy to także {id} w wartościach JSON-u, na przykład w image.
Najczęstszy błąd dotyczy nazwy pliku: pliki nazywają się 1.json, 2.json, a marketplace szuka 000…001.json. Wpisz w narzędziu ID tokenu, aby zobaczyć pełny adres. W ERC-721 {id} nie jest zastępowane.
ERC-1155 ma ponadto trzy własne pola: decimals dla podzielnych tokenów, properties dla dowolnych dodatkowych danych oraz localization dla tłumaczeń. W localization obowiązkowe są uri, default i locales, a uri zawiera {locale}, które klient zastępuje kodem języka.
| ID tokenu | Zastąpienie, 64 znaki |
|---|---|
| 1 | 0000000000000000000000000000000000000000000000000000000000000001 |
| 42 | 000000000000000000000000000000000000000000000000000000000000002a |
| 255 | 00000000000000000000000000000000000000000000000000000000000000ff |
| 314592 | 000000000000000000000000000000000000000000000000000000000004cce0 |
07 / KOLEKCJA
contractURI: metadane całej kolekcji
Nazwa, baner i opis strony kolekcji pochodzą z osobnego pliku, na który wskazuje funkcja contractURI. Opisuje go ERC-7572; standard jest jeszcze projektem, ale OpenSea mimo to go odczytuje. Obowiązkowe jest tylko name. Gdy plik się zmienia, umowa wysyła ContractURIUpdated().
| Pole | Co powinna zawierać |
|---|---|
| name | Nazwa kolekcji. Jedyne pole obowiązkowe. |
| symbol | Skrót kolekcji. |
| description | Opis kolekcji. |
| image | Zdjęcie profilowe kolekcji. |
| banner_image | Obraz banera u góry strony kolekcji. |
| featured_image | Obraz dla wyróżnionych obszarów. |
| external_link | Państwa strona internetowa. Uwaga: tutaj pole nazywa się external_link, a w tokenie external_url. |
| collaborators | Adresy Ethereum, które mogą edytować stronę kolekcji na marketplace’ach. |
Narzędzie sprawdza format i sumę kontrolną adresów w collaborators według EIP-55. Błędna wielkość liter prawie zawsze wskazuje literówkę. Poszczególne adresy można porównać znak po znaku w Walidatorze adresów Ethereum.
08 / BADANIA
Co badania mówią o metadanych NFT
Oceny w narzędziu opierają się na pomiarach w ekosystemie NFT i sieci IPFS. Pięć ustaleń wspiera najważniejsze decyzje; pełna lista z adnotacją kontrolną znajduje się niżej.
- Adresy metadanych się zmieniają, a treści WWW znikają. 2,89 procent adresów zmieniło się w ciągu trzech miesięcy, a treści poza IPFS ginęły częściej Das i in. 2022. Dlatego narzędzie ocenia https jako zmienne.
- Adresy gatewayów zmieniają IPFS w serwer WWW. Trwale wpisane gatewaye obniżają dostępność do poziomu chmury Balduf i in. 2022, a ich odpowiedzi można zmieniać po drodze Stöger i in. 2023. Narzędzie zgłasza każdy adres gatewaya wraz z zamiennikiem.
- IPFS nie utrzymuje danych samo. Wiele plików NFT wymagało kilku prób pobrania Shi i in. 2024, a marketplace’y często pokazują własną kopię Guidi i in. 2025. Dlatego przy każdym adresie ipfs:// widnieje wskazówka dotycząca pinningu.
- Cechy wpływają na ceny. Rzadkość wynikająca z attributes wiąże się z ceną i zwrotem Mekacher i in. 2022. Dlatego narzędzie zgłasza już spację na końcu.
- Błędne metadane rozdzielają token i treść. Tak opisuje to raport NIST o słabościach NFT Mell i Yaga 2024; nieprawidłowe image jest więc błędem, a nie drobiazgiem.
09 / SPOSÓB DZIAŁANIA
Jak poprawnie uruchomić kolekcję
- Ustal miejsce przechowywania. Małe metadane i SVG jako data:-URI w umowie, większe obrazy i filmy w IPFS albo Arweave. https tylko dla treści, które mają się zmieniać.
- Sprawdź plik każdego tokenu. Wklej tutaj nazwę, obraz i cechy, aż nie będzie błędów ani ostrzeżeń. W ERC-1155 wpisz ID tokenu i porównaj nazwy plików.
- Zadbaj o podwójny pinning. U dwóch niezależnych dostawców albo na własnym węźle, dla całego folderu.
- Napisz plik kolekcji. contractURI z name, obrazem, banerem i external_link, a następnie sprawdź go tutaj.
- Obejrzyj w sieci testowej. Wybij token i obejrzyj go w sieci testowej marketplace’a oraz w dwóch portfelach, zanim przejdziesz do sieci głównej.
- Zgłaszaj zmiany. Wysyłaj MetadataUpdate (ERC-4906), URI (ERC-1155) albo ContractURIUpdated(), gdy coś się zmieni.
Gdzie kończy się działanie walidatora
- Nie pobiera niczego. Nie sprawdza, czy obraz pod ipfs:// nadal jest przypięty ani czy serwer odpowiada. Do pobrania podaje adres gatewaya jako tekst.
- Marketplace’y się różnią. Sprawdzanie odbywa się według standardów, dokumentacji OpenSea i projektu ERC-8495. Poszczególne portfele odczytują mniej, a niektóre marketplace’y stosują własne dodatkowe pola.
- Bez oceny wartości ani autentyczności. Nazwę i obraz można dowolnie kopiować; fałszerstwa często używały nawet tych samych adresów obrazów co oryginał Das i in. 2022. NFT rozpoznaje się po adresie umowy i ID tokenu.
Więcej narzędzi do projektów blockchainowych znajduje się w zestawieniu Narzędzia Web3. Strona Programowanie Web3 opisuje, jak tworzymy kolekcje, tokeny dostępu i aplikacje wokół nich.
10 / DLA ASYSTENTÓW AI
Korzystanie z tego narzędzia przez asystenta AI
Asystenci, tacy jak Claude czy ChatGPT, którzy obsługują Model Context Protocol (MCP), mogą wywołać obliczenia tej strony bezpośrednio, zamiast je odtwarzać. Serwer jest publiczny, nie wymaga logowania i niczego nie zapisuje. Odpowiedź zawsze zawiera link do tej strony, stan danych i granice wyniku.
- Endpoint
https://aureum-tech.com/mcp- Narzędzie
werkzeug_nft_metadaten_pruefer- Transport
- Streamable HTTP, tylko odczyt
| Nazwa | Wymagane | Znaczenie |
|---|---|---|
metadaten | tak | Co ma zostać sprawdzone: JSON metadanych jako tekst, wynik tokenURI, uri albo contractURI jako data:-URI (typ mediów application/json, Base64 albo niezakodowany) albo sam adres (ipfs://, ar://, https://), który zostanie sprawdzony, lecz nie pobrany. |
standard | nie | Według którego standardu: erc721 = metadane tokenu (tokenURI), erc1155 = metadane tokenu z {id} (uri), erc7572 = metadane kolekcji (contractURI), auto = rozpoznanie po polach (standardowo). |
token_id | nie | Tylko ERC-1155: ID tokenu dziesiętnie (314592) albo szesnastkowo z 0x (0x4cce0), aby zastąpić {id} i pokazać oczekiwane nazwy plików. |
Pytania, przy których asystent powinien go użyć
- „Czy te metadane NFT są poprawne i czy OpenSea właściwie wyświetla cechy?”
- „Moje tokenURI zwraca data:-URI z JSON-em Base64. Czy to jest poprawne?”
- „Jak musi nazywać się plik dla tokenu ERC-1155 314592, jeśli URI zawiera {id}.json?”
- „Czy ipfs://Qm… czy adres gatewaya Pinata jest lepszym wyborem dla obrazu?”
Jak działa połączenie i co MCP może dać we własnej firmie, opisujemy na stronie Integracje MCP.
11 / CZĘSTE PYTANIA
Częste pytania o metadane NFT
Dlaczego OpenSea nie wyświetla obrazu mojego NFT?
Najczęściej problem leży w adresie w image. Typowe przyczyny: pole nie istnieje albo nazywa się image_url, adres jest względny (tylko „1.png”) lub nieszyfrowany (http), wskazuje na wyłączony gateway, taki jak cloudflare-ipfs.com (od 14.08.2024), albo niezakodowany data:-URI zawiera #, od którego przeglądarka odcina resztę. Jeśli zmienił się tylko obraz, często brakuje zdarzenia MetadataUpdate według ERC-4906; marketplace nadal pokazuje wtedy starą wersję z pamięci podręcznej.
ipfs:// czy adres gatewaya: co wpisać w metadanych?
Wpisuje się ipfs://<CID>, na przykład ipfs://bafy…/1.png. Adres gatewaya, taki jak https://gateway.pinata.cloud/ipfs/…, wiąże plik z jednym operatorem; gdy przestanie działać, obraz nie załaduje się, mimo że dane nadal są w sieci IPFS. W projekcie ERC-8495 nie ładowało się 113 z 204 zbadanych adresów tokenów z gatewayem. Linki gatewaya tworzy sam interfejs; narzędzie proponuje dla każdego adresu gatewaya formę ipfs://.
Jak poprawnie zapisywać liczby i daty w attributes?
Liczby bez cudzysłowów: "value": 5, a nie "value": "5". W cudzysłowie liczba jest tekstem, więc filtry nie sortują po niej. Przy display_type number, boost_number, boost_percentage i date value musi być liczbą. Datę podaje się jako czas Unix w sekundach; wartość od 1 000 000 000 000 wygląda na milisekundy. max_value jest opcjonalne i musi być co najmniej tak duże jak value.
Do czego służy {id} w ERC-1155?
Jeśli {id} występuje w uri albo w wartości metadanych, klient zastępuje je identyfikatorem tokenu: szesnastkowo, małymi literami, bez 0x i dopełnionym zerami do 64 znaków. Token 314592 staje się 000000000000000000000000000000000000000000000000000000000004cce0. Plik musi więc nazywać się 000000000000000000000000000000000000000000000000000000000004cce0.json; klient przestrzegający standardu nie znajdzie „314592.json”.
Co powinno znaleźć się w contractURI kolekcji?
Według ERC-7572 jest to JSON z name jako jedynym polem obowiązkowym oraz symbol, description, image, banner_image, featured_image, external_link i collaborators. Uwaga na stronę internetową: w kolekcji pole nazywa się external_link, a w pojedynczym tokenie external_url. collaborators to adresy Ethereum, które mogą edytować stronę kolekcji na marketplace’ach. ERC-7572 jest jeszcze projektem, ale OpenSea go odczytuje.
Base64 czy ;utf8: która forma data:-URI jest poprawna?
Obie formy są odczytywane, lecz zalecane jest Base64. W niezakodowanym data:-URI przeglądarka odcina wszystko od #, a nazwa taka jak „Pass #42” uszkadza JSON. Ponadto ;utf8 nie jest prawidłowym parametrem według RFC 2397; poprawna forma to ;charset=utf-8. Narzędzie tworzy z każdego poprawnego JSON-u wersję Base64 do skopiowania.
Czy background_color trzeba zapisywać z #?
Nie, bez niego. Wymagane jest dokładnie sześć cyfr szesnastkowych, na przykład "E0F2FE". Niektórzy klienci sami usuwają #, inni całkowicie ignorują kolor. Skróty takie jak "fff", nazwy kolorów czy rgb() nie są odczytywane.
Gdzie kończy się narzędzie do sprawdzania metadanych NFT?
Sprawdza tekst, który Państwo wklejają, według ERC-721, ERC-1155, ERC-7572 i udokumentowanych zasad marketplace’ów. Nie pobiera żadnego adresu, więc nie wie, czy obraz pod ipfs:// nadal jest przypięty ani czy serwer odpowiada. Nie wypowiada się o wartości, autentyczności ani prawach do treści. Chętnie ustalimy z Państwem, jak umowa, metadane i przechowywanie pasują do siebie oraz kto zapewnia trwałe przypinanie.
12 / BADANIA I ŹRÓDŁA
Na czym opiera się to narzędzie
Wartości orientacyjne i wskazówki powyżej opierają się na tych 15 pracach naukowych. Każdą sprawdziliśmy przez jej DOI lub stronę wydawcy (ostatnio 14 listopada 2026): istnieje, nie została wycofana, a jej wnioski nadal odpowiadają na to pytanie.
Das, D.; Bose, P.; Ruaro, N. i in. (2022): Understanding Security Issues in the NFT Ecosystem. Proceedings of the 2022 ACM SIGSAC Conference on Computer and Communications Security (CCS ’22), s. 667–681
Ustalenie Badanie ośmiu dużych marketplace’ów NFT i milionów sprzedanych tokenów: 80,69 procent adresów metadanych nie było w IPFS, w 2,89 procent przypadków adres zmienił się w ciągu trzech miesięcy, a treści poza IPFS znikały częściej. Fałszerstwa często używały tych samych adresów obrazów co oryginał.
W narzędziu Narzędzie ocenia adresy https jako zmienne i przypomina, że NFT rozpoznaje się po umowie i ID tokenu, a nie po nazwie i obrazie.
doi.org/10.1145/3548606.3559342 · Referat konferencyjny
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), s. 1–6
Ustalenie Spośród 51 umów dotyczących wysokowartościowych artystycznych NFT 19 co najmniej raz zmieniło adres metadanych. Wiele zawierało stały adres gatewaya zamiast ipfs://, a połowa treści IPFS miała po tygodniu mniej niż dziesięciu dostawców. Autorzy zalecają przechowywanie w umowie (data:) albo adresowanie treści hashem.
W narzędziu Narzędzie zgłasza adresy gatewayów jako ostrzeżenie wraz z zamiennikiem ipfs://; data:-URI uznaje za najlepszy wybór; przy CID-ach folderów wskazuje, że folder i plik muszą pozostać dostępne.
doi.org/10.1145/3565383.3566106 · Referat konferencyjny
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
Ustalenie Niemal każdy punkt, w którym NFT działają przez usługi centralne, można obejść. W eksperymencie odpowiedzi gatewayów IPFS i dostępów do blockchaina mogły zostać podmienione po drodze.
W narzędziu Wyjaśnia, dlaczego narzędzie wymaga ipfs:// zamiast adresu gatewaya: tylko CID można sprawdzić względem treści, niezależnie od drogi, którą dociera.
doi.org/10.1007/978-3-031-47751-5_11 · Referat konferencyjny
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), s. 1–6
Ustalenie Dwa tygodnie obserwacji plików NFT z dziesięciu kolekcji w sieci IPFS: IPFS nie gwarantuje wysokiej dostępności, a marketplace’y często pokazują własne kopie zamiast pliku z umowy.
W narzędziu Stąd wskazówka w wyniku: fakt, że marketplace wyświetla obraz, nie dowodzi, że plik nadal jest dostępny w sieci.
doi.org/10.1109/iscc65549.2025.11326542 · Referat konferencyjny
Shi, R.; Cheng, R.; Han, B. i in. (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
Ustalenie Pomiar ponad czterech milionów plików w IPFS: około połowa należy do NFT, a wiele z nich daje się pobrać dopiero po kilku próbach. 50 największych dostawców, głównie węzłów chmurowych, dostarcza 95 procent plików.
W narzędziu Wprowadza wskazówkę o pinningu: ipfs:// jest dostępne tylko tak długo, jak węzły przechowujące dane.
doi.org/10.1145/3656015 · Czasopismo naukowe
Balduf, L.; Korczyński, M.; Ascigil, O. i in. (2023): The Cloud Strikes Back: Investigating the Decentralization of IPFS. Proceedings of the 2023 ACM Internet Measurement Conference (IMC ’23), s. 391–405
Ustalenie Obszerne badanie topologii, ruchu i dostawców w sieci IPFS: wyraźna centralizacja oraz duży udział węzłów w chmurze.
W narzędziu Dlatego narzędzie zaleca przypinanie danych NFT u co najmniej dwóch niezależnych dostawców, zamiast u jednego.
doi.org/10.1145/3618257.3624797 · Referat konferencyjny
Trautwein, D.; Raman, A.; Tyson, G. i in. (2022): Design and evaluation of IPFS: a storage layer for the decentralized web. Proceedings of the ACM SIGCOMM 2022 Conference, s. 739–752
Ustalenie Opisuje budowę i pomiary IPFS: przechowywanie adresowane zawartością w sieci peer-to-peer, z węzłami w ponad 2700 sieciach i 152 krajach; publikowanie i pobieranie są wystarczająco szybkie dla wielu zastosowań.
W narzędziu Podstawa wyjaśnienia CID: adres jest hashem zawartości, dlatego narzędzie dokładnie sprawdza jego budowę.
doi.org/10.1145/3544216.3544232 · Referat konferencyjny
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
Ustalenie Porównuje IPFS, Swarm, Hypercore, SAFE, Storj i Arweave. IPFS przechowuje dane tylko tak długo, jak węzły udostępniają je dobrowolnie albo odpłatnie (np. przez Filecoin); Arweave ma przechowywać dane trwale i pobiera opłatę za przesłanie.
W narzędziu Wyjaśnia różnicę między ipfs:// a ar:// w uwagach dotyczących lokalizacji przechowywania.
doi.org/10.1109/COMST.2022.3143147 · Praca przeglądowa
Mell, P.; Yaga, D. (2024): Non-fungible token security. National Institute of Standards and Technology, NIST IR 8472
Ustalenie Wyjaśnia technikę NFT i wymienia 27 możliwych słabości. Błędnie przechowywane metadane mogą oddzielić NFT od jego przedmiotu i uczynić je bezwartościowym; osoba kontrolująca zewnętrzną tabelę przyporządkowań może przepinać tokeny.
W narzędziu Uzasadnia, dlaczego narzędzie zgłasza brakujące lub nieprawidłowe adresy obrazu i metadanych jako błędy oraz wskazuje zmienne lokalizacje przechowywania.
doi.org/10.6028/NIST.IR.8472 · Raport badawczy
Mekacher, A.; Bracci, A.; Nadini, M. i in. (2022): Heterogeneous rarity patterns drive price dynamics in NFT collections. Scientific Reports 12, Art. 13890
Ustalenie 3,7 miliona transakcji w 410 kolekcjach: rzadkość, obliczona na podstawie czytelnych cech NFT, wyraźnie wiąże się z ceną, częstotliwością handlu i stopą zwrotu.
W narzędziu Cechy nie są drobiazgiem. Dlatego narzędzie zgłasza liczby w cudzysłowach, spacje na brzegach i różną pisownię tego samego rodzaju cechy, ponieważ zniekształcają filtry i rzadkość.
doi.org/10.1038/s41598-022-17922-5 · Czasopismo naukowe
Nadini, M.; Alessandretti, L.; Di Giacinto, F. i in. (2021): Mapowanie rewolucji NFT: trendy rynkowe, sieci handlowe i cechy wizualne. Scientific Reports 11, Art. 20902
Ustalenie Analiza 6,1 miliona sprzedaży 4,7 miliona NFT (2017–2021): kolekcje są jednolite wizualnie, a poza historią sprzedaży to cechy obrazu najlepiej przewidują cenę.
W narzędziu Obraz jest tym, co widzą kupujący. Dlatego narzędzie zgłasza brakujący lub niedający się załadować image jako ostrzeżenie, a nie drobiazg.
doi.org/10.1038/s41598-021-00053-8 · Czasopismo naukowe
White, B.; Mahanti, A.; Passi, K. (2022): Characterizing the OpenSea NFT Marketplace. Companion Proceedings of the Web Conference 2022 (WWW ’22), s. 488–496
Ustalenie 5,25 miliona sprzedaży na OpenSea w latach 2019–2021, na rynku z największą liczbą użytkowników i największym obrotem; wzrost napędza niewielu bardzo aktywnych użytkowników.
W narzędziu Dlatego narzędzie sprawdza obok standardów ERC pola udokumentowane przez OpenSea: są to zasady, według których kierują się inne rynki.
doi.org/10.1145/3487553.3524629 · Referat konferencyjny
Klein, M.; Van de Sompel, H.; Sanderson, R. i in. (2014): Scholarly Context Not Found: One in Five Articles Suffers from Reference Rot. PLoS ONE 9 (12), e115253
Ustalenie Ponad milion odsyłaczy internetowych z 3,5 miliona artykułów naukowych: co piąty artykuł ma problem z wygasłymi linkami lub zmienionymi treściami, a wśród artykułów z odsyłaczami internetowymi – siedem na dziesięć.
W narzędziu Potwierdza uwagę przy adresach https: adresy internetowe z czasem znikają albo zmieniają treść, także bez złych zamiarów.
doi.org/10.1371/journal.pone.0115253 · Czasopismo naukowe
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
Ustalenie Pliki SVG to nie tylko obrazy, lecz mogą zawierać HTML, JavaScript i inne wykonywalne elementy; przeglądarki często niewłaściwie obsługiwały spreparowane SVG.
W narzędziu Dlatego rynki pokazują SVG wyłącznie jako obraz bez skryptów, a narzędzie ostrzega, gdy SVG zawiera skrypty, atrybuty zdarzeń lub zewnętrzne odwołania, które tam nie działają.
doi.org/10.1145/2046707.2046735 · Referat konferencyjny
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
Ustalenie Przegląd przejścia od statycznych NFT, których metadane są ustalone po wybiciu, do dynamicznych NFT, które się zmieniają; trudności techniczne dotyczą głównie metadanych i ich zmian.
W narzędziu W przypadku zmiennych metadanych narzędzie wskazuje zdarzenie z ERC-4906 lub URI z ERC-1155, aby rynki przejęły zmianę.
doi.org/10.3390/fi15060189 · Praca przeglądowa
Normy, urzędy i dane producentów
- ERC-721: standard tokenów niewymiennych (Final) · Finalny, sprawdzono 14.11.2026
- ERC-1155: standard wielu tokenów, sekcja Metadata (Final) · Finalny, sprawdzono 14.11.2026
- ERC-7572: metadane na poziomie kontraktu przez contractURI() (projekt) · Draft, sprawdzono 14.11.2026
- ERC-4906: rozszerzenie aktualizacji metadanych EIP-721 (Final) · Finalny, sprawdzono 14.11.2026
- ERC-8495: schemat JSON metadanych tokena (projekt, Pull Request 2163) · Projekt, otwarty 10.11.2026, wersja z 12.11.2026, jeszcze nieprzyjęty; reguły z niego tylko jako ostrzeżenie
- OpenSea Developer Docs: Media and traits, Metadata storage, Contract-level metadata · Stan na 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, z tabelą Multibase i Multicodec · sprawdzono 14.11.2026
- IPFS Docs: Best Practices for Storing NFT Data using IPFS · sprawdzono 14.11.2026
- Arweave HTTP API: pole id (Base64URL, SHA-256 podpisu) · sprawdzono 14.11.2026
- Cloudflare-Blog: Cloudflare's public IPFS gateways and supporting Interplanetary Shipyard · 14.05.2024
- EIP-55: kodowanie adresu z sumą kontrolną wielkości liter · Finalny
13 / INNE NARZĘDZIA
Zostało jeszcze jakieś pytanie?
- AT-W32 · Firmy
Czy blockchain ma sens? Test
Czy Państwa projekt naprawdę potrzebuje blockchaina, czy wystarczy baza danych? - AT-W33 · Firmy
Test MiCA
Czy Państwa token podlega MiCA i jakie obowiązki z tego wynikają? - AT-W34 · Dom i firmy
Kalkulator opłat gas
Ile kosztuje transakcja na Ethereum, Arbitrum, Optimism, Base albo Polygon? - AT-W35 · Dom i firmy
Walidator adresów Ethereum
Czy ten adres Ethereum jest prawidłowy i dobrze zapisany? Suma kontrolna według EIP-55 i porównanie dwóch adresów. - AT-W36 · Firmy
Kalkulator selektorów i topiców
Jaki selektor funkcji albo topic zdarzenia należy do tej sygnatury Solidity i odwrotnie? - AT-W37 · Firmy
Dekoder calldata
Co robi ta transakcja? Calldata w czytelnej formie, zanim Państwo podpiszą.
Wydają Państwo kolekcję lub tokeny dostępu? Proszę przesłać nam skopiowany wynik. Połączymy kontrakt, metadane i miejsce przechowywania tak, aby rynki i portfele wyświetlały wszystko poprawnie, oraz skonfigurujemy pinning – z Rodewisch.
+49 3744 4399760[email protected]pon.–pt. 8–17 · Straße der Jugend 5, 08228 Rodewisch