Como fazer um snapshot de holders na NEAR: a lista de wallets de qualquer token ou coleção NFT em CSV
Se você vai recompensar sua comunidade, montar uma allowlist ou só quer saber quem tem seu token, aprender como fazer um snapshot de holders na NEAR é o primeiro passo. Em poucos segundos você obtém a lista completa de contas que têm um token ou um NFT, pronta para baixar em CSV ou transformar direto em um airdrop.
Neste guia eu te mostro para que serve um snapshot na NEAR, como extraí-lo de um token e de uma coleção NFT com a tool da Smithii, o que a lista inclui e o que fica de fora, e quanto custa. Bora lá.
O que é um snapshot de holders e para que serve na NEAR
Um snapshot é uma fotografia da distribuição de um ativo em um momento específico, com todas as contas que o possuem e seu saldo. Na NEAR tem uma vantagem curiosa frente a outras redes, porque muitas dessas contas são nomes legíveis, tipo alice.near ou um usuário do Telegram, e dá para entender a lista de uma olhada.
Os usos mais comuns para um dev são estes:
- Airdrops para holders: distribuir um token novo para quem tem outro, ou para quem possui um NFT da sua coleção.
- Allowlists: dar acesso prioritário a uma venda ou a um mint para quem já faz parte do projeto.
- Migrações: se você relançar um token, a lista permite devolver a cada holder o que ele tinha.
- Análise de distribuição: ver se poucas wallets concentram supply demais antes de tomar decisões.
Nenhum desses usos exige que os holders façam nada nem que te deem permissão. Os saldos de qualquer token estão on-chain à vista de todos, e o que a tool entrega é reuni-los, limpá-los e te entregá-los em um formato utilizável sem precisar consultar a API de um explorer ou escrever um script. Por isso também serve para estudar tokens que não são seus, por exemplo o de um projeto com cuja comunidade você quer colaborar.
Como fazer um snapshot de holders na NEAR para um token
O Token Snapshot de Smithii para NEAR é uma tool que permite exportar todas as contas que possuem um token NEP-141 sem escrever código nem consultar a API de um explorer. Ela te sugere os tokens com mais atividade no momento e deixa você colar qualquer outro. Quando estiver na interface da tool, você verá o seguinte:
Se tiver a conta do token à mão e 11,55 NEAR para a taxa, o processo é este:
- Conecte sua wallet da NEAR: HOT, Meteor ou qualquer uma do seletor.
- Escolha o token: clique em um dos tokens em alta ou cole a conta dele, por exemplo token.rhealab.near.
- Clique em Take Snapshot: a tool verifica o número de holders e pede para você aprovar a taxa.
- Baixe ou reutilize a lista: em CSV ou TXT, ou mande direto para o Multisender da NEAR.
Antes de cobrar qualquer coisa, a tool lê quantos holders o token tem e mostra uma estimativa junto ao nome dele. Se passar do limite, ela te avisa antes do pagamento, então você nunca paga por uma lista que não dá para montar.
Como extrair os holders de uma coleção NFT da NEAR
A mesma tool tem uma segunda aba, o NFT Snapshot para NEAR, que funciona com coleções do padrão NEP-171. Em vez de saldos, ela te devolve as contas que possuem pelo menos um NFT da coleção. Ao abrir, você verá o seletor de coleções:
O funcionamento é idêntico ao dos tokens. Você escolhe uma coleção ativa ou cola a conta do contrato dela, tipo asac.near, clica em Take Snapshot, aprova os 11,55 NEAR e baixa a lista ou manda para o multisender. As coleções que aparecem no seletor são as que têm mais transferências naquele dia, junto com o número de holders.
O que a lista de holders inclui e o que fica de fora
A lista sai dos dados indexados pela NearBlocks e a tool a filtra antes de te entregar. As contas com saldo zero e a própria conta do token são removidas, porque não acrescentam nada a uma distribuição.
O que permanece são as contas de contratos que têm saldo, como as pools da Rhea ou as tesourarias de uma DAO. São holders reais do ponto de vista técnico, mas não são pessoas, então revise a lista antes de usá-la em um airdrop e decida se quer incluí-las.
O caso dos tokens com reflection
Nos tokens com reflection, os saldos crescem sozinhos a cada transferência e o indexer pode ficar atrasado. Para os tokens criados com Smithii, a tool lê de novo direto da chain o saldo dos maiores holders, de modo que os números no topo da lista sejam os reais.
Quando fazer o snapshot do seu token na NEAR
O momento em que você tira a fotografia decide quem é premiado. Se anunciar a data com antecedência, atrai compras de última hora de gente que vai vender assim que receber a recompensa, e também de quem distribui o saldo entre várias contas para receber várias vezes.
Existem três formas simples de evitar isso sem complicar a campanha:
- Faça o snapshot antes de anunciar o airdrop: assim a lista reflete quem já estava, não quem chegou atrás da recompensa.
- Combine duas fotografias: tire uma hoje e outra daqui a algumas semanas, e premie apenas as contas que aparecem nas duas. É uma forma direta de recompensar quem segura.
- Defina um saldo mínimo: contas com quantias simbólicas costumam ser poeira ou de quem tenta multiplicar sua parte, e deixá-las de fora reduz o ruído.
Nenhuma regra elimina totalmente o abuso, mas uma lista bem filtrada distribui o token entre holders que ficam, que é o que qualquer projeto busca com esse tipo de campanha.
Quanto custa um snapshot na NEAR e o que acontece se algo falhar
| Tipo de snapshot | O que consulta | Limite | Comissão |
|---|---|---|---|
| Token Snapshot | Contas com saldo de um token NEP-141 | 5.000 holders | 11,55 NEAR |
| NFT Snapshot | Contas com pelo menos um NFT de uma coleção NEP-171 | 5.000 holders | 11,55 NEAR |
O pagamento está protegido nas duas pontas. Se o token for grande demais, você sabe antes de pagar. E se você pagar mas a lista não chegar a carregar, o pagamento fica guardado durante um dia para aquele token e aquela wallet, então você pode repetir o snapshot sem uma segunda cobrança.
Do snapshot ao airdrop sem passos intermediários
O habitual após um snapshot é distribuir algo para essas contas. Com Smithii não é preciso baixar o arquivo e subir de novo, porque um clique carrega os holders no Multisender da NEAR, que ainda registra na sua token as contas que precisarem.
Um exemplo típico é premiar os holders de uma coleção com o token do seu projeto. Você faz o NFT Snapshot, envia a lista ao multisender, escolhe uma quantia igual para todos e em alguns minutos cada holder tem sua recompensa.
Aqui está o processo completo para fazer um airdrop na NEAR com o registro de contas incluído.
Os snapshots ficam também no seu histórico. Você pode baixar de novo um antigo ou comparar duas datas para ver como mudou a distribuição do seu token depois de uma campanha.
FAQ
Quanto custa fazer um snapshot de holders na NEAR?
Cada snapshot custa 11,55 NEAR, tanto o de um token como o de uma coleção NFT, mais um pouco de gas. A comissão é paga ao Smithii antes que a lista seja construída.
Que tokens e coleções posso consultar?
Qualquer token NEP-141 e qualquer coleção NEP-171 da NEAR mainnet com até 5.000 holders. Se o token ou a coleção ultrapassar esse limite, a ferramenta rejeita antes de você pagar.
O que acontece se a lista não carregar depois de pagar?
Seu pagamento fica salvo por um dia para esse token e essa wallet. Rode o snapshot de novo e não será cobrado uma segunda vez.
O snapshot inclui as wallets com saldo zero?
Não. As contas com saldo zero e a própria conta do token ficam fora da lista. Já as contas de contratos com saldo, como as pools, aparecem sim, e vale a pena revisá-las antes de um airdrop.
Posso repetir um snapshot que fiz há dias?
Sim. Os snapshots ficam salvos no seu histórico e você pode baixá-los ou reutilizá-los mais tarde, por exemplo para comparar como a distribuição mudou entre duas datas.
Conclusão
Depois que você entende como fazer um snapshot de holders em NEAR, consegue transformar qualquer token ou coleção em uma lista de contas pronta para um airdrop, uma allowlist ou uma análise. A ferramenta confere o tamanho antes de cobrar e já filtra os saldos vazios para você.
Revise as contas de contratos antes de distribuir e aproveite a conexão com o multisender. Com isso, o pulo da lista para o reparto é imediato.
Criador de conteúdo e contribuidor SEO na Smithii. Estudante de Engenharia de Sistemas e entusiasta de crypto e tecnologia.
