Blog

Tradução automática · Ler em inglês

Como distribuir tokens para membros ativos (NFTs: ainda não)

A Zealy não consegue filtrar membros por atividade recente e não consegue enviar NFTs hoje. O mecanismo que funciona é um sprint — com o cálculo do pagamento lido a partir do código.

Por Mathis Grosjean

Capa de artigo da Zealy em um fundo escuro texturizado com o texto: Recompense quem apareceu — tokens, NFTs e quem realmente os recebe.
Nesta página

Resposta curta: Faça um sprint. Na Zealy, um sprint é um leaderboard com data de início e data de término, então o XP que ele classifica é conquistado dentro dessa janela, e não acumulado para sempre. Esse é o único mecanismo do produto que paga as pessoas por estarem ativas agora, em vez de por terem entrado uma vez. A Zealy então decide quem venceu e registra qual endereço pagar. Ela não move os tokens e não consegue anexar um NFT de forma alguma — o próprio campo de recompensa diz isso: Recompensas em NFT ainda não estão disponíveis.

O que este post não vai fazer: entregar um filtro que não existe. Você não pode pedir à Zealy "membros que resgataram algo nos últimos 30 dias" e receber uma lista. E ele não vai dizer como enviar um NFT pela Zealy, porque não há recompensa em NFT para enviar. O que ele pode fazer pela parte dos NFTs é obter uma lista defensável de destinatários — o sprint decide quem, e a criação e o envio acontecem nas suas próprias ferramentas.

Divulgação: A Zealy publica este conteúdo e a Zealy vende o produto descrito. Todo comportamento da Zealy abaixo foi extraído do código-fonte da Zealy, e não da documentação oficial da Zealy, que se mostrou incorreta em vários pontos. Todo número externo traz sua fonte no ponto em que aparece.

Última verificação: 15 de agosto de 2026.

Por que "recompensar meus membros ativos" é mais difícil do que parece

A maioria das distribuições de tokens paga por um retrato do passado e depois observa os tokens irem embora. Em um estudo acadêmico de nove airdrops, na maioria dos protocolos o destinatário mediano fez uma única transferência de tokens, e o intervalo mediano entre a primeira e a última foi de zero dias. Recompensar a atividade, em vez disso, significa pagar por comportamento dentro de uma janela que você define.

Esse estudo é "Airdrops: Dar Dinheiro É Mais Difícil Do Que Parece" por Johnnatan Messias, Aviv Yaish e Benjamin Livshits, cobrindo nove distribuições de protocolo. Uma transferência e nenhum tempo decorrido não é um membro que você conquistou. É uma fila que você pagou para ficar na sua frente uma vez.

A resposta usual é filtrar com mais rigor antes de enviar, o que funciona de forma cara e tardia. Essa abordagem, e o que Optimism e LayerZero obtiveram com ela, é o tema de como executar um airdrop que não seja farmado.

Há uma versão mais barata da mesma ideia. Em vez de distribuir para todos e depois subtrair as pessoas que você não queria, defina uma janela, publique o que gera crédito dentro dela e pague o ranking resultante. Ninguém precisa ser removido, porque ninguém nunca esteve na lista de graça.

Você não pode filtrar membros do Zealy por atividade recente

A tabela de membros do Zealy filtra por exatamente treze colunas: id, nome, função, data de entrada, handle e ID do Discord, nome de usuário do TikTok, nome de usuário do X, contagem de seguidores no X, ID do X, email, país e endereço ETH. A data de entrada é a única data. Não há filtro de última atividade, filtro de último claim nem filtro de XP nos últimos 30 dias.

Isso surpreende as pessoas, então vale ser exato sobre até onde isso vai. A página de membros fornece a lista acima. O XP nem está nela — o XP aparece como coluna, mas é calculado depois que a página de membros já foi buscada, por isso não é possível filtrar nem ordenar por ele. A API pública é ainda mais limitada: search, roles, ids, joinedAfter, joinedBefore e uma ordenação. As análises da Zealy mostram usuários ativos ao longo do tempo em gráficos, mas um gráfico é um agregado. A Zealy dirá quantas pessoas estiveram ativas na semana passada e não entregará os nomes delas.

Ordenar por XP também não resolve, porque o XP de um membro é um total acumulado, e não algo limitado a um período. Um membro que farmou muito em março e não abre seu questboard desde então ainda fica à frente de alguém que reivindicou algo toda semana neste mês. Ordenar sua comunidade por XP é ordená-la por histórico.

Então a declaração honesta da limitação: na Zealy hoje, "ativo" não é uma propriedade de um membro que você possa consultar. É uma propriedade de um período de tempo que você define.

O mecanismo que funciona na Zealy: um sprint

Um sprint da Zealy é um leaderboard com data de início e data de fim, que conta o XP das reivindicações feitas dentro dessa janela nas quests incluídas no sprint. O ranking é uma lista de quem esteve ativo durante o período que você escolheu. Membros com zero XP de sprint são excluídos do pagamento automaticamente.

Esse último detalhe faz mais do que parece. A metade inativa da sua comunidade não é filtrada por uma regra que você escreveu; ela está ausente do resultado porque não fez nada na janela. Você obtém o filtro que queria como efeito colateral do formato da coisa.

Uma ressalva, porque ela decide se você pode chamar um sprint de medição limpa: o XP concedido manualmente por um admin dentro da janela também conta para o sprint, junto com as reivindicações. Se você distribui XP de bônus, está ajustando o mesmo número a partir do qual o pagamento é calculado.

Os sprints pagam de uma de duas formas, e vale entender as duas antes de escolher um número.

Proporcional. Cada membro recebe floor(pool × their sprint XP ÷ total sprint XP)Considere um pool de 10.000 tokens, 250.000 XP entre todos os elegíveis e um membro que ganhou 4.000 desse total: a parte dele é de 160 tokens. Cada parte é arredondada para baixo, então os pagamentos podem somar um pouco menos que o pool. Observe que, se você também definir uma zona de recompensa, o total nesse denominador é recalculado apenas sobre as pessoas dentro da zona — então adicionar um corte aumenta a parte de todos e também encurta a lista.

Em níveis. Você define faixas de classificação, cada uma recebendo uma porcentagem do pool, dividida igualmente dentro da faixa. As classificações 1–10 podem receber 40% entre elas e as classificações 11–50 outros 20%. Você pode definir até 50 níveis, e eles não podem se sobrepor nem deixar lacuna entre as faixas. O pagamento por níveis recompensa a posição em vez do esforço, que é o que você quer quando o objetivo é uma corrida visível.

Além de qualquer um dos dois, a zona de recompensa é um corte rígido de top-N. Defina como 200 e a classificação 201 não recebe nada, não importa quanto XP tenha ganhado. Um sprint não tem modo sorteio — o pagamento é por classificação e XP, então se você quer aleatoriedade, está olhando para um método de recompensa de quest em vez de um sprint.

As comunidades vêm executando exatamente esse formato há anos. Bandzaï descreveu um sprint com quase 600.000 $BZAI e NFTs Zaï para os 200 melhores jogadores do leaderboard. CoinW realizou um leaderboard Top 50 com a maior recompensa de 100 USDT. Alphaday colocou os 10 melhores colocados do seu leaderboard na disputa por uma parte de um prêmio total de $300 em ETH. ShimmerSea ofereceu 5,500 USDT e 404 NFTs especiais Lumi para fazer as pessoas testarem todas as partes do seu protocolo. Todos os quatro estudos de caso são de 2023, e todos os quatro são zonas de recompensa com uma data definida.

Um deles comprova o ponto sobre NFTs para mim. O prêmio da Bandzaï foi tokens e NFTs para uma zona top-200. O sprint seleciona os 200. Entregar os NFTs a eles era, e ainda é, tarefa do próprio projeto — o que nos leva ao que a Zealy vai e não vai colocar nas mãos de alguém.

O que a Zealy realmente envia, tipo de recompensa por tipo de recompensa

O modelo de dados da Zealy tem sete tipos de recompensa e o editor de quests oferece seis: XP, cargo no Discord, Zaps, USDC, token e um "outro" personalizado. USDC é o único que chega sozinho. Recompensas em token são registradas em vez de enviadas, e recompensas em NFT não estão disponíveis no produto hoje.

RecompensaNo editor de quests?Quem realmente movimenta
XPSimZealy, dentro da Zealy
ZapsSimZealy, dentro do Zealy
Cargo no DiscordSimO bot do Zealy, de forma assíncrona; um membro sem Discord vinculado nunca recebe um
USDCSimZealy, automaticamente em um claim bem-sucedido, a partir de um saldo que você pré-financia
TokenSimVocê. Zealy registra o vencedor e o endereço para pagamento
Personalizado "outro"SimVocê, pelos meios que você descreveu
NFTNãoNinguém. O campo diz Recompensas NFT ainda não estão disponíveis

A linha de NFT é a que você deve ler duas vezes. O modelo de dados da Zealy ainda inclui um tipo de recompensa NFT, e a Zealy de fato já cunhou NFTs por meio de um serviço externo na Polygon, atrás de uma feature flag. No produto que você usa hoje, o campo de recompensa NFT exibe apenas uma string informando que ela não está disponível, e tudo por trás disso está desativado. Qualquer guia que mostre como anexar uma recompensa NFT a uma quest da Zealy está descrevendo algo que não existe.

Recompensas em token funcionam, com uma divisão de trabalho fácil de interpretar errado. A Zealy decide quem ganhou e grava uma linha pendente com o vencedor e o endereço verificado dele. Depois você envia da sua própria carteira e cola o hash da transação de volta — há uma ação em massa que aplica um único hash a todos os vencedores pendentes de uma vez, o que permite liquidar um sprint com top 200 sem 200 cópias e colagens. A Zealy oferece suporte a mais de vinte identificadores de rede para isso, dois dos quais são testnets.

Quatro etapas para uma recompensa em token da Zealy. A Zealy decide quem ganhou, depois registra o vencedor e o endereço a pagar. Você envia os tokens e paga o gas, depois cola o hash da transação de volta.

Onde a Zealy termina e a comunidade começa, no caso de uma recompensa em token. USDC é a exceção — é creditado automaticamente.

Duas consequências decorrem disso, e nenhuma está no material de marketing. A Zealy não mantém nenhum signer para recompensas em token, então a comunidade paga o gas. E a Zealy atualmente não verifica on-chain se o valor correto chegou ao endereço correto. O formulário de vencedor único verifica se o ID da transação ao menos tem um formato válido; a ação em massa que aplica um único hash a todos os vencedores pendentes só verifica se você digitou algo. O hash é um registro da sua declaração de que pagou, não uma prova de pagamento. Se sua comunidade for grande o bastante para que essa distinção importe, mantenha sua própria conciliação.

USDC é a exceção que se comporta como as pessoas esperam que uma recompensa se comporte. Você adiciona saldo, cada quest bloqueia fundos contra ele, e um claim bem-sucedido credita o membro automaticamente. O USDC acumula como saldo do lado da Zealy e é sacado para a carteira Polygon vinculada do membro. Direcione as pessoas para a tela de saque para ver os termos atuais, em vez de prometer um valor líquido no briefing da sua campanha.

O que os destinatários devem sobre qualquer um desses pontos é uma questão separada com consequências reais, e ganhar cripto sem comprar nenhuma cobre o lado do destinatário.

Zealy vs Galxe na entrega da recompensa

A Galxe oferece um tipo de recompensa em NFT e executa sorteios de tokens on-chain. A Zealy não faz nenhum dos dois: recompensas em NFT estão desativadas e recompensas em tokens são registradas, não enviadas. Em contrapartida, o sorteio on-chain da Galxe cobra uma taxa de gas do usuário, e as recompensas personalizadas da Galxe são distribuídas pelo projeto, assim como os tokens da Zealy.

ZealyGalxe
NFT como tipo de recompensaNão disponível; o campo diz Recompensas em NFT ainda não estão disponíveisSuportado. A Galxe lista suas recompensas como "Points, OAT, NFT, Custom Rewards, Mystery Boxes, Tokens e Discord Roles" e afirma que "suporta recompensas NFT em qualquer rede blockchain compatível"
Distribuição de tokensA Zealy registra o vencedor e o endereço; o projeto envia"Token Raffles" operam on-chain, enquanto "Token FCFS" permanece off-chain sem acionar uma transação
Quem paga o gasO projeto, da própria carteiraPara recompensas de tokens no modo sorteio, "exigindo que os usuários paguem uma taxa de transação de gas em tokens G na rede Gravity"
Recompensas personalizadasO projeto entrega, assim como os tokens"O projeto é responsável por distribuir essas recompensas, que serão tratadas fora do Galxe"

As citações do Galxe vêm da sua documentação de recompensas publicada, vinculada no cabeçalho da tabela.

Leia a troca com honestidade. Se o que você precisa é um NFT chegando em uma carteira como resultado direto de concluir uma quest, o Galxe faz isso e o Zealy não, e nenhum design de sprint do Zealy substitui isso. Se o que você precisa é uma distribuição em que os destinatários não pagam nada e não tocam em nenhuma chain para receber, o caminho de USDC do Zealy faz isso e um sorteio on-chain não. Ambas as plataformas deixam recompensas personalizadas nas mãos do projeto, então ninguém resolveu o caso geral.

Como executar um pagamento de sprint no Zealy, passo a passo

Defina primeiro as datas do sprint, porque a janela é o filtro. Escolha pagamento proporcional ou por faixas e uma zona de recompensa. Quando o sprint encerrar, exporte o leaderboard ou os vencedores da recompensa para obter os endereços das carteiras, envie da sua própria carteira e cole o hash da transação de volta no Zealy.

1. Decida o que a janela está medindo. O XP do sprint vem de claims feitos entre as datas de início e fim, então as quests que você publica dentro dessa janela são a definição de "ativo" pela qual você está pagando. Se você quer profundidade em vez de cliques, pondere o XP dessa forma antes do sprint abrir, não depois. Criando um sprint aborda a configuração.

2. Escolha proporcional ou escalonado. O proporcional recompensa o volume de esforço e gera uma longa cauda de pagamentos pequenos. O escalonado concentra o valor no topo e gera uma corrida. Uma zona de recompensa de algumas centenas mantém a lista de pagamentos em um tamanho que você consegue liquidar manualmente.

3. Restrinja as quests, não os membros. Não há lista de membros permitidos no Zealy, então a forma de manter um sprint honesto é com condições de quest. O Zealy aceita sete tipos de condição — concluir outra quest, nível, cargo no Discord, data, possuir um NFT, número de seguidores no X e idade da conta no X — combinados com AND ou OR. Condições de nível aceitam apenas "above" e "below", e a restrição por NFT é exclusiva da Polygon. A documentação de condições lista todos os sete.

4. Escolha o método de recompensa por recompensa. Métodos de recompensa são todos, por ordem de chegada, sorteio, top e votação, e são definidos por recompensa, não por quest. Por ordem de chegada e sorteio têm limite de 1.000 vencedores cada, top também tem limite de 1.000, e votação não tem limite máximo. Um sorteio é uma ordenação aleatória das reivindicações bem-sucedidas e precisa de um limite de reivindicações ou de uma data de encerramento para ser válido.

5. Exporte o arquivo correto. A exportação de membros fornece userId, nome, função, XP, data de entrada e status de banimento, e nenhum endereço de carteira. Os endereços vêm da exportação do leaderboard ou da exportação de vencedores de recompensas — embora o arquivo de vencedores de recompensas emita especificamente uma coluna de endereço Ethereum, então uma comunidade Solana ou TON deve usar a exportação do leaderboard. Baixar a lista de membros e se perguntar onde foram parar as carteiras é a hora mais comumente desperdiçada em todo esse fluxo de trabalho.

6. Envie, depois registre. Pague pela sua carteira, cole o hash, use a ação em massa se a lista de vencedores for longa. Publique o hash também para a sua comunidade — como a Zealy não verifica on-chain, a verificação pelos seus membros é a checagem que existe. Documentação de recompensas cobre a configuração da recompensa em si.

As partes que vão te morder

A Zealy não tem lista de membros permitidos, nem bloqueio por saldo de tokens, nem verificação on-chain de que sua transação de pagamento fez o que você diz que fez. Redefinir o leaderboard é destrutivo e altera a data de início de um sprint ativo. A exportação de membros não contém endereço de carteira. Cada um desses pontos tem uma solução alternativa, e nenhuma delas é óbvia.

A redefinição do leaderboard é a que custa dinheiro de verdade. Redefinir apaga concessões manuais de XP, zera o contador de claims de cada quest e — se um sprint estiver em andamento — puxa a data de início desse sprint para o momento da redefinição. Metade do histórico do seu sprint pode desaparecer por causa de um botão que parece só manutenção. Termine os sprints antes de redefinir, ou não redefina de jeito nenhum.

Os bloqueios ausentes moldam o que você pode prometer. Você não pode enviar uma lista de endereços e restringir uma quest a eles, e uma condição de saldo de tokens não é algo que você possa definir, embora o conceito exista no código. Então "somente holders" não é um sprint da Zealy que você possa configurar; possuir NFT na Polygon é o bloqueio mais próximo disponível.

O bloqueio por nível merece um aviso próprio. Você bloqueia por nível, não por XP bruto, e apenas acima ou abaixo de um nível. Os limites de nível vêm de uma curva global fixa idêntica em todas as comunidades da Zealy, então uma faixa "nível 5 e acima" significa a mesma quantidade de XP acumulado na sua comunidade que na de todo mundo. Projete as faixas sabendo que você não está definindo os limites — como executar um programa de embaixadores cripto funciona criando patentes nomeadas em torno dessa restrição.

Nada disso faz do sprint uma resposta ruim. Faz dele uma resposta específica: o Zealy é bom em decidir quem merece a recompensa e nada romântico na hora de movimentá-la. Se você entrar esperando um motor de distribuição, vai se irritar. Se entrar esperando um placar muito preciso com um botão de exportar, é exatamente isso que vai receber, e o envio são trinta minutos da sua própria carteira.

FAQs

Defina uma janela de tempo e pague o ranking que sair dela, em vez de filtrar uma lista de membros depois do fato. No Zealy isso é um sprint: um leaderboard com data de início e fim, em que o XP só acumula a partir de claims feitos dentro da janela e membros com zero XP de sprint são excluídos do pagamento automaticamente. Defina uma zona de recompensa — o top 50, o top 200 — e pague proporcionalmente por XP ou em faixas por posição.

Não. Recompensas em NFT não estão disponíveis no Zealy hoje. O tipo de recompensa ainda existe no modelo de dados do Zealy, e o Zealy já cunhou NFTs na Polygon por meio de um serviço externo atrás de uma feature flag, mas o editor de quests oferece seis tipos de recompensa e NFT não é um deles. O próprio campo exibe uma única linha: recompensas em NFT ainda não estão disponíveis. Se a entrega de NFT como resultado direto de uma quest é o que você precisa, a Galxe lista NFT entre seus tipos de recompensa de quest e o Zealy não.

Só para USDC. Recompensas em USDC são creditadas automaticamente em um claim bem-sucedido, a partir de um saldo que você pré-financia, e o membro saca para a carteira Polygon vinculada. Para o token próprio de um projeto, o Zealy decide quem ganhou e registra qual endereço pagar, então você envia da sua própria carteira e cola o hash da transação de volta no Zealy. O Zealy não detém nenhum signer para recompensas em token, então sua comunidade paga o gas, e o Zealy confere o formato desse hash sem verificar on-chain se o valor certo chegou ao endereço certo.

Use a exportação do leaderboard ou a exportação de vencedores de recompensas. A exportação de membros é o arquivo errado — ela retorna userId, name, role, XP, join date e ban status, sem nenhum endereço de carteira. As exportações do leaderboard e de vencedores de recompensas incluem endereços, por isso são elas que você quer ao final de um sprint.

Não. Os filtros de membros do Zealy são treze colunas: id, name, role, join date, Discord handle e ID, TikTok username, X username, X follower count, X ID, email, country e ETH address. Join date é o único campo de data, então não há filtro de last-active, last-claim ou XP-in-the-last-30-days. XP não é filtrável de forma alguma, nem ordenável: ele é exibido, mas calculado depois que a página de membros já foi buscada. O Zealy exibe usuários ativos como um agregado ao longo do tempo sem nomeá-los. Um sprint é o substituto: ele produz a lista de membros ativos recentemente como um ranking em vez de uma consulta.

Um sprint do Zealy não tem modo de sorteio — o pagamento do sprint é por rank e XP, com membros com zero XP excluídos e uma zona rígida de recompensa top-N. A aleatoriedade fica nas recompensas de quests: sorteio é um dos cinco métodos de recompensa, ao lado de all, first-come-first-served, top e vote, é definido por recompensa e não por quest, tem limite de 1.000 vencedores, e o sorteio é uma ordenação aleatória das claims bem-sucedidas. Um sorteio também precisa de um limite de claims ou de uma data de encerramento para ser válido. Use o sprint quando quiser pagar as pessoas que mais fizeram, e um sorteio de quest quando quiser que todos que atingiram um critério tenham uma chance.