Blog

Traduction automatique · Lire en anglais

Comment distribuer des tokens aux membres actifs (NFT : pas encore)

Zealy ne peut pas filtrer les membres par activité récente et ne peut pas envoyer de NFT aujourd'hui. Le mécanisme qui fonctionne est un sprint — avec le calcul des paiements lu dans le code.

Par Mathis Grosjean

Couverture d'article Zealy sur un fond sombre texturé indiquant : Récompensez ceux qui se sont présentés — tokens, NFT et qui les reçoit réellement.
Sur cette page

Réponse courte : Lancez un sprint. Sur Zealy, un sprint est un classement avec une date de début et une date de fin, donc les XP classés sont gagnés dans cette fenêtre plutôt qu'accumulés indéfiniment. C'est le seul mécanisme du produit qui rémunère les gens pour leur activité actuelle plutôt que pour s'être inscrits une fois. Zealy décide ensuite qui a gagné et enregistre l'adresse à payer. Il ne transfère pas les tokens et ne peut pas attacher de NFT du tout — le champ de récompense le dit lui-même : Les récompenses NFT ne sont pas encore disponibles.

Ce que cet article ne fera pas : vous fournir un filtre qui n'existe pas. Vous ne pouvez pas demander à Zealy « les membres qui ont réclamé quelque chose au cours des 30 derniers jours » et obtenir une liste. Et il ne vous dira pas comment envoyer un NFT via Zealy, car il n'y a pas de récompense NFT à envoyer. Ce qu'il peut faire pour la partie NFT, c'est vous obtenir une liste de destinataires défendable — le sprint décide qui, et le minting et l'envoi se font dans vos propres outils.

Divulgation : Zealy publie ceci et Zealy vend le produit décrit. Chaque comportement de Zealy ci-dessous a été lu dans le code source de Zealy plutôt que dans la documentation de Zealy, qui s'est avérée erronée à plusieurs endroits. Chaque chiffre externe porte sa source à l'endroit où il apparaît.

Dernière vérification : 15 août 2026.

Pourquoi « récompenser mes membres actifs » est plus difficile qu'il n'y paraît

La plupart des distributions de tokens paient pour un instantané du passé puis regardent les tokens partir. Dans une étude académique de neuf airdrops, sur la plupart des protocoles, le destinataire médian a effectué un seul transfert de tokens, et l'écart médian entre son premier et son dernier était de zéro jour. Récompenser l'activité signifie plutôt payer pour un comportement dans une fenêtre que vous définissez.

Cette étude est « Airdrops: Giving Money Away Is Harder Than It Seems » de Johnnatan Messias, Aviv Yaish et Benjamin Livshits, couvrant neuf distributions de protocoles. Un transfert et aucun temps écoulé, ce n'est pas un membre que vous avez acquis. C'est une file d'attente que vous avez payée pour se tenir devant vous une fois.

La réponse habituelle est de filtrer plus durement avant d'envoyer, ce qui fonctionne chèrement et tardivement. Cette approche, et ce qu'Optimism et LayerZero en ont obtenu, fait l'objet de comment lancer un airdrop qui ne se fait pas farmer.

Il existe une version moins coûteuse de la même idée. Au lieu de distribuer à tout le monde puis de soustraire les personnes non désirées, définissez une fenêtre, publiez ce qui rapporte des crédits à l'intérieur, et payez le classement qui en résulte. Personne n'a besoin d'être retiré, car personne n'a jamais été sur la liste gratuitement.

Vous ne pouvez pas filtrer les membres Zealy par activité récente

Le tableau des membres de Zealy filtre sur exactement treize colonnes : id, nom, rôle, date d'inscription, identifiant et handle Discord, nom d'utilisateur TikTok, nom d'utilisateur X, nombre d'abonnés X, ID X, email, pays et adresse ETH. La date d'inscription est la seule date. Il n'y a pas de filtre dernière activité, pas de filtre dernière réclamation, et pas de filtre XP des 30 derniers jours.

Cela surprend les gens, il vaut donc la peine d'être précis sur l'ampleur du problème. La page des membres vous donne la liste ci-dessus. Les XP n'y figurent même pas — les XP sont affichés comme une colonne mais calculés après que la page de membres a déjà été récupérée, ce qui explique qu'ils ne peuvent être ni filtrés ni triés. L'API publique est encore plus limitée : recherche, rôles, ids, joinedAfter, joinedBefore et un tri. Les analytics de Zealy tracent bien les utilisateurs actifs dans le temps, mais un graphique est un agrégat. Zealy vous dira combien de personnes étaient actives la semaine dernière et ne vous donnera pas leurs noms.

Trier par XP ne vous sauve pas non plus, car les XP d'un membre sont un total cumulé et non quelque chose limité à une période. Un membre qui a farmé dur en mars et n'a pas ouvert votre tableau de quêtes depuis dépasse encore quelqu'un qui a réclamé quelque chose chaque semaine ce mois-ci. Trier votre communauté par XP la trie par historique.

Donc l'énoncé honnête de la contrainte : sur Zealy aujourd'hui, « actif » n'est pas une propriété d'un membre que vous pouvez interroger. C'est une propriété d'une période de temps que vous définissez.

Le mécanisme qui fonctionne sur Zealy : un sprint

Un sprint Zealy est un classement avec une date de début et une date de fin, comptant les XP des réclamations effectuées dans cette fenêtre sur les quêtes incluses dans le sprint. Le classement est une liste de ceux qui ont été actifs pendant la période que vous avez choisie. Les membres avec zéro XP de sprint sont automatiquement exclus du paiement.

Ce dernier détail fait plus qu'il n'y paraît. La moitié dormante de votre communauté n'est pas filtrée par une règle que vous avez écrite ; elle est absente du résultat parce qu'elle n'a rien fait dans la fenêtre. Vous obtenez le filtre souhaité comme effet secondaire de la forme de la chose.

Une mise en garde, car elle détermine si vous pouvez qualifier un sprint de mesure propre : les XP accordés manuellement par un admin dans la fenêtre comptent aussi pour le sprint, en plus des réclamations. Si vous distribuez des XP bonus, vous ajustez le même nombre à partir duquel le paiement est calculé.

Les sprints paient de deux façons, et les deux valent la peine d'être comprises avant de choisir un nombre.

Proportionnel. Chaque membre reçoit floor(pool × their sprint XP ÷ total sprint XP). Prenez un pool de 10 000 tokens, 250 000 XP répartis entre tous les éligibles, et un membre qui en a gagné 4 000 : sa part est de 160 tokens. Chaque part est arrondie à l'inférieur, donc la somme des paiements peut être légèrement inférieure au pool. Notez que si vous définissez aussi une zone de récompense, le total de ce dénominateur est recalculé uniquement sur les personnes situées dans la zone — ajouter un seuil augmente donc la part de chacun tout en raccourcissant la liste.

Par paliers. Vous définissez des plages de classement, chacune prenant un pourcentage du pool, réparti équitablement à l'intérieur de la plage. Les rangs 1 à 10 pourraient se partager 40 % et les rangs 11 à 50 un autre 20 %. Vous pouvez définir jusqu'à 50 paliers, qui ne peuvent ni se chevaucher ni laisser d'écart entre les plages. Le mode par paliers récompense la position plutôt que l'effort, ce que vous voulez quand l'enjeu est une course visible.

En plus de l'un ou l'autre, la zone de récompense est un seuil strict de top N. Fixez-le à 200 et le rang 201 ne reçoit rien, quel que soit le XP gagné. Un sprint n'a pas de mode tirage au sort — le paiement se fait par rang et par XP, donc si vous voulez de l'aléatoire, il s'agit d'une méthode de récompense de quête plutôt que d'un sprint.

Les communautés organisent exactement ce format depuis des années. Bandzaï a décrit un sprint avec près de 600 000 $BZAI et des NFT Zaï pour les 200 meilleurs joueurs du classement. CoinW a organisé un classement Top 50 avec une récompense maximale de 100 USDT. Alphaday a placé les 10 meilleurs performeurs de son classement en lice pour une part d'une cagnotte de 300 $ en ETH. ShimmerSea a offert 5 500 USDT et 404 NFT Lumi spéciaux pour inciter les gens à tester chaque partie de son protocole. Les quatre études de cas datent de 2023, et toutes les quatre sont des zones de récompenses assorties d'une date.

L'une d'elles illustre parfaitement mon propos sur les NFT. Le prix de Bandzaï était des tokens et des NFT pour une zone top 200. Le sprint sélectionne les 200. Leur livrer les NFT était, et reste, le travail du projet lui-même — ce qui nous amène à ce que Zealy mettra ou non entre les mains de quelqu'un.

Ce que Zealy envoie réellement, type de récompense par type de récompense

Le modèle de données de Zealy comporte sept types de récompenses et l'éditeur de quêtes en propose six : XP, rôle Discord, Zaps, USDC, token et un « autre » personnalisé. L'USDC est le seul qui arrive de lui-même. Les récompenses en tokens sont enregistrées plutôt qu'envoyées, et les récompenses NFT ne sont pas disponibles dans le produit aujourd'hui.

RécompenseDans l'éditeur de quêtes ?Qui le transfère réellement
XPOuiZealy, au sein de Zealy
ZapsOuiZealy, dans Zealy
Rôle DiscordOuiLe bot Zealy, de manière asynchrone ; un membre sans Discord lié n'en reçoit jamais
USDCOuiZealy, automatiquement lors d'une réclamation réussie, depuis un solde que vous préfinancez
TokenOuiVous. Zealy enregistre le gagnant et l'adresse de paiement
Personnalisé « autre »OuiVous, par les moyens que vous avez décrits
NFTNonPersonne. Le champ indique Les récompenses NFT ne sont pas encore disponibles

La ligne NFT est celle à lire deux fois. Le modèle de données de Zealy comporte toujours un type de récompense NFT, et Zealy a bien déjà frappé des NFT via un service externe sur Polygon derrière un feature flag. Dans le produit que vous utilisez aujourd'hui, le champ de récompense NFT affiche une simple chaîne indiquant qu'elle n'est pas disponible, et tout ce qui se trouve derrière est désactivé. Tout guide qui vous montre comment attacher une récompense NFT à une quête Zealy décrit quelque chose qui n'existe pas.

Les récompenses en tokens fonctionnent, avec une répartition des rôles facile à mal interpréter. Zealy décide qui a gagné et écrit une ligne en attente contenant le gagnant et son adresse vérifiée. Ensuite, vous envoyez depuis votre propre portefeuille et collez le hash de transaction en retour — une action groupée permet d'apposer un seul hash sur tous les gagnants en attente d'un coup, ce qui vous permet de régler un sprint de 200 participants sans 200 copier-coller. Zealy prend en charge plus de vingt identifiants de réseau pour cela, dont deux testnets.

Quatre étapes pour une récompense en tokens Zealy. Zealy décide qui a gagné, puis enregistre le gagnant et l'adresse à payer. Vous envoyez les tokens et payez le gas, puis vous collez le hash de transaction en retour.

Où Zealy s'arrête et où la communauté commence, pour une récompense en tokens. USDC est l'exception — il est crédité automatiquement.

Deux conséquences en découlent, et aucune ne figure dans les supports marketing. Zealy ne détient aucun signataire pour les récompenses en tokens, donc la communauté paie le gas. Et Zealy ne vérifie pas actuellement on-chain que le bon montant est arrivé à la bonne adresse. Le formulaire pour un seul gagnant vérifie au moins que l'ID de transaction a une forme valide ; l'action groupée qui appose un seul hash sur tous les gagnants en attente vérifie seulement que vous avez saisi quelque chose. Le hash est un enregistrement de votre déclaration de paiement, pas une preuve de paiement. Si votre communauté est assez grande pour que cette distinction compte, gardez votre propre rapprochement.

USDC est l'exception qui se comporte comme on attend d'une récompense. Vous alimentez un solde, chaque quête bloque des fonds dessus, et une réclamation réussie crédite automatiquement le membre. Les USDC s'accumulent sous forme de solde côté Zealy et sont retirés vers le portefeuille Polygon lié du membre. Orientez les gens vers l'écran de retrait pour les conditions en vigueur plutôt que de leur promettre un montant net dans votre brief de campagne.

Ce que les bénéficiaires doivent sur tout cela est une question distincte aux conséquences réelles, et gagner de la crypto sans en acheter couvre le côté bénéficiaire.

Zealy vs Galxe sur l'envoi de la récompense

Galxe propose un type de récompense NFT et exécute des tirages de tokens on-chain. Zealy ne fait ni l'un ni l'autre : les récompenses NFT sont désactivées et les récompenses en tokens sont enregistrées, pas envoyées. En contrepartie, le tirage on-chain de Galxe facture des frais de gas à l'utilisateur, et les récompenses personnalisées de Galxe sont distribuées par le projet, comme les tokens de Zealy.

ZealyGalxe
NFT comme type de récompenseNon disponible ; le champ indique Les récompenses NFT ne sont pas encore disponiblesPris en charge. Galxe liste ses récompenses comme « Points, OAT, NFT, Custom Rewards, Mystery Boxes, Tokens et Discord Roles » et indique qu'il « prend en charge les récompenses NFT sur tout réseau blockchain compatible »
Distribution des tokensZealy enregistre le gagnant et l'adresse ; le projet envoieLes « Token Raffles » fonctionnent on-chain, tandis que « Token FCFS » reste off-chain sans déclencher de transaction
Qui paie le gasLe projet, depuis son propre walletPour les récompenses en tokens en mode tirage au sort, « exigeant que les utilisateurs paient des frais de transaction gas en tokens G sur le réseau Gravity »
Récompenses personnaliséesLe projet livre, comme pour les tokens"Le projet est responsable de la distribution de ces récompenses, qui sera gérée en dehors de Galxe"

Les citations de Galxe proviennent de sa documentation sur les récompenses publiée, liée dans l'en-tête du tableau.

Évaluez l'échange honnêtement. Si ce qu'il vous faut est un NFT arrivant dans un portefeuille comme résultat direct de l'accomplissement d'une quête, Galxe le fait et Zealy non, et aucune conception de sprint Zealy ne peut le remplacer. Si ce qu'il vous faut est une distribution où les bénéficiaires ne paient rien et ne touchent aucune chaîne pour recevoir, la voie USDC de Zealy le fait et une loterie on-chain non. Les deux plateformes laissent les récompenses personnalisées à la charge du projet, donc personne n'a résolu le cas général.

Comment exécuter un paiement de sprint sur Zealy, étape par étape

Définissez d'abord les dates du sprint, car la fenêtre est le filtre. Choisissez un paiement proportionnel ou par paliers et une zone de récompense. À la clôture du sprint, exportez le classement ou les gagnants des récompenses pour obtenir les adresses de portefeuille, envoyez depuis votre propre portefeuille, puis collez le hash de transaction dans Zealy.

1. Décidez ce que la fenêtre mesure. Les XP de sprint proviennent des claims effectués entre les dates de début et de fin, donc les quêtes que vous publiez dans cette fenêtre définissent ce que vous payez comme "actif". Si vous voulez de la profondeur plutôt que des clics, pondérez les XP en ce sens avant l'ouverture du sprint, pas après. Créer un sprint couvre la configuration.

2. Choisissez proportionnel ou par paliers. Les récompenses proportionnelles valorisent le volume d'effort et produisent une longue traîne de petits paiements. Les paliers concentrent la valeur en haut et créent une course. Une zone de récompense de quelques centaines maintient la liste des paiements à une taille que vous pouvez réellement régler à la main.

3. Conditionnez les quêtes, pas les membres. Il n'y a pas de liste d'autorisation des membres sur Zealy, donc la façon de garder un sprint honnête passe par les conditions des quêtes. Zealy accepte sept types de conditions — terminer une autre quête, niveau, rôle Discord, date, détention d'un NFT, nombre d'abonnés X et ancienneté du compte X — combinés avec AND ou OR. Les conditions de niveau acceptent uniquement « above » et « below », et le gating NFT est réservé à Polygon. La documentation des conditions les liste toutes les sept.

4. Choisissez la méthode de récompense pour chaque récompense. Méthodes de récompense sont toutes disponibles : premier arrivé premier servi, tirage au sort, top et vote, et elles sont définies par récompense plutôt que par quête. Le premier arrivé premier servi et le tirage au sort sont chacun limités à 1 000 gagnants, le top est également limité à 1 000, et le vote n'a pas de limite supérieure. Un tirage au sort est un classement aléatoire des participations réussies, et il nécessite soit une limite de participations, soit une date de clôture pour être valide.

5. Exportez le bon fichier. L'export des membres vous donne userId, nom, rôle, XP, date d'inscription et statut de bannissement, et aucune adresse de portefeuille. Les adresses proviennent de l' export du classement ou de l'export des gagnants de récompenses — bien que le fichier des gagnants de récompenses émette spécifiquement une colonne d'adresse Ethereum, donc une communauté Solana ou TON devrait plutôt prendre l'export du classement. Récupérer la liste des membres et se demander où sont passés les portefeuilles est l'heure perdue la plus courante dans tout ce processus.

6. Envoyez, puis enregistrez. Payez depuis votre portefeuille, collez le hash, utilisez l'action groupée si la liste des gagnants est longue. Publiez aussi le hash auprès de votre communauté — Zealy ne le vérifiant pas on-chain, la vérification par vos membres est le seul contrôle existant. Documentation sur les récompenses couvre la configuration des récompenses elle-même.

Les points qui vont vous poser problème

Zealy n'a pas de liste d'autorisation des membres, pas de condition de solde de tokens, et aucune vérification on-chain que votre transaction de paiement a fait ce que vous prétendez. Réinitialiser le classement est destructif et déplace la date de début d'un sprint en cours. L'export des membres ne contient aucune adresse de portefeuille. Chacun de ces points a une solution de contournement, et aucune n'est évidente.

La réinitialisation du classement est celle qui coûte de l'argent réel. Réinitialiser efface les attributions manuelles d'XP, remet à zéro le compteur de claims de chaque quête et — si un sprint est en cours — avance la date de début de ce sprint au moment de la réinitialisation. La moitié de l'historique de votre sprint peut disparaître via un bouton qui ressemble à de l'entretien courant. Terminez les sprints avant de réinitialiser, ou ne réinitialisez pas du tout.

Les conditions manquantes déterminent ce que vous pouvez promettre. Vous ne pouvez pas importer une liste d'adresses et restreindre une quête à celles-ci, et une condition de solde de tokens n'est pas configurable même si le concept existe dans le code. Donc « réservé aux détenteurs » n'est pas un sprint Zealy que vous pouvez configurer ; la détention de NFT sur Polygon est la condition disponible la plus proche.

Le verrouillage par niveau mérite son propre avertissement. Vous verrouillez par niveau, pas par XP brut, et uniquement au-dessus ou en dessous d'un niveau. Les seuils de niveau proviennent d'une courbe globale fixe identique dans chaque communauté Zealy, donc un palier « niveau 5 et plus » signifie la même quantité d'XP accumulée dans votre communauté que dans toutes les autres. Concevez vos paliers en sachant que vous ne définissez pas les seuils — comment lancer un programme d'ambassadeurs crypto passe par la création de rangs nommés autour de cette contrainte.

Rien de tout cela ne fait du sprint une mauvaise réponse. Cela en fait une réponse spécifique : Zealy sait décider qui mérite la récompense et ne fait pas de sentiment pour la distribuer. Si vous y allez en attendant un moteur de distribution, vous serez agacé. Si vous y allez en attendant un tableau de scores très précis avec un bouton d'export, vous obtiendrez exactement cela, et l'envoi représente trente minutes de votre propre portefeuille.

FAQs

Définissez une fenêtre temporelle et payez le classement qui en résulte, plutôt que de filtrer une liste de membres après coup. Sur Zealy, c'est un sprint : un classement avec une date de début et de fin, où les XP ne s'accumulent qu'à partir des claims effectués dans la fenêtre et où les membres ayant zéro XP de sprint sont automatiquement exclus du paiement. Définissez une zone de récompense — le top 50, le top 200 — et payez proportionnellement aux XP ou par paliers selon le rang.

Non. Les récompenses NFT ne sont pas disponibles sur Zealy aujourd'hui. Le type de récompense existe toujours dans le modèle de données de Zealy, et Zealy a déjà minté des NFT sur Polygon via un service externe derrière un feature flag, mais l'éditeur de quêtes propose six types de récompenses et le NFT n'en fait pas partie. Le champ lui-même affiche une seule ligne : NFT rewards are not yet available. Si la livraison de NFT comme résultat direct d'une quête est ce qu'il vous faut, Galxe liste le NFT parmi ses types de récompenses de quête, contrairement à Zealy.

Uniquement pour l'USDC. Les récompenses en USDC sont créditées automatiquement lors d'un claim réussi, à partir d'un solde que vous préfinancez, et le membre retire vers son portefeuille Polygon lié. Pour le token propre d'un projet, Zealy détermine qui a gagné et enregistre l'adresse à payer, puis vous envoyez depuis votre propre portefeuille et collez le hash de transaction dans Zealy. Zealy ne détient aucun signataire pour les récompenses en tokens, donc votre communauté paie le gas, et Zealy vérifie le format de ce hash sans vérifier on-chain que le bon montant a atteint la bonne adresse.

Utilisez l'export du classement ou l'export des gagnants de récompenses. L'export des membres est le mauvais fichier — il renvoie userId, name, role, XP, join date et ban status, sans adresse de portefeuille. Les exports du classement et des gagnants de récompenses incluent bien les adresses, c'est pourquoi ce sont ceux qu'il vous faut à la fin d'un sprint.

Non. Les filtres de membres de Zealy comportent treize colonnes : id, name, role, join date, Discord handle et ID, TikTok username, X username, X follower count, X ID, email, country et ETH address. join date est le seul champ de date, il n'existe donc pas de filtre last-active, last-claim ou XP-in-the-last-30-days. XP n'est pas filtrable du tout, ni triable : il est affiché, mais calculé après le chargement de la page de membres. Zealy mesure les utilisateurs actifs en agrégé dans le temps sans les nommer. Le sprint est la solution de remplacement : il produit la liste des membres récemment actifs sous forme de classement plutôt que de requête.

Un sprint Zealy n'a pas de mode tirage au sort — le paiement du sprint se fait par rang et XP, avec exclusion des membres à zéro XP et une zone de récompense top-N stricte. L'aléatoire réside plutôt dans les récompenses de quêtes : le tirage au sort est l'une des cinq méthodes de récompense avec all, first-come-first-served, top et vote, il se définit par récompense et non par quête, il est plafonné à 1 000 gagnants, et le tirage est un ordre aléatoire des claims réussis. Un tirage au sort nécessite aussi soit une limite de claims, soit une date de clôture pour être valide. Utilisez le sprint pour récompenser ceux qui en ont fait le plus, et un tirage au sort de quête pour donner une chance à tous ceux qui ont franchi un seuil.