mpl-core & mpl-token-metadata

Bibliotecas Metaplex modelam NFTs e ativos digitais na Solana. mpl-token-metadata cobre as contas clássicas do Metaplex Token Metadata anexadas a Mints SPL. mpl-core (Core Digital Assets) fornece um modelo de ativo simplificado com plugins. Crates Rust encapsulam construtores de instrução; clientes TypeScript frequentemente usam integrações Umi ou @solana/kit 7.0.0 juntamente com APIs DAS.

Receita

Cartão de receita de referência rápida - pronto para copiar e colar.

[dependencies]
mpl-token-metadata = "5.1"
mpl-core = "0.9"

use mpl_token_metadata::accounts::Metadata;
// Parsing de layout para PDA de metadados de NFT legado

Quando usar isso:

• Mintar NFTs com metadados on-chain e array de criadores.
• Construir marketplaces que atualizam metadados ou verificam coleções.
• Adotar Metaplex Core para emissão de ativos de menor custo.
• Ler registros de ativos via DAS em vez de caminhadas manuais de PDA.

Exemplo de Trabalho

use anchor_lang::prelude::*;
use mpl_core::{
    instructions::CreateV1CpiBuilder,
    types::{Attribute, Attributes, DataState, PluginAuthorityPair},
};
 
pub fn create_core_asset<'info>(
    asset: &AccountInfo<'info>,
    payer: &Signer<'info>,
    system_program: &AccountInfo<'info>,
    mpl_core_program: &AccountInfo<'info>,
    name: String,
    uri: String,
) -> Result<()> {
    CreateV1CpiBuilder::new(mpl_core_program)
        .asset(asset)
        .payer(payer)
        .system_program(system_program)
        .name(name)
        .uri(uri)
        .data_state(DataState::AccountState)
        .invoke()?;
    Ok(())
}

O que isso demonstra:

• MPL Core usa construtores CPI para direcionar o programa Core.
• Nome e URI apontam para JSON off-chain (IPFS/Arweave/https).
• DataState escolhe modelos de estado de conta vs. ledger.
• Funciona dentro de instruções Anchor 0.32.1 com contas explícitas.

Mergulho Profundo

Como Funciona

• Token Metadata anexa um PDA por mint com nome, símbolo, uri, criadores, coleção.
• Core Assets unifica propriedade e plugins com uma interface de programa diferente.
• API DAS indexa ativos legados e comprimidos para consultas de clientes.
• Royalties aplicados via regras de programa e integrações de marketplace.

Tabela de Crates Rust

Tabela TypeScript / NPM

Notas Rust

// Prefira DAS para dashboards com muitas leituras; use crates para escritas/CPIs
// Valide o comprimento da URI e a soma das participações dos criadores em 100% antes do CPI

Armadilhas

• Mistura de modelos Core e Token Metadata - layouts de conta incompatíveis. Correção: escolha por coleção; documente no aplicativo.
• Metadados on-chain superdimensionados - pico de aluguel e CU. Correção: armazene JSON off-chain; apenas uri on-chain.
• Incompatibilidade do array de criadores - falha na aplicação de royalties. Correção: corresponda aos pontos percentuais de taxa do vendedor às regras de negócios.
• Verificação de coleção ausente - associação falsa de coleção. Correção: execute a instrução de verificação de coleção.
• Suposição de escritas DAS - DAS é somente leitura. Correção: construa instruções MPL para mutações.

Alternativas

FAQs

Relacionados

• Noções Básicas de NFT na Solana - conceitos
• Metaplex Core - guia Core
• Token Metadata - metadados legados
• Lendo NFTs (API DAS) - caminho de leitura

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.