Actualizar metadata de un token de Solana: nombre y logo

Actualizar metadata token Solana parece una sola tarea y en realidad son dos. La metadata es la ficha pública de la moneda: nombre, símbolo, logo, descripción y enlaces. Esa información no vive en un sitio, vive en dos, y cada uno se edita por separado.

De ahí sale el mensaje más repetido después de un lanzamiento: cambiaste el logo hace una semana y Solscan sigue mostrando el nombre viejo.

• Nombre, símbolo y dirección web están en la red. Cambiarlos cuesta una comisión.
• Logo, descripción y enlaces sociales están en un archivo. Cambiarlos es gratis.
• Editar una capa no toca la otra, nunca.
• Bloquear es la única decisión que no se puede deshacer.

Las dos capas de la metadata

Cuando se acuña un token, sus datos llegan a través de Metaplex Token Metadata, el estándar que sigue casi toda moneda en Solana. Eso crea la primera capa. Cómo se engancha esa cuenta al mint está descrito en la documentación de Solana sobre Metaplex Metadata.

La capa uno está en la red. Guarda exactamente tres cosas: el nombre, el símbolo (el ticker) y una dirección web que apunta a un archivo. Las billeteras y los exploradores leen aquí primero. Tocar cualquiera de las tres es una edición en la red y tiene coste.

La capa dos es el archivo que hay en esa dirección. Dentro están el logo, la descripción, la web y los enlaces sociales. Cambiar cualquiera de ellos se reduce a volver a subir el archivo a la misma dirección. Sin transacción y sin comisión.

Así que cuando alguien cambia el logo y el nombre no se mueve, no hay nada roto. El logo está en el archivo, el nombre está en la red, y editar uno jamás altera el otro.

Campo	Capa	Cómo se cambia	Coste
Nombre del token	En la red	Herramienta de actualización	0,2 SOL
Símbolo (ticker)	En la red	Herramienta de actualización	0,2 SOL
Dirección web (URI)	En la red	Herramienta de actualización	0,2 SOL
Logo	El archivo	Volver a subirlo a la misma dirección	gratis
Descripción	El archivo	Volver a subirlo a la misma dirección	gratis
Web y redes	El archivo	Volver a subirlo a la misma dirección	gratis

Cuándo hace falta tocar la metadata

• Quieres otro logo. Diseño entregó una versión mejor. Como el logo vive en el archivo, lo vuelves a subir a la misma dirección y listo. Gratis.
• Cambió un enlace. Se movió el Discord, cambió la cuenta de X, la web está en otro dominio. Misma historia: editas el archivo y ya está.
• El nombre o el símbolo están mal. Lanzaste con un nombre provisional o el ticker tiene una errata. Eso está sellado en la red, así que pasa por la herramienta de actualización.
• Mueves el archivo a almacenamiento permanente. Como cambia la propia dirección, también es una edición en la red. Este paso va siempre antes de bloquear nada.

Los dos primeros casos no tocan la red y no cuestan nada, y puedes repetirlos tantas veces como quieras. Los dos últimos pasan por el mismo formulario, sea el nombre, el ticker o la dirección. Dicho de otro modo: lo cosmético es gratis y solo los tres campos sellados tienen precio.

Cómo actualizar la metadata de un token en Solana, paso a paso

Si solo cambias logo o enlaces, nada de esto hace falta. Para nombre, símbolo o dirección, el recorrido son cuatro pasos.

• Mira primero cómo está. Abre la herramienta de snapshot y pega la dirección del token. Lee los valores actuales y te dice si el permiso de edición sigue en manos de una billetera. Es gratis, y si el permiso ya se entregó, no tiene sentido pagar nada.
• Conecta la billetera correcta. Solo la que tiene ese permiso puede firmar el cambio. Con otra, la edición simplemente no entra.
• Escribe los valores nuevos y firma. En la herramienta de actualizar metadata pegas la dirección, escribes lo nuevo y apruebas en tu billetera. La comisión del momento aparece en la página antes de confirmar.
• Comprueba después. Vuelve a pasar el snapshot. Con el logo, ten paciencia: las billeteras guardan la imagen en caché entre diez y treinta minutos.

Antes de bloquear, tu archivo tiene que estar en un sitio permanente. El desastre que se repite: el equipo lo sube a un hosting gratuito durante el lanzamiento, bloquea la metadata semanas después y meses más tarde el hosting caduca. La dirección devuelve un 404. El nombre sigue viéndose porque está sellado en la red, pero el logo y la descripción desaparecen, y como el permiso ya no existe, nadie puede apuntar el token a un archivo nuevo.

Bloquear o dejarlo abierto

En algún momento te dirán que bloquees la metadata. Bloquear significa entregar el permiso de edición para siempre, de modo que ya nadie pueda cambiar nada, tú incluido. A los compradores les gusta verlo y algunas listas de verificación para listados lo piden.

El orden es lo que decide. Primero mueves el archivo a Arweave o a IPFS con pinning, después apuntas la dirección de la red al enlace nuevo, luego compruebas desde dos equipos distintos durante unos días, y solo entonces bloqueas.

Al bloquear eliges hasta dónde. La herramienta para revocar el permiso de edición quita solo el derecho sobre nombre, símbolo y dirección. La herramienta de make immutable entrega de una vez los permisos de edición, emisión y congelación. Los tres están comparados uno al lado del otro en la guía para revocar las autoridades del token.

Como regla práctica: bloquea cuando la marca ya está asentada, cuando el token lleva medio año sin cambios de nombre a la vista, cuando el archivo ya vive en almacenamiento permanente o cuando un exchange lo pide expresamente. Espera mientras siga habiendo un rebrand posible, mientras el archivo dependa de un hosting que puedes perder, o mientras una versión dos siga sobre la mesa. Es la única puerta de este proceso que abre en un solo sentido.

Por qué a veces el cambio no entra

Dos motivos cubren casi todos los casos. O el permiso de edición ya fue revocado, muchas veces durante la creación, y entonces el nombre, el símbolo y la dirección están sellados de forma definitiva. O la billetera conectada no es la que tiene el permiso.

El segundo caso parece un fallo de la herramienta y no lo es. Mira en el snapshot qué billetera tiene el permiso y conecta exactamente esa. Si el permiso se entregó de verdad, no hay vuelta atrás y el único camino es un token nuevo.

Hay un tercer caso que se le parece y es inofensivo: el cambio entró hace rato y la billetera sigue enseñando la imagen vieja. Las razones por las que un token se ve raro o no aparece están reunidas en no me aparece el token en Phantom. Y que la moneda salga en la búsqueda del explorador es otro trámite aparte, con sus propios requisitos, explicado en la guía de verificación de tokens de Solana.

Hay un detalle que se cae más que los otros: comprobar en qué formato estás mirando el archivo. Muchos equipos abren la dirección en el navegador, ven el JSON viejo guardado en caché por el propio navegador y concluyen que la subida falló. Ábrelo en una ventana privada o añade un parámetro cualquiera al final de la dirección y lo verás como lo ve una billetera nueva.

Los errores que más se repiten

• Editar el archivo y dar por hecho que el nombre también cambió. El logo está en el archivo, el nombre en la red. Revisa cada uno por su lado.
• Bloquear con el archivo en un hosting temporal. El error más caro de esta lista, y no tiene arreglo posible después.
• No esperar al caché. Entre diez y treinta minutos es normal. Antes de repetir la operación, lee el snapshot.
• Intentar renombrar desde el archivo. El campo de nombre del archivo lo ignoran las billeteras. Un cambio de nombre real siempre pasa por la herramienta.
• Firmar con la billetera equivocada. No cuesta comisión, pero cuesta unos minutos de confusión cada vez.

Preguntas frecuentes sobre la metadata

¿Se puede cambiar el nombre de un token después del lanzamiento?

Sí, siempre que el permiso de edición siga en una billetera. Compruébalo gratis con el snapshot y luego el cambio cuesta 0,2 SOL firmados por esa billetera.

¿Por qué mi token sigue mostrando el logo antiguo?

O editaste la capa equivocada, o la billetera aún guarda la imagen en caché. Vuelve a subir el logo a la misma dirección, lee el snapshot y espera el caché.

¿Cuánto cuesta actualizar la metadata?

Editar el archivo es gratis. Cambiar el nombre, el símbolo o la dirección cuesta 0,2 SOL más una pequeña comisión de red, y el importe aparece en la página antes de confirmar.

¿Conviene hacer el token inmutable?

Cuando la marca está asentada, el token tiene algo de historia y el archivo vive en almacenamiento permanente, sí. Mientras puedas cambiar de marca, espera.

¿Qué es la autoridad de actualización?

Es el permiso, en manos de una billetera concreta, para editar más adelante la metadata que está en la red. Si se entrega, el registro queda sellado para siempre.

¿Esto vale también para Token-2022?

Solo en parte. Token-2022 puede llevar la metadata dentro del propio token y sigue otro camino. Esta guía cubre el flujo clásico de SPL con Metaplex.

Antes de tocar nada

Actualizar es barato y repetible, así que el primer día no tiene por qué salir perfecto. Puedes corregir un nombre, cambiar un logo o mover enlaces las veces que haga falta. Lo único irreversible es bloquear: mueve el archivo a almacenamiento permanente, apunta la dirección, confirma que carga y solo entonces entrega el permiso.