Cuando creas un token en Solana, el Programa de Tokens SPL básico solo almacena los saldos brutos y los decimales. No almacena de forma nativa el nombre legible del token, el símbolo, la descripción, la página web o la imagen del logotipo.
Para mostrar una marca completa en billeteras (como Phantom y Solflare) e interfaces DEX (como Raydium y DexScreener), Solana utiliza el Estándar de Metadatos de Tokens de Metaplex.
Comprender cómo se conectan las cuentas de metadatos en cadena con los archivos JSON fuera de cadena garantiza que tu token muestre su logotipo y detalles sin imágenes rotas ni fallos de visualización.
El Estándar de Metadatos de Metaplex divide la información del token en dos capas distintas:
Una cuenta dedicada almacenada directamente en la memoria de los validadores de Solana, derivada de la dirección de emisión de tu token. Almacena campos de texto fijos:
- Nombre (Name): Nombre del token (hasta 32 caracteres).
- Símbolo (Symbol): Símbolo de cotización (hasta 10 caracteres).
- URI: Una cadena URL (hasta 200 caracteres) que apunta al archivo JSON fuera de cadena.
- Autoridad de actualización (Update Authority): La clave pública autorizada para actualizar los metadatos.
Un archivo JSON estructurado alojado en un almacenamiento descentralizado permanente (como Arweave o IPFS). Este archivo contiene los detalles ampliados del proyecto:
image: URL directa al archivo de imagen PNG, JPEG o SVG.description: Resumen detallado del proyecto.external_url: Enlace al sitio web oficial.properties.files: Matriz de archivos de medios y tipos de contenido.
Las especificaciones oficiales se mantienen en la Documentación de Desarrolladores de Metaplex.
Causas comunes de logotipos de tokens rotos
Los creadores a menudo notan que el logotipo de su token aparece en la billetera Phantom pero no se carga en Solscan, o viceversa. Esto ocurre por discrepancias en las especificaciones:
- URL de imagen no directa: Enlazar a una página web que contiene una imagen en lugar de una URL directa de imagen que termine en
.png o .svg.
- Restricciones CORS: Alojar la imagen en un servidor web centralizado que bloquea las solicitudes CORS de billeteras e interfaces DEX.
- Proporciones de imagen no cuadradas: Cargar imágenes no cuadradas. Las interfaces de las billeteras esperan una proporción cuadrada (por ejemplo, 512x512 píxeles).
- Proveedores de alojamiento temporal: Alojar imágenes en sitios de carga temporal que eliminan archivos tras 30 días.
Para garantizar la visualización universal en todas las billeteras de Solana y agregadores DEX, sigue estas pautas:
- Formato de imagen: PNG o SVG (se recomienda fondo transparente).
- Dimensiones: Cuadrado de 512x512 píxeles (menos de 1 MB de tamaño).
- Alojamiento JSON: Almacenamiento descentralizado permanente (puerta de enlace Arweave o IPFS).
- Uso de HTTPS: Todas las URI deben utilizar protocolos seguros
https:// o ar://.
Crear y vincular manualmente archivos JSON de Metaplex requiere configurar billeteras Arweave y herramientas de desarrollo.
El Creador de Tokens de Solana de PumpBolt automatiza todo el proceso de metadatos en un solo paso:
- Subes tu imagen de logotipo cuadrada directamente en el formulario web.
- PumpBolt optimiza la imagen y la sube a un almacenamiento descentralizado permanente.
- PumpBolt genera un archivo JSON de metadatos compatible y lo vincula a Arweave.
- Al emitir tu token, PumpBolt adjunta la URI de Arweave a tu cuenta de metadatos de Metaplex en cadena en la misma transacción.
Seguir el estándar Metaplex y utilizar almacenamiento permanente garantiza que la marca de tu token permanezca visible e inmutable en todo el ecosistema de Solana.