Coleções e verificação

Coleções agrupam NFTs sob uma identidade compartilhada. Verificação prova que um asset realmente pertence àquela coleção - crítico porque campos de coleção não verificados podem ser falsificados por qualquer pessoa.

Receita

// Core: criar Collection, mintar Asset com plugin de coleção, verificar
import { createCollection, create, addPlugin } from "@metaplex-foundation/mpl-core";
 
// Token Metadata: definir coleção nos metadados + verifyCollectionV1

Quando usar:

• Lançar coleções generativas ou de foto de perfil com vários itens
• Mostrar selo verificado em UIs de carteira e marketplace
• Token-gate por associação à coleção via DAS getAssetsByGroup
• Impedir rótulos falsos de coleção em mints não relacionados

Exemplo prático

import { createUmi } from "@metaplex-foundation/umi-bundle-defaults";
import { mplCore } from "@metaplex-foundation/mpl-core";
import {
  createCollection,
  create,
  fetchCollection,
  ruleSetNone,
} from "@metaplex-foundation/mpl-core";
import { generateSigner } from "@metaplex-foundation/umi";
 
const umi = createUmi("https://api.devnet.solana.com").use(mplCore());
 
const collection = generateSigner(umi);
await createCollection(umi, {
  collection,
  name: "Demo Collection",
  uri: "https://arweave.net/collection.json",
}).sendAndConfirm(umi);
 
const asset = generateSigner(umi);
await create(umi, {
  asset,
  name: "Item #1",
  uri: "https://arweave.net/1.json",
  collection: collection.publicKey,
}).sendAndConfirm(umi);
 
const col = await fetchCollection(umi, collection.publicKey);
console.log(col.name, col.numMinted);

// DAS: consulta por coleção
await dasRpc("getAssetsByGroup", {
  groupKey: "collection",
  groupValue: collection.publicKey.toString(),
  page: 1,
  limit: 100,
});

O que isso demonstra:

• A conta de coleção é o identificador canônico do grupo para Core
• Assets referenciam a coleção no momento do mint
• DAS agrupa assets para consultas de galeria e gating

Mergulho profundo

Como funciona

• Core: conta Collection + plugin vinculando cada Asset
• Token Metadata: campo collection nos metadados + verified: bool após autoridade assinar verify
• Metadados de coleção não verificados são apenas cosméticos - marketplaces ignoram
• Indexadores e DAS expõem grouping / collection para conjuntos verificados

Estados de verificação

Notas TypeScript

// Após mint, execute instrução verify se não for auto-verificado no fluxo do SDK
// Token-gate: getAssetsByOwner + filtrar grouping.key === "collection"

Erros comuns

• Pular etapa de verify - nome da coleção aparece mas não é confiável. Correção: collection authority assina instrução verify.
• Pubkey de coleção errada na UI - bypass de gating. Correção: compare com endereço oficial da coleção na documentação do projeto.
• Misturar modelos de coleção Core e Token Metadata - layouts de conta incompatíveis. Correção: um padrão por coleção.
• Lacunas de paginação DAS durante mint - galeria incompleta. Correção: paginação por cursor + retry após fim do mint.
• Collection authority revogada - não é possível verificar itens futuros. Correção: proteja authority em multisig antes do lançamento.

Alternativas

FAQs

Relacionados

• Metaplex Core - contas de coleção
• Token Metadata - fluxo verify legado
• Lendo NFTs (DAS API) - consultas por grupo

Versões da stack: Esta página foi escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0 e LiteSVM 0.6.x.