Co robi to narzędzie
Wklej adres kontraktu NFT plus numer tokena (token id), wybierz sieć, a my odczytamy metadane prosto z blockchaina. Serwer wywołuje tokenURI (dla ERC-721) lub uri (dla ERC-1155), idzie pod ten link (HTTPS lub IPFS) i pokazuje obrazek, nazwę, opis oraz cechy w jednym panelu.
Bez klucza API i bez podłączania portfela. Dostajesz też kopiowalny tokenURI, pełny surowy JSON oraz linki jednym klikiem do OpenSea i block explorera.
Jak używać
- Wklej adres kontraktu NFT w pierwsze pole. Musi mieć format `0x` plus 40 znaków heksadecymalnych (standard adresu EVM).
- Wpisz numer tokena (token id) w drugie pole. Większość kolekcji zaczyna od `1` lub `0` i liczy w górę. Możesz też wkleić id w hexie typu `0x1a3b`, jeśli skopiowałeś je z marketplace'u.
- Wybierz sieć, w której NFT żyje. Ten sam adres kontraktu nie pojawia się w dwóch sieciach jednocześnie, ale projekt może mieć równoległe deploymenty na Polygon, Base, Arbitrum, Optimism lub BSC.
- Kliknij "Sprawdź". Serwer wykrywa, czy kontrakt to ERC-721 czy ERC-1155, odczytuje on-chainowy link i pobiera plik z metadanymi (8 sekundowy timeout).
- Spójrz na podgląd obrazka po lewej i opis plus linki po prawej. Obrazek jest ładowany przez nasz proxy, żeby bramki z ochroną przed hotlinkiem nie blokowały żądania.
- Przewiń do tabeli cech (attributes), żeby zobaczyć traity typu "Background: Aquamarine" albo "Mouth: Bored Unshaven". Są sortowane po nazwie cechy dla przewidywalnej kolejności.
- Użyj przycisków kopiowania przy wierszu tokenURI i pudełku z surowym JSON-em, jeśli potrzebujesz dokładnych stringów do własnego skryptu, indexera lub notatek audytowych.
- Kliknij "OpenSea" lub "Explorer", żeby otworzyć tokena na marketplace lub w block explorerze dla danej sieci.
Kiedy się przydaje
Sześć typowych sytuacji, w których odczyt metadanych NFT ma sens:
- Weryfikacja, że adres kontraktu rzeczywiście wskazuje na kolekcję, o której myślisz: wklej adres z Discorda albo tweeta i sprawdź, czy nazwa, obrazek i link OpenSea pasują do projektu.
- Debugowanie własnego kontraktu NFT przed mintem: potwierdź, że tokenURI ustawiony w kontrakcie poprawnie się rozwija przez IPFS i że Twój JSON parsuje się za pierwszym razem.
- Audyt dokumentu metadanych przed zakupem: zobacz dokładnie te atrybuty, które zwraca kontrakt, a nie przefiltrowany widok marketplace'u. Niektóre kolekcje mają cechy, które marketplace ukrywa.
- Porównanie tego samego token id między oryginałem a forkami: pochodne kontrakty często zachowują strukturę tokenURI, więc szybki lookup powie Ci, czy klon używa tego samego JSON-a, czy podmienia własny.
- Backup obrazka i metadanych własnego NFT: skopiuj rozwiązany URL bramki IPFS, przypnij go na własnym węźle IPFS i nie zależysz już od tego, czy pinning service projektu pozostanie online.
- Budowa dashboardu, galerii lub indexera: weź kanoniczną nazwę, obrazek i traity ze źródła raz, zcache'uj je i przestań scrapować HTML marketplace'u po dane, które już są on-chain.
Powiązane: info o tokenie ERC-20, ENS resolver, multi-chain address activity, walidator adresów krypto, gas tracker.
Pytania i odpowiedzi
NFT to wpis w smart kontrakcie, który wiąże unikalny numer (token id) z paczką metadanych: zwykle nazwą, opisem, obrazkiem i listą cech. Kontrakt gwarantuje, że dokładnie jeden portfel posiada każdy token id naraz i że historia własności jest publicznie widoczna na blockchainie. Sam obrazek nie jest trzymany na blockchainie. Kontrakt trzyma tylko link do pliku z metadanymi (często na IPFS), który z kolei linkuje do obrazka. Dlatego to narzędzie potrzebuje dwóch kroków: odczyt on-chainowego linku, a potem pobranie pliku, na który wskazuje.