Busca en todas las páginas de la documentación
Metaplex Token Metadata es el estándar heredado de NFT: una cuenta de acuñación (mint account) más una cuenta PDA de metadatos, una edición maestra (master edition) y cuentas opcionales de registro de token (token record). Todavía impulsa una gran parte de la liquidez del mercado secundario y colecciones antiguas.
const TOKEN_METADATA_PROGRAM = "metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s";
// Metadata PDA: ["metadata", program_id, mint_id]# Prefiere las herramientas Metaplex Umi / Sugar sobre la CLI manual para nuevas acuñaciones compatibles con el estándar heredadoCuándo usar esto:
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);// Lectura DAS (preferida para wallets)
const asset = await dasRpc("getAsset", { id: mint.toString() });Lo que esto demuestra:
sellerFeeBasisPoints almacena el porcentaje de regalías (500 = 5%).metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1smax_supply para impresiones limitadas.| Cuenta | Propósito |
|---|---|
| Mint | Token de propiedad SPL |
| Metadata PDA | URI JSON, creadores, bps de regalías |
| Master edition | Reglas de Edición/escasez |
| Token record | Estado de autorización de pNFT |
// Verificar colección: instrucciones setCollectionV1 + verifyCollectionV1
// Usa @metaplex-foundation/mpl-token-metadata para todos los constructores de instrucciones| Alternativa | Usar Cuando | No Usar Cuando |
|---|---|---|
| Metaplex Core | Nuevas colecciones | Debe permanecer en Token Metadata |
| cNFT | Lanzamientos masivos | Necesita acuñación completa en cadena por artículo |
| Lecturas solo DAS | Visualización en wallet | Construcción de instrucciones de acuñación |
No está eliminado, pero Metaplex recomienda Core para nuevos NFTs mientras que Token Metadata sigue siendo compatible.
Cuenta derivada del programa que almacena el nombre del NFT, URI, creadores y campos de colección.
NFTs programables con cuentas de registro de token que controlan las transferencias a través de conjuntos de reglas.
sellerFeeBasisPoints en los metadatos, aplicados por mercados cooperativos.
Sí, si la autoridad de actualización se conserva y no es inmutable.
La autoridad de la colección firma la instrucción verify_collection que vincula los metadatos a la acuñación de la colección.
DAS es preferido para wallets; GPA todavía es utilizado por indexadores que ingieren actualizaciones en bruto.
Edición maestra + instrucciones de acuñación de impresión para impresiones numeradas.
Metaplex Sugar se dirige a lanzamientos de colecciones de Token Metadata; consulta la documentación para alternativas de Core.
Deserializa la cuenta de metadatos a través del crate mpl-token-metadata en programas de Rust.
metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s.
Requisitos explícitos del mercado/listado que exigen el formato de Token Metadata.
Versiones de Stack: Esta página fue 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, y LiteSVM 0.6.x.
Revisado por Chris St. John·Última actualización: 16 jul 2026