Solana Token Metadata Güncelleme: Ne Zaman, Nasıl, Neden

Solana token metadata güncelleme ihtiyacının arkasında genelde aynı küçük şok vardır: logoyu değiştirdin, sosyal linki düzelttin, ama Solscan hâlâ eski ismi gösteriyor. Burada bir hata yok. Sen tek bir "metadata" sanırken aslında iki ayrı katman var ve insanların çoğu bu ikisini karıştırır. Önce bu farkı oturtalım, sonra neyi nasıl ve kaça düzelteceğin netleşir.

Metadata, bir token'ın herkese açık kimlik bilgisidir: ismi, sembolü (kısa kodu, ticker), logosu, açıklaması ve linkleri. Bu bilgiler tek bir yerde durmaz. Bir kısmı on-chain tutulur, yani doğrudan Solana ağına yazılır; orası cüzdanların güvendiği, değiştirmesi zor olan kayıt yeridir. Diğer kısmı off-chain bir dosyada, internette herhangi bir yerde duran sıradan bir dosyada durur.

Şöyle düşün: token'ının bir kimlik kartı var. Kartın ön yüzünde isim ve sembol yazıyor ve bu ön yüz zamanla mühürleniyor. Kartın üstünde bir de adres var, o adres düzenleyebileceğin bir klasöre işaret ediyor. Logoyu, açıklamayı, sosyal linkleri o klasörden değiştirirsin. Logoyu yenilediğinde dosyayı düzenlersin, ama isim on-chain durduğu için ona dokunmamış olursun. Solscan'de eski ismin kalmasının sebebi tam olarak budur.

Token metadata nedir, hangi katmanda ne durur?

Token ilk oluşturulduğunda metadata'sını taşıyan sistem Metaplex Token Metadata'dır. Bunu basitçe "çoğu Solana token'ının ismini, sembolünü ve bir linki taşımak için kullandığı standart" diye düşün. Bu standart on-chain tarafa üç şey yazar: isim, sembol ve bir web adresi (yani on-chain duran ve bir dosyaya işaret eden link, kısaca URI). Cüzdanlar ve gezginler önce buraya bakar. Bu üçünden birini değiştirmek on-chain bir düzenlemedir.

O web adresinin gösterdiği dosya ise off-chain durur. İçinde logo görseli, açıklama, web sitesi ve sosyal linkler (Twitter/X, Telegram, Discord) bulunur. Bunlardan birini değiştirmek, dosyayı aynı adrese yeniden yüklemekten ibarettir. Zincire dokunmaz, ücretsizdir. Bir tarafta mühürlü bir kimlik kartının ön yüzü var, öbür tarafta o kartın işaret ettiği, istediğin zaman güncelleyebileceğin bir klasör. Aşağıdaki tablo her alanın nerede durduğunu ve nasıl değiştirileceğini gösteriyor.

Ne zaman güncellersin ve kaça mal olur?

Dört tipik durum var ve maliyetleri birbirinden çok farklı.

• Logo yenileme. Yeni bir logo çizdirdin. Görsel dosyada durduğu için dosyayı aynı adrese yeniden yüklersin, işin biter. On-chain'e dokunmaz, ücretsizdir.
• Sosyal link değişimi. Telegram grubun taşındı, Twitter hesabın değişti, Discord açtın. Bunlar da dosyada olduğu için bedavadır.
• İsim veya sembol düzeltme. Lansmanda ismi yanlış yazdın ya da marka adını değiştirdin. Bunlar on-chain alanlardır, düzeltmek için on-chain metadata güncelleme aracını kullanırsın, ücreti 0.2 SOL.
• Dosyayı kalıcı depoya taşıma. Dosyan geçici bir yerde duruyorsa ve onu güvenli bir yere taşımak istiyorsan, yeni adresi on-chain kayda yazman gerekir. Bu da on-chain bir düzenlemedir. Neden önemli olduğuna birazdan geliyoruz.

Yani küçük kozmetik düzeltmeler bedava, ağ kaydına dokunan üç alan ise 0.2 SOL. Bugün SOL yaklaşık 67 dolar olduğu için bu kabaca 13 dolar civarına denk geliyor; SOL fiyatı oynadıkça bu rakam da değişir.

j.tools üzerinde adım adım nasıl güncellersin?

Pratik cevap dört adımdan oluşur ve hepsi formdan ilerler.

1. Önce durumu kontrol et. Token'ın güncel durumunu okuyan snapshot aracı token'ın şu anki metadata'sını gösterir ve hâlâ düzenlenebilir mi, yani düzenleme izni hâlâ bir cüzdanda duruyor mu söyler. Bu araç tamamen ücretsiz. İzin daha önce kaldırıldıysa hiçbir şey değiştiremezsin, o yüzden ilk iş bunu öğrenmektir.
2. Doğru cüzdanı bağla. On-chain tarafı sadece update authority'yi, yani metadata'yı sonradan düzenleme iznini elinde tutan cüzdan değiştirebilir. Bunu hâlâ düzenlenebilen bir tabelanın anahtarını elinde tutmak gibi düşün. O anahtar kimdeyse değişikliği o yapar; başka bir cüzdanla giriş yaparsan araç değişikliği yazamaz.
3. Yeni değerleri girip imzala. Yeni ismi, sembolü veya web adresini forma yazar, kendi cüzdanınla onaylarsın. Ücret 0.2 SOL.
4. Sonradan doğrula. Ücretsiz snapshot aracıyla tekrar bak, ismin güncellendiğini gör. Logo için sabırlı ol: cüzdanlar görselleri 10 ila 30 dakika önbellekte tutabilir, bu yüzden yeni görselin hemen görünmemesi normaldir.

Update authority kaldırma: sonsuza kadar kilitlemeli misin?

İşin tek yönlü kapısı burada. Düzenleme iznini kalıcı olarak silebilirsin, böylece metadata bir daha asla değiştirilemez. Buna kilitleme (revoke / lock) denir; kilitlenmiş metadata artık immutable, yani sonsuza kadar sabittir. Alıcılar ve borsa listeleme kontrol listeleri "metadata kilitli" durumunu genelde bir güven işareti sayar.

j.tools'da iki yol var. Sadece metadata'yı kilitleyen revoke aracı yalnızca düzenleme iznini siler, coin basma (mint authority, daha fazla coin üretme izni) ve hesap dondurma (freeze authority, sahipleri dondurma izni) izinlerine dokunmaz; ücreti 0.1 SOL. Üç izni birden kapatan make-immutable aracı ise düzenleme, basma ve dondurma izinlerini tek seferde kaldırır; ücreti 0.2 SOL. Sadece basma veya sadece dondurma iznini ayrı bırakmak istersen coin basma iznini bırakma aracı ve hesap dondurma iznini bırakma aracı da 0.1 SOL'dür.

Kilitlemek mantıklıdır: marka oturduysa, token 6 aydan eski ve istikrarlıysa, dosyan kalıcı depodaysa, bir borsa bunu senden istiyorsa. Beklemek daha doğrudur: hâlâ marka değiştiriyorsan, dosyan kaybedebileceğin bir host'taysa, ileride bir isim değişikliği veya v2 ihtimali varsa.

Kilitlemeden önceki tek kural: off-chain dosyan kalıcı bir yerde durmalı. Seçenekler Arweave (bir kere öde, sonsuza kadar saklasın) ya da pinlenmiş IPFS (dosyanı paylaşımlı bir ağda tutan, abonelikle erişilebilir kılan bir "pinning" servisi). Klasik felaket şudur: ekip lansmanda dosyayı hızlı ve bedava bir host'a atar, haftalar sonra metadata'yı kilitler, aylar sonra host'un süresi dolar ya da alan adı düşer. Web adresi artık 404 (sayfa bulunamadı) döndürür. İsim hâlâ görünür çünkü on-chain mühürlüdür, ama logo ve açıklama kaybolur. Düzenleme izni de gittiği için kimse onu yeni bir dosyaya bağlayamaz. Token her cüzdanda kalıcı olarak bozulur. Doğru sıra şu: önce dosyayı Arweave veya pinlenmiş IPFS'e taşı, on-chain adresi yeni kalıcı linke çevir, iki ayrı bilgisayardan birkaç gün açıldığını doğrula, sonra kilitle.

j.tools nedir?

j.tools, 40'tan fazla kodsuz aracı olan bir Solana araç setidir: metadata güncelleme, token oluşturma, izin kilitleme, bir token'ın durumunu okuma ve daha fazlası. Türkçe ve İngilizce çalışır. Geliştirici olmayan biri her şeyi basit bir formdan yapsın diye kurduk ve güvenlik tarafında nettir: özel anahtarını asla istemez, kendi cüzdanını bağlarsın, her işlemi kendin onaylarsın. Token'ını sıfırdan kuruyorsan standart bir SPL token oluşturabilir ya da yerleşik metadata taşıyan Token-2022 formatında bir token üretebilirsin (Token-2022, metadata'yı kendi içinde taşıyan daha yeni bir Solana token biçimidir ve farklı bir güncelleme yolu izler; bu yazı çoğu token'ın kullandığı klasik SPL + Metaplex akışını anlatır).

Sık yapılan hatalar

• Dosyayı düzenleyip on-chain ismin de değiştiğini sanmak. Logoyu yenilemek isme dokunmaz. İsim ağ kaydında durur, ayrı bir güncelleme ister.
• Dosya geçici host'tayken kilitlemek. Bu, az önceki 404 felaketinin kapısıdır. Host düşünce token kalıcı bozulur ve düzeltme şansın kalmaz. Önce kalıcı depoya taşı.
• Önbelleği beklememek. Logo değişmedi diye işlemi tekrar etme. Cüzdanlar 10-30 dakika eski görseli gösterebilir, "olmadı" diye paniğe gerek yok.
• İsmi dosyadan değiştirmeye çalışmak. Dosyadaki isim alanı görsel amaçlıdır, cüzdanların okuduğu isim ve sembol on-chain'dedir. İsim için güncelleme aracını kullan.

Benzer rehberler için token yönetimi rehberleri kategorisine göz atabilir, konuyla ilgili diğer yazılar için Solana etiketli içerikleri inceleyebilirsin.

Sık sorulanlar

Lansmandan sonra bir Solana token'ının ismini değiştirebilir miyim? Evet, düzenleme izni hâlâ bir cüzdandaysa. İsim on-chain bir alandır, güncelleme aracıyla 0.2 SOL'e değiştirilir. İzin daha önce kaldırıldıysa isim sonsuza kadar sabittir, artık kimse değiştiremez.

Token'ım neden hâlâ eski logoyu gösteriyor? İki sebepten biri. Ya logoyu içeren dosyayı henüz aynı adrese yüklemedin, ya da yükledin ama cüzdan eski görseli 10-30 dakika önbellekte tutuyor. İkincisi kendiliğinden geçer, biraz bekleyip tekrar bak.

Token metadata güncellemek kaça mal olur? Logo, açıklama ve linkler dosyada olduğu için ücretsizdir. İsim, sembol veya web adresi on-chain olduğu için 0.2 SOL. Sadece metadata'yı kilitlemek 0.1 SOL, üç iznin hepsini birden kilitlemek 0.2 SOL.

Token'ımı immutable yapmalı mıyım? Markan oturduysa ve dosyan Arweave ya da pinlenmiş IPFS'te kalıcıysa evet, güven işareti olur. Hâlâ marka değiştiriyorsan ya da dosyan geçici bir yerdeyse bekle, çünkü kilitlemek tek yönlü kapıdır.

Update authority nedir? Bir cüzdanda duran ve metadata'nın on-chain kısmını (isim, sembol, web adresi) düzenleme iznidir. O cüzdan bu üç alanı değiştirebilir. İzni kaldırırsan metadata bir daha asla değiştirilemez.

Kısa kapanış

İsim, logo veya link güncellemek ucuz ve istediğin kadar tekrarlanabilir bir iş. Kilitleme ise tek yönlü bir kapı. O yüzden sıralama hep aynı: önce dosyayı Arweave ya da pinlenmiş IPFS gibi kalıcı bir yere taşı, ücretsiz snapshot aracıyla durumu kontrol et, her şeyin oturduğundan emin ol, ondan sonra kilitle.