Blueprint NFTs e Metaplex
NFTs na Solana não são um objeto separado no ledger. Combinam propriedade on-chain escassa, metadados definidos por programa e mídia off-chain que carteiras e mercados concordam em exibir. Metaplex fornece os padrões, SDKs e ferramentas de lançamento que a maioria das equipes usa; quando você vê modelo, armazenamento, coleção, caminho de mint e leitura como uma stack, Core vs Token Metadata, Candy Machine e DAS deixam de parecer produtos não relacionados.
Noções básicas de NFT na Solana é a entrada prática; Metaplex Core, Metadados e armazenamento, Coleções e verificação, Candy Machine e Lendo NFTs (DAS API) aprofundam cada camada. Esta página fica por baixo: como as peças se conectam, qual padrão escolher e como apps em produção mintam e leem assets.
Resumo
- Um NFT Solana é propriedade mais metadados sob um programa Metaplex (ou compressão) - contas Asset Core, grafos mint Token Metadata ou folhas de árvore comprimidas - com JSON e mídia geralmente off-chain e DAS como superfície de leitura padrão do cliente.
- Por que importa: Escolha errada de padrão queima rent e tempo de integração; armazenamento ou verificação fracos arruínam confiança; lançamento sem guards ou planejamento de escala falha no mint; ler PDAs brutos em vez de DAS quebra carteiras e galerias.
- Conceitos-chave: Modelo NFT (supply, decimals, propriedade), Metaplex Core, Token Metadata (legado), uri + JSON off-chain, coleções e verificação, Candy Machine / guards, NFTs comprimidos (cNFT), DAS API.
- Quando usar: Projetar novas coleções, integrar marketplaces ou token gates, escolher Core vs legado vs cNFT, planejar drop público ou construir UIs de portfólio e explorer.
- Limitações / trade-offs: Mídia off-chain pode apodrecer ou ser mutada conforme o host; royalties exigem enforcement de marketplace ou programa; cNFTs trocam contas simples por provas e dependência de indexador; DAS exige provedor RPC com DAS.
- Tópicos relacionados: noções básicas NFT, Metaplex Core, metadados e armazenamento, coleções e verificação, Candy Machine, leitura DAS.
Fundamentos
A Solana não tem tipo nativo "NFT" no runtime. Escassez e identidade vêm de programas e convenções: identidade de asset única, owner e metadados que mercados tratam como arte, ingressos ou itens.
Historicamente isso significava mints SPL Token com supply = 1 e decimals = 0, mais Metaplex Token Metadata para nome, uri, criadores e coleção. Esse grafo multi-conta ainda detém enorme volume secundário. Metaplex Core moderniza: uma conta Asset (mais plugins opcionais) com nome, uri, owner e update authority com menor rent. NFTs comprimidos vão além: folhas em árvore merkle concorrente tornam custo por mint mínimo em troca de provas e dependência de indexador.
Camadas da propriedade até superfícies de produto:
+------------------------------------------+
| UI de produto (carteira, galeria, gate) | <- DAS + lógica do app
+------------------------------------------+
| Caminho launch/mint (Candy Machine, |
| create Core, Bubblegum, programa custom) |
+------------------------------------------+
| Identidade de coleção + verificação |
+------------------------------------------+
| JSON de metadados + mídia (Arweave/IPFS/HTTP)|
+------------------------------------------+
| Modelo de asset on-chain |
| (Core | Token Metadata | folha cNFT) |
+------------------------------------------+
| Cluster / RPC (Agave, kit, DAS-RPC) |
+------------------------------------------+Modelo de asset on-chain responde o que é possuído e quem pode atualizar. Core armazena owner no Asset; Token Metadata liga propriedade a conta token SPL com a única unidade do mint; cNFTs codificam propriedade em estado da árvore verificado por provas.
Metadados e armazenamento respondem como parece. Campos on-chain permanecem curtos (nome, uri). A uri aponta para JSON com image, attributes e animation opcional. Arweave otimiza permanência; IPFS precisa pinning; HTTPS simples é conveniente e mutável.
Coleções e verificação respondem qual grupo é real. Qualquer um pode colar pubkey de coleção em cosméticos. Mercados e gates confiam em associação verificada da collection authority (ou vinculação Core).
Candy Machine responde como muitas pessoas mintam com justiça. Config, guards (pagamento, allowlist, limites, go-live) e listas de itens dirigem drops públicos, frequentemente Token Metadata via Sugar. Drops enormes gratuitos ou de baixo valor frequentemente usam Bubblegum cNFTs.
DAS (Digital Asset Standard) responde como clientes leem tudo da mesma forma. Métodos de provedor como getAsset, getAssetsByOwner e getAssetsByGroup unificam Core, Token Metadata e cNFTs para apps evitarem GPA bruto e matemática PDA para galerias.
Este site fixa @solana/kit 7.0.0 para RPC e transações padrão. Plugins Umi Metaplex permanecem o caminho de escrita comum para Core, Candy Machine e Token Metadata. Programas customizados que validam propriedade NFT usam Rust 1.91.1 e, quando escolhido, Anchor 0.32.1.
Mecânica e interações
Escolha o modelo de propriedade primeiro
Escolha o padrão on-chain antes de pipelines de arte ou sites de mint.
| Modelo | Identidade | Propriedade | Melhor encaixe |
|---|---|---|---|
| Metaplex Core | Pubkey Asset | Campo na conta Asset | Novos 1/1s e coleções (padrão 2026) |
| Token Metadata | Pubkey mint | Conta token SPL (supply 1) | Integrações legadas, mercados antigos |
| cNFT (Bubblegum) | Asset id / folha | Folha da árvore + prova | Alto volume, baixo rent por item |
Metaplex Core é o padrão greenfield: programa CoREENxT6tW1HoK8yfYWXSzaXUcGUimvH2vQJ55jEo, com plugins para royalties, atributos, freeze e links de coleção. Use Token Metadata quando parceiros ainda exigem mint + metadata PDA + master edition (metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s). Use cNFTs quando rent de conta completa domina (drops de jogos, mints gratuitos grandes). Layouts: Noções básicas de NFT na Solana.
Metadados são contrato de uri, não apenas bytes on-chain
Instruções mint e update armazenam uri curta. Clientes buscam JSON, depois mídia. Contas permanecem pequenas; permanência e mutabilidade vivem no armazenamento.
asset on-chain (nome, uri, authorities)
|
v
JSON de metadados --> image / animation_url / attributes
|
v
Arweave | IPFS | host HTTPSColeções em produção geralmente fazem upload com Sugar ou bundlers similares, validam schema e preferem hosts endereçados por conteúdo. HTTPS mutável é ok para protótipos e reveals controlados; é risco de confiança se o host puder trocar arte após venda. Veja Metadados e armazenamento.
Coleções precisam de etapa verify para significar algo
Uma coleção é identidade compartilhada (conta coleção Core ou mint coleção Token Metadata) mais link de cada item. Verificação é a prova assinada pela authority de que o link é intencional.
Collection authority --verifica--> Asset/metadata --> Identidade de coleção
|
v
Agrupamento DAS / selo marketplace / token gateCampos de coleção não verificados são falsificáveis. Gates e mercados secundários devem exigir associação verificada. Consulte com DAS getAssetsByGroup, não rótulos fornecidos pelo cliente. Veja Coleções e verificação.
Candy Machine é orquestração de lançamento, não o padrão NFT
Candy Machine v3 mantém config de lançamento: supply, contagem resgatada, hidden settings e guards (pagamento, allowlists, limites de mint, horários de início). Cada mint cria assets conforme config (frequentemente Token Metadata). Sugar é a CLI de operador: validate, upload, deploy, test mint, reveal.
assets/ + config --> sugar validate/upload --> CM + guards
--> mints públicos (itemsRedeemed++) --> uris de reveal opcionaisPara drops muito grandes, compare rent contra Bubblegum em vez de contas Token Metadata completas. Candy Machine é o plano de controle de fair-launch para drops generativos clássicos; não é exigido para alguns creates Core. Veja Candy Machine.
DAS é o caminho de leitura em produção
Carteiras não devem descobrir NFTs escaneando programas Metaplex com getProgramAccounts bruto. RPC habilitada para DAS retorna assets formatados:
| Método | Uso típico |
|---|---|
getAsset | Página de detalhe único |
getAssetsByOwner | Portfólio da carteira |
getAssetsByGroup | Explorer de coleção / gate |
searchAssets | Descoberta filtrada |
@solana/kit --> JSON-RPC (enviar tx, saldos, status)
DAS RPC --> getAsset* / searchAssets (portfólio, galeria)
Umi + mpl-* --> mint, update, CM, instruções CoreUse kit para transações e status da chain; DAS para grafos de assets e superfícies cNFT. Planeje paginação e cache do provedor. Veja Lendo NFTs (DAS API).
Como as peças interagem em uma semana de lançamento
- Escolha Core vs Token Metadata vs cNFT por escala e restrições de integração.
- Prepare mídia e JSON; escolha Arweave/IPFS/HTTPS e política de congelamento de uri.
- Crie identidade de coleção; verifique no mint ou imediatamente depois.
- Drops públicos: guards Candy Machine na devnet; conjuntos Core pequenos: Umi
createmais plugins de coleção. - Aponte UIs para DAS para portfólios; use kit para pagamentos e RPC não-DAS.
- Documente royalty bps e quais mercados ou plugins aplicam.
- Reveal se necessário; verifique uris e linhas DAS após mint.
Considerações avançadas e aplicações
Combine escala, necessidades de marketplace e complexidade de leitura a um caminho; aprofunde lançamento e indexação conforme o risco cresce.
| Caminho | O que você executa | Forças | Fraquezas | Melhor encaixe |
|---|---|---|---|---|
| Core 1/1 ou conjunto pequeno | Umi + mpl-core, armazenamento permanente, DAS | Baixo rent; plugins; propriedade simples | Algumas ferramentas só TM legado | Nova arte, ingressos, memberships |
| Mint público generativo | Sugar + Candy Machine + guards + reveal | Fases justas; ops comprovadas | Maior custo por mint; orientado TM | Lançamentos PFP clássicos |
| Distribuição em massa | Árvores Bubblegum + DAS | Barato por item; supply enorme | Provas, capacidade de árvore, indexadores | Jogos, POAPs, cupons |
| Integração legada | Token Metadata + DAS | Máxima compatibilidade secundária | Rent e complexidade multi-conta | Coleções antigas ou parceiros |
Conjunto pequeno Core é o padrão para NFTs de produto que não são mints gratuitos em massa. Plugins cobrem royalties e regras sem programa de metadados paralelo.
Mint público generativo otimiza justiça temporal e roteamento de pagamento. Estresse guards, priority fees e corridas de esgotamento na devnet; automatize reveal.
Distribuição em massa otimiza economia. Orçamente profundidade e canopy da árvore; trate DAS como infraestrutura obrigatória.
Integração legada é realidade de marketplace. Prefira DAS para leituras; derive PDAs de metadados manualmente apenas para indexadores customizados ou ambientes sem DAS.
Não confunda camadas: Candy Machine não é Core, DAS não é caminho de mint, nome de coleção não é verificação e HTTPS não é permanência. Revisões de design devem travar modelo de propriedade, permanência de armazenamento, verificação, justiça de mint e métodos DAS primeiro.
Equívocos comuns
- "Solana tem opcode NFT built-in." Escassez e metadados são convenções de programa (Core, Token Metadata, Bubblegum), não tipo especial do runtime.
- "Core e Token Metadata são iguais por baixo." Grafos de conta, semântica de transferência e SDKs diferentes; só o conceito de produto "NFT" é compartilhado.
- "Definir campo de coleção basta para selo azul." Sem verificação (ou regras Core de coleção), o campo é falsificável.
- "Royalties sempre pagam em toda transferência." Royalties secundários dependem de política de marketplace e plugins ou hooks on-chain opcionais, não apenas movimentos SPL.
- "Candy Machine é exigido para toda coleção." Use para lançamentos multi-fase justos; mints Core pequenos podem chamar create diretamente.
- "getProgramAccounts é ok para galerias de carteira." É frágil, pesado e incompleto para cNFTs; DAS é o padrão de leitura em produção.
- "IPFS sem pinning é permanente." Disponibilidade dura enquanto algo fixar o CID; prefira Arweave para metas de permanência.
- "cNFTs removem necessidade de infraestrutura." Removem rent por mint; aumentam dependência de árvores, provas e indexadores.
FAQs
Qual é a ideia mais importante em NFTs Solana?
Trate NFT como propriedade mais metadados sob padrão escolhido (Core, Token Metadata ou folha comprimida), com mídia off-chain e DAS como caminho de leitura usual do produto.
Novos projetos devem usar Metaplex Core ou Token Metadata?
Use Metaplex Core por padrão para novos assets, a menos que parceiro, marketplace ou ferramenta ainda exija layouts Token Metadata.
Quando usar NFTs comprimidos?
Quando precisa de volume de mint muito grande e rent por item domina custo (itens de jogo, ingressos em massa, drops gratuitos), aceitando dependências de prova e DAS.
O que a uri on-chain realmente armazena?
Ponteiro curto (HTTPS, ar://, URL gateway IPFS, etc.) para JSON que descreve o asset e vincula mídia; não são os bytes completos da imagem.
Por que marketplaces se importam com verificação de coleção?
Rótulos de coleção não verificados podem ser forjados; verificação prova que a collection authority endossou a associação do asset.
Candy Machine é só para PFPs de arte?
Não. Qualquer drop multi-item que precise acesso temporal, pagamentos, allowlists ou limites de mint pode usar guards Candy Machine; PFPs de arte são só o caso famoso.
Como DAS se relaciona com @solana/kit?
Kit foca RPC Solana geral e transações. DAS é superfície JSON-RPC estendida em nós de provedor para digital assets; muitos apps usam ambos.
Posso ler Core e Token Metadata com o mesmo código cliente?
Sim para leituras estilo portfólio: DAS normaliza. Caminhos de escrita ainda usam plugin Umi ou instruções de programa correspondentes por padrão.
Preciso de Anchor para lançar NFTs?
Não. A maioria dos fluxos mint/update é client-side com SDKs Metaplex. Anchor ajuda quando seu programa deve validar propriedade, gates ou estado customizado ligado a NFT.
Onde ficam royalties?
Em campos de metadados ou plugins royalty Core (basis points e criadores). Enforcement é preocupação separada de marketplace ou plugin, não automática em toda transferência.
Como fazer token-gate por coleção em um app?
Consulte DAS pelos assets da carteira no grupo de coleção (ou verifique on-chain conforme necessário), depois autorize sua API ou programa a partir dessa checagem de associação.
Sugar é obrigatório para Candy Machine?
Não estritamente, mas é o caminho padrão de operador para validate, upload, deploy e reveal. Umi serve para UIs de mint customizadas após deploy.
O que construir primeiro para feature NFT mínima?
Minte um asset Core com uri permanente, leia com getAsset, adicione verificação de coleção, depois Candy Machine ou cNFT apenas se escala exigir.
Relacionados
- Noções básicas de NFT na Solana - modelos NFT em nível de conta e visão geral de padrões
- Metaplex Core - padrão Asset de conta única e plugins
- Metadados e armazenamento - JSON off-chain, Arweave, IPFS e uris
- Coleções e verificação - agrupar assets e por que verificação importa
- Candy Machine - config de mint justo, guards e lançamentos Sugar
- Lendo NFTs (DAS API) - leituras de portfólio, coleção e busca
Versões da stack: Esta página foi escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, Rust 1.91.1 e @solana/kit 7.0.0.