Mejores Prácticas de Metadatos de Tokens SPL

¿Qué son los Metadatos de Token?

Los metadatos del token son información adicional adjunta a su token SPL que lo hace reconocible y utilizable en todo el ecosistema de Solana. Sin los metadatos adecuados, su token es solo una dirección; con ellos, su token tiene una identidad, representación visual y contexto.

Por qué importan los Metadatos

Los metadatos adecuados aseguran que su token:

• Se muestre correctamente en billeteras como Phantom, Solflare y Backpack
• Aparezca en exploradores como Solscan y Solana Explorer con información completa
• Sea indexado por DEXs y agregadores como Jupiter y Raydium
• Parece profesional y confiable para los posibles poseedores
• Pueda ser descubierto por usuarios que buscan tokens en su categoría

Las primeras impresiones importan: Los usuarios a menudo juzgan la legitimidad de un token por lo profesional que se ven sus metadatos. Los metadatos deficientes o faltantes son una señal de alerta que grita "estafa" o "poco profesional".

El Estándar Metaplex

Metaplex es el estándar de facto para metadatos de NFT y tokens en Solana. La mayoría de las billeteras, exploradores y plataformas siguen el estándar de metadatos de tokens de Metaplex.

Metadatos On-Chain vs Off-Chain

Metaplex utiliza un enfoque híbrido:

• On-Chain: Datos esenciales como nombre, símbolo y URI almacenados directamente en Solana
• Off-Chain: Datos extendidos como imágenes, descripciones y atributos almacenados como JSON y referenciados por URI

Este diseño mantiene bajos los costos de la cadena de bloques al tiempo que permite metadatos ricos.

Campos Requeridos

Como mínimo, los metadatos de su token deben incluir:

• name - Nombre completo del token (por ejemplo, "Mi Token Impresionante")
• symbol - Símbolo de cotización (por ejemplo, "MAT")
• uri - URL que apunta a su archivo JSON de metadatos

Campos Opcionales Pero Recomendados

• description - Explicación detallada de su token
• image - URL de su logotipo de token
• external_url - El sitio web de su proyecto
• attributes - Propiedades y etiquetas personalizadas
• properties - Información extendida que incluye enlaces sociales

Especificaciones de la Imagen del Token

El logotipo de su token es la parte más visible de sus metadatos. Así es como debe hacerlo correctamente:

Requisitos Técnicos

• Formato: PNG con transparencia (preferido) o JPG
• Dimensiones: 500x500px mínimo, 1000x1000px recomendado
• Relación de Aspecto: 1:1 (cuadrado) es obligatorio; los tokens circulares deben ser cuadrados con esquinas transparentes
• Tamaño del Archivo: Menos de 1 MB para una carga rápida, idealmente 100-300 KB
• Resolución: 72 DPI mínimo, 300 DPI para calidad de impresión

Mejores Prácticas de Diseño

• Sencillo y Reconocible: Debe ser identificable incluso en tamaños pequeños (32x32px)
• Alto Contraste: Funciona tanto en fondos claros como oscuros
• Calidad Profesional: Sin pixelación, desenfoque o elementos de diseño amateur
• Identidad Única: Lo suficientemente distintivo como para evitar confusiones con otros tokens
• Consistente con la Marca: Coincide con la identidad visual general de su proyecto

Consejo Profesional: Pruebe su logotipo en diferentes tamaños (16px, 32px, 64px, 128px) para asegurarse de que permanezca claro y reconocible. Las billeteras muestran los tokens en varios tamaños.

Errores Comunes de Imagen a Evitar

• Usar imágenes no cuadradas que se distorsionan
• Imágenes de baja resolución que se ven pixeladas
• Diseños complejos con demasiados detalles para pantallas pequeñas
• Infracción de derechos de autor: usar arte de otra persona sin permiso
• Imágenes inapropiadas u ofensivas
• Fondos blancos que chocan con las interfaces de modo oscuro

Mejores Prácticas para la Descripción

La descripción de su token explica qué es su token y por qué existe. Aparece en exploradores y en algunas billeteras.

Estructure su Descripción

Una buena descripción sigue este formato:

1. Línea de Apertura: Declaración concisa de lo que es el token (1 oración)
2. Propósito: Explique la utilidad y los casos de uso del token (2-3 oraciones)
3. Características Clave: Resalte lo que lo hace único o valioso
4. Llamada a la Acción: Invite a los usuarios a obtener más información o a participar

Consejos de Redacción

• Sea Conciso: 150-300 caracteres es ideal. La gente escanea, no lee
• Lenguaje Claro: Evite la jerga a menos que su audiencia la espere
• Propuesta de Valor: Concéntrese en los beneficios, no solo en las características
• Tono Profesional: Incluso las monedas meme necesitan una gramática y ortografía adecuadas
• Sin Lenguaje de Hype: Evite "a la luna", "retornos garantizados" o promesas de hacerse rico rápidamente
• Amigable para SEO: Incluya palabras clave relevantes de forma natural

Ejemplo de Descripción (Buena)

"MYTOKEN es el token de gobernanza para el ecosistema MyDAO. Los poseedores de tokens pueden votar sobre actualizaciones de protocolo, gestión de tesorería e iniciativas comunitarias. Con un suministro fijo de 100 millones de tokens y sin autoridad de acuñación, MYTOKEN está diseñado para la acumulación de valor a largo plazo a través de tarifas de plataforma y recompensas por staking."

Ejemplo de Descripción (Mala)

"¡MYTOKEN va a la LUNA 🚀🚀🚀 100x GARANTIZADO! ¡Compra ahora antes de que sea demasiado tarde! ¡Esta es la próxima GRAN cosa en cripto!"

Enlaces Sociales y URLs Externas

Conectar su token con su presencia web genera confianza y comunidad.

Enlaces Esenciales

Incluya estos en la sección properties de sus metadatos:

• Sitio Web: La página de inicio oficial de su proyecto
• Twitter/X: Para anuncios y participación de la comunidad
• Telegram o Discord: Para discusión comunitaria
• Documentación: Libro blanco o documentos técnicos

Enlaces Opcionales Pero Valiosos

• Medium o blog para actualizaciones
• GitHub para proyectos de código abierto
• Comunidad de Reddit
• YouTube para contenido de video
• Listado de CoinGecko o CoinMarketCap

Mejores Prácticas de Enlaces

• Usar HTTPS: Todas las URLs deben ser seguras
• Verificar Enlaces: Pruebe cada enlace antes de implementar los metadatos
• Mantener Actualizado: Los enlaces rotos dañan la credibilidad
• Solo Canales Oficiales: No enlace a páginas de fans no oficiales
• Marca Consistente: Los identificadores sociales deben coincidir cuando sea posible

Nota de Seguridad: Nunca enlace a sitios sospechosos o de phishing. Los enlaces maliciosos en los metadatos pueden hacer que su token sea marcado o eliminado de la lista.

Estructura JSON de los Metadatos

Aquí hay un ejemplo completo de metadatos de token correctamente estructurados:

{
  "name": "My Awesome Token",
  "symbol": "MAT",
  "description": "MAT is the governance token for the MyDAO ecosystem, enabling community-driven decision making and value distribution.",
  "image": "https://arweave.net/your-image-hash",
  "external_url": "https://myawesometoken.com",
  "attributes": [
    {
      "trait_type": "Type",
      "value": "Governance"
    },
    {
      "trait_type": "Supply",
      "value": "Fixed"
    }
  ],
  "properties": {
    "files": [
      {
        "uri": "https://arweave.net/your-image-hash",
        "type": "image/png"
      }
    ],
    "category": "currency",
    "creators": [],
    "links": {
      "website": "https://myawesometoken.com",
      "twitter": "https://twitter.com/MyAwesomeToken",
      "telegram": "https://t.me/myawesometoken",
      "discord": "https://discord.gg/myawesometoken",
      "medium": "https://medium.com/@myawesometoken"
    }
  }
}

Explicaciones de Campos

• name: Nombre completo del token, mostrado en billeteras
• symbol: Ticker de 2-5 caracteres
• description: Explicación detallada (150-500 caracteres)
• image: URL directa al logotipo de su token
• external_url: El sitio web principal de su proyecto
• attributes: Pares clave-valor para categorización y filtrado
• properties.files: Matriz de archivos asociados (generalmente solo la imagen)
• properties.category: Tipo de token (generalmente "currency" para tokens fungibles)
• properties.links: Toda su presencia social y web

Alojar sus Metadatos

Dónde aloja sus metadatos importa para la permanencia y la accesibilidad.

Opciones de Alojamiento

1. Arweave (Recomendado)

• Almacenamiento permanente: Pague una vez, almacenado para siempre
• Descentralizado: Sin un único punto de falla
• Estándar de la industria: Preferido por el ecosistema de Solana
• Costo: ~0.10-0.20 $ por carga de metadatos

2. IPFS

• Descentralizado: Almacenamiento dirigido por contenido
• Amplio soporte: La mayoría de las plataformas aceptan URIs de IPFS
• Costo: Variable, depende del servicio de anclaje
• Consideración: Requiere anclaje para asegurar la disponibilidad

3. Alojamiento Web Tradicional (No Recomendado)

• Flexible: Fácil de actualizar metadatos
• Barato: Puede usar el alojamiento web existente
• Riesgos: Puede caerse, el dominio puede expirar, la empresa puede cerrar
• Caso de uso: Solo durante el desarrollo/pruebas

Mejor Práctica: Use Arweave para tokens de producción. La permanencia y la descentralización se alinean con los principios criptográficos y previenen problemas futuros.

Carga a Arweave

La mayoría de las plataformas de creación de tokens (como CreateMyCoin) manejan las cargas a Arweave automáticamente. Si lo hace manualmente:

1. Cargue la imagen de su token a Arweave (obtiene una URL permanente)
2. Cree su archivo JSON de metadatos con la URL de la imagen
3. Cargue el archivo JSON a Arweave (obtiene otra URL permanente)
4. Use la URL JSON como URI de su token al acuñar

Actualización y Mantenimiento de Metadatos

A veces necesita actualizar los metadatos de su token después de la creación.

Qué se puede Actualizar

Si mantuvo la autoridad de actualización durante la creación del token:

• El URI que apunta a sus metadatos
• Metadatos fuera de la cadena (descripción, enlaces, imágenes) subiendo un nuevo JSON
• Nombre y símbolo del token (aunque esto puede causar confusión)

Qué no se puede Cambiar

• Dirección de acuñación del token (esta es la identidad permanente de su token)
• Decimales (establecidos para siempre en la creación)
• Suministro inicial (aunque se puede acuñar más si mantuvo la autoridad de acuñación)

Cuándo Actualizar Metadatos

Razones válidas para actualizar:

• Corregir errores tipográficos o de descripción
• Actualizar enlaces sociales cuando cambian las URLs
• Mejorar el logotipo del token con una versión de mayor calidad
• Agregar nuevas características o casos de uso a la descripción
• Cambio de marca (con comunicación clara a la comunidad)

Mejores Prácticas para Actualizaciones

• Anunciar cambios: Informe a su comunidad antes de actualizar
• Preservar el historial: Mantenga los metadatos antiguos accesibles para mayor transparencia
• No abuse: Los cambios frecuentes dañan la confianza
• Pruebe primero: Verifique que los nuevos metadatos funcionen antes de implementarlos

Lista de Verificación de Metadatos

Antes de implementar su token, verifique:

• ✅ El logotipo es PNG de 1000x1000px con transparencia
• ✅ El logotipo se ve bien en tamaños de 32px, 64px y 128px
• ✅ La descripción es clara, profesional y tiene menos de 300 caracteres
• ✅ Todos los enlaces sociales funcionan y usan HTTPS
• ✅ Los metadatos JSON son válidos y están formateados correctamente
• ✅ Los metadatos están alojados en almacenamiento permanente (Arweave recomendado)
• ✅ No hay errores tipográficos en el nombre, símbolo o descripción
• ✅ La URL externa apunta a su sitio web oficial
• ✅ La URL de la imagen es accesible y se carga rápidamente
• ✅ Los metadatos se han probado en al menos una billetera

Conclusión

Los metadatos de calidad marcan la diferencia entre un token profesional y un proyecto amateur. Es la primera impresión de su token, su identidad en todo el ecosistema y un factor clave para generar confianza con los posibles poseedores.

Al seguir estas mejores prácticas (usar especificaciones de imagen adecuadas, escribir descripciones claras, proporcionar enlaces sociales completos y alojar en almacenamiento permanente), se asegura de que su token presente su mejor cara desde el primer día.

Recuerde: puede tener la mejor tokenómica y utilidad del mundo, pero si sus metadatos parecen poco profesionales o faltan, los usuarios nunca se quedarán el tiempo suficiente para descubrir su propuesta de valor.