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
01 / DENETLEYİCİ
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.
Sonuç
Önizleme, aşağı yukarı bir pazar yerindeki gibi
Bulgular
Adresler ve depolama yerleri
| Alan | Sınıflandırma | Adres |
|---|
Hiçbir şey çağrılmaz. Dosyayı kendisi görmek isteyen, belirtilen gateway adresini tarayıcıda açar.
Düzeltilmiş sürüm
JSON'u göster
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.
02 / SÜREÇ
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.
Token meta verisinin alanları
| Alan | Köken | İçinde neler olmalı |
|---|---|---|
| name | ERC-721, ERC-1155 | Token'ın adı, düz metin. Yoksa pazar yerleri çoğunlukla sadece “#123” gösterir. |
| description | ERC-721, ERC-1155 | Açıklama. OpenSea Markdown okur, ham HTML gösterilmez. |
| image | ERC-721, ERC-1155 | Listeler 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_url | OpenSea, ERC-8495 taslağı | Görselin yerine gösterilen video, ses, 3D model ya da HTML sayfası. Görsel, yedek olarak yine zorunludur. |
| external_url | OpenSea, ERC-8495 taslağı | Pazar yerinden kendi sayfanıza bağlantı, tercihen https. |
| background_color | OpenSea, ERC-8495 taslağı | Görselin arkasındaki arka plan rengi: # olmadan altı onaltılık rakam, örneğin E0F2FE. |
| attributes | OpenSea, 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. |
| decimals | ERC-1155 | Miktarın gösterimi için ondalık basamak sayısı, 0 ve üzeri tam sayı. |
| properties | ERC-1155 | Nesne olarak istediğiniz ek bilgiler. Pazar yerleri filtre olarak yalnızca attributes içindeki özellikleri gösterir. |
| localization | ERC-1155 | Çeviriler: {locale} içeren uri, default ve locales zorunludur. |
| image_data | Eski alan (OpenSea 2018) | image yerine ham SVG. Artık sadece image yoksa okunur; kullanmayın. |
| youtube_url | Eski 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.
03 / ÖZELLİKLER
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.
| attributes içindeki kayıt | Görüntü | Tür |
|---|---|---|
| {"trait_type":"Renk","value":"Altın"} | Renk: Altın | Metin |
| {"trait_type":"Seviye","value":3,"max_value":5} | Seviye: 3 / 5 | Sayı |
| {"display_type":"number","trait_type":"Puan","value":12} | Puan: 12 | Sayı |
| {"display_type":"boost_number","trait_type":"Dayanıklılık","value":40} | Dayanıklılık: +40 | Bonus |
| {"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.2027 | Tarih |
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.
04 / DEPOLAMA YERLERİ
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.
| Yazım | Sınıflandırma | Neden |
|---|---|---|
data:application/json;base64,… | iyi | Sö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> | iyi | Arweave, kalıcı olarak ödenmiş depolama. ID 43 karakter Base64URL'dir. |
ar://<Name> | dikkatli kullanın | ArNS adı: başka yere yönlendirilebilen bir işaretçi, yani değişebilir. |
https://… | dikkatli kullanın | Kendi sunucu ya da bulut. Kimse ödemeyi sürdürmediğinde içerik değişebilir ya da kaybolabilir. |
https://<Gateway>/ipfs/<CID> | dikkatli kullanın | IPFS içeriğini tek bir işletmeciye bağlar. ipfs://<CID> yazmak daha iyi. |
ipns://… | dikkatli kullanın | IPFS'te değişebilen ad. Yalnızca değişmesi istenen içerikler için. |
web3://…, onchain:… | dikkatli kullanın | Bir 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.png | yanlış | Ş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.
| CIDv0 | QmbWqxBEKC3P8tqsKc98xmWNzrzDtRLMiMPL8wBuTGsMnR |
|---|---|
| CIDv1 | bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi |
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.
05 / ONCHAIN
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.
06 / ERC-1155
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.
| Token-ID | Değişim, 64 karakter |
|---|---|
| 1 | 0000000000000000000000000000000000000000000000000000000000000001 |
| 42 | 000000000000000000000000000000000000000000000000000000000000002a |
| 255 | 00000000000000000000000000000000000000000000000000000000000000ff |
| 314592 | 000000000000000000000000000000000000000000000000000000000004cce0 |
07 / KOLEKSİYON
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.
| Alan | İçinde neler olmalı |
|---|---|
| name | Koleksiyonun adı. Tek zorunlu alan. |
| symbol | Koleksiyonun kısaltması. |
| description | Koleksiyonun açıklaması. |
| image | Koleksiyonun profil görseli. |
| banner_image | Koleksiyon sayfasının üstündeki banner görseli. |
| featured_image | Öne çıkan alanlar için görsel. |
| external_link | Web siteniz. Dikkat: Burada alanın adı external_link, token'da external_url. |
| collaborators | Pazar 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.
08 / ARAŞTIRMA
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.
09 / YÖNTEM
Bir koleksiyonu sorunsuz başlatmanın yolu
- 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.
- 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.
- 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ı.
- Koleksiyon dosyasını yazın. name, görsel, banner ve external_link içeren contractURI'yi burada tekrar kontrol edin.
- Testnette inceleyin. Ana ağa geçmeden önce bir token mint edin ve bir pazar yerinin testnetinde ve iki cüzdanda inceleyin.
- 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.
10 / YAPAY ZEKÂ ASİSTANLARI İÇİN
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
| Ad | Zorunlu | Anlamı |
|---|---|---|
metadaten | evet | Kontrol 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. |
standard | hayır | Hangi 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_id | hayır | Yalnı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.
11 / SIK SORULAN SORULAR
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.
12 / ÇALIŞMALAR VE KAYNAKLAR
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.
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.
doi.org/10.1145/3548606.3559342 · Konferans bildirisi
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.
doi.org/10.1145/3565383.3566106 · Konferans bildirisi
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.
doi.org/10.1007/978-3-031-47751-5_11 · Konferans bildirisi
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.
doi.org/10.1109/iscc65549.2025.11326542 · Konferans bildirisi
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.
doi.org/10.1145/3656015 · Bilimsel dergi
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.
doi.org/10.1145/3618257.3624797 · Konferans bildirisi
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.
doi.org/10.1145/3544216.3544232 · Konferans bildirisi
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.
doi.org/10.1109/COMST.2022.3143147 · Derleme makalesi
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.
doi.org/10.6028/NIST.IR.8472 · Araştırma raporu
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.
doi.org/10.1038/s41598-022-17922-5 · Bilimsel dergi
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.
doi.org/10.1038/s41598-021-00053-8 · Bilimsel dergi
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.
doi.org/10.1145/3487553.3524629 · Konferans bildirisi
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.
doi.org/10.1371/journal.pone.0115253 · Bilimsel dergi
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.
doi.org/10.1145/2046707.2046735 · Konferans bildirisi
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.
doi.org/10.3390/fi15060189 · Derleme makalesi
Standartlar, resmî kurumlar ve üretici bilgileri
- ERC-721: Non-Fungible Token Standard (Final) · Final, kontrol tarihi 14.11.2026
- ERC-1155: Multi Token Standard, Metadata bölümü (Final) · Final, kontrol tarihi 14.11.2026
- ERC-7572: Contract-level metadata via contractURI() (taslak) · Draft, kontrol tarihi 14.11.2026
- ERC-4906: EIP-721 Metadata Update Extension (Final) · Final, kontrol tarihi 14.11.2026
- ERC-8495: Token Metadata JSON Schema (taslak, Pull Request 2163) · Taslak, açılış 10.11.2026, 12.11.2026 tarihli sürüm, henüz kabul edilmedi; buradan gelen kurallar yalnızca uyarı olarak
- OpenSea Developer Docs: Media and traits, Metadata storage, Contract-level metadata · Güncelleme 12.11.2026
- RFC 2397: The "data" URL scheme · 1998
- RFC 8259: The JavaScript Object Notation (JSON) Data Interchange Format · 2017
- multiformats/cid: Content Identifier, Multibase ve Multicodec tablosuyla · kontrol tarihi 14.11.2026
- IPFS Docs: Best Practices for Storing NFT Data using IPFS · kontrol tarihi 14.11.2026
- Arweave HTTP API: id alanı (Base64URL, imzanın SHA-256'sı) · kontrol tarihi 14.11.2026
- Cloudflare-Blog: Cloudflare's public IPFS gateways and supporting Interplanetary Shipyard · 14.05.2024
- EIP-55: Mixed-case checksum address encoding · Final
13 / DİĞER ARAÇLAR
Aklınıza takılan bir soru mu kaldı?
- AT-W32 · İşletme
Blockchain uygunluk kontrolü
Projeniz için gerçekten blockchain mi gerekiyor, yoksa bir veritabanı yeter mi? - AT-W33 · İşletme
MiCA kontrolü
Token'ınız MiCA kapsamına giriyor mu, bundan hangi yükümlülükler doğuyor? - AT-W34 · Bireysel ve işletme
Gas hesaplayıcı
Ethereum, Arbitrum, Optimism, Base ya da Polygon üzerinde bir işlem ne kadar tutar? - AT-W35 · Bireysel ve işletme
Ethereum adres denetleyici
Bu Ethereum adresi geçerli mi, doğru yazılmış mı? EIP-55'e göre sağlama toplamı ve iki adresin karşılaştırması. - AT-W36 · İşletme
Selector ve topic hesaplayıcı
Bu Solidity imzasına hangi fonksiyon selector'ı ya da event topic'i karşılık gelir, ya da tersi? - AT-W37 · İşletme
Calldata çözücü
Bu işlem ne yapıyor? İmzalamadan önce calldata'yı okunur hâle getirin.
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