Token Metadata
Metaplex Token Metadata é o padrão NFT legado: uma conta de mint mais metadata PDA, master edition e contas token record opcionais. Ainda alimenta grande parte da liquidez em mercados secundários e coleções antigas.
//
Busque em todas as páginas da documentação
Metaplex Token Metadata é o padrão NFT legado: uma conta de mint mais metadata PDA, master edition e contas token record opcionais. Ainda alimenta grande parte da liquidez em mercados secundários e coleções antigas.
const TOKEN_METADATA_PROGRAM = "metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s";
// Metadata PDA: ["metadata", program_id, mint_id]# Prefira Metaplex Umi / ferramentas Sugar em vez de CLI manual para novos mints compatíveis com legadoQuando usar:
import { createUmi } from "@metaplex-foundation/umi-bundle-defaults";
import { mplTokenMetadata } from "@metaplex-foundation/mpl-token-metadata";
import { fetchMetadataFromSeeds } from "@metaplex-foundation/mpl-token-metadata";
import { publicKey } from "@metaplex-foundation/umi";
const umi = createUmi("https://api.mainnet-beta.solana.com").use(mplTokenMetadata());
const mint = publicKey("MINT_PUBKEY");
const metadata = await fetchMetadataFromSeeds(umi, { mint });
console.log(metadata.name, metadata.uri);
console.log("seller fee bps:", metadata.sellerFeeBasisPoints);// Leitura DAS (preferida para carteiras)
const asset = await dasRpc("getAsset", { id: mint.toString() });O que isso demonstra:
sellerFeeBasisPoints armazena percentual de royalty (500 = 5%)metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1smax_supply para prints limitados| Conta | Propósito |
|---|---|
| Mint | Token de propriedade SPL |
| Metadata PDA | uri JSON, criadores, royalty bps |
| Master edition | Regras de edição/escassez |
| Token record | Estado de autorização pNFT |
// Verificar coleção: instruções setCollectionV1 + verifyCollectionV1
// Use @metaplex-foundation/mpl-token-metadata para todos os builders de instrução| Alternativa | Use quando | Não use quando |
|---|---|---|
| Metaplex Core | Novas coleções | Precisa permanecer no Token Metadata |
| cNFT | Drops em massa | Precisa mint on-chain completo por item |
| Leituras apenas DAS | Exibição em carteira | Construir instruções de mint |
Não foi removido - mas Metaplex recomenda Core para novos NFTs enquanto Token Metadata permanece suportado.
Conta derivada do programa armazenando nome, uri, criadores e campos de coleção do NFT.
NFTs programáveis com contas token record controlando transferências via rulesets.
sellerFeeBasisPoints nos metadados - aplicadas por marketplaces cooperantes.
Sim se update authority for mantida e não for imutável.
Collection authority assina instrução verify_collection vinculando metadados ao mint da coleção.
DAS preferida para carteiras; GPA ainda usada por indexadores ingerindo atualizações brutas.
Master edition + instruções de mint de print para prints numerados.
Metaplex Sugar foca lançamentos de coleção Token Metadata - verifique docs para alternativas Core.
Desserialize conta de metadados via crate mpl-token-metadata em programas Rust.
metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s.
Requisitos de listagem em marketplace exigindo explicitamente layout Token Metadata.
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.
Revisado por Chris St. John·Última atualização: 16 de jul. de 2026