Token URI: ¿Qué es una Token URI?Una Token URI es un enlace o identificador que apunta a los metadatos de un token de criptomonedas.En la mayoría de las conversaciones sobre cripto, Token URI se utiliza para losToken URI: ¿Qué es una Token URI?Una Token URI es un enlace o identificador que apunta a los metadatos de un token de criptomonedas.En la mayoría de las conversaciones sobre cripto, Token URI se utiliza para los
¿Qué es una Token URI?
Una Token URI es un enlace o identificador que apunta a los metadatos de un token de criptomonedas.En la mayoría de las conversaciones sobre cripto, Token URI se utiliza para los NFT, ya que estos suelen necesitar metadatos como un nombre, descripción, imagen, animación, atributos, rasgos y archivos externos.El estándar oficial de URI RFC 3986 define una URI como una secuencia compacta de caracteres que identifica un recurso abstracto o físico.
En los contratos de NFT, una Token URI suele identificar el recurso de metadatos vinculado a un ID de token específico.El estándar oficial ERC-721 define una función de metadatos opcional llamada
tokenURI(uint256 tokenId)
, que puede devolver una URI distinta para un token no fungible específico.Una Token URI puede apuntar a metadatos almacenados en IPFS, Arweave, un servidor web convencional o directamente dentro del contrato inteligente mediante una data URI.Una Token URI normalmente no almacena la obra de arte en sí en la blockchain.En su lugar, suele indicar a las wallets, los marketplaces, los exploradores y las aplicaciones descentralizadas dónde encontrar el archivo de metadatos que describe el token.Por eso, una Token URI es uno de los detalles técnicos más importantes para la visualización de NFT.En un glosario cripto, Token URI debe entenderse como el puntero de metadatos que conecta un ID de token on-chain con la información off-chain u on-chain que los usuarios ven realmente.Por qué las Token URI son importantes en cripto
Las Token URI son importantes porque las blockchains están optimizadas para la propiedad, las transferencias y la verificación, no para almacenar archivos multimedia grandes a bajo coste.Un NFT puede representar arte digital, música, equipamiento de juego, un pase de membresía, una identidad similar a un dominio, una entrada, una credencial o un registro de activos del mundo real.La blockchain puede registrar quién posee el token, pero los usuarios siguen necesitando una forma de ver qué representa.La Token URI proporciona esa conexión.Sin una Token URI funcional, un NFT puede aparecer como un elemento vacío, una imagen rota o solo como una dirección de contrato y un ID de token.Para los coleccionistas, la calidad de la Token URI puede afectar a la confianza, al valor de reventa y a la confianza a largo plazo.Para los desarrolladores, el diseño de la Token URI afecta a la compatibilidad con wallets, la visualización en marketplaces, las actualizaciones de metadatos, los mecanismos de revelación y la experiencia de usuario.Para los traders, la estructura de la Token URI puede revelar si los metadatos son permanentes, modificables, centralizados o controlados por un administrador.En los proyectos de gaming y de activos del mundo real, el diseño de la Token URI puede determinar si los datos dinámicos de los elementos o las referencias documentales siguen siendo precisos.Por tanto, una Token URI no es solo un enlace técnico, ya que determina cómo entienden los usuarios el token.Cómo funciona una Token URI
Una Token URI suele funcionar mediante una función de contrato inteligente que acepta un ID de token y devuelve una cadena URI.Para un NFT ERC-721, una wallet o dApp puede llamar a
tokenURI(tokenId)
para preguntar al contrato dónde se encuentran los metadatos.El contrato devuelve una cadena como
ipfs://bafy.../1.json
, https://example.com/metadata/1
o data:application/json;base64,...
.Después, la wallet o dApp obtiene o descodifica los metadatos.Los metadatos suelen estar en formato JSON y contienen campos como
name
, description
, image
y attributes
.Si los metadatos incluyen un campo de imagen, la wallet obtiene esa imagen y la muestra al usuario.Si los metadatos incluyen rasgos, el marketplace o la aplicación puede mostrar detalles de rareza, estadísticas del juego o filtros por categoría.Este proceso puede realizarse mediante una llamada directa al contrato, un indexador, una API, una caché o un servicio de metadatos de wallet.Normalmente, el usuario solo ve la imagen y los detalles finales, no todo el proceso de resolución.Sin embargo, comprender la Token URI ayuda a los usuarios a evaluar si los metadatos del NFT son fiables.Token URI en ERC-721
ERC-721 es el principal estándar de tokens para NFT únicos en redes compatibles con Ethereum.La extensión de metadatos ERC-721 incluye
name()
, symbol()
y tokenURI(uint256 tokenId)
.La función
tokenURI
es opcional en el estándar, pero se utiliza ampliamente porque los usuarios esperan que los NFT muestren metadatos.Un proyecto ERC-721 básico puede almacenar una URI base y combinarla con un ID de token.Por ejemplo, el contrato puede combinar
ipfs://CID/
con 1
para formar ipfs://CID/1
.La documentación oficial de OpenZeppelin ERC-721 explica que se puede utilizar una URI base para calcular
ERC721.tokenURI
, y que la URI resultante puede ser la URI base más el ID de token.Otros proyectos pueden almacenar una URI diferente para cada ID de token.Algunos proyectos pueden generar todos los metadatos directamente on-chain.Algunos proyectos pueden apuntar a un servidor que crea metadatos dinámicos bajo demanda.Dado que los proyectos ERC-721 pueden implementar los metadatos de distintas formas, los usuarios deben comprobar cómo gestiona una colección específica su Token URI.Token URI en ERC-1155
ERC-1155 es un estándar multítoken que puede gestionar tokens fungibles, tokens semifungibles y NFT dentro de un mismo contrato.El estándar oficial ERC-1155 define un patrón de URI de metadatos en el que una cadena URI puede incluir el marcador de posición
{id}
.Los clientes sustituyen
{id}
por el ID de token real en el formato hexadecimal requerido.Esto significa que una plantilla de URI puede admitir muchos ID de token.Por ejemplo, un contrato ERC-1155 puede devolver
ipfs://CID/{id}.json
.La wallet o dApp debe sustituir
{id}
por el ID de token correcto antes de obtener los metadatos.Este enfoque puede resultar eficiente para activos de juego, ediciones, entradas, membresías y colecciones con muchos tipos de token.También crea una fuente habitual de errores de visualización cuando un cliente gestiona incorrectamente la sustitución del ID de token.La documentación de OpenZeppelin sobre la URI de metadatos ERC-1155 explica que la extensión de URI de metadatos puede apuntar cada token a un archivo JSON que sigue el esquema de metadatos ERC-1155.
Un usuario que vea metadatos ERC-1155 rotos debería considerar si el problema procede del contrato, la capa de almacenamiento, el cliente o el proceso de sustitución.Token URI frente a metadatos
Una Token URI no es lo mismo que los metadatos.La Token URI es el puntero.Los metadatos son la información que se encuentra en ese puntero.Por ejemplo,
ipfs://CID/42.json
es una Token URI.El archivo JSON que se encuentra en esa URI son los metadatos.Los metadatos pueden incluir el nombre del token, descripción, enlace de imagen, enlace de animación, atributos, color de fondo, página externa, información sobre licencias u otros campos.Si cambia la Token URI, puede cambiar la ubicación de los metadatos.Si cambia el archivo de metadatos, el token puede mostrar contenido diferente aunque la Token URI siga siendo la misma.Esta diferencia es importante porque algunos proyectos afirman que los metadatos son fijos cuando solo es fijo el formato de la Token URI.Los usuarios deben comprobar tanto la Token URI como el contenido que devuelve.Token URI frente a Image URI
Una Token URI tampoco es lo mismo que una URI de imagen.La Token URI suele apuntar a un archivo JSON de metadatos.El archivo JSON de metadatos puede incluir después un campo
image
que apunta a la obra de arte o archivo multimedia real.Por ejemplo,
tokenURI
puede devolver ipfs://CID/1.json
.Dentro de
1.json
, el campo image
puede apuntar a ipfs://AnotherCID/1.png
.Esto crea dos capas de fiabilidad.El archivo de metadatos debe seguir disponible.La imagen o el archivo multimedia referenciado dentro de los metadatos también debe seguir disponible.Un token puede cargar correctamente sus metadatos y, aun así, mostrar una imagen rota si falla la URI de imagen.Una buena diligencia debida sobre NFT comprueba ambas capas.Formatos habituales de Token URI
Los formatos de Token URI más habituales son
ipfs://
, https://
, ar://
y data:
.Una Token URI
ipfs://
apunta a contenido direccionado por IPFS.Una Token URI
https://
apunta a un servidor web convencional o a un endpoint de API.Una Token URI
ar://
puede apuntar a datos alojados en Arweave.Una Token URI
data:
contiene los metadatos directamente dentro de la URI.Cada formato presenta diferentes ventajas e inconvenientes en cuanto a permanencia, coste, comodidad, capacidad de modificación y compatibilidad.Los metadatos HTTP son fáciles de crear y actualizar, pero pueden ser centralizados y frágiles.Los metadatos IPFS pueden mejorar la integridad del contenido, pero el contenido debe seguir anclado y ser recuperable.Las data URI pueden admitir metadatos totalmente on-chain, pero pueden ser más grandes y difíciles de implementar.El formato de la Token URI dice mucho a los usuarios sobre cómo entiende el proyecto la durabilidad y el control.Token URI e IPFS
IPFS es una de las opciones de almacenamiento más comunes para los metadatos de NFT.La documentación de direccionamiento de contenido de IPFS explica que IPFS utiliza Content Identifiers, o CID, para gestionar datos direccionados por contenido.
El direccionamiento por contenido significa que el identificador está vinculado al contenido en sí, en lugar de estarlo únicamente a la ubicación de un servidor.Esto ayuda a los usuarios a verificar que los metadatos o el contenido multimedia no han cambiado silenciosamente bajo el mismo identificador.Una Token URI como
ipfs://bafy.../1.json
apunta al contenido mediante un CID.Las wallets y dApps suelen convertir los enlaces
ipfs://
en URL de gateway para que los navegadores puedan cargar el contenido.Esta conversión es solo un método de recuperación y no modifica el identificador de contenido IPFS subyacente.El contenido de IPFS debe seguir estando disponible desde nodos, servicios de pinning, gateways u otra infraestructura de almacenamiento.Si nadie almacena o sirve el contenido, el CID puede seguir siendo válido mientras los metadatos se vuelven difíciles de recuperar.Por este motivo, IPFS mejora la integridad, pero no garantiza automáticamente la disponibilidad para siempre.Token URI y enlaces HTTP
Muchos proyectos NFT utilizan Token URI
https://
porque son sencillas y conocidas.Un servidor puede generar metadatos rápidamente, actualizar archivos, controlar el momento de la revelación y admitir contenido dinámico.Esto resulta útil para juegos, pases de membresía, entradas para eventos en directo y proyectos que necesitan cambios de metadatos.La debilidad es que los enlaces web convencionales dependen de servidores, dominios, cuentas de alojamiento y las operaciones del proyecto.Si el servidor queda fuera de línea, el NFT puede dejar de mostrarse correctamente.Si el dominio caduca, otra persona podría controlar posteriormente el endpoint de metadatos.Si el proyecto modifica el JSON, los usuarios pueden ver imágenes o rasgos diferentes.Esto no significa que todas las Token URI HTTP sean malas.Significa que los usuarios deben saber si los metadatos están controlados por un servidor centralizado y si el proyecto tiene un plan de preservación a largo plazo.Para NFT de alto valor, la dependencia de un servidor debe formar parte de la revisión de riesgos.Token URI y data URI
Una data URI puede almacenar los metadatos directamente dentro de la cadena devuelta.Muchos NFT totalmente on-chain utilizan una Token URI
data:application/json;base64
.Esto significa que el contrato devuelve JSON codificado en lugar de un enlace a un archivo externo.El JSON puede incluir una imagen SVG integrada u otra referencia multimedia on-chain.Este enfoque puede reducir la dependencia del almacenamiento externo.También puede hacer que el contrato sea más caro y complejo.Las wallets y dApps deben descodificar correctamente la data URI para mostrar el token.Una data URI puede ser potente para arte generativo, tokens de identidad, insignias y contenido multimedia sencillo que puede crearse mediante código.Puede ser menos práctica para vídeos grandes, imágenes de alta resolución o archivos de juego complejos.Las data URI muestran que Token URI no siempre significa un enlace web convencional.Token URI y URI base
Una URI base es una ruta inicial compartida que se utiliza para crear enlaces de metadatos específicos para cada token.Por ejemplo, un contrato puede almacenar
ipfs://CID/
como su URI base.Cuando alguien llama a
tokenURI(10)
, el contrato puede devolver ipfs://CID/10
.Este patrón ahorra almacenamiento porque el contrato no necesita guardar una URI completa para cada token.La lógica de URI base es habitual en las colecciones ERC-721.También es común en proyectos basados en revelación, en los que la URI base puede cambiar de una ubicación provisional a una ubicación final de metadatos.El riesgo es que un administrador pueda cambiar la URI base después de la acuñación.Si la URI base puede modificarse, los usuarios deben saber quién controla ese permiso y si puede bloquearse o renunciarse a él.Una URI base fija puede favorecer la confianza, mientras que una URI base sin restricciones puede generar riesgo de cambios en los metadatos.Por tanto, el diseño de la URI base es una parte importante de la seguridad de los metadatos NFT.Token URI y revelaciones de NFT
Los mecanismos de revelación de NFT suelen depender de cambios en la Token URI.Antes de la revelación, todos los tokens pueden apuntar a los mismos metadatos provisionales.Después de la revelación, el contrato puede actualizar la URI base para que cada token apunte a su archivo final de metadatos.Esto genera una experiencia habitual en la que los compradores ven una imagen misteriosa antes de que aparezca la obra final.Los sistemas de revelación pueden ser legítimos cuando son transparentes y justos.También pueden crear problemas de confianza si el equipo del proyecto puede manipular los metadatos después de ver los resultados de la acuñación.Los usuarios deben preguntar si los metadatos se prepararon antes de la acuñación y si el proceso de revelación es verificable.Los desarrolladores deben utilizar eventos claros y documentación pública al actualizar metadatos.Una revelación no debe ser una oportunidad oculta para que los iniciados asignen rasgos raros de forma injusta.El comportamiento de la Token URI es fundamental para que una revelación de NFT parezca fiable.Token URI y actualizaciones de metadatos
Algunos NFT están diseñados para cambiar con el tiempo.Un elemento de juego puede subir de nivel.Un pase de membresía puede renovarse o caducar.Un token de activo del mundo real puede actualizar referencias documentales.Un token de arte dinámico puede cambiar según datos on-chain u off-chain.La extensión de actualización de metadatos ERC-4906 define eventos de actualización de metadatos que ayudan a las plataformas de terceros a saber cuándo han cambiado los metadatos de un token.
Esto es importante porque las wallets y los marketplaces suelen almacenar los metadatos en caché para ganar velocidad.Si los metadatos cambian sin una señal de actualización clara, los usuarios pueden seguir viendo información obsoleta.Las actualizaciones de metadatos son útiles cuando se esperan y están documentadas.Las actualizaciones de metadatos son arriesgadas cuando otorgan a un emisor un control ilimitado sobre lo que compraron los usuarios.Token URI y metadatos a nivel de contrato
La Token URI suele describir un ID de token específico.Los metadatos a nivel de contrato describen toda la colección o el contrato.El estándar de metadatos a nivel de contrato ERC-7572 estandariza
contractURI()
para información a nivel de colección, como el nombre, la descripción y la imagen.Esta distinción es importante porque una colección necesita metadatos tanto a nivel de token como a nivel de colección.La Token URI responde qué representa un token concreto.La URI de contrato responde qué representa toda la colección o el contrato.Una wallet puede utilizar la Token URI para mostrar la imagen específica del NFT.Un marketplace puede utilizar metadatos a nivel de contrato para mostrar el logotipo, el banner y la descripción de una colección.Ambas capas de metadatos deben ser precisas, duraderas y transparentes.Un diseño completo de metadatos NFT no debe centrarse únicamente en el archivo de token individual.Token URI y ERC-1046
Token URI no se limita a los NFT en todos los debates sobre estándares.La propuesta de interoperabilidad tokenURI ERC-1046 añade una función
tokenURI
a ERC-20 y amplía la interoperabilidad de los metadatos entre los tipos de token ERC-20, ERC-721 y ERC-1155.Esto es importante porque los tokens fungibles también pueden beneficiarse de metadatos más completos.Un token fungible puede necesitar un logotipo, descripción, sitio web del proyecto, información del emisor, documentación del activo o detalles de cumplimiento normativo.En la práctica, la compatibilidad con ERC-1046 puede variar entre wallets y aplicaciones.Aun así, la propuesta muestra que los metadatos de tokens son un tema de diseño más amplio que las obras de arte NFT.A medida que el ecosistema cripto incorpora más aplicaciones, los metadatos estandarizados pueden adquirir mayor importancia en muchos tipos de token.Los usuarios deben seguir verificando los contratos de token y las fuentes oficiales, en lugar de confiar únicamente en los campos de metadatos.Los metadatos pueden ayudar a mostrar información, pero no prueban la legitimidad por sí mismos.Una Token URI solo es útil cuando la información devuelta es precisa y fiable.Token URI y caché
El almacenamiento en caché consiste en guardar temporalmente los metadatos para que las aplicaciones carguen tokens más rápido.Las wallets, exploradores, marketplaces e indexadores suelen almacenar en caché los resultados de Token URI y los archivos de metadatos.Esto mejora el rendimiento porque obtener repetidamente miles de archivos de metadatos sería lento.El inconveniente es que los metadatos almacenados en caché pueden quedar obsoletos.Un token puede revelar una obra nueva, pero la wallet puede seguir mostrando la imagen provisional antigua.Un NFT dinámico puede actualizar sus rasgos, pero el marketplace puede seguir mostrando la versión anterior.Los eventos de actualización de metadatos y los botones de actualización pueden ayudar a resolver este problema.Los usuarios deben recordar que un problema de visualización puede deberse a la caché y no al contrato NFT en sí.Los desarrolladores deben utilizar estructuras de metadatos predecibles y eventos de actualización estándar para facilitar el almacenamiento en caché.Un buen diseño de Token URI reduce confusiones innecesarias sobre los metadatos.Token URI y mutabilidad
La mutabilidad significa que la Token URI o los metadatos a los que apunta pueden cambiar.Cierta mutabilidad resulta útil para NFT dinámicos, juegos, entradas, credenciales y membresías evolutivas.Otra mutabilidad genera riesgo porque el emisor puede tener la capacidad de cambiar la obra de arte o los rasgos después de que los usuarios compren el token.Una Token URI puede ser inmutable mientras que el servidor de metadatos es modificable.Una Token URI también puede ser modificable si el propietario del contrato inteligente puede cambiar la URI base.Un proyecto puede congelar los metadatos bloqueando la URI base, anclando el contenido final de IPFS o eliminando los poderes administrativos de actualización.Los usuarios deben preguntar si los metadatos están congelados, son dinámicos, están controlados por un administrador o son completamente on-chain.Los desarrolladores deben explicar claramente la mutabilidad antes de la acuñación.La mutabilidad oculta puede perjudicar la confianza y reducir la confianza del mercado.La mutabilidad prevista puede generar experiencias de token útiles y atractivas.Token URI y riesgos de seguridad
Las Token URI pueden generar riesgos de seguridad porque las wallets y dApps obtienen y muestran contenido externo.Los metadatos maliciosos pueden incluir enlaces de phishing, mensajes de recompensa falsos, imágenes engañosas o URL externas inseguras.Un NFT de spam puede aparecer en una wallet y utilizar sus metadatos para indicar al usuario que visite una página falsa de reclamación.Una colección falsa puede copiar nombres e imágenes de una colección real.Un servidor comprometido puede modificar los metadatos para dirigir a los usuarios a un sitio web malicioso.Las wallets y dApps deben tratar los metadatos como una entrada no fiable.Los usuarios no deben hacer clic en enlaces incluidos en metadatos NFT desconocidos.Los usuarios nunca deben introducir frases de recuperación, claves privadas o copias de seguridad de wallets porque una imagen o descripción NFT se lo indique.Una Token URI ayuda a mostrar datos, pero también puede mostrar datos controlados por atacantes.Un comportamiento cripto seguro exige escepticismo ante tokens no solicitados y metadatos sospechosos.Token URI y permanencia de los NFT
La permanencia de un NFT depende en parte del diseño de su Token URI.Un token puede permanecer on-chain mientras desaparecen sus metadatos.Si una Token URI apunta a un servidor inactivo, el NFT puede dejar de mostrarse correctamente.Si una Token URI apunta a contenido IPFS que no está anclado, los metadatos pueden resultar difíciles de recuperar.Si una Token URI apunta a datos on-chain, la permanencia puede ser mayor, pero el coste y la flexibilidad pueden ser limitados.Los coleccionistas deben entenderlo antes de comprar NFT de alto valor.Los desarrolladores deben diseñar el almacenamiento de metadatos para la vida útil prevista del activo.Los proyectos deben explicar si los metadatos son permanentes, modificables, descentralizados, centralizados o dependen de un servidor de empresa.Un NFT no es automáticamente permanente solo porque la propiedad esté registrada en una blockchain.La Token URI y el plan de almacenamiento determinan si el token sigue siendo útil visual e informativamente.Token URI y tokens de activos del mundo real
Los tokens de activos del mundo real pueden utilizar Token URI para hacer referencia a documentos, certificados, imágenes, auditorías, tasaciones, condiciones legales o registros de verificación.Esto puede hacer que el diseño de la Token URI sea más sensible que los metadatos habituales de coleccionables.Una Token URI de un activo del mundo real puede necesitar control de versiones, restricciones de acceso, hashes de documentos, datos del emisor y contexto legal claro.Una Token URI rota u obsoleta puede inducir a error a los usuarios sobre el activo representado.Una Token URI por sí sola no prueba la propiedad legal de un activo físico.El acuerdo legal, el emisor, el custodio, la jurisdicción, el proceso de reembolso y la documentación siguen siendo importantes.Los usuarios deben leer los documentos oficiales del activo y no confiar únicamente en los metadatos mostrados en una wallet.Los desarrolladores deben evitar mezclar de forma confusa imágenes de marketing con registros legalmente importantes.En el caso de los activos del mundo real, la calidad de la Token URI forma parte de la calidad de la información divulgada.Los metadatos deben facilitar la verificación, no sustituir la diligencia debida legal.Token URI y activos de gaming
Los activos de juego suelen utilizar Token URI para describir objetos, personajes, skins, terrenos, armas, insignias y logros.Un NFT de juego puede necesitar metadatos dinámicos porque las estadísticas de los objetos pueden cambiar durante la partida.Una espada puede subir de nivel.Un personaje puede obtener nuevos rasgos.Un terreno puede mostrar edificios mejorados.Una Token URI puede devolver metadatos que reflejen estos cambios.Esto hace que los activos de juegos blockchain sean más interactivos.También significa que el servidor del juego o el motor de metadatos pueden pasar a ser importantes para la utilidad del activo.Si el juego cierra, algunos metadatos dinámicos pueden dejar de actualizarse.Los usuarios deben entender qué partes de un activo de juego están realmente on-chain y cuáles dependen del operador del juego.Cómo comprobar una Token URI
Los usuarios pueden comprobar una Token URI viendo el contrato del token en un explorador de blockchain y consultando la función
tokenURI
cuando esté disponible.También pueden utilizar herramientas de desarrollador, vistas de metadatos de wallets, herramientas de análisis NFT o llamadas directas al contrato.Para los tokens ERC-1155, los usuarios deben recordar que la URI puede incluir un marcador de posición
{id}
.Después de encontrar la URI, los usuarios pueden comprobar si utiliza IPFS, HTTP, Arweave o una data URI.Si la URI apunta a JSON, los usuarios pueden abrir u obtener el JSON mediante un visor seguro.Deben comprobar si los campos de imagen y atributos apuntan a ubicaciones fiables.Deben comparar la dirección del contrato con la dirección oficial del proyecto.Deben tener cuidado de no interactuar con enlaces sospechosos que aparezcan dentro de los metadatos.Comprobar una Token URI es útil para la diligencia debida, pero los usuarios deben evitar sitios web inseguros y herramientas no fiables.En caso de duda, utiliza herramientas de solo lectura y no firmes transacciones solo para ver metadatos.Problemas habituales de Token URI
El primer problema habitual es una Token URI ausente o vacía.El segundo problema habitual son los metadatos JSON no válidos.El tercer problema habitual es un enlace de imagen roto dentro de los metadatos.El cuarto problema habitual es un CID de IPFS que no está disponible desde ningún gateway.El quinto problema habitual es un servidor centralizado que queda fuera de línea.El sexto problema habitual son los metadatos obsoletos almacenados en caché después de una revelación.El séptimo problema habitual es un marcador de posición
{id}
de ERC-1155 gestionado incorrectamente.El octavo problema habitual son los metadatos que cambian sin aviso.El noveno problema habitual es una Token URI controlada por una clave de administrador sin límites claros.El décimo problema habitual son los metadatos maliciosos diseñados para engañar a los usuarios y hacerles visitar sitios de phishing.Buenas prácticas para desarrolladores
Utiliza funciones de metadatos estándar al crear tokens ERC-721 o ERC-1155.Devuelve cadenas URI válidas que las wallets y aplicaciones puedan resolver de forma fiable.Utiliza metadatos JSON claros que cumplan las expectativas habituales de marketplaces y wallets.Prioriza un almacenamiento duradero para los activos a largo plazo.Utiliza almacenamiento direccionado por contenido cuando la integridad de los metadatos sea importante.Ancla los metadatos y archivos multimedia de IPFS en lugar de asumir que el contenido seguirá disponible automáticamente.Documenta si los metadatos son modificables, están congelados, son dinámicos o están controlados por un administrador.Emite eventos de actualización de metadatos estándar cuando cambien los metadatos.Prueba el comportamiento de Token URI en varias wallets, exploradores y dApps antes de la acuñación pública.No dependas de controles de metadatos ocultos que los usuarios no puedan comprender o auditar.Buenas prácticas para usuarios
Comprueba la Token URI antes de comprar NFT caros.Verifica si los metadatos se almacenan en IPFS, Arweave, HTTP o datos on-chain.Revisa si el proyecto puede cambiar la URI base o los metadatos después de la acuñación.Actúa con cautela con los NFT que dependen únicamente de un servidor centralizado.No hagas clic en enlaces sospechosos incluidos en los metadatos NFT.No firmes transacciones solo porque una página de metadatos indique que hay una recompensa disponible.Comprueba si la dirección del contrato de token coincide con fuentes oficiales del proyecto.Utiliza pequeñas transacciones de prueba al interactuar con contratos o herramientas NFT desconocidos.Entiende que una imagen de token en una wallet no prueba que la colección sea oficial.Considera la revisión de la Token URI como parte de la diligencia debida de NFT.Preguntas frecuentes
¿Qué significa Token URI?
Token URI se refiere a la URI que apunta a los metadatos de un token de criptomonedas, especialmente un NFT.¿Qué hace tokenURI?
La función
tokenURI
suele devolver la URI de metadatos de un ID de token ERC-721 específico.¿Token URI es lo mismo que los metadatos NFT?
No, la Token URI es el puntero, mientras que los metadatos son la información que se encuentra en ese puntero.¿Token URI es lo mismo que la imagen NFT?
No, la Token URI suele apuntar a un archivo JSON de metadatos, y ese archivo JSON puede contener una URI de imagen independiente.¿Qué es una Token URI ERC-721?
Una Token URI ERC-721 es una URI devuelta por
tokenURI(tokenId)
para un NFT único.¿Qué es una Token URI ERC-1155?
Una Token URI ERC-1155 es una URI de metadatos que puede utilizar un marcador de posición
{id}
para distintos ID de token.¿Qué significa una Token URI de IPFS?
Una Token URI de IPFS significa que se hace referencia a los metadatos mediante un identificador de contenido IPFS.¿Puede cambiar una Token URI?
Sí, una Token URI puede cambiar si el contrato permite actualizaciones de metadatos, cambios de URI base, metadatos dinámicos o respuestas controladas por servidor.¿Pueden cambiar los metadatos NFT sin que cambie la Token URI?
Sí, los metadatos pueden cambiar si la Token URI apunta a un servidor modificable o a un archivo que puede sustituirse en la misma ubicación web.¿Es más segura una Token URI on-chain?
Una Token URI on-chain puede reducir la dependencia del almacenamiento externo, pero puede ser más cara y seguir requiriendo un diseño de contrato cuidadoso.¿Por qué no se muestran los metadatos de mi NFT?
Los metadatos pueden no mostrarse porque falta la Token URI, el JSON no es válido, el almacenamiento no está disponible, el enlace de imagen está roto o la caché de la aplicación está obsoleta.¿Qué es una URI base?
Una URI base es un prefijo compartido que un contrato de token puede combinar con ID de token para crear Token URI completas.¿Qué es una revelación en el diseño de Token URI?
Una revelación es una actualización de metadatos en la que las Token URI provisionales se sustituyen o redirigen a los metadatos finales del token.¿Pueden ser maliciosos los metadatos de una Token URI?
Sí, los metadatos pueden incluir enlaces de phishing, descripciones engañosas, mensajes de recompensa falsos o referencias externas inseguras.¿Qué deben comprobar los usuarios antes de confiar en una Token URI?
Los usuarios deben comprobar el tipo de almacenamiento, los permisos del contrato, la dirección oficial del contrato, la disponibilidad de metadatos, el enlace de imagen, las reglas de mutabilidad y los enlaces externos sospechosos.Conclusión
Una Token URI es el puntero de metadatos que conecta un token de blockchain con la información que los usuarios ven en wallets, exploradores, marketplaces y dApps.En los NFT ERC-721, suele devolverse mediante
tokenURI(tokenId)
.En los tokens ERC-1155, puede devolverse mediante una plantilla URI que utiliza el marcador de posición
{id}
.Una Token URI puede apuntar a IPFS, Arweave, servidores HTTPS o datos almacenados directamente dentro del contrato inteligente.Cada formato presenta diferentes ventajas e inconvenientes en cuanto a permanencia, flexibilidad, coste, compatibilidad y confianza.El diseño de Token URI afecta a si los NFT se muestran correctamente, si los metadatos pueden cambiar, si las imágenes siguen disponibles y si los usuarios pueden verificar qué poseen.Los desarrolladores deben utilizar funciones estándar, metadatos válidos, almacenamiento duradero, eventos de actualización claros y reglas de mutabilidad transparentes.Los usuarios deben comprobar la estructura de la Token URI antes de confiar en NFT caros, activos dinámicos, elementos de juego o tokens de activos del mundo real.También deben evitar enlaces de metadatos sospechosos y recordar que la visualización en una wallet no prueba la autenticidad.Token URI es una de las bases técnicas ocultas del valor y la utilidad de los NFT.En un glosario cripto, Token URI debe entenderse como la URI devuelta o utilizada por un contrato de token para identificar el recurso de metadatos que describe un token específico.También te puede interesar
WhatsMiner M30S++
¿Qué es WhatsMiner M30S++? WhatsMiner M30S++ es un minero ASIC de Bitcoin de MicroBT diseñado para la minería Proof of Work con SHA-256. Forma parte de la serie WhatsMiner M30 y se utiliza principalme
2026/10/15 11:08
Dominios Web3
¿Qué son los dominios Web3? Los dominios Web3 son nombres basados en blockchain que pueden sustituir direcciones largas de carteras, dirigir a contenido descentralizado, representar una identidad on-c
2026/10/15 11:08
Proyectos Web3
¿Qué son los proyectos Web3? Los proyectos Web3 son aplicaciones, protocolos, herramientas, redes y comunidades basados en blockchain que utilizan tecnología descentralizada para dar a los usuarios ma
2026/10/15 11:06
POPULAR
Criptomonedas de moda que están acaparando la atención del mercado
Volumen TOP
Las criptomonedas con mayor volumen de trading
Recién Añadidos
Criptomonedas recientemente listadas y disponibles para operar