Come fare uno snapshot degli holder su NEAR: la lista delle wallet di qualsiasi token o collezione NFT in CSV
Se vuoi premiare la tua community, preparare una allowlist o semplicemente sapere chi detiene il tuo token, imparare come fare uno snapshot degli holder su NEAR è il primo passo. In pochi secondi hai la lista completa degli account che possiedono un token o un NFT, pronta da scaricare in CSV o trasformare direttamente in un airdrop.
In questa guida ti spiego a cosa serve uno snapshot su NEAR, come ricavarlo da un token e da una collezione NFT con lo strumento di Smithii, cosa include la lista e cosa resta fuori, e quanto costa. Partiamo.
Cos’è uno snapshot degli holder e a cosa serve su NEAR
Uno snapshot è una fotografia della distribuzione di un asset in un momento preciso, con tutti gli account che lo detengono e il relativo saldo. Su NEAR offre un vantaggio interessante rispetto ad altre reti, perché molti di quegli account hanno nomi leggibili, come alice.near o un username di Telegram, e la lista si capisce a colpo d’occhio.
Gli utilizzi più comuni per un dev sono questi:
- Airdrop agli holder: distribuire un nuovo token a chi ne possiede un altro, o a chi detiene un NFT della tua collezione.
- Allowlist: dare accesso prioritario a una vendita o a un mint a chi fa già parte del progetto.
- Migrazioni: se rilanci un token, la lista ti permette di restituire a ogni holder quello che aveva.
- Analisi della distribuzione: capire se poche wallet concentrano troppo supply prima di prendere decisioni.
Nessuno di questi utilizzi richiede che gli holder facciano qualcosa o ti diano un permesso. I saldi di qualunque token stanno sulla chain alla vista di tutti, e quello che aggiunge il tool è raccoglierli, ripulirli e consegnarteli in un formato pronto all’uso senza interrogare l’API di un explorer né scrivere uno script. Per questo serve anche a studiare token che non sono tuoi, ad esempio quello di un progetto con la cui community vuoi collaborare.
Come fare uno snapshot di holder su NEAR per un token
Il Token Snapshot di Smithii per NEAR è un tool che ti permette di esportare tutti gli account che detengono un token NEP-141 senza scrivere codice né interrogare l’API di un explorer. Ti suggerisce i token con più attività del momento e ti lascia incollare qualunque altro. Quando sei nell’interfaccia del tool, vedrai questo:
Se hai sottomano l’account del token e 11,55 NEAR per la commissione, il processo è questo:
- Connetti il tuo wallet NEAR: HOT, Meteor o qualsiasi altro dal selettore.
- Scegli il token: clicca uno dei token in trend o incolla il suo account, ad esempio token.rhealab.near.
- Clicca Take Snapshot: il tool verifica il numero di holder e ti chiede di approvare la commissione.
- Scarica o riusa la lista: in CSV o TXT, oppure inviala direttamente al Multisender di NEAR.
Prima di addebitarti qualunque cosa, il tool legge quanti holder ha il token e mostra una stima accanto al suo nome. Se supera il limite, te lo dice prima del pagamento, così non paghi mai per una lista che non si può costruire.
Come estrarre gli holder di una collezione NFT su NEAR
Lo stesso tool ha una seconda scheda, lo NFT Snapshot per NEAR, che funziona con collezioni dello standard NEP-171. Al posto dei saldi, ti restituisce gli account che detengono almeno un NFT della collezione. Aprendola vedrai il selettore delle collezioni:
Il funzionamento è identico a quello dei token. Scegli una collezione attiva o incolli l’account del suo contratto, come asac.near, premi Take Snapshot, approvi gli 11,55 NEAR e scarichi la lista o la mandi al multisender. Le collezioni che compaiono nel selettore sono quelle con più trasferimenti in giornata, insieme al loro numero di holder.
Cosa include la lista degli holder e cosa lascia fuori
La lista nasce dai dati indicizzati da NearBlocks e il tool la ripulisce prima di consegnartela. Gli account con saldo zero e l’account stesso del token vengono rimossi, perché non aggiungono nulla a una distribuzione.
Quello che invece rimane sono gli account di contratti che hanno saldo, come i pool di Rhea o le treasury di un DAO. Sono holder reali a livello tecnico, ma non persone, quindi controlla la lista prima di usarla in uno airdrop e decidi se vuoi includerli.
Il caso dei token con reflection
Nei token con reflection, i saldi crescono da soli a ogni trasferimento e l’indexer può andare in ritardo. Per i token creati con Smithii, il tool rilegge direttamente dalla chain il saldo degli holder più grandi, in modo che le cifre in cima alla lista siano quelle reali.
Quando fare lo snapshot del tuo token su NEAR
Il momento in cui scatti la fotografia decide chi premi. Se annunci la data con anticipo, attiri acquisti dell’ultimo minuto da parte di chi venderà non appena riceve la ricompensa, e anche di chi distribuisce il proprio saldo tra molti account per incassare più volte.
Ci sono tre modi semplici per evitarlo senza complicare la campagna:
- Fai lo snapshot prima di annunciare l’airdrop: così la lista rispecchia chi era già presente, non chi è arrivato per la ricompensa.
- Combina due fotografie: scattane una oggi e un’altra tra qualche settimana, e premia solo gli account che compaiono in entrambe. È un modo diretto per ricompensare chi tiene a lungo.
- Imposta un saldo minimo: gli account con quantità simboliche di solito sono dust o appartengono a chi prova a moltiplicare la propria quota, e tagliarli fuori riduce il rumore.
Nessuna regola elimina del tutto gli abusi, ma una lista ben filtrata distribuisce l’token tra gli holder che restano, che è quello che cerca qualsiasi progetto con campagne di questo tipo.
Quanto costa uno snapshot su NEAR e cosa succede se qualcosa va storto
| Tipo di snapshot | Cosa consulta | Limite | Commissione |
|---|---|---|---|
| Token Snapshot | Account con saldo di un token NEP-141 | 5.000 holder | 11,55 NEAR |
| NFT Snapshot | Account con almeno un NFT di una collezione NEP-171 | 5.000 holder | 11,55 NEAR |
Il pagamento è protetto in entrambe le direzioni. Se lo token è troppo grande, lo sai prima di pagare. E se paghi ma la lista non riesce a caricarsi, il pagamento resta salvato per un giorno per quel token e quella wallet, così puoi ripetere lo snapshot senza un secondo addebito.
Dallo snapshot al airdrop senza passaggi intermedi
Dopo uno snapshot di solito si distribuisce qualcosa a quegli account. Con Smithii non serve scaricare il file e ricaricarlo, perché con un clic carichi gli holder nel Multisender di NEAR, che tra l’altro registra nel tuo token gli account che ne hanno bisogno.
Un esempio tipico è premiare gli holder di una collezione con il token del tuo progetto. Fai lo NFT Snapshot, invii la lista al multisender, scegli un importo uguale per tutti e in pochi minuti ogni holder ha la sua ricompensa.
Qui trovi il processo completo per fare uno airdrop su NEAR con la registrazione degli account inclusa.
Gli snapshot restano anche nel tuo storico. Puoi riscaricare uno vecchio o confrontare due date per vedere come è cambiata la distribuzione del tuo token dopo una campagna.
FAQ
Quanto costa fare uno snapshot di holder su NEAR?
Ogni snapshot costa 11,55 NEAR, sia quello di un token sia quello di una collezione NFT, più un po’ di gas. La commissione si paga a Smithii prima che la lista venga costruita.
Quali token e collezioni posso consultare?
Qualsiasi token NEP-141 e qualsiasi collezione NEP-171 di NEAR mainnet con fino a 5.000 holder. Se il token o la collezione supera questo limite, lo strumento lo rifiuta prima che tu paghi.
Cosa succede se la lista non si carica dopo il pagamento?
Il tuo pagamento resta valido per un giorno su quel token e su quella wallet. Rifai il snapshot senza pagare una seconda volta.
Il snapshot include le wallet con saldo zero?
No. Gli account con saldo zero e lo stesso account del token restano fuori dalla lista. Gli account di contratti con saldo, come le pool, invece compaiono: conviene controllarli prima di un airdrop.
Posso rifare un snapshot fatto giorni fa?
Sì. Gli snapshots restano salvati nella tua cronologia e puoi scaricarli o riutilizzarli in un secondo momento, ad esempio per confrontare come è cambiata la distribuzione tra due date.
Conclusione
Una volta che sai come fare un snapshot di holder su NEAR, puoi trasformare qualsiasi token o collezione in una lista di account pronta per un airdrop, una allowlist o un’analisi. Il tool controlla la dimensione prima di addebitare e ripulisce al posto tuo i saldi vuoti.
Controlla gli account dei contratti prima di distribuire e sfrutta la connessione con il multisender. Così il passaggio dalla lista alla distribuzione è immediato.
Content creator e contributore SEO in Smithii. Studente di Ingegneria dei Sistemi e appassionato di crypto e tecnologia.
