Metadados explicados

Todo NFT tem duas partes: a imagem que as pessoas veem, e os metadados que a descrevem. Os metadados são o que faz funcionar o filtro de traços, a raridade e o nome da peça. Veja o que entra nisso e como acertar na KURV.

O que os metadados contêm

Para cada peça, os metadados em geral incluem:

• Nome: por exemplo “Sapo Sonolento #12”.
• Descrição: uma linha curta sobre a coleção ou a peça.
• Imagem: um link para o arquivo da imagem.
• Atributos (traços): pares como “Chapéu: Gorro azul” ou “Fundo: Pôr do sol”.

De onde isso vem na KURV

• Camadas: a KURV monta os metadados para você. Cada camada vira um tipo de traço, e cada nome de traço vira o valor. Por isso nomes claros importam.
• Arte finalizada: você entrega um metadata.json com uma entrada para cada peça.
• Trazer uma coleção: os metadados já existem e foram publicados com a coleção original.

Como escrever o metadata.json da arte finalizada

Uma entrada simples fica assim:

{
  "name": "Sapo Sonolento #12",
  "description": "Sapos aconchegantes de chapéus minúsculos.",
  "attributes": [
    { "trait_type": "Chapéu", "value": "Gorro azul" },
    { "trait_type": "Fundo", "value": "Pôr do sol" }
  ]
}

Passos:

1. Faça uma entrada por imagem.
2. Use os mesmos tipos de traço em todo lugar (“Chapéu”, nunca “chapéu” num e “Chapéus” noutro).
3. Use a mesma grafia para o mesmo valor.
4. Confira se o número de entradas bate com o número de imagens.
5. Monte no Studio e veja como os traços aparecem.

Por que a consistência importa

Os filtros de traço agrupam peças pelo texto exato. “Gorro azul” e “gorro azul” viram dois traços diferentes. Isso parte a contagem, deixa a raridade com cara estranha e confunde quem procura um traço.

Um exemplo na prática

A coleção de arte finalizada da Ana tinha um traço de chapéu. No meio de escrever os metadados, ela começou a digitar “Gorro (azul)” em vez de “Gorro azul”. No Studio, o filtro mostrou dois traços separados, cada um com metade das peças. Ela usou localizar e substituir, montou de novo, e o filtro mostrou um traço só.

Metadados e publicação

Quando você publica na KURV, a arte e os metadados vão para o IPFS com uma impressão digital da montagem. O Freeze torna permanente o link para os seus arquivos, não os arquivos em si. Na prática, isso quer dizer acertar os metadados antes de publicar.

O que os metadados não fazem

• Não provam que uma coleção é a original. Só o contrato e a página oficial provam.
• Não definem um preço.
• Não guardam a imagem em si, só um link para ela.

O campo de descrição

A descrição costuma ficar para o fim, mas é o que aparece quando uma peça é compartilhada ou vista sozinha. Deixe curta e verdadeira: o que a coleção é e quem fez. Uma linha sobre a ideia basta. Evite qualquer coisa que soe como promessa sobre o futuro ou sobre preço, e evite afirmações que você não consegue sustentar.

Tipos de traço que valem a pena

Bons traços respondem perguntas que quem coleciona faz de verdade. “Quais têm a coroa?” é uma boa pergunta. “Quais têm o pixel 412 aceso?” não é. Numa coleção em camadas, cada camada em geral vira um tipo de traço sozinha. Na arte finalizada, escolha um punhado que signifique alguma coisa:

• Traços visíveis: chapéu, fundo, expressão.
• Traços de história: o nome ou o papel de um personagem, se a coleção tem história.
• Traços de conjunto: uma série ou um capítulo, se as peças foram feitas em grupos.

Pule traços que toda peça compartilha. Eles enchem a tela sem contar nada para ninguém.

Como conferir os metadados, passo a passo

1. Abra a montagem no Studio.
2. Escolha dez peças ao acaso e leia os traços em voz alta.
3. Abra os filtros de traço e procure, em cada lista, duplicatas que só mudam na grafia ou na maiúscula.
4. Compare a contagem de peças por traço com o que você pretendia.

Um segundo exemplo: um erro de grafia num traço

Os metadados de um criador têm “Funndo” numa peça e “Fundo” no resto. Os mercados tratam isso como dois tipos de traço diferentes. Aquela peça mostra um traço que nenhuma outra tem, e o fundo dela não aparece no filtro de fundo. A correção é sem graça e importante: escreva cada tipo de traço e cada valor exatamente iguais em todos os arquivos antes de publicar, porque os metadados ficam fixos quando a coleção lança.

Erros comuns

• Maiúscula ou grafia inconsistente.
• Entradas faltando, e algumas peças ficam sem traço.
• Nomes de traço que só fazem sentido para você, como “v2”.
• Traços demais, que ninguém vai usar para filtrar.
• Contagens que não batem entre imagens e entradas.

Perguntas frequentes

Preciso escrever metadados numa coleção em camadas? Não. A KURV monta a partir das suas camadas e dos nomes dos traços.

Quem coleciona vê os metadados? Sim, são públicos. Os traços aparecem em cada peça.

Posso editar os metadados depois de publicar? Trate como definitivo. O Freeze torna o link permanente.

Os metadados afetam a raridade? A raridade é contada a partir dos traços, então sim.

Para onde seguir

• Crie traços que pareçam equilibrados