8 minutos de leitura
Visão geral
Even in the 2022 bear market, Solana NFTs are showing no signs of slowing down. If you are building with Solana NFTs, understanding your NFTs' metadata will make it easier for you to deploy and update NFTs, communicate with your users, and develop innovative applications for NFTs. Whether you're a collector, deciphering your NFTs' metadata will help you understand your NFT and how to find essential information on a Solana block explorer.
Neste guia, irá aprender:
- O que é o padrão de tokens NFT Metaplex?
- Como acompanhar e encontrar informações sobre os seus NFT(s) utilizando Solana
- O que são «Coleções Certificadas» e «Máquinas de Doces» e como é que estas afetam os metadados de um NFT?
O que vai precisar
- Experiência básica com Solana
O Padrão de Tokens NFT Metaplex
Metadata is an essential tool in blockchain protocols to allow additional information to be assigned to a fungible or non-fungible token. This includes data such as the image or traits associated with an NFT, the acronym of a fungible token (e.g., $USDC or $mSOL), or a creator's royalty amount and wallet.
Uma vez que o programa de tokens SPL Solana inclui apenas metadados mínimos (por exemplo, a oferta de tokens), a Metaplex criou um protocolo amplamente adotado para associar metadados adicionais aos tokens. O protocolo da Metaplex cria um Endereço Derivado do Programa (PDA) (para mais informações sobre PDAs, consulte o nosso Guia de ReferênciaSolana ) associado a uma Conta de Emissão (as contas de cunhagem são responsáveis por armazenar a informação global de um token e as contas de token armazenam a relação entre uma carteira e uma conta de cunhagem. Fonte : docs.metaplex.com). Por outras palavras, cada token (fungível ou não) tem uma conta de cunhagem; e a entidade responsável pelo token pode anexar metadados adicionais a essa conta utilizando o programa Metaplex Metadata através de um PDA:
Fonte: *docs.metaplex.com
*
Nota: Se tiver experiência na criação Solana , o PDA é inicializado com: a chave pública do programa de cunhagem do token, a chave pública do programa de metadados do token e o termo «metadados».
O programa Metaplex Metadata define normas para NFTs, tokens fungíveis e ativos fungíveis/tokens semifungíveis (SFTs). Este guia irá centrar-se nos NFTs — para mais informações sobre outras normas, consulte as Normas de Tokens da Metaplex.
The metadata includes two main parts: data stored on-chain in the PDA and data stored off-chain (usually in some permanent decentralized storage, e.g., Arweave, IPFS, or Shadow Drive) linked in the PDA through a unique URI. The primary purpose for hosting some data off-chain is to limit the cost of rent for a metadata PDA and to allow the metadata program to more flexibly evolve as the needs of the industry change (more information available at Metaplex FAQs).
On-Chain Metadata
The following fields are data stored within the on-chain metadata PDA for a given NFT:
- Chave - Um identificador de conta que identifica o tipo de conta de metadados
- Autoridade de atualização — A chave pública autorizada a atualizar esta conta
- Mint - A chave pública da conta Mint da qual deriva
- Name - The on-chain name of the token (e.g., "Quick Pixel #1")
- Symbol - The on-chain symbol of the token (e.g., "FFF")
- Uri - O URI dos metadados externos. Este URI aponta para um ficheiro JSON fora da cadeia que contém dados adicionais, de acordo com uma determinada norma
- Taxa do Vendedor em Pontos Base — Os royalties compartilhados pelos criadores em pontos base — ou seja, 550 significa royalties de 5,5%. Observação: embora este campo seja usado pela maioria dos marketplaces de NFTs, ele não é obrigatório pelo próprio programa de Metadados do Token.
- Venda Primária Realizada - Um valor booleano que indica se o token já foi vendido pelo menos uma vez. Uma vez definido como True, nunca mais poderá voltar a ser False. Este campo pode afetar a forma como os direitos de autor são distribuídos
- É mutável - Um valor booleano que indica se a conta de metadados pode ser atualizada. Uma vez definido como False, nunca mais poderá voltar a ser True
- Criadores - (opcional) Uma matriz com os criadores e a sua percentagem dos direitos de autor. Esta matriz está limitada a 5 criadores. Cada objeto «criador» contém os seguintes campos: Endereço (cadeia de caracteres da chave pública do criador), Verificado (booleano — verdadeiro se o criador tiver assinado o NFT), Participação (um número [0-100] que representa a participação proporcional nos direitos de autor em %. A soma das participações de todos os criadores deve ser igual a 100)
- Os campos opcionais adicionais incluem: Criadores, Nonce da edição, Padrão do token, Coleção, Utilizações, Detalhes da coleção
Fonte: Contas de metadados do Metaplex Token
Metadados fora da cadeia
Os campos seguintes correspondem aos dados armazenados no JSON que está associado ao PDA de um determinado NFT através do campo URI:
- nome - Nome do NFT
- símbolo - símbolo do NFT
- descrição - descrição do NFT
- imagem - URI que aponta para a imagem principal do recurso (normalmente aquela que está associada a um NFT)
- animation_url - URI que aponta para a animação do recurso, caso exista
- external_url — URI que aponta para um URL externo que define o recurso — por exemplo, o site do criador.
- atributos — um conjunto de atributos que definem as características do ativo.
- propriedades — quaisquer ficheiros associados ao NFT e um tipo de ficheiro principal, a «categoria».
- category (deprecated) - you may see instances of this in older NFTs, however, this information has now been moved to the on-chain metadata.
That's a lot to digest--here's a quick visual showing how the on-chain and off-chain information are related:
Fonte: *docs.metaplex.com
*
Vamos tentar compreender melhor isto através de um exemplo.
Navegar pelos metadados utilizando Solana
Vamos analisar um NFT na cadeia utilizando Solana e explorar os elementos dos seus metadados. Encontrei um Okay Bear sobre o qual estou interessado em saber mais. O seu endereço de cunhagem é H6wPjAGAU1mH83sQ8pJC98kYkGCju5Z5ZpJ4sWcLfn2a. Aceda a explorer.solana.com e introduza o endereço de cunhagem na barra de pesquisa. Deverá ser redirecionado para a página de cunhagem do NFT, aqui.
Deve ver a imagem de um NFT com algumas informações básicas sobre o mesmo:
If you scroll down, you should see a "Metadata" tab (note: this will only be found on mint pages with associated metadata discovered by the explorer). Click it. You should see our NFT's on-chain metadata outlined in JSON format:
This should look familiar to the "On-Chain Metadata" bullets we outlined above. Solana Explorer abstracts some of our off-chain data (e.g., Traits) in the "Attributes" tab, but where is the rest of our off-chain metadata? If you return to the metadata tab, find the field "uri." If you recall, this is where we link our external JSON. Copy the link and open it in a new tab.
Deve ver um ficheiro JSON no seu navegador:
Reserve um momento para explorar os dados. Deverá ver todos os campos que definimos acima. Não hesite em procurar o URI «image» e abri-lo numa nova aba. Esse IPFS irá levá-lo à imagem original!
That's it! Between the on-chain data we looked at on Solana Explorer and its off-chain data found through the "URI" field, we have all the data about this NFT.
Antes de terminarmos, vamos analisar mais detalhadamente as «Metaplex Certified Collections» e as «Candy Machines» e aprofundar a forma como estas afetam os metadados de um NFT.
Acompanhamento de coleções e criadores
Coleções Certificadas pela Metaplex
In 2022, Metaplex launched Certified Collections to enable on-chain verification and grouping of NFTs. Certifying collections makes it easier for users to query which collection an NFT is a part of, find all NFTs in a collection, and standardize details about the collection. Exchanges and wallets often use collection data to consolidate a folder-like view of sets of NFTs.
Certified Collections are created by assigning the on-chain metadata field "collection" a value of the mint address of a "Collection NFT." A Collection NFT exists to store information about the collection and be a common link between all collection elements. In addition to capturing the public key of the Collection NFT in the "collection" field of an NFT's metadata, you will also see a boolean field, "verified." In order to mark the "verified" field as true, the Authority of the Collection NFT must sign the NFT to prove that it is allowed to be part of the collection (Source: docs.metaplex.com/../certified-collections).
Fonte/Para mais informações: *docs.metaplex.com/../certified-collections
*
Se voltarmos aos metadados do nosso Okay Bear e expandirmos o campo «coleção», podemos ver que foi verificado que o nosso NFT faz parte da coleção 3saAedkM9o5g1u5DCqsuMZuC4GRqPB4TuMkvSsSVvGQ3:
"collection":{
"verified":1
"key":"3saAedkM9o5g1u5DCqsuMZuC4GRqPB4TuMkvSsSVvGQ3"
}
É possível criar coleções durante a emissão de um NFT utilizando o Candy Machine, SDK JS SDK ou através da ferramenta web «Certified Collection» da Metaplex.
If you looked closely at the on-chain metadata for our NFT, you probably noticed something a little odd in our metadata. We have a verified creator that has a 0% share of revenues. Why would they do that? It's actually quite common--we will discuss that in the next section.
Pastilhas de menta da máquina de doces
In addition to automatically certifying collections, Candy Machine includes another handy feature for tracking NFTs associated with a common mint. On mint, they add and verify a new creator in the first position of the creator's list (often referred to as "Creator Zero" as it sits in the 0-index position). The new creator was historically the address of the candy machines, but newer versions use a candy machine mint authority PDA. Since this address isn't a creator, the royalties are automatically set to 0. Since the address is only associated with the mint of a given collection/Candy Machine and since the Candy Machine verifies (signs) the NFT, marketplaces and wallets often use this as an alternative approach to find or track collections of NFTs.
Nota: várias versões do Candy Machines utilizam esta abordagem, tal como várias ferramentas alternativas de criação de moedas. Aqui estão os IDs de programa de algumas delas:
- CandyMachine v1: cndyAnrLdpjq1Ssp1z8xxDsB8dxe7u4HL5Nxi2K5WXZ
- CandyMachine v2: cndy3Z4yapfJBmL3ShUp5exZKqR3z33thTzeNMm2gRZ
- CandyMachine v3: CndyV3LdqHUfDLmE5naZjVN8rBZz4tqhdefbAnjHG3JR
- Fork do MagicEden CM: CMZYPASGWeTz7RNGHaRJfCq2XQ5pYK6nDvVQxzkH51zb
- LaunchMyNft: ArAA6CZC123yMJLUe4uisBEgvfuw2WEvex9iFmFCYiXv
Fonte: Centro de Ajuda do OpenSea
Vamos voltar a olhar para o nosso Urso:
"creators":[
0:{
"address":"3xVDoLaecZwXXtN59o6T3Gfxwjcgf8Hc9RfoqBn995P9"
"verified":1
"share":0
},
1:{...},
...
]
Como se pode ver, 3xVDoLaecZwXXtN59o6T3Gfxwjcgf8Hc9RfoqBn995P9 é o primeiro criador. Está marcado como verificado, com uma quota de royalties de 0%. Normalmente, isto indica que o nosso NFT foi cunhado com uma Candy Machine. Se pesquisarmos esse endereço no Solana , podemos ver que, de facto, esse endereço é um fork da Candy Machine utilizado pela Magic Eden (ID do programa atribuído: CMZYPASGWeTz7RNGHaRJfCq2XQ5pYK6nDvVQxzkH51zb):
É bastante giro, não é?
Desenvolver na Solana
To build on Solana, you'll need an API endpoint to connect with the network. You're welcome to use public nodes or deploy and manage your own infrastructure; however, if you'd like 8x faster response times, you can leave the heavy lifting to us. See why over 50% of projects on Solana choose Quicknode and sign up for a free account here.
Basta copiar o link do teu Provedor HTTP e já estás pronto para começar a criar!
Conclusão
À medida que for explorando os NFTs na Solana, esperamos que possa utilizar estas dicas para criar aplicações mais eficientes e seguras. Junte-se ao nosso Discord se tiver alguma dúvida ou contacte-nos através do Twitter.
Pronto para aprofundar os teus conhecimentos sobre Solana ? Consulta estes guias para continuares a tua jornada: