O que é Candy Machine v2? Um guia completo
Escrito por Shray Jain
Candy Machine é um programa baseado em Solana desenvolvido pela Metaplex Studios, um ecossistema de NFTs para marketplaces, jogos e artes e colecionáveis, para vender tokens não-fungíveis (NFTs) de forma confiável. O estúdio e sua comunidade têm avançado rapidamente para dar suporte a vários milhares de desenvolvedores de NFTs e às coleções de NFTs mais populares da Solana e criadores interessados em lançar seus próprios projetos de NFT na rede blockchain Solana.
Metaplex é um conjunto de ferramentas, contratos inteligentes e outras tecnologias projetadas para simplificar o processo de mintagem e lançamento de NFTs. Metaplex tem três projetos principais: Token Metadata, Candy Machine e Auction House.
Para os fins deste artigo, vamos focar exclusivamente no Candy Machine, frequentemente descrito como funcionando como uma máquina de doces do tipo gumball, na qual os usuários inserem um token para receber um NFT.
O programa usa a interface de linha de comando (CLI) do Metaplex para gerar um NFT, conectar metadados relevantes e uma imagem ao token do NFT e, por fim, configurar um leilão justo. Isso implica que usuários finais não conseguem comprar NFTs antes do horário de mintagem e, uma vez atingido o limite de mintagens de NFT, nenhum novo é gerado.
Além de NFTs generativos, criadores também podem gerar NFTs 1-of-1 ou até tokens semi-fungíveis para suas respectivas comunidades. Além disso, o nome do Candy Machine deriva de uma máquina de doces mecânica do mundo real. Isso porque existe uma expectativa geral de que, uma vez que uma pessoa insere um token na máquina, ela receberá apenas um item. É claro que há algumas exceções, como quando o Candy Machine devolve o seu token caso não haja mais NFTs para mintar.
Qual é a diferença entre candy machine v1 e v2?
A segunda versão do Candy Machine traz diversas melhorias de funcionalidade em relação à anterior. Em geral, a versão mais recente do programa possibilita novas formas de distribuição e oferece proteção aprimorada contra ataques de bots, tudo isso mantendo a mesma interface fácil de usar.
Como resultado da atualização, o Candy Machine v1 foi descontinuado e não é mais suportado. Isso significa que não é mais possível criar uma nova instância do Candy Machine v1, e os usuários finais são incentivados a usar o Candy Machine v2 em vez disso.
No Candy Machine v2, a Metaplex introduziu melhorias relacionadas à forma como os usuários finais configuram o Candy Machine e novas configurações que permitem pausar a mintagem em determinado ponto. Além disso, qualquer valor de configuração pode ser atualizado. Ainda assim, aqui estão alguns recursos que devem interessar a desenvolvedores e criadores:
1. Índice de mintagem imprevisível
Na versão anterior do Candy Machine, era possível estimar qual NFT específico seria mintado durante um lançamento de NFT generativo, pois a mintagem acontecia em ordem sequencial.
Essa ordem não randomizada criava a possibilidade de escolher qual NFT mintar, dado que todas as informações sobre os itens estavam disponíveis on-chain. Isso dava uma vantagem injusta a colecionadores de NFTs com formação em desenvolvimento.
A segunda versão elimina essa possibilidade usando um índice de mintagem imprevisível, que não é possível prever. Essa funcionalidade garante um jogo justo na mintagem de NFTs usando o Candy Machine v2.
2. Configurações de captcha
Ao incorporar captchas, as mintagens agora ficam restritas a humanos, o que significa muito menos bots. Embora existam comunidades de NFTs na Solana que dão acesso a bots de mintagem de NFT por meio de sua própria coleção de NFT e Discord com token-gating, as configurações de captcha do Candy Machine dificultam a mintagem automática de NFTs usando bots.
3. Whitelist
Os usuários agora podem criar diversas configurações de whitelists de NFT, nas quais os usuários podem mintar antes da data oficial de início, obter NFTs com preços reduzidos ou até ter acesso exclusivo às mintagens. Como qualquer token SPL pode ser usado para criar whitelists, fica a critério do criador do projeto como elas serão distribuídas.
4. Suporte a grandes coleções e drops hide-and-reveal
Usando a versão 2 do Candy Machine, agora é possível criar grandes coleções e drops hide-and-reveal especificando um único hash. Embora o hash seja o mesmo em todas as mintagens, o nome de cada item é especificado com um número único, permitindo que um processo off-chain atualize posteriormente os metadados com o item real.
O que você pode construir com o Candy Machine v2?
Usando o Candy Machine v2, desenvolvedores e criadores podem montar suas próprias lojas de NFT na Solana, adicionar uma página de mintagem ao seu site e lançar um projeto de NFT com sucesso e segurança.
Segundo a Metaplex, mais de 11,5 milhões de NFTs já foram mintados usando os protocolos da organização, que forneceram padrões e ferramentas para mais de 100.000 projetos e comunidades online.
Como funciona o Candy Machine v2?
Depois de baixar as ferramentas de desenvolvimento da Solana pré-requisitadas e configurar sua máquina, você deve conseguir criar um novo Candy Machine pronto para mintar tokens logo após a implantação inicial.
Criadores interessados em oferecer uma experiência de ponta a ponta conveniente para o consumidor devem considerar fornecer uma experiência de mintagem em frontend, dando à comunidade a chance de também mintar.
A interface de usuário nativa da Metaplex suporta uma variedade de configurações do Candy Machine v2, como whitelisting (tanto para pré-venda quanto para descontos) e configurações de encerramento (ou seja, adaptando automaticamente os componentes de UI dependendo se o token de whitelist é detectado ou não).
Quais problemas comuns o candy machine resolve?
A motivação por trás do Candy Machine foi resolver problemas na forma como os drops de NFT eram gerenciados e processados na blockchain Solana. Alguns problemas importantes que foram resolvidos na atualização mais recente incluem os seguintes:
- Aceitação de fundos de compradores mesmo quando o projeto subjacente estava sem NFTs para vender
- Falta de um horário de início preciso e global
- Projetos não produzindo NFTs válidos e consistentes
- Estruturação incorreta dos metadados de NFT
- Proteção contra ataques persistentes de bots de NFT
- Criação de uma coleção on-chain de NFTs para fins de autenticação
Em geral, havia uma necessidade clara de criar uma forma mais fácil de resolver os problemas mais fundamentais enfrentados por compradores, vendedores e marketplaces no cenário de NFTs. O Candy Machine da Metaplex resolve essas deficiências de forma dinâmica.
Por que é melhor construir um drop de NFT com o candy machine?
Há alguns motivos pelos quais desenvolvedores devem considerar usar o Candy Machine. Mesmo que criadores de NFT reconhecidos globalmente usem ferramentas de mintagem automatizada similares ao Candy Machine, a ferramenta desenvolvida pela Metaplex é altamente recomendada porque agora é um programa de distribuição de NFTs totalmente on-chain.
Hoje, a ferramenta da Metaplex se tornou comum em todo o setor devido à sua utilidade inerente, documentação notável e lógica para combater ameaças como ataques de bots. Em conjunto com a ferramenta Dynamic NFT Pricing Mint da Strata, os criadores podem lançar campanhas de NFT na Solana de forma confiável com um kit de ferramentas simples.
O que é um candy machine ID?
Cada projeto de NFT que usa o Candy Machine para mintar NFTs é sempre designado com um identificador único (ID), que os desenvolvedores podem usar para verificar a autenticidade do ativo subjacente na blockchain Solana. Se o NFT supostamente foi gerado no Candy Machine, mas não possui um Candy Machine ID (CMID), os usuários devem ter cautela ao mintar, comprar ou negociar esse NFT.
Como cada projeto tem um CMID específico, bots de NFT analisam a blockchain Solana para encontrar CMIDs listados e tentar mintar o NFT antes do início do lançamento. Como existem ferramentas de sniping de NFT, alguns projetos de NFT criam honeypots, ou CMIDs falsos que aceitam tokens SOL, mas não retornam um NFT, para dissuadir bots.
Como implantar o Candy Machine v2
Há algumas etapas importantes a seguir para garantir que o Candy Machine v2 esteja funcionando corretamente. Para começar, você precisará das seguintes ferramentas de desenvolvimento da Solana baixadas em sua máquina local.
Se estiver executando o programa no Mac OS com o chip Apple M1, dependências adicionais serão necessárias.
- Git - um sistema de controle de versão distribuído e de código aberto
- Node - um ambiente de execução JavaScript (JS) de código aberto que executa código JS fora de um navegador web
- Yarn - sistema de empacotamento de software desenvolvido pela Meta Platforms para o ambiente de execução Node.js Javascript
- TypeScript Node - um ambiente de execução baseado em TypeScript
- Solana CLI - uma interface de linha de comando para interagir com a blockchain Solana
- Metaplex - uma interface de linha de comando para interagir com a Metaplex
1. Instalar o Candy Machine v2 da metaplex
Os desenvolvedores podem clonar o repositório da Metaplex puxando a CLI do GitHub. Em seguida, ao baixar as dependências relevantes, os usuários finais devem conseguir compilar e executar o software. Ainda assim, os usuários devem verificar se tudo foi instalado corretamente e garantir que definiram as variáveis de ambiente.
2. Configurar uma carteira Solana
Conecte uma carteira Solana relevante e adicione fundos para criar e implantar um Candy Machine. Os usuários podem usar um keypair existente com fundos ou criar um novo keypair especificamente para este projeto. Depois, adicione fundos.
3. Configurar o candy machine
Mantenha suas configurações escolhidas em áreas como whitelisting, proteção por captcha e configurações de gatekeeper. O Candy Machine lê um arquivo JSON que pode ser ajustado conforme suas preferências.
4. Preparar seus NFTs
Como o Candy Machine é um programa de distribuição de NFTs, é importante que ele seja carregado com a arte e os metadados do seu projeto. Depois de concluir a preparação inicial, é fundamental verificar se os arquivos estão prontos para upload. Na verdade, a CLI do Candy Machine oferece o comando verify_assets para verificar se os ativos carregados estão no formato correto.
5. Implantar o candy machine
Depois de verificar que seu keypair tem fundos e que seus ativos foram carregados corretamente, você está pronto para implantar o candy machine. Além disso, você também pode confirmar se o upload está pronto para ser implantado usando a CLI do Candy Machine.
6. Mintar tokens
Agora que você concluiu a maior parte das etapas de inicialização, seu Candy Machine está pronto para mintar NFTs da Solana. Dependendo das configurações, o acesso pode estar restrito a usuários da whitelist ou o goLiveDate ainda não ter sido atingido. Ainda assim, o proprietário do Candy Machine deve estar pronto para mintar tokens.
7. Assinar mintagens
Depois de terminar a mintagem, você deve considerar assinar seus NFTs para se verificar como o criador. Ser verificado significa que o criador com aquele endereço de carteira assinou o NFT, provando que ele é de fato o criador.
Normalmente, o criador verificado será o próprio Candy Machine por padrão. Isso permite que o marketplace em geral, storefronts e CLIs busquem NFTs mintados por um Candy Machine de forma tranquila e confiável. Por exemplo, você poderia usar uma ferramenta de análise de NFT baseada em Solana que depende de dados processados por uma API da Solana.
8. Configurar um site
Para a configuração mais conveniente, os criadores são incentivados a usar a UI de frontend fornecida pela Metaplex. Para mais informações sobre como criar um frontend para sua mintagem de NFT, ou como usar o Candy Machine v2, consulte a documentação oficial da Metaplex.
Parabéns! Está tudo pronto para você mintar seu primeiro NFT usando o Candy Machine v2.
Visões gerais relacionadas
Solana27 de julho de 2026
Nós Solana: validadores, nós RPC e self-hosting
O que são nós Solana, como validadores, nós RPC e sistemas de dados secundários se diferenciam, e quando optar por self-hosting versus usar um provedor.
Solana22 de julho de 2026
Dados de arquivamento do Solana: como consultar o histórico completo de blocos e transações
Dados de arquivamento do Solana explicados: por que os nós fazem prune do histórico, quais métodos RPC exigem acesso a dados de arquivamento e como consultar o histórico completo de blocos e transações em escala.
Solana28 de maio de 2026
Solana Agent Kit vs GOAT vs ElizaOS: qual framework você deve usar?
Comparação entre Solana Agent Kit, GOAT e ElizaOS: profundidade nativa em Solana, abrangência multi-chain ou runtime completo de agentes. Exemplos de código e um framework de decisão.

Construa magia blockchain
A Alchemy combina os produtos e ferramentas de desenvolvimento Web3 mais poderosos com recursos, comunidade e suporte lendário.