Cara Mengambil List Holders di Arc, Baik dari token maupun dari Sebuah Koleksi
Sebelum kamu bikin airdrop, nyiapin allowlist, atau nutup akses buat yang udah masuk, ada satu hal yang harus dijawab dulu: siapa aja yang megang token atau koleksi kamu sekarang. Makanya penting tahu cara mengambil list holders di Arc yang bikin kamu bisa download file berisi semua holders dari sebuah token atau NFT.
Baik untuk token maupun untuk NFT, prosesnya sama saja. Yang harus kamu pahami adalah snapshot mana yang perlu kamu jalankan dan cara paling praktis untuk memanfaatkannya. Di panduan ini saya jelaskan caranya. Langsung saja.
Cara Mengambil List Holders dari Sebuah token di Arc Langkah demi Langkah
Token Snapshot dari Smithii untuk Arc menjalankan query langsung on-chain, tanpa bergantung pada indexer eksternal atau apakah token-nya terdaftar di mana pun. Cukup dengan alamat contract, jadi bisa dipakai untuk ERC-20 apa saja di network ini, punya kamu atau bukan. Ini tampilan interface-nya:
Setelah alamat contract-nya siap, tinggal lima langkah:
- Hubungkan wallet ke network. Ini dibutuhkan untuk membayar fee dan supaya tool bisa menyimpan riwayat kamu.
- Tetap di tab Token Snapshot, tab inilah yang bekerja dengan ERC-20.
- Masukkan contract: tempel alamatnya atau cari berdasarkan nama. Di bawah kolom itu ada shortcut untuk token dengan aktivitas terbanyak di network ini.
- Klik Take Snapshot lalu setujui pembayaran. Nominalnya muncul tepat di atas tombol sebelum kamu tanda tangani.
- Tunggu proses pembacaan selesai lalu download CSV berisi daftar alamatnya.
Cara Mengambil List Holders dari Sebuah Koleksi di Arc Tanpa Nulis Kode
Tab kedua adalah NFT Snapshot untuk koleksi Arc, dan kamu bisa berpindah dari tab sebelumnya lewat menu tab di bagian atas. Data yang diminta sama saja, alamat contract, cuma di sini yang ditangani adalah ERC-721. Karena kepemilikan sebuah NFT adalah informasi publik, tool ini jalan untuk koleksi mana saja yang ada di Arc. Ini tampilannya:
Alurnya tidak jauh berbeda dari yang sebelumnya:
- Hubungkan wallet kamu ke Arc. Tanpa itu, tidak ada cara untuk membayar fee atau mencatat proses extract-nya.
- Buka tab NFT Snapshot, yang kedua dari dua tab tersebut. Yang pertama membaca ERC-20 dan tidak mengenali collection.
- Tempel alamat smart contract ERC-721 di kolom pencarian, atau ketik nama collection untuk memilihnya dari daftar.
- Klik Take Snapshot dan tanda tangani pembayarannya. Total biaya muncul di bawah tombol sebelum kamu mengonfirmasi apa pun.
- Download CSV-nya begitu proses selesai. File tersebut juga tersimpan terkait dengan wallet yang kamu pakai untuk bayar, kalau nanti kamu perlu mengambilnya lagi.
Apa yang kamu dapat dari tiap daftar
Di sinilah kedua tab mulai berbeda. Keduanya sama-sama meng-export alamat, tidak lebih, tapi kriteria yang dipakai untuk menyusun barisnya berbeda, dan itulah yang menentukan file tersebut cocok untuk apa.
| Token Snapshot (ERC-20) | NFT Snapshot (ERC-721) | |
|---|---|---|
| Apa itu satu baris | Sebuah alamat dengan saldo token | Sebuah alamat dengan minimal satu piece dari NFT |
| Pengulangan | Satu baris per pemilik | Sudah di-dedupe per pemilik |
Deduplikasi di kolom kedua ini penting untuk dipahami dengan baik, karena banyak orang tidak menyangkanya. Sebuah wallet dengan empat puluh piece dari collection tersebut hanya mengambil satu baris, sama persis dengan yang cuma punya satu, dan di file tidak ada apa pun yang memberi tahu kamu mana yang mana.
Untuk allowlist, format ini sudah benar: tujuannya adalah mencadangkan satu slot per orang, dan yang mengumpulkan empat puluh unit tidak seharusnya mengambil empat puluh slot. Tapi kalau kamu mau memberi reward proporsional dengan jumlah kepemilikan masing-masing, ini jadi batasan, dan logika yang sama berlaku di tab token, di mana juga tidak ada saldo yang bisa dijadikan patokan.
Smart contract muncul tanpa label di kedua daftar
Bagi blockchain, pemilik adalah alamat yang tercatat sebagai pemilik. Dan di balik alamat tersebut tidak selalu ada orang yang bisa kamu ajak bicara.
Di daftar ERC-20, liquidity pool muncul sebagai salah satu alamat, begitu juga semua smart contract yang menyimpan token. Di daftar collection, kasus umumnya berbeda: saat sebuah piece dijual di marketplace yang menyimpannya selama listing aktif, pemilik selama periode itu adalah smart contract marketplace tersebut. Hal yang sama terjadi dengan vault, staking, dan pinjaman yang menerima NFT sebagai jaminan. Orangnya tetap ada di balik operasi tersebut, tapi yang tercatat di file adalah smart contract-nya.
Karena kedua export tidak menyertakan label, baris-baris tersebut tidak bisa dibedakan hanya dengan melihat sekilas. Pengecekannya murah: cari alamat yang tidak kamu kenali di explorer Arc dan lihat apakah ada kode yang terhubung. Kalau ada, itu smart contract. Sebaiknya lakukan ini sebelum melakukan distribusi, karena pengiriman ke smart contract yang tidak tahu harus berbuat apa dengan aset yang diterima tidak bisa di-revert oleh siapa pun.
Tentukan waktu snapshot sebelum menjalankan prosesnya
File tersebut adalah snapshot kondisi blockchain pada saat kamu menjalankan prosesnya. Tidak update otomatis: setiap transfer setelahnya mengubah kondisi sebenarnya, dan CSV tetap seperti semula.
Efek ini lebih terasa di collection dibanding token, karena NFT tidak berpindah tangan dengan ritme konstan melainkan dalam gelombang. Sebuah listing, kenaikan harga, atau secondary market yang tiba-tiba aktif bisa memindahkan dalam waktu singkat apa yang selama berminggu-minggu tenang tidak bergerak, jadi dua kali pembacaan yang berjarak satu jam bisa jadi tidak cocok pada sebagian alamat yang cukup besar.
Makanya urutannya penting. Pertama tetapkan waktu snapshot-nya, baru jalankan prosesnya. Mengumumkan ‘snapshot diambil hari Jumat pukul 18:00’ menghindarkan kamu dari komplain yang sudah bisa diprediksi dari orang yang menjual setengah jam sebelumnya dan tidak masuk daftar. Dan kalau tujuanmu memberi reward pada holder yang bertahan, solusinya adalah mengulang query: dua eksekusi dengan jarak waktu, dicocokkan di spreadsheet, memberimu daftar alamat yang muncul di keduanya.
Berapa Biaya Bikin snapshot di Arc
62,5 USDC per eksekusi, tarif flat dan sama di kedua tab, plus gas fees transaksi. Karena Arc juga menagih gas dalam USDC, seluruh pengeluaran tetap dalam satu koin tanpa perlu konversi apa pun. Kalau wallet kamu belum ada saldonya, kamu perlu membawa USDC ke network sebelum menjalankan prosesnya.
Flat artinya ukuran tidak masuk hitungan: biaya untuk token dengan lima puluh wallet sama dengan yang punya dua puluh ribu, begitu juga koleksi dua ratus piece sama dengan yang sepuluh ribu. Konsekuensinya ada dua. Untuk basis besar, tiap alamat yang didapat jadi sangat murah, yang membalik intuisi orang yang biasa pakai tool dengan tarif per record. Untuk project kecil justru sebaliknya, jadi sebaiknya tiap extract sudah punya tujuan yang jelas daripada dijalankan hanya karena penasaran.
Catatan soal budget sebelum lanjut: kalau list ini cuma dipakai buat langsung didistribusikan, multisender bisa mengekstraknya sendiri dengan biaya yang sama, jadi kamu hemat satu langkah. Mengambilnya terpisah di sini masuk akal kalau kamu ingin menyimpan file-nya, memakainya lagi, atau membandingkannya nanti.
Kegunaan Export List Holders dari Sebuah token di Arc
Tidak adanya saldo dan hitungan kelihatan seperti kekurangan, sampai kamu lihat untuk apa file ini dipakai dalam praktiknya. Tiga kasus berikut nggak butuh apa-apa selain address:
- Distribusi rata, di mana semua orang menerima jumlah yang sama. CSV-nya langsung masuk ke pengiriman massal token di Arc tanpa perlu diubah formatnya sama sekali.
- Allowlist untuk mint, presale, atau early access, di mana yang penting cuma apakah suatu address ada di dalam list atau enggak.
- Mengukur perkembangan basis holder kamu. Dua pengambilan data di waktu berbeda bakal kasih tahu berapa yang masuk, berapa yang keluar, dan siapa saja yang masih bertahan sejak awal.
Kegunaan ketiga ini yang paling underrated. Membandingkan dua file pakai spreadsheet bakal kasih kamu list siapa yang bertahan dan siapa yang cabut, itu segmentasi bagus dan nggak butuh data saldo sama sekali. Di chain yang baru rilis seperti Arc, tracking semacam ini nilainya lebih tinggi lagi, karena basis holder-nya masih kecil dan setiap yang masuk atau keluar itu berdampak.
Biar jujur, perlu juga disebutkan apa yang nggak bisa. Kamu nggak bisa distribusi berdasarkan tier, nggak bisa mengukur konsentrasi supply, dan nggak bisa tahu wallet mana yang memegang setengah koleksi. Tiga pertanyaan itu bisa dijawab di explorer network, yang memang menampilkan saldo dan memungkinkan kamu inspect address tertentu. snapshot kasih kamu jangkauan; explorer kasih detailnya.
FAQ
Berapa biaya snapshot holder di Arc?
62,5 USDC per ekstraksi, tarif tetap, plus gas fees network yang juga dibayar dalam USDC. Harganya sama di tab token maupun tab koleksi, dan nggak berubah tergantung jumlah holder atau ukuran koleksi.
Apakah CSV-nya menyertakan saldo atau jumlah NFT tiap wallet?
Tidak, keduanya tidak. Ekspor ERC-20 hanya berisi address tanpa saldo maupun persentase supply, dan ekspor koleksi juga nggak menyertakan ID token atau hitungan piece per owner. Kalau campaign kamu butuh reward yang diberi bobot, data itu harus dikumpulkan lewat jalur lain sebelum kamu desain campaign-nya.
Bisakah kamu ambil holder dari token atau koleksi yang bukan milik kamu?
Bisa. Siapa memegang apa itu informasi terbuka di blockchain, jadi cukup dengan alamat smart contract dan nggak perlu ada hubungan apa pun dengan proyeknya. Ini cara umum buat menjangkau komunitas proyek sejenis lewat distribusi, atau buat mempelajari ukuran sebenarnya dari basis holder mereka.
Tab mana yang kamu butuhkan, token atau NFT?
Yang sesuai dengan tipe smart contract-nya. Kalau aset-nya fungible dan orang memegang sejumlah tertentu, itu ERC-20 dan masuk ke Token Snapshot. Kalau setiap unitnya unik dan dimiliki per piece, itu ERC-721 dan masuk ke NFT Snapshot. Menaruh smart contract di tab yang salah nggak akan menghasilkan apa-apa.
Bisakah ini dipakai buat distribusi airdrop ke para holder?
Bisa, selama semua orang menerima jumlah yang sama. Dengan satu baris per address, file-nya langsung cocok di multisender network tanpa perlu diutak-atik. Yang nggak bisa itu menyesuaikan jumlah kiriman berdasarkan kepemilikan masing-masing, karena angka itu nggak ada di dalam CSV.
Bisakah kamu ambil lagi snapshot lama?
Bisa, tool-nya menyimpan riwayat ekstraksi yang terhubung ke wallet kamu, jadi begitu kamu connect lagi, kamu bisa lihat lagi yang pernah kamu buat. Meski begitu, tetap disarankan menyimpan setiap CSV sendiri, apalagi kalau kamu berencana membandingkan dua list dari waktu yang berbeda.
Kesimpulan
Sekarang setelah kamu tahu cara membuat snapshot di Arc, baik untuk token maupun koleksi NFT, tinggal putuskan mau diapakan list-nya. Kalau kamu memantau wallet dari proyek kamu sendiri, info ini bakal berguna buat tahu apakah jumlah holder berubah atau bertambah, atau buat bikin airdrop reward ke komunitas kamu sendiri.
Dengan ekspektasi yang sudah pas, file ini menutup apa yang biasanya benar-benar dibutuhkan hampir setiap kali: menyaring akses, menyusun allowlist, atau feed distribusi yang sama rata buat semua orang. Tentukan cutoff-nya, jalankan pembacaannya, dan review list-nya sebelum kamu tanda tangan apa pun dengannya.
Content creator dan kontributor SEO di Smithii. Mahasiswa Teknik Sistem dan penggemar crypto-tech.
