Araç AT-W40REV. 2026-A

NFT meta veri kontrolü: Pazar yeri NFT'nizi doğru gösteriyor mu?

Pazar yerleri ve cüzdanlar bir NFT'nin adını, görselini ve özelliklerini, sözleşmenin tokenURI ile gösterdiği bir JSON dosyasından okur. Rengin önünde bir #, tırnak içinde bir sayı ya da ipfs:// yerine bir gateway adresi yeter: Alanlar eksik görünür ya da görsel bir gün kaybolur. Denetleyici JSON'unuzu ya da data:-URI'yi okur, ERC-721, ERC-1155, ERC-7572 ve pazar yerlerinin kurallarına göre kontrol eder ve bir önizleme gösterir.

  • ücretsiz
  • cüzdan (wallet) gerekmez
  • tarayıcıda kontrol eder, hiçbir şey çağırmaz

Meta veriyi yapıştırın, bulguları ve önizlemeyi okuyun

Denetleyici · ERC-721, ERC-1155 ve ERC-7572'ye göre NFT meta verisi

Araç, yapıştırdığınız içeriği ERC-721, ERC-1155, ERC-7572 ve pazar yerlerinin belgelenmiş kurallarına göre kontrol eder. Hiçbir şey çağırmaz: Adreslerin arkasındaki görsellerin ve dosyaların gerçekten erişilebilir olup olmadığını kontrol etmez.

Adım 1Neyi kontrol ediyorsunuz?
Adım 2Meta veriyi yapıştırın

Meta veri dosyanızdaki JSON, tokenURI ya da uri'nin data:application/json;base64,… biçimindeki çıktısı veya ipfs://… gibi bir adres (adres yalnızca kontrol edilir, çağrılmaz).

Sonuç

bekliyorMeta veri JSON'u, bir data:-URI ya da bir adres yapıştırın.

Kurallar ERC-721, ERC-1155, ERC-7572, OpenSea dokümantasyonu ve ERC-8495 taslağına göre, güncelleme 14 Kasım 2026. Kaynak her bulgunun yanında yazar. Her yerde doğru görünen bir koleksiyonu sizinle birlikte kurarız; bize iletişim formu üzerinden yazın.

Tarayıcınızda kontrol eder. Hiçbir şey gönderilmez, kaydedilmez ya da çağrılmaz.

Pazar yeri adı ve görseli nereden alır

Sözleşmede neredeyse hiçbir zaman görselin kendisi durmaz. Bir ERC-721 sözleşmesi her token için tokenURI işleviyle bir adres verir, bir ERC-1155 sözleşmesi ise uri ile. Bu adresin arkasında ad, açıklama ve görselin adresini içeren küçük bir JSON belgesi bulunur. Yani pazar yeri art arda iki dosya çeker ve her biri eksik, hatalı yazılmış ya da taşınmış olabilir.

ERC-721 bunun için sadece üç alan belirler: name, description ve image. Pazar yerlerinin gösterdiği diğer her şey, videolardan özelliklere kadar, OpenSea'nin 2018'de belgelediği bir kullanım kuralına dayanır. OpenSea en çok kullanıcıya ve en yüksek ciroya sahip pazar yeri olduğu için White vd. 2022, diğerleri de buna uyar. Kasım 2026'dan beri bu kural ERC-8495 taslağı olarak mevcut; denetleyici ikisini de ölçüt alır ve her bulguda kaynağı belirtir.

Hatalı meta veri bir görünüş meselesi değildir. Token ile dosya arasındaki eşleşmeyi yanlış kaydeden, NFT'yi temsil ettiği şeyden ayırır ve en kötü durumda onu değersiz kılar Mell ve Yaga 2024.

ÇAĞRISÖZLEŞMETOKENURIMETA VERİ JSONIMAGEGÖRSEL ADRESİPAZAR YERİNDEPAZAR YERİDEPOLAMA YERİDATA: KONUMSÖZLEŞMECID İLE IPFS://AR:// ARWEAVEHTTPS WEB SUNUCUSUÇAĞRISÖZLEŞME TOKENURIMETA VERİ JSONIMAGE GÖRSEL ADRESİPAZAR YERİNDE GÖRÜNTÜDEPOLAMA YERİSÖZLEŞMEDE DATA:CID İLE IPFS://AR:// ARWEAVEHTTPS WEB SUNUCUSU
ŞEKİL 1 · SÖZLEŞMEDEN GÖRÜNTÜYEALTIN RENGİ = BU ARACIN KONTROL ETTİĞİ

Token meta verisinin alanları

tokenURI ya da uri'nin arkasındaki dosyadaki alanlar
AlanKökenİçinde neler olmalı
nameERC-721, ERC-1155Token'ın adı, düz metin. Yoksa pazar yerleri çoğunlukla sadece “#123” gösterir.
descriptionERC-721, ERC-1155Açıklama. OpenSea Markdown okur, ham HTML gösterilmez.
imageERC-721, ERC-1155Listeler ve önizleme için görsel. Genişlik için ERC-721, 320 ile 1080 px arasını önerir, OpenSea en az 3000 × 3000 px.
animation_urlOpenSea, ERC-8495 taslağıGörselin yerine gösterilen video, ses, 3D model ya da HTML sayfası. Görsel, yedek olarak yine zorunludur.
external_urlOpenSea, ERC-8495 taslağıPazar yerinden kendi sayfanıza bağlantı, tercihen https.
background_colorOpenSea, ERC-8495 taslağıGörselin arkasındaki arka plan rengi: # olmadan altı onaltılık rakam, örneğin E0F2FE.
attributesOpenSea, ERC-8495 taslağıtrait_type, value ve isteğe bağlı display_type ile max_value'dan oluşan bir liste olarak özellikler. Koleksiyonun filtreleri bunlardan oluşur.
decimalsERC-1155Miktarın gösterimi için ondalık basamak sayısı, 0 ve üzeri tam sayı.
propertiesERC-1155Nesne olarak istediğiniz ek bilgiler. Pazar yerleri filtre olarak yalnızca attributes içindeki özellikleri gösterir.
localizationERC-1155Çeviriler: {locale} içeren uri, default ve locales zorunludur.
image_dataEski alan (OpenSea 2018)image yerine ham SVG. Artık sadece image yoksa okunur; kullanmayın.
youtube_urlEski alan (OpenSea 2018)animation_url yerine YouTube videosu. Artık kullanmayın.

ERC-721'de bile hiçbir alan zorunlu değildir. name ya da image yoksa pazar yeri yine de sadece bir numara ve bir yer tutucu gösterir. Kuralların güncelliği: 14 Kasım 2026.

Görsel özel bir özen ister. Koleksiyonlar görsel olarak bütünlüklüdür ve geçmiş satış seyrinin yanında fiyatı en iyi görsel özellikler tahmin eder Nadini vd. 2021. ERC-721, 4:5 ile 1,91:1 arası en-boy oranında 320 ile 1080 piksel genişlik önerir, OpenSea ise en az 3000 × 3000 piksel. Görsel metinde data:-URI olarak duruyorsa denetleyici biçimi ve boyutu doğrudan baytlardan okur.

attributes: Özellikleri filtrelerin doğru çalışacağı şekilde yazmak

Bir koleksiyonun filtreleri ve birçok sitede bir NFT'nin nadirliği attributes'tan oluşur. Bunun sonuçları var: 410 koleksiyondaki 3,7 milyon işlemde, özelliklerden hesaplanan nadirlik fiyat ve alım satımla belirgin biçimde ilişkiliydi Mekacher vd. 2022. “Renk ” içindeki fazladan bir boşluk bir özellik türünü ikiye böler ve sayım artık tutmaz.

Böyle yazılır ve pazar yeri bunu yaklaşık şöyle gösterir
attributes içindeki kayıtGörüntüTür
{"trait_type":"Renk","value":"Altın"}Renk: AltınMetin
{"trait_type":"Seviye","value":3,"max_value":5}Seviye: 3 / 5Sayı
{"display_type":"number","trait_type":"Puan","value":12}Puan: 12Sayı
{"display_type":"boost_number","trait_type":"Dayanıklılık","value":40}Dayanıklılık: +40Bonus
{"display_type":"boost_percentage","trait_type":"İndirim","value":10}İndirim: +%10% olarak bonus
{"display_type":"date","trait_type":"Geçerlilik sonu","value":1798761600}Geçerlilik sonu: 01.01.2027Tarih

display_type: number, boost_number, boost_percentage, date, string, text. Diğer değerler, alan hiç yokmuş gibi işlenir.

  • Sayı tırnak işaretsiz. "value": "5" metindir, "value": 5 bir sayıdır. number, boost_number, boost_percentage ve date için sayı olmalıdır; OpenSea tırnak içindeki bir sayıyı açıkça metin olarak okur.
  • Tarih saniye cinsinden. block.timestamp gibi Unix zamanı, yani 1 Ocak 2027 için 1798761600. 1.000.000.000.000 ve üzeri değerler neredeyse her zaman milisaniyedir: 1798761600000 saniye olarak okunursa 58970 yılı olur.
  • max_value yalnızca sayılarda. max_value yoksa OpenSea koleksiyonda gördüğü en yüksek değeri alır. max_value, value'dan küçükse bilgi geçersizdir.
  • Birden çok değer, tek ad. Bir şapka ve bir atkı: iki kez trait_type “Aksesuar”, her birinde bir value. Liste olarak verilen bir değer yok sayılır.
  • Yazım birebir aynı olmalı. “Renk” ve “renk” pazar yeri için iki ayrı filtredir. Denetleyici bu tür çiftleri bildirir.

data:, ipfs://, ar:// ya da https: Görsel ve JSON nerede durmalı

Bir NFT, gösterdiği dosya kadar kalıcıdır. Sekiz büyük pazar yeri üzerine yapılan bir incelemede meta veri adreslerinin yüzde 80,69'u IPFS'te değildi; token'ların yüzde 2,89'unda adres üç ay içinde değişti ve IPFS dışındaki içerikler daha sık kayboldu Das vd. 2022. Yüksek fiyatlı sanat eserlerinde durum pek farklı değildi: 51 sözleşmeden 19'u meta veri adresini en az bir kez değiştirmişti Balduf vd. 2022.

Denetleyici adresleri nasıl sınıflandırır
YazımSınıflandırmaNeden
data:application/json;base64,…iyiSözleşmenin kendisinde durur, yalnızca sözleşmeyle birlikte değişir. Küçük meta veriler ve SVG görseller için önerilir.
ipfs://<CID>/…iyiİçerik adresi: CID, içeriğin bir hash'idir. En az bir düğüm verileri hazır tuttuğu sürece erişilebilir (pinning).
ar://<Transaktions-ID>iyiArweave, kalıcı olarak ödenmiş depolama. ID 43 karakter Base64URL'dir.
ar://<Name>dikkatli kullanınArNS adı: başka yere yönlendirilebilen bir işaretçi, yani değişebilir.
https://…dikkatli kullanınKendi sunucu ya da bulut. Kimse ödemeyi sürdürmediğinde içerik değişebilir ya da kaybolabilir.
https://<Gateway>/ipfs/<CID>dikkatli kullanınIPFS içeriğini tek bir işletmeciye bağlar. ipfs://<CID> yazmak daha iyi.
ipns://…dikkatli kullanınIPFS'te değişebilen ad. Yalnızca değişmesi istenen içerikler için.
web3://…, onchain:…dikkatli kullanınBir sözleşme çağrısıyla erişim (ERC-4804, ERC-8493 taslağı). OpenSea okur, her cüzdan okumaz.
http://…yanlışŞifresiz; tarayıcılar https sayfalarında bu tür görselleri engeller.
ipfs://ipfs/<CID>yanlışÇift ipfs; bazı istemciler bunu düzeltir, ama buna güvenmeyin.
relativ, z. B. 1.pngyanlışŞema olmadan hiçbir istemci dosyanın nerede olduğunu bilemez.

https: olağan durum, ama kalıcı değil

Bir web adresi pratiktir, ama yalnızca sunucu ve hosting sözleşmesi sürdüğü kadar yaşar. Bu bir NFT sorunu değil: Bilimsel makalelerdeki bir milyonu biraz aşan web bağlantısında, her beş makaleden birinde en az bir bağlantı boşluğa ya da değişmiş içeriğe çıkıyordu Klein vd. 2014. Bilerek değişmesi gereken şeyler için, örneğin geçerlilik süresi olan bir erişim token'ı için, https yine de doğrudur; bu tür dinamik NFT'ler artık ayrı bir araştırma alanıdır Guidi ve Michienzi 2023. Bu durumda sözleşme her değişiklikte ERC-4906'ya göre MetadataUpdate olayını gönderir; yoksa pazar yeri uzun süre eski hâli gösterir.

ipfs://: içerik adresi, ama yalnızca pinning ile

IPFS'te adres, içeriğin bir hash'idir, yani CID Trautwein vd. 2022. Tek bir piksel değişirse CID de değişir; dolayısıyla bir ipfs:// adresinin arkasındaki içeriği kimse sessizce değiştiremez. Bir CIDv0 Qm ile başlar ve 46 karakterdir, bir CIDv1 çoğunlukla bafy ile başlar. Denetleyici ikisini de çözer ve sürümü, codec'i ve hash uzunluğunu kontrol eder, çünkü kesilmiş bir CID ilk bakışta normal görünür.

Ancak IPFS kendiliğinden hiçbir şey saklamaz. Bir dosya, en az bir düğüm onu hazır tuttuğu sürece erişilebilir kalır Daniel ve Tschorsch 2022. Yaklaşık yarısı NFT'lere ait dört milyonu aşkın IPFS dosyası üzerinde yapılan bir ölçümde, birçok dosya ancak birkaç denemeden sonra çekilebildi ve dosyaların yüzde 95'ini 50 sağlayıcı sunuyordu Shi vd. 2024. Genel olarak da ağ, ününden çok daha merkezî ve buluta bağımlıdır Balduf vd. 2023. Bir pazar yerinin görseli göstermesi de pek bir şey kanıtlamaz: Çoğu zaman kendi kopyasını gösterir Guidi vd. 2025.

Aynı dosya, iki yazılış
CIDv0QmbWqxBEKC3P8tqsKc98xmWNzrzDtRLMiMPL8wBuTGsMnR
CIDv1bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

Bundan üç kural çıkar. En az iki bağımsız sağlayıcıda ya da kendi düğümünüzde pinleyin. Dosya bir klasördeyse (ipfs://…/1.png) klasörün tamamını pinleyin, çünkü klasör bloğu olmadan dosyayı kimse bulamaz. Ve ipfs:// yazın, asla gateway adresi yazmayın.

Gateway adresleri: en sık yapılan, önlenebilir hata

Birçok sözleşme ipfs:// yerine https://gateway.pinata.cloud/ipfs/… ya da https://ipfs.io/ipfs/… yazar. Böylece görüntü tam olarak tek bir işletmeciye bağlanır; erişilebilirlik ve bütünlük sıradan bir web sunucusunun seviyesine düşer Balduf vd. 2022. Bir gateway'in cevapları, CID'yi kimse yeniden hesaplamadığı sürece, yolda fark edilmeden değiştirilebilir bile Stöger vd. 2023. ERC-8495 taslağı kendi örneklemini veriyor: Gateway kullanan 204 token adresinden 113'ü yüklenmedi. Gateway'ler gerçekten de kayboluyor; Cloudflare, cloudflare-ipfs.com ve cf-ipfs.com'u 14.08.2024'te kapattı. Denetleyici yol ve alt alan adı (subdomain) gateway'lerini tanır ve ipfs:// biçimini önerir.

ar://: uzun süre için ödenmiş

Arweave farklı bir yaklaşım izler. Yükleme bir kez ücretlidir ve ağın verileri kalıcı olarak tutması amaçlanır Daniel ve Tschorsch 2022. Adres, büyük-küçük harfe duyarlı 43 karakterlik Base64URL işlem ID'si ile ar:// biçimindedir. ar:// arkasındaki daha kısa bir ad ise bir ArNS adıdır: pratik, ama yönlendirilebilir ve dolayısıyla değişebilir.

Sözleşmede meta veri: tuzaksız data:-URI'ler

En kalıcı meta veri, sözleşmenin kendisinin döndürdüğüdür. Özellikle pahalıya satılan sanat NFT'lerini inceleyen araştırmacılar, yeterince küçük olan her şey için tam olarak bunu önerir Balduf vd. 2022. Bu durumda tokenURI bir adres değil, JSON'u içeren bir data:-URI döndürür; görsel de çoğu zaman SVG olarak hemen içindedir. Bunun ne kadar gas tuttuğunu Gas hesaplayıcı hesaplar.

  • Kodlanmamış değil, Base64. data:application/json;base64,… önerilen biçimdir. Kodlanmamışsa tarayıcı ilk # işaretinde keser; “Pass #42” gibi bir ad ya da SVG'deki #fff gibi bir renk belgeyi bozar.
  • ;utf8 bir parametre değildir. data:application/json;utf8,… yaygındır ve okunur, ama RFC 2397 yalnızca nitelik=değer biçimini tanır, yani ;charset=utf-8. Base64 ile bu soru hiç ortaya çıkmaz.
  • Script'siz SVG. SVG çalıştırılabilir kod içerebilir Heiderich vd. 2011. Bu yüzden pazar yerleri onu yalnızca görsel olarak gösterir: Script'ler çalışmaz, harici yazı tipleri ve görseller yüklenmez, OpenSea SVG'yi PNG olarak önbelleğe alır. Bunlara bağlı olan her şey görüntüde eksik kalır.
  • Uygun medya türü. image alanına image/svg+xml, image/png vb. yazılır. Denetleyici bu bilgiyi gerçek baytlarla karşılaştırır.

Denetleyici her geçerli JSON için, rengin önündeki #, tırnak içindeki sayılar ya da gateway adresleri gibi güvenli düzeltmelerden sonra, kopyalanabilir Base64 sürümünü üretir.

ERC-1155: {id}, dosya adları ve çeviriler

Bir ERC-1155 sözleşmesi çoğu zaman tüm token'lar için aynı uri'yi döndürür, örneğin ipfs://bafy…/{id}.json. İstemci {id} yer tutucusunu token ID'siyle değiştirir: onaltılık, küçük harflerle, 0x olmadan ve 64 karaktere tamamlanmış olarak. Bu, JSON değerlerindeki {id} için de geçerlidir, örneğin image içinde.

En sık hata dosya adındadır: Dosyaların adı 1.json, 2.json'dur, pazar yeri ise 000…001.json arar. Denetleyiciye token ID'sini girin, tam adresi görürsünüz. Bu arada ERC-721'de {id} değiştirilmez.

ERC-1155 ayrıca kendine ait üç alan getirir: bölünebilir token'lar için decimals, istenen ek bilgiler için properties ve çeviriler için localization. localization'da uri, default ve locales zorunludur; uri, istemcinin dil koduyla değiştirdiği {locale} içerir.

{id} neye dönüşür
Token-IDDeğişim, 64 karakter
10000000000000000000000000000000000000000000000000000000000000001
42000000000000000000000000000000000000000000000000000000000000002a
25500000000000000000000000000000000000000000000000000000000000000ff
314592000000000000000000000000000000000000000000000000000000000004cce0

contractURI: tüm koleksiyonun meta verisi

Koleksiyon sayfasının adı, banner'ı ve açıklaması, contractURI işlevinin gösterdiği ayrı bir dosyadan gelir. Bunu ERC-7572 tanımlar; standart henüz bir taslak, OpenSea yine de okuyor. Zorunlu olan yalnızca name. Dosya değişirse sözleşme ContractURIUpdated() gönderir.

contractURI'nin arkasındaki dosyadaki alanlar
Alanİçinde neler olmalı
nameKoleksiyonun adı. Tek zorunlu alan.
symbolKoleksiyonun kısaltması.
descriptionKoleksiyonun açıklaması.
imageKoleksiyonun profil görseli.
banner_imageKoleksiyon sayfasının üstündeki banner görseli.
featured_imageÖne çıkan alanlar için görsel.
external_linkWeb siteniz. Dikkat: Burada alanın adı external_link, token'da external_url.
collaboratorsPazar yerlerinde koleksiyon sayfasını düzenleyebilen Ethereum adresleri.

collaborators içindeki adresleri denetleyici biçim ve EIP-55'e göre sağlama toplamı açısından kontrol eder. Büyük-küçük harf hatası neredeyse her zaman bir yazım hatasına işaret eder. Tek tek adresleri Ethereum adres denetleyici ile karakter karakter karşılaştırabilirsiniz.

Araştırmalar NFT meta verisi hakkında ne diyor

Denetleyicideki sınıflandırmalar, NFT ekosisteminde ve IPFS ağında yapılan ölçümlere dayanır. En önemli kararların arkasında beş bulgu var; kontrol notlarıyla tam liste aşağıda.

  • Meta veri adresleri değişir, web içerikleri kaybolur. Adreslerin yüzde 2,89'u üç ayda değişti, IPFS dışındaki içerikler daha sık kayboldu Das vd. 2022. Bu yüzden denetleyici https'i değişebilir olarak sınıflandırır.
  • Gateway adresleri IPFS'i bir web sunucusuna çevirir. Sabit yazılmış gateway'ler erişilebilirliği bulut seviyesine düşürür Balduf vd. 2022 ve cevapları yolda değiştirilebilir Stöger vd. 2023. Denetleyici her gateway adresini bir alternatifle birlikte bildirir.
  • IPFS verileri kendiliğinden tutmaz. Birçok NFT dosyası birkaç çekme denemesi gerektirdi Shi vd. 2024 ve pazar yerleri çoğu zaman kendi kopyalarını gösterir Guidi vd. 2025. Bu yüzden her ipfs:// adresinin yanında pinning notu bulunur.
  • Özellikler fiyatları etkiler. attributes'tan çıkan nadirlik, fiyat ve getiriyle ilişkilidir Mekacher vd. 2022. Bu yüzden denetleyici kenardaki tek bir boşluğu bile bildirir.
  • Hatalı meta veri token'ı içerikten ayırır. NIST'in NFT zafiyetleri raporu bunu böyle anlatır Mell ve Yaga 2024; bu yüzden geçersiz bir image küçük bir ayrıntı değil, bir hatadır.

Bir koleksiyonu sorunsuz başlatmanın yolu

  1. Depolama yerini belirleyin. Küçük meta veriler ve SVG sözleşmede data:-URI olarak, daha büyük görseller ve videolar IPFS'te ya da Arweave'de. https yalnızca değişmesi istenen içerikler için.
  2. Her token için bir dosya kontrol edin. Adı, görseli ve özellikleri buraya yapıştırın, hata ve uyarı kalmayana kadar. ERC-1155'te token ID'sini girin ve dosya adlarını karşılaştırın.
  3. Pinning'i çift yapın. İki bağımsız sağlayıcıda ya da kendi düğümünüzde, klasörün tamamını.
  4. Koleksiyon dosyasını yazın. name, görsel, banner ve external_link içeren contractURI'yi burada tekrar kontrol edin.
  5. Testnette inceleyin. Ana ağa geçmeden önce bir token mint edin ve bir pazar yerinin testnetinde ve iki cüzdanda inceleyin.
  6. Değişiklikleri bildirin. Bir şey değiştiğinde MetadataUpdate (ERC-4906), URI (ERC-1155) ya da ContractURIUpdated() gönderin.

Denetleyicinin sınırı nerede

  • Hiçbir şey çağırmaz. ipfs:// altındaki bir görselin hâlâ pinlenmiş olup olmadığını ya da bir sunucunun cevap verip vermediğini göremez. Çekmek için gateway adresini metin olarak verir.
  • Pazar yerleri farklılık gösterir. Kontrol, standartlara, OpenSea dokümantasyonuna ve ERC-8495 taslağına göre yapılır. Bazı cüzdanlar daha az okur, bazı pazar yerleri kendi ek alanlarını okur.
  • Değer ya da orijinallik hakkında yargı yok. Ad ve görsel istendiği gibi kopyalanabilir; sahteler çoğu zaman orijinaliyle aynı görsel adreslerini bile kullandı Das vd. 2022. Bir NFT'yi sözleşme adresinden ve token ID'sinden tanırsınız.

Blockchain projeleri için diğer araçlar Web3 araçları genel bakışında yer alıyor. Koleksiyonları, erişim token'larını ve etraflarındaki uygulamaları nasıl geliştirdiğimizi Web3 geliştirme sayfası anlatıyor.

Bu aracı bir yapay zekâ asistanı üzerinden kullanın

Claude ya da ChatGPT gibi Model Context Protocol (MCP) destekleyen asistanlar, bu sayfadaki hesabı baştan kurmak yerine doğrudan çağırabilir. Sunucu herkese açıktır, kayıt gerektirmez ve hiçbir şey kaydetmez. Cevapta her zaman bu sayfanın bağlantısı, verilerin tarihi ve sonucun sınırları yer alır.

Uç nokta
https://aureum-tech.com/mcp
Araç
werkzeug_nft_metadaten_pruefer
Aktarım
Streamable HTTP, salt okunur
Girdiler
AdZorunluAnlamı
metadatenevetKontrol edilecek içerik: metin olarak meta veri JSON'u, data:-URI olarak tokenURI, uri ya da contractURI dönüşü (medya türü application/json, Base64 ya da kodlanmamış) ya da yalnızca bir adres (ipfs://, ar://, https://); adres o zaman kontrol edilir ama çağrılmaz.
standardhayırHangi standarda göre: erc721 = token meta verisi (tokenURI), erc1155 = {id} ile token meta verisi (uri), erc7572 = koleksiyon meta verisi (contractURI), auto = alanlara göre algıla (varsayılan).
token_idhayırYalnızca ERC-1155: {id} değiştirilsin ve beklenen dosya adları gösterilsin diye ondalık (314592) ya da 0x ile onaltılık (0x4cce0) token ID.

Bir asistanın bu aracı çağırması gereken sorular

  • “Bu NFT meta verileri doğru mu, OpenSea özellikleri doğru gösteriyor mu?”
  • “tokenURI'm Base64 JSON içeren bir data:-URI döndürüyor. Bu geçerli mi?”
  • “URI {id}.json içeriyorsa ERC-1155 token 314592 için dosyanın adı ne olmalı?”
  • “Görsel için ipfs://Qm… mi yoksa Pinata'nın gateway adresi mi daha iyi?”

Bağlantının nasıl çalıştığını ve MCP'nin kendi işletmenizde neler yapabileceğini MCP entegrasyonları sayfasında okuyabilirsiniz.

NFT meta verisi hakkında sık sorulan sorular

OpenSea neden NFT'min görselini göstermiyor?

Çoğu zaman sorun image alanındaki adrestir. Sık görülen nedenler: alan yok ya da adı image_url; adres göreli (sadece “1.png”) ya da şifresiz (http); adres, cloudflare-ipfs.com gibi kapatılmış bir gateway'i gösteriyor (14.08.2024'ten beri); ya da kodlanmamış bir data:-URI bir # içeriyor ve tarayıcı bu işaretten sonrasını kesiyor. Görsel sadece değiştiyse çoğu zaman ERC-4906'ya göre MetadataUpdate olayı eksiktir; o zaman pazar yeri önbelleğindeki eski sürümü göstermeye devam eder.

ipfs:// mi, gateway adresi mi: Meta veriye hangisi yazılır?

Yazılması gereken ipfs://<CID> biçimidir, örneğin ipfs://bafy…/1.png. https://gateway.pinata.cloud/ipfs/… gibi bir gateway adresi dosyayı tek bir işletmeciye bağlar; o işletmeci devre dışı kalırsa, veriler IPFS ağında hâlâ dursa bile görsel yüklenmez. ERC-8495 taslağında, gateway kullanan 204 token adresinden 113'ü yüklenmedi. Gateway bağlantılarını görüntüleyen taraf kendisi oluşturur; denetleyici her gateway adresi için ipfs:// biçimini önerir.

attributes içinde sayıları ve tarihleri nasıl doğru yazarım?

Sayılar tırnak işaretsiz yazılır: "value": 5, "value": "5" değil. Tırnak içindeki sayı metin sayılır ve filtreler buna göre sıralama yapmaz. display_type number, boost_number, boost_percentage ve date olduğunda value bir sayı olmalıdır. Tarih, saniye cinsinden Unix zamanı olarak yazılır; 1.000.000.000.000 ve üzeri bir değer milisaniyeye benzer. max_value isteğe bağlıdır ve en az value kadar büyük olmalıdır.

ERC-1155'te {id} neye dönüşür?

{id} uri içinde ya da meta verideki bir değerde geçiyorsa, istemci onu token ID'siyle değiştirir: onaltılık (hex), küçük harflerle, 0x olmadan ve sıfırlarla 64 karaktere tamamlanmış olarak. 314592 numaralı token 000000000000000000000000000000000000000000000000000000000004cce0 olur. Yani dosyanın adı 000000000000000000000000000000000000000000000000000000000004cce0.json olmalıdır; standarda uyan bir istemci “314592.json” dosyasını bulamaz.

Bir koleksiyonun contractURI dosyasına neler yazılır?

ERC-7572'ye göre tek zorunlu alanı name olan bir JSON; ayrıca symbol, description, image, banner_image, featured_image, external_link ve collaborators. Web sitesine dikkat: Koleksiyonda alanın adı external_link, tek tek token'larda external_url. collaborators, pazar yerlerinde koleksiyon sayfasını düzenleyebilen Ethereum adresleridir. ERC-7572 henüz bir taslak, ama OpenSea onu okuyor.

Base64 mü, ;utf8 mi: data:-URI'nin hangi biçimi doğru?

İkisi de okunur, önerilen Base64'tür. Kodlanmamış bir data:-URI'de tarayıcılar # işaretinden sonraki her şeyi keser ve “Pass #42” gibi bir ad JSON'u bozar. Üstelik ;utf8, RFC 2397'ye göre geçerli bir parametre bile değildir; doğrusu ;charset=utf-8 olurdu. Denetleyici her geçerli JSON'dan kopyalanabilir Base64 sürümünü üretir.

background_color # ile mi yazılmalı?

Hayır, # olmadan. İstenen tam olarak altı onaltılık rakamdır, örneğin "E0F2FE". # olursa bazı istemciler işareti kendisi siler, bazıları rengi tamamen yok sayar. "fff" gibi kısa biçimler, renk adları ya da rgb() okunmaz.

NFT meta veri denetleyicinin sınırı nerede?

Yapıştırdığınız metni ERC-721, ERC-1155, ERC-7572 ve pazar yerlerinin belgelenmiş kurallarına göre kontrol eder. Hiçbir adresi çağırmaz; bu yüzden ipfs:// altındaki bir görselin hâlâ pinlenmiş olup olmadığını ya da bir sunucunun cevap verip vermediğini bilemez. Değer, orijinallik ya da içerik üzerindeki haklar hakkında bir şey söylemez. Sözleşme, meta veri ve depolamanın birbirine nasıl uyduğunu ve kalıcı pinlemeyi kimin üstleneceğini sizinle birlikte netleştirebiliriz.

Bu araç neye dayanıyor

Yukarıdaki referans değerler ve notlar bu 15 bilimsel çalışmaya dayanır. Her biri DOI kaydı ya da yayınevinin sayfası üzerinden kontrol edildi (en son 14 Kasım 2026'da): Çalışma var, geri çekilmemiş ve bulgusu bu soru için bugün de geçerli.

  1. Das, D.; Bose, P.; Ruaro, N. vd. (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

    Bulgu Sekiz büyük NFT pazar yeri ve milyonlarca alınıp satılan token üzerine inceleme: Meta veri adreslerinin yüzde 80,69'u IPFS'te değildi, yüzde 2,89'unda adres üç ay içinde değişti ve IPFS dışındaki içerikler daha sık kayboldu. Sahteler çoğu zaman orijinaliyle aynı görsel adreslerini kullandı.

    Araçta Araç https adreslerini değişebilir olarak sınıflandırır ve bir NFT'nin ad ve görselden değil, sözleşme ve token ID'sinden tanındığını hatırlatır.

  2. 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

    Bulgu Yüksek fiyatlı sanat NFT'lerine ait 51 sözleşmeden 19'u meta veri adresini en az bir kez değiştirdi. Birçoğu ipfs:// yerine sabit bir gateway adresi yazmıştı ve IPFS içeriklerinin yarısının bir hafta içinde ondan az sağlayıcısı vardı. Yazarlar sözleşmede (data:) ya da hash ile içerik adresli depolamayı öneriyor.

    Araçta Araç gateway adreslerini ipfs:// alternatifiyle birlikte uyarı olarak bildirir; data:-URI'ler en iyi seçenek sayılır; klasör CID'lerinde klasörün ve dosyanın erişilebilir kalması gerektiğini hatırlatır.

  3. 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

    Bulgu NFT'lerin merkezî hizmetlerden geçtiği neredeyse her nokta istismar edilebilir. Deneyde IPFS gateway'lerinin ve blockchain erişim noktalarının cevapları yolda değiştirilebildi.

    Araçta Aracın neden gateway adresi yerine ipfs:// istediğinin gerekçesi: İçerik hangi yoldan gelirse gelsin, yalnızca CID içeriğe karşı doğrulanabilir.

  4. 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

    Bulgu On koleksiyona ait NFT dosyalarının IPFS ağında iki hafta boyunca gözlemlenmesi: IPFS yüksek erişilebilirliği garanti etmez ve pazar yerleri çoğu zaman sözleşmedeki dosya yerine kendi kopyalarını gösterir.

    Araçta Sonuçtaki not bu yüzden var: Bir pazar yerinin görseli göstermesi, dosyanın ağda hâlâ erişilebilir olduğunu kanıtlamaz.

  5. Shi, R.; Cheng, R.; Han, B. vd. (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

    Bulgu IPFS'teki dört milyonu aşkın dosya üzerinde ölçüm: Yaklaşık yarısı NFT'lere ait, birçoğu ancak birkaç denemeden sonra çekilebiliyor. Çoğu bulut düğümü olan en büyük 50 sağlayıcı dosyaların yüzde 95'ini sunuyor.

    Araçta Pinning notunun dayanağı: ipfs://, yalnızca verileri hazır tutan düğümler kadar erişilebilirdir.

  6. Balduf, L.; Korczyński, M.; Ascigil, O. vd. (2023): The Cloud Strikes Back: Investigating the Decentralization of IPFS. Proceedings of the 2023 ACM Internet Measurement Conference (IMC ’23), s. 391–405

    Bulgu IPFS ağında topoloji, trafik ve sağlayıcılar üzerine büyük ölçüm: belirgin merkezîleşme ve buluttaki düğümlerin yüksek payı.

    Araçta Bu yüzden araç, NFT verilerini tek bir sağlayıcı yerine birbirinden bağımsız en az iki sağlayıcıda pinlemeyi önerir.

  7. Trautwein, D.; Raman, A.; Tyson, G. vd. (2022): Design and evaluation of IPFS: a storage layer for the decentralized web. Proceedings of the ACM SIGCOMM 2022 Conference, s. 739–752

    Bulgu IPFS'in yapısını ve ölçümünü anlatır: 2700'ü aşkın ağda ve 152 ülkede düğümü olan bir eşler arası (peer-to-peer) ağ üzerinden içerik adresli depolama; yayımlama ve çekme birçok uygulama için yeterince hızlı.

    Araçta CID açıklamasının temeli: Adres içeriğin bir hash'idir, bu yüzden araç yapısını titizlikle kontrol eder.

  8. 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

    Bulgu IPFS, Swarm, Hypercore, SAFE, Storj ve Arweave'i karşılaştırır. IPFS verileri yalnızca düğümler onları gönüllü olarak ya da ücret karşılığında (örneğin Filecoin üzerinden) tuttuğu sürece saklar; Arweave verileri kalıcı olarak saklamayı hedefler ve yüklemeyi ücretlerle ödetir.

    Araçta Depolama yerleriyle ilgili notlarda ipfs:// ile ar:// arasındaki farkı açıklar.

  9. Mell, P.; Yaga, D. (2024): Non-fungible token security. National Institute of Standards and Technology, NIST IR 8472

    Bulgu NFT teknolojisini açıklar ve 27 olası zafiyet sayar. Hatalı kaydedilmiş meta veriler bir NFT'yi temsil ettiği şeyden ayırıp değersiz kılabilir; harici bir eşleştirme tablosunu kontrol eden kişi token'ları başka içeriğe bağlayabilir.

    Araçta Aracın eksik ya da geçersiz görsel ve meta veri adreslerini neden hata olarak bildirdiğinin ve değişebilir depolama yerlerini neden ayrıca belirttiğinin gerekçesi.

  10. Mekacher, A.; Bracci, A.; Nadini, M. vd. (2022): Heterogeneous rarity patterns drive price dynamics in NFT collections. Scientific Reports 12, makale 13890

    Bulgu 410 koleksiyonda 3,7 milyon işlem: Bir NFT'nin okunabilir özelliklerinden hesaplanan nadirlik, fiyat, alım satım sıklığı ve getiriyle belirgin biçimde ilişkilidir.

    Araçta Özellikler yan konu değildir. Bu yüzden araç, filtreleri ve nadirliği bozdukları için tırnak içindeki sayıları, kenardaki boşlukları ve aynı özellik türünün farklı yazılışlarını bildirir.

  11. Nadini, M.; Alessandretti, L.; Di Giacinto, F. vd. (2021): Mapping the NFT revolution: market trends, trade networks, and visual features. Scientific Reports 11, Art. 20902

    Bulgu 4,7 milyon NFT'nin 6,1 milyon satışının değerlendirilmesi (2017 ile 2021 arası): Koleksiyonlar görsel olarak bütünlüklüdür ve satış geçmişinin yanında fiyatı en iyi görsel özellikler tahmin eder.

    Araçta Görsel, alıcıların gördüğü şeydir. Bu yüzden araç eksik ya da yüklenemeyen bir image'ı küçük bir ayrıntı olarak değil, uyarı olarak bildirir.

  12. White, B.; Mahanti, A.; Passi, K. (2022): Characterizing the OpenSea NFT Marketplace. Companion Proceedings of the Web Conference 2022 (WWW ’22), s. 488–496

    Bulgu En çok kullanıcıya ve en yüksek ciroya sahip pazar yeri OpenSea'de 2019 ile 2021 arasında 5,25 milyon satış; büyümeyi az sayıda çok aktif kullanıcı sürüklüyor.

    Araçta Bu yüzden araç ERC standartlarının yanında OpenSea'nin belgelediği alanları da kontrol eder: Bunlar, diğer pazar yerlerinin uyduğu kurallardır.

  13. Klein, M.; Van de Sompel, H.; Sanderson, R. vd. (2014): Scholarly Context Not Found: One in Five Articles Suffers from Reference Rot. PLoS ONE 9 (12), e115253

    Bulgu 3,5 milyon bilimsel makaleden bir milyonu aşkın web bağlantısı: Her beş makaleden biri bozulmuş bağlantılardan ya da değişmiş içeriklerden etkileniyor, web bağlantısı olan makalelerde ise ondan yedisi.

    Araçta https adreslerindeki notun dayanağı: Web adresleri, kötü niyet olmasa bile zamanla kaybolur ya da içerikleri değişir.

  14. 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

    Bulgu SVG dosyaları sıradan görseller değildir; HTML, JavaScript ve başka çalıştırılabilir parçalar içerebilir. Tarayıcılar özel hazırlanmış SVG'leri çoğu zaman yanlış işledi.

    Araçta Bu yüzden pazar yerleri SVG'yi yalnızca script'siz bir görsel olarak gösterir; araç da bir SVG orada çalışmayan script'ler, olay nitelikleri ya da harici bağlantılar içeriyorsa uyarır.

  15. 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), makale 189

    Bulgu Meta verisi mint edildikten sonra sabit kalan statik NFT'lerden değişen dinamik NFT'lere geçişe genel bakış; teknik güçlükler özellikle meta verilerde ve onların değişiminde yatıyor.

    Araçta Değişebilir meta veriler için araç, pazar yerleri değişikliği alsın diye ERC-4906'daki olayı ya da ERC-1155'teki URI'yi belirtir.

Standartlar, resmî kurumlar ve üretici bilgileri

Pzt–Cum 8–17

Bir koleksiyon ya da erişim token'ları mı çıkarıyorsunuz? Kopyaladığınız sonucu bize gönderin. Sözleşmeyi, meta veriyi ve depolama yerini, pazar yerleri ve cüzdanlar her şeyi doğru gösterecek şekilde bir araya getiriyor ve pinning'i kuruyoruz, Rodewisch'ten.

+49 3744 4399760[email protected]

Pzt–Cum 8–17 · Straße der Jugend 5, 08228 Rodewisch

NFT projenizi görüşelim
+49 3744 4399760Pzt–Cum 8–17
ArayınGeri arama

PARÇA LİSTESİ · SAYFA 1/1

Bu sayfa nelerden oluşuyor

Değerler sayfa oluşturulurken ölçüldü. JavaScript açıksa tarayıcınız canlı olarak yeniden ölçer.

SIRAPARÇATÜRBOYUT
01index.htmlBelge≈ 29 kB
02styles.cssStil dosyası≈ 20 kB
03scripts.jsKomut dosyası≈ 13 kB
04archivo-variable.woff2Yazı tipi≈ 58 kB
05ibm-plex-mono.woff2Yazı tipi≈ 30 kB
06favicon.svgGrafik< 1 kB

Reklam ya da analiz çerezi: yok. Siz onay vermeden bu site, içerik dağıtım hizmetimiz Cloudflare dışında yabancı sunuculardan hiçbir şey yüklemez; yazı tipleri, komut dosyaları ve grafikler bizde durur. Sizin IT sisteminizi de böyle kuruyoruz.

ÇALIŞMA SAATLERİ DIŞINDA

Yine de çekinmeden arayın

Normalde pazartesiden cumaya 8–17 arası ofisteyiz.

Numara akşamları ve hafta sonu da bize yönlendirilir, çoğu zaman da telefonu açan biri olur. Ama bunun sözünü veremeyiz.

Kimseye ulaşamazsanız kısa bir sesli mesaj bırakın: adınız, numaranız ve konu. En kısa zamanda, en geç bir sonraki iş günü sizi geri ararız.

Görüşme ücretsizdir. Çalışma saatleri dışında birinin hemen ilgilenmesi gerekiyorsa fiyat listesindeki ek ücret uygulanır.

Şimdi arayın+49 3744 4399760

Yazmayı mı tercih edersiniz? İletişim formunu kullanın ya da [email protected] adresine yazın. Mesajınızı bir sonraki iş günü okuruz.

TEŞHİS · AT-K2

Nasıl yardımcı olabiliriz?

↵ SEÇESC KAPATBİZİ ARAYIN: +49 3744 4399760

Kişisel ayarlar

Hangi hizmetler yüklenebilsin?

Teknik olarak gerekli

Burada verdiğiniz karar ile renk şeması ve hareket ayarlarınız. Bu bilgiler cihazınızda küçük kayıtlar olarak kalır ve hiçbir zaman bir sunucuya gönderilmez. Sitenin çalışması için gereklidir, bu yüzden kapatılamaz.