Blog

Tradotto automaticamente · Leggi in inglese

Come distribuire token ai membri attivi (NFT: non ancora)

Zealy non può filtrare i membri per attività recente e oggi non può inviare NFT. Il meccanismo che funziona è uno sprint — con il calcolo del payout letto dal codice.

Di Mathis Grosjean

Copertina dell'articolo Zealy su uno sfondo scuro texturizzato con la scritta: Premia chi si è presentato — token, NFT e chi li riceve davvero.
In questa pagina

Risposta breve: Avvia uno sprint. Su Zealy uno sprint è una classifica con una data di inizio e una data di fine, quindi gli XP che classifica vengono guadagnati in quella finestra anziché accumulati per sempre. È l'unico meccanismo del prodotto che paga le persone per essere attive ora invece che per essersi iscritte una volta. Zealy poi decide chi ha vinto e registra quale indirizzo pagare. Non sposta i token e non può allegare alcun NFT — lo dice il campo della ricompensa stesso: Le ricompense NFT non sono ancora disponibili.

Cosa non farà questo post: darti un filtro che non esiste. Non puoi chiedere a Zealy "membri che hanno riscattato qualcosa negli ultimi 30 giorni" e ottenere un elenco. E non ti dirà come inviare un NFT tramite Zealy, perché non c'è alcuna ricompensa NFT da inviare. Per la parte NFT, può però procurarti un elenco di destinatari difendibile — lo sprint decide chi, mentre il minting e l'invio avvengono nei tuoi strumenti.

Informativa: Zealy pubblica questo contenuto e Zealy vende il prodotto descritto. Ogni comportamento di Zealy riportato di seguito è stato ricavato dal codice sorgente di Zealy anziché dalla documentazione ufficiale di Zealy, che si è rivelata errata in diversi punti. Ogni dato esterno riporta la propria fonte nel punto in cui appare.

Ultima verifica: 15 agosto 2026.

Perché "premiare i miei membri attivi" è più difficile di quanto sembri

La maggior parte delle distribuzioni di token paga per un'istantanea del passato e poi guarda i token andarsene. In uno studio accademico su nove airdrop, nella maggior parte dei protocolli il destinatario mediano ha effettuato un singolo trasferimento di token, e l'intervallo mediano tra il primo e l'ultimo è stato di zero giorni. Premiare l'attività significa invece pagare per il comportamento all'interno di una finestra che imposti tu.

Quello studio è "Airdrop: regalare denaro è più difficile di quanto sembri" di Johnnatan Messias, Aviv Yaish e Benjamin Livshits, che copre nove distribuzioni di protocollo. Un trasferimento e nessun tempo trascorso non è un membro che hai acquisito. È una coda che hai pagato per metterti davanti una volta.

La risposta abituale è filtrare più duramente prima di inviare, il che funziona in modo costoso e tardivo. Questo approccio, e ciò che Optimism e LayerZero ne hanno ottenuto, è l'argomento di come gestire un airdrop che non venga farmato.

Esiste una versione più economica della stessa idea. Invece di distribuire a tutti e poi sottrarre le persone che non volevi, definisci una finestra, pubblica cosa dà diritto al credito al suo interno e paga la classifica che ne risulta. Nessuno deve essere rimosso, perché nessuno è mai stato sulla lista gratuitamente.

Non puoi filtrare i membri Zealy per attività recente

La tabella dei membri di Zealy filtra esattamente su tredici colonne: id, name, role, join date, handle e ID Discord, username TikTok, username X, numero di follower X, ID X, email, paese e indirizzo ETH. La data di iscrizione è l'unica data. Non esiste un filtro per ultima attività, né per ultimo claim, né per XP negli ultimi 30 giorni.

Questo sorprende le persone, quindi vale la pena essere precisi su quanto è profondo. La pagina dei membri ti fornisce l'elenco qui sopra. Gli XP non sono nemmeno presenti: gli XP sono mostrati come colonna ma calcolati dopo che la pagina dei membri è già stata recuperata, motivo per cui non è possibile filtrarli né ordinarli. L'API pubblica è ancora più limitata: search, roles, ids, joinedAfter, joinedBefore e un ordinamento. Le analytics di Zealy mostrano effettivamente gli utenti attivi nel tempo, ma un grafico è un aggregato. Zealy ti dirà quante persone sono state attive la settimana scorsa e non ti fornirà i loro nomi.

Anche ordinare per XP non ti salva, perché gli XP di un membro sono un totale cumulativo e non qualcosa riferito a un periodo. Un membro che ha fatto farming intenso a marzo e non ha più aperto la tua questboard supera comunque chi ha riscattato qualcosa ogni settimana di questo mese. Ordinare la tua community per XP significa ordinarla per storico.

Quindi l'affermazione onesta del vincolo: su Zealy oggi, "attivo" non è una proprietà di un membro che puoi interrogare. È una proprietà di un periodo di tempo che definisci tu.

Il meccanismo che funziona su Zealy: uno sprint

Uno sprint di Zealy è una classifica con una data di inizio e una data di fine, che conta gli XP dei riscatti effettuati all'interno di quella finestra sulle quest incluse nello sprint. La classifica è un elenco di chi è stato attivo durante il periodo che hai scelto. I membri con zero XP nello sprint sono esclusi automaticamente dal pagamento.

Quest'ultimo dettaglio fa più di quanto sembri. La metà dormiente della tua community non viene filtrata da una regola che hai scritto; è assente dal risultato perché non ha fatto nulla nella finestra. Ottieni il filtro che volevi come effetto collaterale della forma della cosa.

Una precisazione, perché decide se puoi definire uno sprint una misurazione pulita: anche gli XP concessi manualmente da un admin all'interno della finestra contano per lo sprint, insieme ai riscatti. Se distribuisci XP bonus, stai modificando lo stesso numero da cui viene calcolato il pagamento.

Gli sprint pagano in uno di due modi, ed entrambi vale la pena capirli prima di scegliere un numero.

Proporzionale. Ogni membro riceve floor(pool × their sprint XP ÷ total sprint XP). Prendi un pool di 10.000 token, 250.000 XP distribuiti tra tutti gli aventi diritto, e un membro che ne ha guadagnati 4.000: la sua quota è di 160 token. Ogni quota viene arrotondata per difetto, quindi i pagamenti possono sommare a poco meno del pool. Nota che se imposti anche una zona premio, il totale in quel denominatore viene ricalcolato solo sulle persone dentro la zona — quindi aggiungere una soglia aumenta la quota di tutti oltre a ridurre la lista.

A livelli. Definisci intervalli di posizione, ognuno dei quali prende una percentuale del pool, divisa equamente all'interno dell'intervallo. Le posizioni 1–10 potrebbero prendere il 40% tra loro e le posizioni 11–50 un altro 20%. Puoi definire fino a 50 livelli, e non possono né sovrapporsi né lasciare un vuoto tra gli intervalli. Il sistema a livelli paga la posizione anziché l'impegno, ed è ciò che vuoi quando il punto è una gara visibile.

In aggiunta a entrambi, la zona premio è una soglia rigida delle prime N posizioni. Impostala a 200 e la posizione 201 non riceve nulla, indipendentemente da quanti XP ha guadagnato. Uno sprint non ha modalità estrazione — il pagamento è per posizione e XP, quindi se vuoi casualità stai guardando un metodo di ricompensa delle quest, non uno sprint.

Le community gestiscono esattamente questo formato da anni. Bandzaï ha descritto uno sprint con quasi 600.000 $BZAI e NFT Zaï per i primi 200 giocatori della classifica. CoinW ha organizzato una classifica Top 50 con un premio massimo di 100 USDT. Alphaday ha messo i primi 10 classificati in lizza per una quota di un montepremi di 300 $ in ETH. ShimmerSea ha offerto 5.500 USDT e 404 NFT Lumi speciali per spingere le persone a testare ogni parte del suo protocollo. Tutti e quattro i casi di studio sono del 2023 e tutti e quattro sono zone premio con una data associata.

Uno di questi dimostra il punto sugli NFT per me. Il premio di Bandzaï era in token e NFT per una zona top 200. Lo sprint seleziona i 200. Consegnare loro gli NFT era, ed è ancora, compito del progetto stesso — il che ci porta a ciò che Zealy metterà e non metterà nelle mani di qualcuno.

Cosa invia effettivamente Zealy, tipo di ricompensa per tipo di ricompensa

Il modello dati di Zealy prevede sette tipi di ricompensa e l'editor delle quest ne offre sei: XP, ruolo Discord, Zaps, USDC, token e un "altro" personalizzato. USDC è l'unico che arriva da solo. Le ricompense in token vengono registrate anziché inviate, e le ricompense NFT non sono disponibili nel prodotto oggi.

RicompensaNell'editor delle quest?Chi lo sposta effettivamente
XPSìZealy, all'interno di Zealy
ZapsSìZealy, dentro Zealy
Ruolo DiscordSìIl bot Zealy, in modo asincrono; un membro senza Discord collegato non ne riceve mai uno
USDCSìZealy, automaticamente al momento di una richiesta riuscita, da un saldo che prefinanzi
TokenSìTu. Zealy registra il vincitore e l'indirizzo a cui pagare
Personalizzato "altro"SìTu, con qualsiasi mezzo tu abbia descritto
NFTNoNessuno. Il campo riporta I premi NFT non sono ancora disponibili

La riga NFT è quella da leggere due volte. Il modello dati di Zealy include ancora un tipo di premio NFT e Zealy ha effettivamente coniato NFT in passato tramite un servizio esterno su Polygon dietro un feature flag. Nel prodotto che usi oggi, il campo del premio NFT mostra una singola stringa che ti dice che non è disponibile, e tutto ciò che sta dietro è disattivato. Qualsiasi guida che ti mostri come collegare un premio NFT a una quest di Zealy descrive qualcosa che non esiste.

I premi in token funzionano, con una divisione dei compiti facile da fraintendere. Zealy decide chi ha vinto e scrive una riga in sospeso con il vincitore e il suo indirizzo verificato. Poi invii dal tuo wallet e incolli di nuovo l'hash della transazione — c'è un'azione in blocco che applica un unico hash a tutti i vincitori in sospeso contemporaneamente, ed è così che regoli uno sprint con i primi 200 senza 200 copia-incolla. Zealy supporta più di venti identificatori di rete per questo, due dei quali sono testnet.

Quattro passaggi per un premio in token di Zealy. Zealy decide chi ha vinto, poi registra il vincitore e l'indirizzo da pagare. Invii i token e paghi il gas, poi incolli di nuovo l'hash della transazione.

Dove finisce Zealy e inizia la community, per un premio in token. USDC è l'eccezione — viene accreditato automaticamente.

Ne derivano due conseguenze, e nessuna delle due è nel materiale di marketing. Zealy non detiene alcun firmatario per i premi in token, quindi la community paga il gas. E Zealy attualmente non verifica on-chain che l'importo corretto sia arrivato all'indirizzo corretto. Il modulo per singolo vincitore verifica almeno che l'ID della transazione abbia un formato valido; l'azione in blocco che applica un unico hash a tutti i vincitori in sospeso verifica solo che tu abbia digitato qualcosa. L'hash è una registrazione della tua dichiarazione di aver pagato, non una prova di pagamento. Se la tua community è abbastanza grande perché questa distinzione conti, mantieni una tua riconciliazione.

USDC è l'eccezione che si comporta come le persone si aspettano da una ricompensa. Ricarichi un saldo, ogni quest blocca fondi su di esso e una richiesta andata a buon fine accredita automaticamente il membro. Gli USDC si accumulano come saldo lato Zealy e vengono prelevati sul wallet Polygon collegato del membro. Indirizza le persone alla schermata di prelievo per i termini correnti invece di promettere loro una cifra netta nel brief della campagna.

Quanto devono i destinatari su tutto questo è una questione separata con conseguenze reali, e guadagnare crypto senza acquistarne copre il lato del destinatario.

Zealy vs Galxe sull'uscita della ricompensa

Galxe offre un tipo di ricompensa NFT ed esegue estrazioni di token on-chain. Zealy non fa né l'uno né l'altro: le ricompense NFT sono disabilitate e le ricompense in token vengono registrate, non inviate. Il controargomento è che l'estrazione on-chain di Galxe addebita all'utente una commissione gas, e le ricompense personalizzate di Galxe sono distribuite dal progetto, come i token di Zealy.

ZealyGalxe
NFT come tipo di ricompensaNon disponibile; il campo indica Le ricompense NFT non sono ancora disponibiliSupportato. Galxe elenca le sue ricompense come "Points, OAT, NFT, Custom Rewards, Mystery Boxes, Tokens e Discord Roles" e afferma di "supportare ricompense NFT su qualsiasi rete blockchain compatibile"
Distribuzione dei tokenZealy registra il vincitore e l'indirizzo; il progetto invia"Token Raffles" opera on-chain, mentre "Token FCFS" resta off-chain senza attivare una transazione
Chi paga il gasIl progetto, dal proprio walletPer le ricompense in token in modalità raffle, "che richiedono agli utenti di pagare una commissione di transazione in gas in token G sulla rete Gravity"
Ricompense personalizzateIl progetto distribuisce, come per i token"Il progetto è responsabile della distribuzione di queste ricompense, che saranno gestite al di fuori di Galxe"

Le citazioni di Galxe provengono dalla sua documentazione pubblicata sulle ricompense, collegata nell'intestazione della tabella.

Valuta lo scambio con onestà. Se ciò che ti serve è un NFT che arriva in un wallet come risultato diretto del completamento di una quest, Galxe lo fa e Zealy no, e nessun design di sprint Zealy può sostituirlo. Se ciò che ti serve è una distribuzione in cui i destinatari non pagano nulla e non toccano alcuna chain per ricevere, il percorso USDC di Zealy lo fa e una riffa on-chain no. Entrambe le piattaforme lasciano le ricompense personalizzate al progetto, quindi nessuno ha risolto il caso generale.

Come gestire un pagamento sprint su Zealy, passo dopo passo

Imposta prima le date dello sprint, perché la finestra è il filtro. Scegli un pagamento proporzionale o a fasce e una zona ricompensa. Alla chiusura dello sprint, esporta la classifica o i vincitori delle ricompense per ottenere gli indirizzi dei wallet, invia dal tuo wallet, poi incolla l'hash della transazione di nuovo in Zealy.

1. Decidi cosa misura la finestra. Gli XP dello sprint provengono dalle claim effettuate tra la data di inizio e quella di fine, quindi le quest che pubblichi in quella finestra sono la definizione di "attivo" per cui stai pagando. Se vuoi profondità invece di clic, pondera gli XP in quel modo prima che lo sprint inizi, non dopo. Creazione di uno sprint copre la configurazione.

2. Scegli proporzionale o a livelli. Le ricompense proporzionali premiano il volume di impegno e producono una lunga coda di piccoli pagamenti. Quelle a livelli concentrano il valore in cima e producono una gara. Una zona di ricompensa di poche centinaia mantiene la lista dei pagamenti di dimensioni che puoi davvero liquidare a mano.

3. Metti condizioni sulle quest, non sui membri. Non esiste una allowlist dei membri su Zealy, quindi il modo per mantenere uno sprint onesto sono le condizioni delle quest. Zealy accetta sette tipi di condizione — completare un'altra quest, livello, ruolo Discord, data, possesso di un NFT, numero di follower su X ed età dell'account X — combinate con AND o OR. Le condizioni di livello accettano solo "above" e "below", e il gating tramite NFT è solo su Polygon. La documentazione delle condizioni le elenca tutte e sette.

4. Scegli il metodo di ricompensa per ogni ricompensa. Metodi di ricompensa sono tutti: primo arrivato, estrazione, top e voto, e vengono impostati per ricompensa anziché per quest. Primo arrivato ed estrazione hanno ciascuno un limite di 1.000 vincitori, anche top ha un limite di 1.000, mentre il voto non ha limite massimo. Un'estrazione è un ordinamento casuale delle richieste andate a buon fine e richiede un limite di richieste o una data di chiusura per essere valida.

5. Esporta il file corretto. L'esportazione dei membri fornisce userId, nome, ruolo, XP, data di iscrizione e stato di ban, e nessun indirizzo wallet. Gli indirizzi provengono dall' esportazione della classifica o dall'esportazione dei vincitori delle ricompense — anche se il file dei vincitori delle ricompense emette specificamente una colonna con indirizzo Ethereum, quindi una community Solana o TON dovrebbe usare invece l'esportazione della classifica. Scaricare l'elenco dei membri e chiedersi dove siano finiti i wallet è l'ora più sprecata di tutto questo flusso di lavoro.

6. Invia, poi registra. Paga dal tuo wallet, incolla l'hash, usa l'azione in blocco se la lista dei vincitori è lunga. Pubblica l'hash anche nella tua community: poiché Zealy non lo verifica on-chain, la verifica da parte dei tuoi membri è l'unico controllo esistente. Documentazione sui premi copre la configurazione stessa del premio.

Le parti che ti daranno problemi

Zealy non ha allowlist dei membri, né blocco sul saldo token, né verifica on-chain che la tua transazione di pagamento abbia fatto ciò che dichiari. Reimpostare la classifica è un'operazione distruttiva e sposta la data di inizio di uno sprint attivo. L'export dei membri non contiene indirizzi wallet. Ognuna di queste ha una soluzione alternativa, e nessuna è ovvia.

Il reset della classifica è quello che costa soldi veri. Il reset cancella le assegnazioni manuali di XP, azzera il contatore delle claim di ogni quest e, se uno sprint è in corso, sposta la data di inizio di quello sprint al momento del reset. Metà della cronologia del tuo sprint può sparire con un pulsante che sembra una semplice manutenzione. Completa gli sprint prima di resettare, oppure non resettare affatto.

I blocchi mancanti determinano ciò che puoi promettere. Non puoi caricare una lista di indirizzi e limitare una quest a quelli, e una condizione sul saldo token non è impostabile anche se il concetto esiste nel codice. Quindi "solo holder" non è uno sprint Zealy che puoi configurare; il possesso di NFT su Polygon è il blocco più vicino disponibile.

Il blocco per livello merita un avviso a parte. Il blocco è sul livello, non sull'XP grezzo, e solo sopra o sotto un livello. Le soglie di livello derivano da una curva globale fissa identica in ogni community Zealy, quindi un tier "livello 5 e superiore" significa la stessa quantità di XP accumulato nella tua community come in tutte le altre. Progetta i tier sapendo che non stai impostando tu le soglie — come gestire un programma di ambasciatori crypto si sviluppa creando ranghi con nomi specifici attorno a quel vincolo.

Niente di tutto ciò rende lo sprint una cattiva risposta. Lo rende una risposta specifica: Zealy è bravo a decidere chi merita la ricompensa e poco romantico nel distribuirla. Se ti aspetti un motore di distribuzione, rimarrai deluso. Se ti aspetti un tabellone dei punteggi molto preciso con un pulsante di esportazione, otterrai esattamente questo, e l'invio è mezz'ora del tuo wallet.

FAQs

Definisci una finestra temporale e paga la classifica che ne risulta, invece di filtrare a posteriori un elenco di membri. Su Zealy questo è uno sprint: una classifica con data di inizio e fine, in cui gli XP maturano solo dalle claim effettuate dentro la finestra e i membri con zero XP di sprint sono esclusi automaticamente dal pagamento. Imposta una zona premio — i primi 50, i primi 200 — e paga in proporzione agli XP o a fasce per posizione.

No. Le ricompense NFT non sono disponibili su Zealy oggi. Il tipo di ricompensa esiste ancora nel modello dati di Zealy, e Zealy un tempo coniava NFT su Polygon tramite un servizio esterno dietro un feature flag, ma l'editor delle quest offre sei tipi di ricompensa e NFT non è tra questi. Il campo stesso mostra una sola riga: Le ricompense NFT non sono ancora disponibili. Se la consegna di NFT come output diretto di una quest è ciò che ti serve, Galxe elenca gli NFT tra i tipi di ricompensa delle sue quest e Zealy no.

Solo per USDC. Le ricompense in USDC vengono accreditate automaticamente al completamento di una claim, da un saldo che prefinanzi, e il membro preleva sul wallet Polygon collegato. Per il token di un progetto, Zealy decide chi ha vinto e registra quale indirizzo pagare, poi tu invii dal tuo wallet e incolli l'hash della transazione in Zealy. Zealy non detiene alcun firmatario per le ricompense in token, quindi la tua community paga il gas, e Zealy controlla il formato di quell'hash senza verificare on-chain che l'importo corretto sia arrivato all'indirizzo corretto.

Usa l'esportazione della classifica o quella dei vincitori dei premi. L'esportazione dei membri è il file sbagliato: restituisce userId, nome, ruolo, XP, data di iscrizione e stato di ban, senza alcun indirizzo wallet. Le esportazioni della classifica e dei vincitori dei premi includono invece gli indirizzi, ed è per questo che sono quelle che ti servono al termine di uno sprint.

No. I filtri dei membri di Zealy sono tredici colonne: id, nome, ruolo, data di iscrizione, handle e ID Discord, username TikTok, username X, numero di follower X, ID X, email, paese e indirizzo ETH. La data di iscrizione è l'unico campo data, quindi non esiste un filtro per ultima attività, ultima richiesta o XP negli ultimi 30 giorni. Gli XP non sono filtrabili in alcun modo, né ordinabili: vengono mostrati, ma calcolati dopo che la pagina dei membri è già stata recuperata. Zealy mostra gli utenti attivi come aggregato nel tempo senza nominarli. Lo sprint è il sostituto: produce l'elenco dei membri attivi di recente come classifica invece che come query.

Uno sprint di Zealy non ha una modalità estrazione: il pagamento dello sprint avviene per posizione e XP, con i membri a zero XP esclusi e una zona premi rigida per i primi N. La casualità risiede invece nei premi delle quest: l'estrazione è uno dei cinque metodi di premio insieme a tutti, primo arrivato, primi e voto; si imposta per singolo premio e non per quest, è limitata a 1.000 vincitori e l'estrazione è un ordinamento casuale delle richieste andate a buon fine. Un'estrazione richiede inoltre un limite di richieste o una data di chiusura per essere valida. Usa lo sprint quando vuoi premiare chi ha fatto di più, e un'estrazione di quest quando vuoi che tutti coloro che hanno superato una soglia abbiano una possibilità.