Tudo o que você precisa saber sobre o Metaplex da Solana

Metaplex é uma coleção de padrões e ferramentas de NFT para Solana. Aprenda como usar o Metaplex para mints de NFT na Solana, airdrops de NFT, storefronts de NFT e muito mais!

O que é o metaplex?

Metaplex é uma rede de contratos construída em Solana para potencializar a comunidade de NFT da blockchain. O ecossistema tem quatro contratos: Token Metadata, Token Vault, Auction e Metaplex. Embora o termo Metaplex normalmente se refira ao ecossistema de contratos, usaremos o termo para nos referirmos ao contrato Metaplex (um dos quatro) nesta visão geral.

Por que o metaplex é importante?

O ecossistema Metaplex desbloqueia uma forma completamente nova de interagir com NFTs na Solana e, consequentemente, tem sido a ferramenta de NFT de fato na Solana. Através do Metaplex, os usuários podem criar NFTs, hospedar leilões para vendas primárias/secundárias e visualizar NFTs de forma padronizada.

Contratos inteligentes do metaplex

O ecossistema Metaplex é uma coleção de quatro contratos separados, que se comunicam através do contrato Metaplex para fornecer aos desenvolvedores Solana as ferramentas que precisam para criar NFTs.

1. Token metadata

Chamado de "decorador de mint", este contrato permite que os criadores de NFT anexem uma Metadata PDA (Program Derived Address) ao seu mint. Essa PDA associada contém as informações fundamentais da coleção de NFT, como nome, símbolo, taxa de royalty e status de venda.

2. Token vault

Como o nome sugere, o contrato Token Vault pode armazenar NFTs depositados de qualquer mint e permite a propriedade fracionada do vault e de seus NFTs.

Existem dois estados para o vault: Activated e Combined.

Quando no status "Activated", qualquer NFT no vault fica bloqueado e inacessível. O dono do vault pode então emitir e vender participações (treasury shares) sobre o vault, criando assim a propriedade fracionada de qualquer NFT no vault.

O vault só pode fazer a transição para "Combined" quando não houver participações fracionadas em circulação, ou seja, quando o dono do vault tiver todas as participações. Para recuperar os NFTs no vault, o dono precisa recomprar todas as participações fracionadas no mercado, a partir do que pode "Combinar" o vault.

3. Auction

O contrato Auction atua como o mecanismo de leilão no Metaplex e viabiliza leilões de NFT nos formatos English Auction e Open Edition Auction.

Como um programa simples de lance e venda, o Auction opera sem qualquer conhecimento sobre NFTs ou outros recursos do ecossistema Metaplex. Essa separação reduz bastante os pontos de falha e aumenta a flexibilidade do programa Auction.

4. Metaplex

O contrato Metaplex fornece os AuctionManagers, que gerenciam os três contratos principais listados acima. O AuctionManager mantém o registro de todos os metadados de token e seus respectivos leilões, e permite a transição fluida de dados de conta entre os contratos Token Metadata, Token Vault e Auction.

Ferramentas e recursos do Metaplex

Aqui estão os recursos mais importantes do Metaplex, o que fazem, quando usá-los, por que são importantes e como começar a desenvolver com esses recursos!

O que é o metaplex storefront?

O Metaplex Storefront é o marketplace de NFT tudo-em-um para criar e vender NFTs através dos contratos Metaplex. Diferente dos marketplaces de NFT centralizados na Solana, como o Magic Eden, qualquer pessoa pode criar e auto-hospedar o Storefront como uma solução white-label, ou pode usar Storefronts de marcas já existentes.

Esse recurso único de auto-hospedagem do Storefront do Metaplex permite que os usuários aproveitem plenamente os benefícios da descentralização na Solana, já que podem criar seus próprios marketplaces de NFT.

Como criar um storefront com o metaplex

Esta é uma visão geral resumida de como criar um Storefront, o que é abordado em detalhes na documentação original do Metaplex.

Primeiro, você precisa clonar e inicializar o código-fonte do Metaplex Storefront no Github.

Em seguida, acesse http://localhost:3000/ e mude a rede Solana para Devnet.

Se você não estiver familiarizado com as redes de teste da Solana, leia nosso guia completo sobre como usar a devnet da Solana.

Depois, inicialize o Storefront clicando em "Init Store" e aprovando a transação.

Na seção de configuração da Store, copie o código e cole-o no arquivo .env localizado em js/package/web.

Agora, reinicie o site com yarn start.

Agora você tem um Storefront associado ao seu endereço e hospedado por você!

Pela interface padrão do Storefront, você pode criar NFTs e listá-los para venda, seja como opções instantâneas de "Buy Now", seja como leilão. Ao criar um NFT, você pode especificar a descrição, o royalty e a imagem.

Como a ferramenta de NFT Storefront do Metaplex é open-source e customizável, você pode atualizar o código forkado no GitHub para modificar a interface do usuário (UI) e adicionar novas funcionalidades, como criar um vault de NFTs ou queimar (burn) NFTs.

O que é o Candy Machine v2?

O Candy Machine (CM) é um programa de distribuição generativa de NFT on-chain projetado para simplificar a experiência de compradores, vendedores e criadores com NFTs.

O Candy Machine V2 é a segunda iteração, com recursos aprimorados e adicionados. Antes do CM, não existia um programa universal para gerenciar o mint e a venda de NFTs na Solana. Isso levava a inúmeros erros e experiências ruins para criadores e colecionadores de NFT, o que inspirou a equipe de desenvolvimento do Metaplex a criar o Candy Machine.

O Candy Machine resolve os problemas fundamentais na distribuição de NFT que facilitam as interações dos usuários com NFTs:

• Definir períodos precisos de mint
• Aceitar fundos do comprador apenas quando os NFTs puderem ser mintados
• Ajudar os programas a criar NFTs consistentes através da aplicação de tipos de metadados

O Candy Machine v2 adicionou mais recursos:

• Índice de mint imprevisível - impede que compradores façam "sniping" de NFTs específicos dentro de uma coleção, já que na v1 o mint era sequencial
• Whitelist - permite que apenas certos endereços façam mint
• Captcha - impede que bots façam mint

Além disso, a v2 agora suporta coleções maiores, drops do tipo hide-and-reveal, permite que desenvolvedores web3 atualizem sua configuração a qualquer momento e pausem mints em andamento.

Como usar o Candy Machine v2

Como o Candy Machine é um programa de mint de NFT totalmente on-chain, todas as interações precisam acontecer de forma programática. Embora existam interfaces que automatizam alguns recursos, os usuários precisam ter experiência básica em programação para aproveitar totalmente o Candy Machine. Para começar com o CM v2, consulte a documentação oficial do Metaplex.

O que é o gumdrop?

O Gumdrop é uma nova ferramenta beta para airdrops na Solana com baixo custo de gas. Desenvolvido pela comunidade Metaplex, o Gumdrop realiza airdrops para um grande número de usuários enviando a eles um link de resgate off-chain, por exemplo através de redes sociais. Ele oferece uma solução simples para projetos distribuírem tokens integrados ao Metaplex a baixo custo.

Diferente do modelo tradicional de airdrop, no qual os tokens aparecem diretamente na carteira Solana do usuário, o Gumdrop usa um paradigma "pull-based", em que os usuários precisam reivindicar ativamente seus tokens, ou perdê-los. O Gumdrop utiliza uma merkle tree para verificar se um usuário está na whitelist, o que permite computação rápida on-chain.

O Gumdrop suporta múltiplos tipos de drop de token na Solana:

• Airdrops de token
• Pré-vendas do Candy Machine
• Impressões de edição (edition prints)

Em todos os casos, o drop constrói uma merkle tree a partir dos usuários na whitelist e distribui links de resgate de forma off-chain.

Como usar o gumdrop

Você pode usar o Gumdrop de forma programática ou através de uma experiência interativa com uma UI guiada de airdrop na Solana. Para os passos programáticos, consulte a documentação oficial. Para usar a interface gráfica (UI), siga estas instruções:

Existem três ações que você pode realizar:

1. Create
2. Claim
3. Close

Na página Create, especifique o método de reivindicação (tipo de airdrop).

Em seguida, escolha um método de distribuição off-chain.

Dependendo da seleção, você precisará preencher entradas adicionais, incluindo o endereço de mint, para concluir a criação.

Na página Claim, os usuários podem iniciar a reivindicação do seu airdrop, que é verificada com a merkle tree da whitelist do airdrop na Solana.

Na página Close, os criadores podem excluir um airdrop do Gumdrop fornecendo a chave privada e o endereço de mint.

Depois de fechado, os usuários não conseguirão mais reivindicar os tokens do airdrop.

O que é o AuctionHouse?

O AuctionHouse é um programa de venda de NFT on-chain sem escrow que permite que criadores e minters leiloem e vendam NFTs de forma simples. O AuctionHouse é um conceito separado do site Storefront, que é autohospedado e front-end — é um programa implantado on-chain que aceita SOL e qualquer token SPL. Ao usar o AuctionHouse, os desenvolvedores podem evitar a complexidade e os erros de escrever seus próprios programas de venda de NFT.

Qualquer marketplace de NFT na Solana pode implementar o protocolo AuctionHouse para se beneficiar de seus recursos, como o match automático entre comprador e vendedor para listagens de NFT.

Diferente de outros processos comuns de leilão, em que os compradores precisam "reivindicar" os NFTs, a transação de venda executa automaticamente todas as interações necessárias. Em outras palavras, o AuctionHouse reduz todas as etapas desnecessárias a ações intuitivas para os usuários finais, ao mesmo tempo em que fornece um programa padronizado para desenvolvedores.

O AuctionHouse possui uma variedade de parâmetros configuráveis. Por exemplo, um vendedor pode criar uma ordem de venda parcial de uma coleção de NFT na Solana com uma taxa e destino de tesouraria personalizados, além de exigir que o auction house assine todas as transações. O AuctionHouse também pode aceitar certos tokens SPL ou todos eles.

O AuctionHouse também mantém o histórico de todos os recibos de transação de NFT (por exemplo, listagens, lances e vendas).

Como usar o AuctionHouse

Atualmente, o AuctionHouse só oferece uma biblioteca de CLI escrita em TypeScript, embora uma implementação de interface gráfica (GUI) esteja a caminho.

Primeiro, clone o repositório all-in-one do Metaplex que contém a biblioteca AuctionHouse.

Depois, instale os pacotes necessários na subpasta CLI (JS) da pasta metaplex.

Por fim, usando um keypair existente, você pode criar um AuctionHouse.

Após a transação bem-sucedida, sua linha de comando deve exibir estas mensagens.

Nota: sua chave do auction house será diferente

Para mais procedimentos de CLI, consulte a documentação oficial.

O que é o sugar?

O Sugar é uma alternativa à linha de comando do Candy Machine v2, com melhor desempenho e etapas simplificadas para os desenvolvedores. Ele oferece um processo interativo para desenvolvedores de NFT na Solana implantarem o Candy Machine v2 sem muita complexidade e transtorno na Command Line Interface (CLI) original.

O Sugar oferece diversos benefícios em relação ao CLI do CM v2, conforme descrito em sua documentação:

• Melhor desempenho no upload de arquivos de mídia/metadados
• Procedimentos de build e instalação simplificados, aproveitando o cargo
• Tratamento robusto de erros e validação de entrada
• Mensagens de erro mais informativas

Como usar o sugar para drops de NFT na Solana

Primeiro, instale a biblioteca Sugar com o cargo.

Em seguida, modifique a configuração do CLI da Solana com o provedor de RPC node Solana desejado e seu keypair.

Por fim, inicie a sessão interativa para implantar o Candy Machine.

O que é o hydra?

Hydra é uma carteira de carteiras que permite a distribuição de fundos para conjuntos extremamente grandes de endereços membros. Também é conhecida como "Fanout Wallet" por se assemelhar a um fanout de carteiras a partir da carteira principal. O Hydra viabiliza recursos interessantes como royalties tokenizados (ou seja, distribuir royalties recebidos entre os membros) e associação por token (por exemplo, recompensas de staking facilitadas).

Uma carteira Hydra tem três fases em seu ciclo de vida:

1. Creation
2. Member Addition
3. Distribution

1. Fase de criação

Na fase de Creation, você, o criador (conhecido como Authority), pode criar uma carteira Hydra. Há múltiplos ângulos de personalização, como o modelo de associação, nome, tokens aceitos (SOL ou qualquer token SPL), e total de participações de associação.

Devido às suas operações e requisitos complexos, criar uma carteira Hydra custará centenas de SOL.

2. Fase de adição de membro

Na fase de Member Addition, você pode adicionar uma conta como membro da carteira Hydra. Você pode adicionar uma carteira comum (usuário), um NFT e tokens, o que envolve uma abordagem mais sofisticada para calcular as participações no fundo.

3. Fase de distribuição

Na fase de Distribution, a carteira Hydra é chamada várias vezes para distribuir o fundo de associação a cada membro, de acordo com suas participações.

Cada chamada de distribuição deve incluir o Member que está recebendo, e a carteira Hydra espera múltiplas chamadas ao longo de seu ciclo de vida. Esse design de uma chamada por membro permite que a carteira mantenha baixo custo de processamento e memória ao lidar com um grande conjunto de membros.

Como usar o hydra

O Hydra é mais um programa on-chain que pode ser chamado para interações.

Os program IDs do Hydra são:

• Mainnet: hyDQ4Nz1eYyegS6JfenyKwKzYxRsCWCriYSAjtzP4Vg
• Devnet: hyDQ4Nz1eYyegS6JfenyKwKzYxRsCWCriYSAjtzP4Vg

A documentação oficial inclui exemplos mínimos de código para interagir com e criar uma carteira Hydra. Você pode criar uma carteira assim:

Você também pode adicionar novos membros (seus endereços) em apenas algumas linhas. Aqui está um exemplo de como adicionar um endereço de carteira como membro.

O que é o amman?

Amman é um kit de ferramentas para testar bibliotecas e aplicativos do Solana SDK executando um validador local. O kit de ferramentas foi desenvolvido pela Metaplex Foundation para melhorar a experiência do desenvolvedor em projetos que envolvem atualizações e testes de alta frequência.

Apesar da taxa de gas baixa, implantar um programa Solana complexo na mainnet pode ter um custo proibitivo. Por isso, para uma implantação e teste rápidos de apps e bibliotecas SDK, os desenvolvedores podem usar a devnet, a testnet da Solana, ou um validador local.

Como a testnet/devnet exige airdrops constantes e processos repetitivos de deploy e espera, um validador local é preferível para deploys e testes rápidos, sem depender de WiFi.

Além disso, executar um validador local garante 100% de uptime durante os testes, enquanto a testnet/devnet pode ficar offline no processo.

O Amman CLI inclui o relay, a validator interface, e o mock storage server, que juntos atuam como um validador.

O Amman Client inclui asserts, address labeling, transaction interface, e um cliente para o relay, todos os quais devem ser usados em testes e no navegador para se conectar ao validador local.

Como usar o amman

O repositório GitHub do Amman fornece um excelente guia para executar o Amman. Você precisará clonar esse repositório para começar a usar o Amman.

Para executar o Amman CLI, você precisa criar um arquivo de configuração. Um exemplo é fornecido no repositório GitHub do Amman.

Com o arquivo de configuração, você pode iniciar e, mais tarde, parar o validador local com os seguintes comandos:

O repositório do Amman Client fornece muitos arquivos TypeScript que podem ser usados em scripts de teste ou no navegador web.

O que é o metaboss?

Considerado a "ferramenta canivete suíço" (Swiss Army Tool) do Metaplex, o Metaboss oferece muitas funções em torno do Metaplex para que os desenvolvedores possam construir facilmente no ecossistema.

Como o Metaplex é um sistema novo e em rápida evolução, os desenvolvedores implementam suas próprias funções para interagir com o Metaplex. O Metaboss ajuda nesse processo, oferecendo funções consistentes e padronizadas ao ecossistema.

Algumas das funcionalidades que o Metaboss oferece são:

• Decodificar os metadados de uma conta de mint de token
• Mintar novos NFTs a partir de um arquivo JSON
• Obter um snapshot dos atuais detentores de NFT para um determinado Candy Machine ID ou update authority
• Obter uma lista de todas as contas de estado e configuração de candy machine para uma determinada update authority
• Atualizar todos os campos da struct Data de metadados de um NFT

Como usar o metaboss

Primeiro, instale o Metaboss como um pacote no seu programa Solana executando:

Agora você está pronto para usar o Metaboss!

Há vários exemplos na documentação oficial. Por exemplo, você pode mintar um novo NFT a partir de um arquivo JSON com uma única linha de comando.

Primeiro, prepare o arquivo JSON new_nft.json para o NFT.

Em seguida, você pode criar qualquer quantidade desse NFT usando o comando:

Como começar com o metaplex na Alchemy

A Alchemy oferece APIs Solana com o plano gratuito mais robusto para desenvolvedores começarem a construir imediatamente.

Quer implantar seu projeto de NFT Metaplex na Alchemy? Cadastre-se para uma conta gratuita da Alchemy e comece a construir!