Como fazer airdrop de NFTs Solana usando Metaplex e Gumdrop

Este tutorial mostra como fazer airdrop de NFTs na Solana usando o Gumdrop, uma das ferramentas de NFT criadas pela Metaplex. Se você está começando agora a desenvolver projetos de NFT na Solana, este tutorial para iniciantes é para você.

Tempo estimado para concluir este guia: 15 minutos

Neste tutorial, vamos:

1. Criar um NFT
2. Mintar um NFT
3. Fazer airdrop de um NFT com a Gumdrop Command Line Interface (CLI)
4. Criar um link para compartilhar com amigos usando Vervel e Gumdrop

E não se preocupe se você ainda não entende o que essas palavras significam! Vamos passar por tudo juntos.

O que é um airdrop de NFT?

Um airdrop de NFT é quando um NFT gratuito é transferido para um endereço de carteira. Airdrops de NFT são formas populares de projetos de NFT recompensarem colecionadores, incentivarem o engajamento da comunidade ou distribuírem tokens de allowlist para mints futuros. Airdrops de NFT são mais frequentemente usados como uma tática de marketing de NFT.

Alguns exemplos de airdrops de NFT incluem:

1. Swim Protocol - fez airdrop de um Swimmer NFT para pessoas que usaram sua bridge cross-chain
2. Aurory - faz airdrop de novas artes e colecionáveis para colecionadores de seus Aurorian NFTs
3. Degenerate Ape Academy - fez airdrop de tokens de mint para holders de tokens participarem do mint do Degenerate Trash Panda

Ao essencialmente dar um item gratuito a seus holders, projetos de NFT conseguem continuar criando valor para seus tokens e comunidade.

O que é gumdrop?

Gumdrop é um recurso de NFT da Metaplex que permite aos criadores enviar diretamente usuários de uma allowlist para um link de resgate, construindo a árvore com handles off-chain e permitindo que os usuários resgatem em qualquer carteira. O Gumdrop também pode ser usado com Candy Machine, completar airdrops de NFT e distribuir tokens.

O Gumdrop facilita airdrops de NFT na Solana ao simplificar o processo de distribuição de nossos tokens não fungíveis usando uma allowlist.

Como fazer airdrop de NFTs Solana com gumdrop

Para garantir que você está pronto para este tutorial, você precisará das seguintes ferramentas instaladas em sua máquina:

1. NodeJS (versão 16)
2. TS-Node
3. SolanaCLI
4. Yarn
5. Git
6. Metaplex CLI
7. Phantom Wallet

Se você é novo no desenvolvimento em Solana, aprenda como instalar as ferramentas de desenvolvimento da Solana antes de continuar.

Você pode usar o NVM, caso tenha uma versão diferente do Node instalada em sua máquina.

Se algo parecer complicado agora, não se preocupe. A funcionalidade de cada ferramenta será demonstrada conforme avançamos.

Passo 1. Inicializar usando a gumdrop CLI

A instalação e configuração da Gumdrop CLI são feitas através do repositório do Gumdrop no GitHub. Eles fornecem tudo o que você precisa. Vamos clonar o repositório e trazê-lo para nosso computador. Também precisamos confirmar que node, yarn e ts-node estão instalados antes de prosseguir.

Você pode instalar o ts-node executando:

Você pode verificar executando:

Agora, vamos criar uma pasta vazia com o comando mkdir no seu terminal. Vamos nomear essa pasta solana-airdrop.

Execute o comando a seguir dentro da pasta para criar uma carteira Solana:

A mensagem que você vê no terminal deve ser salva em um local seguro, pois precisaremos da pubkey e da seed phrase mais tarde.

Aqui está um exemplo de como isso deve ficar:

Em seguida, clone o projeto Gumdrop na pasta solana-airdrop:

Depois navegamos até o diretório que contém a CLI:

Em seguida, execute:

Este comando instalará todas as dependências necessárias. O processo de instalação pode levar alguns minutos.

A seguir, vamos nos conectar ao cluster Solana Devnet, já que não queremos gastar dinheiro para fins de aprendizado. Vale notar que, para aplicações reais, precisaríamos usar a mainnet. Você muda para devnet executando o comando abaixo:

Agora, precisamos criar uma nova chave que armazenará nosso NFT. O "Se" basicamente significa que nossa pubkey começa com "Se"

Vamos executar mais alguns comandos para configurar nosso novo endereço Solana:

Isso deve exibir o seguinte:

Passo 2. Financiar sua carteira Devnet

Agora precisamos obter tokens Solana de teste. Como estamos na devnet, você pode obter rapidamente algum sol executando o comando abaixo no terminal:

Alternativamente, você pode obter tokens SOL de devnet em um faucet da Solana.

Você pode confirmar que tem Solana em sua carteira devnet executando este script na linha de comando:

Passo 3: conectar a carteira Phantom ao cluster Devnet

Agora, vamos vincular a carteira devnet recém-criada ao Phantom. Para isso, clique em settings, selecione Change Network e depois escolha Devnet.

Passo 4. Adicionar uma carteira Devnet ao Phantom

Agora precisamos obter a chave privada da carteira devnet. Abra seu terminal e use cat para inspecionar o conteúdo do arquivo keypair.json para obter isso:

Para adicionar a carteira devnet ao Phantom:

1. Abra o Phantom
2. Copie o resultado que você acabou de receber
3. Dê um nome adequado a ela
4. Selecione Import Private Key no menu de navegação superior esquerdo
5. Clique em Add/Connect Wallet‍
6. Cole a chave na área Private Key

Agora, sua Phantom Wallet de Devnet deve mostrar 5 SOL.

Passo 5. Criar um NFT

Você pode usar plataformas como Metaplex, Holaplex ou Solsea que seguem o padrão de metadados para criar e mintar seu NFT Solana.

Aqui está o que fazer primeiro:

1. Configure sua carteira e garanta que ela tenha alguns tokens SOL
2. Visite o site do Holaplex
3. Conecte sua carteira Phantom à plataforma Metaplex

A Metaplex pedirá permissão para visualizar seus fundos e solicitará aprovação para transações. Você pode aprovar isso.

Em seguida:

1. Clique na aba create
2. Selecione browse file‍
3. Faça upload de qualquer imagem de sua escolha
4. Adicione um Name e uma description à sua imagem
5. Adicione alguns atributos
6. Clique em Next

Definimos nosso NFT como unlimited para nos permitir criar quantas cópias quisermos mintar.

Agora devemos conseguir ver o NFT em sua carteira após clicar em mint e a operação ser bem-sucedida.

Agora, obtenha os metadados e armazene-os em um arquivo seguro, e transfira o NFT da sua carteira Phantom para o endereço pubkey que você gerou anteriormente.

Você pode consultar isso executando:

Alternativamente, desenvolvedores Solana mais avançados podem mintar com a Candy Machine.

Passo 6. Selecionar o tipo de drop

Antes de continuar, você deve entender que o programa gumdrop suporta três tipos de drop:

1. O Token Airdrop
2. NFT candy machine pre-sale
3. As Edition prints

Também precisamos definir nosso método de distribuição e a whitelist:

Uma lista de opções que nos orienta sobre como usar a CLI está listada aqui:

Para o tipo de drop, vamos usar o Token Airdrop.

Este método permite que a CLI mova os tokens para o keypair descartável gerado, possibilitando uma criação mais lógica de gumdrops adicionais.

Para o método de distribuição, podemos fazer o airdrop usando SMS, Discord, Email ou carteiras. Para este tutorial, fizemos o airdrop via carteiras usando o comando abaixo:

Antes de prosseguir para executar o comando completo, precisamos criar um arquivo whitelist.json. A allowlist ajudará a especificar os destinatários do airdrop.

É uma lista contendo os destinatários com valores identificadores, como mints ou prints a serem reivindicados, e o número de edições.

A whitelist está no formato abaixo:

Você pode substituí-la pelas informações abaixo e preenchê-la com base no número de amigos que receberão o airdrop de NFT.

Podemos então referenciar a lista de distribuição com o seguinte comando:

Por fim, execute todos os comandos abaixo:

Passo 7. Fazer o airdrop do NFT Solana

Agora, vamos fazer o airdrop dos NFTs para o endereço de sua escolha. No diretório de arquivos, localize a pasta "log", verifique todos os arquivos e procure pelo arquivo .json que contém URLs, conforme mostrado abaixo. O arquivo contém o conteúdo do arquivo whitelist.json com URLs destinadas ao destinatário do airdrop. Você pode acessar esse link no seu navegador.

Você deve ter algo assim:

O Gumdrop fornece uma UI interativa que facilita para os destinatários reivindicarem seu airdrop. Podemos implantar esse site gumdrop personalizado na Vercel.

E é isso! Você construiu um site gumdrop capaz de fazer airdrop de NFTs para amigos.

Passo 8: fechar um gumdrop​

Quando o gumdrop é finalizado, a master edition pode ser recuperada fechando o gumdrop. Se você fechar o gumdrop, os destinatários podem não conseguir reivindicar seu gumdrop.

O trecho de código para fechar um gumdrop é:

Para retirar a autoridade ou devolver tokens, você pode passar informações adicionais sobre a integração de claim.

Passo 9: implantar um site gumdrop personalizado‍​

Você pode optar por implantar seu site Gumdrop. Eu recomendaria a Vercel, conhecida por oferecer uma experiência de desenvolvimento robusta, especialmente ao construir frameworks de frontend e sites estáticos.

Primeiro, acesse a Vercel e crie uma conta gratuita, usando o GitHub para uma integração mais rápida.

Aqui está o que fazer a seguir:

1. Selecione new project e importe o arquivo do seu repositório do Github
2. Preencha o nome do projeto e defina o diretório
3. Ative as Build and Output Settings e faça as alterações mostradas abaixo‍

Agora, confirme que o Output Directory está definido como override e clique em Deploy para obter um link único para o projeto!

Parabéns! Você acabou de implantar um site Custom Gumdrop 🎉

Se quiser compartilhar com seus amigos, basta enviar o link. Você também deve obter os endereços de carteira deles, já que o método de distribuição da allowlist está definido como wallet.