Los metadatos, explicados

Cada NFT tiene dos partes: la imagen que la gente ve, y los metadatos que la describen. Los metadatos son lo que hace funcionar los filtros de rasgos, la rareza y los nombres de las piezas. Esto es lo que traen y cómo dejarlos bien en KURV.

Qué traen los metadatos

Para cada pieza, los metadatos suelen incluir:

• Nombre: como “Rana soñolienta #12”.
• Descripción: una línea corta sobre la colección o la pieza.
• Imagen: un enlace al archivo de la imagen.
• Atributos (rasgos): pares como “Sombrero: Gorro azul” o “Fondo: Atardecer”.

De dónde salen en KURV

• Capas: KURV arma los metadatos por ti. Cada capa se vuelve un tipo de rasgo y cada nombre de rasgo se vuelve su valor. Por eso importan los nombres claros.
• Arte terminado: tú entregas un metadata.json con una entrada por pieza.
• Traer una colección: los metadatos ya existen y se publicaron con la colección original.

Escribir metadata.json para arte terminado

Una entrada simple se ve así:

{
  "name": "Rana soñolienta #12",
  "description": "Ranas acogedoras con sombreros diminutos.",
  "attributes": [
    { "trait_type": "Sombrero", "value": "Gorro azul" },
    { "trait_type": "Fondo", "value": "Atardecer" }
  ]
}

Pasos:

1. Haz una entrada por imagen.
2. Usa los mismos tipos de rasgo en todos lados (“Sombrero”, nunca “sombrero” en una y “Sombreros” en otra).
3. Usa la misma ortografía para el mismo valor.
4. Revisa que el número de entradas coincida con el número de imágenes.
5. Arma en Studio y mira cómo se muestran los rasgos.

Por qué importa la consistencia

Los filtros de rasgos agrupan piezas por el texto exacto. “Gorro azul” y “gorro azul” se vuelven dos rasgos distintos. Eso parte los conteos, hace que la rareza se vea rara y confunde a quien busca un rasgo.

Un ejemplo resuelto

La colección de arte terminado de Ana tenía un rasgo de sombrero. A la mitad de escribir los metadatos empezó a poner “Gorro (azul)” en lugar de “Gorro azul”. En Studio el filtro mostró dos rasgos separados, cada uno con la mitad de las piezas. Hizo un buscar y reemplazar, volvió a armar, y el filtro mostró un solo rasgo.

Metadatos y publicación

Cuando publicas en KURV, tu arte y tus metadatos van a IPFS con una huella del armado. Freeze hace permanente el enlace a tus archivos, no los archivos en sí. En la práctica, eso significa dejar los metadatos bien antes de publicar.

Lo que los metadatos no pueden hacer

• No pueden probar que una colección es la original. Solo su contrato y su página oficial pueden.
• No fijan un precio.
• No guardan la imagen en sí, solo un enlace a ella.

El campo de descripción

La descripción suele quedar para el final, pero es lo que aparece cuando una pieza se comparte o se ve sola. Déjala corta y cierta: qué es la colección y quién la hizo. Con una línea sobre la idea basta. Evita cualquier cosa que suene a promesa sobre el futuro o el precio, y evita afirmaciones que no puedas sostener.

Tipos de rasgo que sí valen la pena

Los buenos rasgos responden preguntas que quien colecciona sí hace. “¿Cuáles tienen la corona?” es una buena pregunta. “¿Cuáles tienen el píxel 412 encendido?” no. En una colección por capas, cada capa suele volverse un tipo de rasgo de forma automática. En arte terminado, elige unos pocos que signifiquen algo:

• Rasgos visibles: sombrero, fondo, expresión.
• Rasgos de historia: el nombre o el papel de un personaje, si tu colección tiene historia.
• Rasgos de conjunto: una serie o un capítulo, si las piezas se hicieron en grupos.

Salta los rasgos que comparten todas las piezas. Suman ruido y no le dicen nada a nadie.

Revisar los metadatos, paso a paso

1. Abre el armado en Studio.
2. Elige diez piezas al azar y lee sus rasgos en voz alta.
3. Abre los filtros de rasgos y revisa cada lista por duplicados que solo cambien en ortografía o mayúsculas.
4. Compara la cantidad de piezas por rasgo con lo que querías.

Otro ejemplo: un error de ortografía en el rasgo

Los metadatos de alguien dicen “Fodo” en una pieza y “Fondo” en el resto. Los mercados tratan eso como dos tipos de rasgo distintos, así que esa pieza muestra un rasgo que nadie más tiene, y su fondo no aparece en el filtro de fondo. La corrección es aburrida e importante: escribe cada tipo de rasgo y cada valor exactamente igual en todos los archivos antes de publicar, porque los metadatos quedan fijos una vez que la colección se lanza.

Errores comunes

• Mayúsculas u ortografía que no coinciden.
• Entradas que faltan, y entonces algunas piezas no tienen rasgos.
• Nombres de rasgos que solo tú entiendes, como “v2”.
• Demasiados rasgos por los que nadie va a filtrar.
• Cantidades que no coinciden entre imágenes y entradas.

Preguntas frecuentes

¿Tengo que escribir metadatos para una colección por capas? No. KURV los arma a partir de tus capas y de los nombres de los rasgos.

¿Quien colecciona puede ver los metadatos? Sí, son públicos. Los rasgos se ven en cada pieza.

¿Puedo editar los metadatos después de publicar? Tómalos como definitivos. Freeze hace permanente el enlace.

¿Los metadatos afectan la rareza? La rareza se cuenta a partir de los rasgos, así que sí.

Por dónde seguir

• Diseña rasgos que se vean equilibrados