Arc üzerinde holder listesi nasıl çıkarılır: hem token hem de koleksiyon için
Bir airdrop başlatmadan, allowlist kurmadan ya da içeridekilere erişimi kapatmadan önce cevaplanması gereken bir soru var: token ya da koleksiyonun şu an kimin elinde olduğu. İşte tam bu yüzden Arc üzerinde holder listesi nasıl çıkarılır bilmek gerekir; böylece bir token veya NFT için tüm holder’ları içeren bir dosyayı indirebilirsin.
İster token için olsun ister NFT için, süreç aynı. Netleştirmen gereken tek şey hangi snapshot işlemini yapman gerektiği ve bundan en kolay nasıl faydalanacağın. Bu rehberde nasıl yapıldığını anlatıyorum. Doğrudan başlayalım.
Arc üzerinde bir token için holder listesi adım adım nasıl çıkarılır
Smithii tarafından geliştirilen Arc için Token Snapshot aracı, sorguyu doğrudan on-chain yapar; dışarıdan bir indexer’a bağımlı değildir ve token tokenının herhangi bir listede yer almasına da gerek yoktur. Kontrat adresi yeterlidir, dolayısıyla ağdaki herhangi bir ERC-20 ile çalışır, senin olsun olmasın fark etmez. Arayüzü şöyle görünür:

Kontrat adresini bulduktan sonra beş adım kalıyor:
- Ağa bir wallet bağla. Ücreti ödemek ve aracın geçmişini kaydedebilmesi için gerekli.
- Token Snapshot sekmesinde kal, ERC-20 ile çalışan sekme burası.
- Kontratı gir: adresi yapıştır ya da isimle ara. Alanın altında ağda en aktif tokenlara doğrudan erişim kısayolları var.
- Take Snapshot butonuna bas ve ödemeyi onayla. Tutar, imzalamadan hemen önce butonun üstünde görünür.
- Okumanın bitmesini bekle ve adresleri içeren CSV dosyasını indir.
Arc üzerinde bir koleksiyonun holder listesi kod yazmadan nasıl çıkarılır
İkinci sekme Arc koleksiyonları için NFT Snapshot aracıdır ve üstteki sekmelerden bir öncekiyle arasında geçiş yapılır. Aynı tek bilgiyi ister, kontrat adresi, farkı yalnızca burada ERC-721 ile çalışması. Bir NFT sahipliği herkese açık bilgi olduğundan, Arc’ta var olan her koleksiyonla çalışır. Şöyle görünür:

Sıralama bir öncekine göre pek değişmiyor:
- wallet’ını Arc’a bağla. Bu olmadan ne ücreti kapatabilirsin ne de çekim kayıt altına girer.
- NFT Snapshot sekmesine geç, iki sekmenin ikincisi. Birincisi ERC-20 okur, koleksiyonları tanımaz.
- Arama alanına ERC-721 contract adresini yapıştır ya da koleksiyonun adını yazıp listeden seç.
- Take Snapshot butonuna bas ve ödemeyi imzala. Toplam tutar, sen onaylamadan önce butonun altında yazıyor.
- Okuma bittiğinde CSV’yi indir. Ayrıca ödemeyi yaptığın wallet ile ilişkili kalıyor, sonradan tekrar erişmen gerekirse diye.
Her liste sana ne getiriyor
İki sekmenin birbirinden ayrıştığı yer burası. İkisi de sadece adres dışa aktarıyor ama satırları oluşturma kriteri aynı değil, ve dosyanın ne işine yarayacağını bu belirliyor.
| Token Snapshot (ERC-20) | NFT Snapshot (ERC-721) | |
|---|---|---|
| Bir satır ne demek | token bakiyesi olan bir adres | NFT’dan en az bir parçaya sahip bir adres |
| Tekrarlar | Sahip başına bir tane | Sahibe göre tekilleştirilmiş |
İkinci sütundaki bu tekilleştirmeyi iyi anlamakta fayda var, çünkü çoğu kişiyi şaşırtıyor. Koleksiyondan kırk parçası olan bir wallet tek satır kaplar, tek parçası olanla tıpatıp aynı şekilde, ve dosyada hangisine baktığını söyleyecek hiçbir şey yok.
Bir allowlist için bu yaklaşım doğru: amaç kişi başına bir yer ayırmak ve kırk adet biriktirmiş biri kırk yer almamalı. Herkesin sahip olduğu miktara orantılı ödül vermek istiyorsan bu bir kısıtlama; aynı mantık token sekmesi için de geçerli, orada da derecelendirme yapabileceğin bir bakiye yok.
İki listede de contract’lar etiketsiz çıkıyor
Zincir açısından sahip, öyle kayıtlı olan adrestir. Ve onun arkasında her zaman konuşabileceğin biri olmayabilir.
Bir ERC-20 listesinde liquidity pool başka bir adres olarak çıkar; onunla birlikte token saklayan her contract da öyle. Bir koleksiyonun listesindeyse tipik durum farklı: bir parça, ilan süresince onu saklayan bir marketplace’te satılıyorsa, o dönemde sahibi custody contract’ıdır. Vault’larda, staking’te ve NFT’leri teminat olarak kabul eden kredilerde de aynısı oluyor. Kişi hâlâ işlemin arkasında ama dosyada görünen contract.
İki dışa aktarım da etiket içermediği için, bu satırları çıplak gözle ayırt edemezsin. Kontrol ucuza patlıyor: tanımadığın adresleri Arc explorer‘da ara ve ilişkili kod gösterip göstermediğine bak. Gösteriyorsa, bir contract’tır. Dağıtımdan önce yapmaya değer, çünkü aldığını ne yapacağını bilmeyen bir contract’a giden transfer’i kimse geri döndürmez.
Kesim anını okumaya başlamadan önce belirle
Dosya, çalıştırdığın anda zincirin durumunun bir fotoğrafı. Kendi kendine güncellenmez: sonraki her transfer gerçekliği değiştirir, CSV olduğu gibi kalır.
Bir token’a kıyasla bir koleksiyonda bunun ağırlığı daha büyük, çünkü NFT’ler sabit bir tempoda değil, dalgalar halinde el değiştiriyor. Bir listeleme, bir fiyat sıçraması ya da uyanan bir secondary; sakin haftalar boyunca kıpırdamayan hacmi kısa sürede döndürebilir, dolayısıyla bir saat arayla yapılan iki okuma adreslerin göze çarpan bir kısmında birbirini tutmayabilir.
İşte bu yüzden sıralama önemli. Önce kesim anı belirlenir, sonra okuma yapılır. “Fotoğraf cuma 18:00’de çekiliyor” diye önceden ilan etmek, yarım saat önce satıp listeye giremeyenin öngörülebilir şikayetini ortadan kaldırır. Ve amacın tutanı ödüllendirmek ise çözüm sorguyu tekrarlamak: zamanla ayrılmış iki çalıştırmayı bir tabloda çaprazlayınca iki listede de görünen adreslerin listesini elde edersin.
Arc üzerinde bir snapshot çıkarmak ne kadar tutar
Çalıştırma başına 62,5 USDC, iki sekmede de aynı sabit ücret, artı işlemin gas’ı. Arc gas’ı da USDC üzerinden aldığı için toplam harcama tek para birimiyle ve arada dönüşüm olmadan kalıyor. wallet’nin henüz bakiyesi yoksa, okumadan önce USDC’i ağa getirmen gerekiyor.
Sabit demek, boyutun hesaba girmediği anlamına geliyor: elli wallet’lı bir token da yirmi bin wallet’lı biri de aynı ücret; iki yüz parçalık bir seri de on binlik biri de öyle. Sonuç iki yönlü. Geniş bir tabanda elde edilen her adres çok ucuza geliyor ve bu, kayıt başına ücret alan araçlardan gelenlerin sezgisini tersine çeviriyor. Küçük bir projede tam tersi geçerli, o yüzden her çekimi meraktan başlatmak yerine önceden belirlenmiş bir amacı olacak şekilde yapmakta fayda var.
Devam etmeden önce bütçeyle ilgili küçük bir not: listenin tek gideceği yer anlık bir dağıtımsa, multisender aynı ücretle listeyi kendisi çekebilir ve bir adımı atlamış olursun. Burada ayrı olarak çıkarmak, dosyayı saklamak, tekrar kullanmak veya ileride karşılaştırmak istediğinde anlam kazanır.
Arc üzerinde bir token holder listesini dışa aktarmak ne işe yarar
Bakiye ve sayı bilgisinin olmaması, dosyanın pratikte ne için kullanıldığına bakana kadar bir eksiklik gibi görünür. Aşağıdaki üç senaryonun adres dışında hiçbir şeye ihtiyacı yok:
- Herkesin aynı miktarı aldığı düz bir dağıtım. CSV, hiçbir düzenleme yapmadan doğrudan Arc üzerinde toplu token gönderimi aracına girer.
- Bir mint, ön satış veya erken erişim için allowlist: burada tek önemli şey bir adresin listede olup olmadığı.
- Topluluk tabanının nasıl geliştiğini ölçmek. Farklı zamanlarda alınan iki okuma, kaç kişinin girdiğini, kaçının çıktığını ve baştan beri kimlerin orada kaldığını gösterir.
Bu üçüncü kullanım en çok hafife alınanı. İki dosyayı bir elektronik tablo üzerinde karşılaştırdığında elinde kimin kaldığı ve kimin gittiği listesi olur; bakiye bilgisine bile ihtiyaç duymayan mükemmel bir segmentasyon. Arc gibi yeni açılmış bir zincirde bu takibin değeri daha da artıyor, çünkü taban küçük ve her giriş ya da çıkış hissediliyor.
Dürüst olmak adına neyin dışarıda kaldığını da söylemek lazım. Kademeli dağıtım yapamazsın, supply konsantrasyonunu ölçemezsin ve hangi wallet koleksiyonun yarısını topladığını da öğrenemezsin. Bu üç sorunun cevabı ağın explorer’ında; orası bakiyeleri gösterir ve belirli bir adresi incelemene olanak tanır. snapshot sana kapsamı, explorer ise detayı verir.
SSS
Arc’ta bir holder snapshot ne kadara mal oluyor?
Her çekim için sabit tarife 62,5 USDC, artı USDC cinsinden ödenen ağ gas ücreti. Fiyat token sekmesinde de koleksiyon sekmesinde de aynı; holder sayısına ya da serinin büyüklüğüne göre değişmiyor.
CSV, her wallet için bakiyeleri veya NFT sayısını içeriyor mu?
Hayır, ikisinde de yok. ERC-20 dışa aktarımı yalnızca adresleri içerir, bakiye ya da supply yüzdesi yoktur; koleksiyon dışa aktarımı ise token ID’lerini veya sahip başına parça sayısını taşımaz. Kampanyan ödülü ağırlıklandırmayı gerektiriyorsa, o veriyi tasarımdan önce başka bir yoldan toplaman gerekir.
Bana ait olmayan bir token ya da koleksiyondan holder’ları çıkarabilir miyim?
Evet. Kimin neye sahip olduğu blockchain üzerinde açık bilgidir, dolayısıyla contract adresi yeterlidir ve projeyle bir ilişki şartı aranmaz. Benzer bir projenin topluluğuna bir dağıtımla ulaşmak veya bir holder tabanının gerçek büyüklüğünü incelemek için standart yol budur.
Hangi sekmeye ihtiyacım var, token mı yoksa NFT mi?
Contract tipine uygun olan. Varlık fungible ise ve insanların belli bir miktarı elinde tutuyorsa, bu bir ERC-20’dir ve Token Snapshot sekmesine gider. Her birim farklıysa ve parça parça sahip olunuyorsa, bu bir ERC-721’dir ve NFT Snapshot sekmesine gider. Contract’ı yanlış sekmeye koyduğunda sonuç dönmez.
Holder’lar arasında bir airdrop dağıtmak için işe yarar mı?
Herkes aynı miktarı aldığı sürece işe yarar. Adres başına bir satırla dosya, ağın multisender aracına hiçbir değişiklik yapmadan uyar. İzin vermediği şey, herkesin sahip olduğu miktara göre dağıtımı derecelendirmek; çünkü o rakam CSV’de yer almaz.
Eski bir snapshot geri alabilir miyim?
Evet, araç wallet ile ilişkili bir çekim geçmişi tutuyor; dolayısıyla bağladığında daha önce yaptıklarını tekrar görebilirsin. Yine de her CSV’yi kendi başına saklamakta fayda var, özellikle farklı zamanlarda alınmış iki listeyi karşılaştırmayı düşünüyorsan.
Sonuç
Artık Arc’ta snapshot nasıl yapılır biliyorsun; hem token’lar hem de NFT koleksiyonları için. Geriye sadece o listeyle ne yapacağına karar vermek kalıyor. Kendi projenin wallet’larını takip ediyorsan bu bilgi, holder sayısının değişip değişmediğini veya arttığını görmen ya da kendi topluluğunda bir ödül airdrop yapman için işine yarayacak.
Beklentiyi buna göre ayarladığında dosya, çoğu zaman ondan gerçekten istenen şeyi karşılıyor: erişimi filtrelemek, bir allowlist kurmak veya herkese eşit bir dağıtımı beslemek. Kesim noktasını sabitle, okumayı çalıştır ve bu listeyle bir şey imzalamadan önce üzerinden geç.

Smithii’de içerik üreticisi ve SEO katkıcısı. Sistem mühendisliği öğrencisi, crypto ve teknoloji meraklısı.







