Token URI Resolver

¿Qué es un Token URI Resolver?

Un Token URI Resolver es un sistema que encuentra, construye, transforma o devuelve la URI de metadatos de un token cripto.

En la mayoría de contextos cripto, el término se utiliza para NFT, ya que los metadatos de los NFT suelen estar fuera del contrato del token y se accede a ellos mediante una URI devuelta por funciones como

o .

El estándar ERC-721 oficial define una extensión opcional de metadatos en la que

puede devolver una URI distinta para un token no fungible específico.

El estándar ERC-1155 oficial define un mecanismo de URI de metadatos en el que una sola URI puede incluir un marcador de posición

que los clientes sustituyen por el ID del token.

Un Token URI Resolver puede ser una función de contrato inteligente, un contrato resolver independiente, un servicio backend, un indexador, una función de cartera o una biblioteca frontend que convierte un ID de token en metadatos utilizables.

El resolver puede devolver una URL HTTP, una URI de IPFS, una URI de Arweave, una URI de datos u otra referencia de contenido compatible.

Una vez resuelta la URI, una cartera o dApp normalmente obtiene el JSON de metadatos y lee campos como nombre, descripción, imagen, animación, rasgos, atributos, licencia o enlaces externos.

En términos sencillos, un Token URI Resolver es el puente entre el token on-chain y la información del token legible para las personas.

Sin un resolver funcional, un NFT puede seguir existiendo on-chain, pero aparecer vacío, defectuoso, desactualizado o incompleto en carteras y aplicaciones.

En un glosario cripto, Token URI Resolver debe entenderse como la capa de búsqueda de metadatos que ayuda a las dApps a mostrar qué representa un token.

Por qué los Token URI Resolvers son importantes en cripto

Los Token URI Resolvers son importantes porque las blockchains son adecuadas para almacenar titularidad, pero resultan caras e ineficientes para guardar imágenes grandes, vídeos, archivos de juegos y objetos extensos de metadatos.

Muchos NFT almacenan únicamente la titularidad y un puntero on-chain, mientras que el contenido visible y la información descriptiva se guardan en otro lugar.

El resolver es la herramienta que convierte ese puntero en algo que los usuarios pueden ver y comprender.

Una cartera necesita metadatos para mostrar el nombre y la imagen de un token.

Un juego necesita metadatos para cargar personajes, armas, niveles o atributos de objetos.

Un marketplace necesita metadatos para mostrar detalles de la colección, rasgos de rareza, archivos multimedia e información de ventas.

Un protocolo de préstamo puede necesitar metadatos para comprender la categoría de activo, la calidad de la garantía o la identidad de la colección.

Un bridge puede necesitar metadatos para reflejar una representación de NFT en otra red.

Una aplicación con acceso restringido por token puede necesitar metadatos para verificar si una cartera posee el pase de acceso correcto.

Si el resolver devuelve metadatos erróneos, ausentes o mutables, los usuarios pueden tomar decisiones basadas en información deficiente.

Token URI Resolver y los metadatos de NFT

Los metadatos de NFT son la información estructurada que describe un token no fungible.

Los campos de metadatos habituales incluyen

, , , , y campos específicos del proyecto.

El contrato del token normalmente no almacena el JSON completo de metadatos de cada token porque puede resultar costoso.

En su lugar, el contrato devuelve una URI que apunta a metadatos almacenados en IPFS, Arweave, un servidor o directamente on-chain mediante una URI de datos.

Un Token URI Resolver ayuda a los clientes a determinar dónde están esos metadatos y cómo obtenerlos.

Para un NFT ERC-721, el resolver suele comenzar con la dirección del contrato y el ID del token, y después llama a

.

Para un token ERC-1155, el resolver suele llamar a

y aplica las reglas requeridas de sustitución del ID del token.

Para NFT dinámicos, el resolver puede calcular los metadatos a partir del estado on-chain en tiempo real o del progreso en el juego.

Para NFT totalmente on-chain, el resolver puede devolver directamente desde el contrato inteligente un objeto JSON codificado en base64.

El objetivo siempre es el mismo: convertir la identidad del token en metadatos visualizables.

Cómo funciona un Token URI Resolver

Un Token URI Resolver comienza con una dirección de contrato de token, un ID de token y un estándar de token conocido.

El resolver comprueba si el contrato admite una interfaz de metadatos como los metadatos ERC-721 o ERC-1155.

Si el token es ERC-721, el resolver llama a

.

Si el token es ERC-1155, el resolver llama a

.

Si el proyecto utiliza un contrato de metadatos independiente, el contrato del token puede reenviar la solicitud a otro contrato resolver.

Si la URI devuelta utiliza

, el resolver puede convertirla en una URL de gateway para obtener el contenido.

Si la URI devuelta utiliza

, el resolver puede descodificar directamente el JSON integrado.

Si la URI devuelta utiliza

, el resolver puede obtener la URL y analizar la respuesta JSON.

Si la URI presenta un formato incorrecto, falta, tiene limitación de solicitudes o no está disponible, el resolver puede devolver un error o mostrar metadatos de marcador de posición.

Un buen resolver debe gestionar múltiples formatos porque los proyectos NFT no implementan todos los metadatos de la misma manera.

Token URI Resolver en ERC-721

ERC-721 es el estándar más reconocido para tokens no fungibles en redes de estilo Ethereum.

La extensión de metadatos ERC-721 incluye

, y .

La función

es opcional en el estándar, pero se utiliza ampliamente porque las carteras y dApps necesitan metadatos para mostrar correctamente los NFT.

Una URI simple de token ERC-721 podría devolver

.

Otra URI de token ERC-721 podría devolver

.

Una URI ERC-721 totalmente on-chain podría devolver una URI de datos que contenga JSON y una imagen SVG.

La documentación de OpenZeppelin sobre ERC-721 explica ERC-721 como un estándar para tokens únicos, donde cada token puede representar un activo distinto.

Los desarrolladores suelen utilizar la lógica de URI base para crear una ruta completa de metadatos a partir de una base de nivel de colección y un ID de token.

Un resolver no debe asumir que todos los proyectos ERC-721 utilizan el mismo patrón de URI.

Algunos proyectos utilizan metadatos fijos, mientras que otros utilizan revelaciones aplazadas, estado dinámico o lógica personalizada.

Token URI Resolver en ERC-1155

ERC-1155 es un estándar multitenedor que puede representar tokens fungibles, tokens semifungibles y tokens no fungibles en un solo contrato.

Los metadatos ERC-1155 utilizan una función URI que puede incluir el marcador de posición

.

Un cliente que resuelve metadatos ERC-1155 sustituye

por el ID de token formateado conforme a las reglas del estándar.

Esto puede ser más eficiente que almacenar una URI independiente para cada ID de token.

Una URI simple de metadatos ERC-1155 podría tener este aspecto:

.

El Token URI Resolver debe sustituir correctamente el ID de token antes de obtener los metadatos.

Si el resolver no gestiona correctamente el marcador de posición

, es posible que los metadatos no se carguen.

ERC-1155 es habitual en juegos, coleccionables, membresías, vales y proyectos en los que muchos tipos de token comparten un contrato.

La documentación de OpenZeppelin sobre la URI de metadatos ERC-1155 explica que la extensión de URI de metadatos puede gestionar y almacenar URI para tokens individuales.

Un resolver sólido debe entender que la resolución de metadatos ERC-1155 es similar a ERC-721, pero no idéntica.

Token URI Resolver y ERC-1046

ERC-1046 es una propuesta de interoperabilidad tokenURI que amplía los conceptos de URI de metadatos a ERC-20, ERC-721 y ERC-1155.

La propuesta oficial de interoperabilidad tokenURI ERC-1046 indica que añade una función

a ERC-20 y amplía ERC-721 y ERC-1155 para mejorar la interoperabilidad de metadatos.

Esto es importante porque los metadatos de tokens no solo son útiles para los NFT.

Los tokens fungibles también pueden necesitar metadatos más completos, como logotipo, descripción, enlaces del proyecto, detalles de cumplimiento normativo o documentación de activos.

Un Token URI Resolver que comprenda ERC-1046 puede, en teoría, admitir metadatos más completos en diferentes tipos de tokens.

En la práctica, la compatibilidad puede variar entre carteras, dApps, contratos de tokens y herramientas de indexación.

Esto significa que los desarrolladores no deben asumir que todos los clientes leerán automáticamente los metadatos ERC-1046.

La propuesta sigue siendo útil porque muestra el objetivo más amplio de estandarizar más la información de los tokens y facilitar su resolución.

Para los lectores de este glosario, ERC-1046 ayuda a explicar por qué la resolución de URI de token va más allá de las imágenes NFT.

Forma parte del impulso más amplio hacia una información de tokens interoperable.

Token URI Resolver e IPFS

IPFS se utiliza habitualmente para metadatos de NFT porque usa direccionamiento por contenido en lugar del direccionamiento habitual basado en ubicación.

La documentación de IPFS sobre direccionamiento por contenido explica que un identificador de contenido, o CID, apunta al material según el propio contenido, en lugar de una ubicación de servidor tradicional.

Esto es útil para los NFT porque un CID puede ayudar a demostrar que los metadatos o archivos multimedia referenciados no han cambiado de forma inesperada.

Un Token URI Resolver puede recibir una URI

y convertirla en una URL de gateway que los clientes web habituales pueden cargar.

Por ejemplo, un resolver puede transformar

en una solicitud a un gateway que pueda obtenerse.

Esta conversión no modifica el identificador de contenido subyacente.

Solo proporciona al cliente una forma de recuperar el contenido a través de la web.

El contenido de IPFS aún debe estar disponible desde al menos un nodo o servicio de pinning.

Si nadie fija o sirve el contenido, el CID puede ser válido, pero difícil o imposible de recuperar.

Un buen resolver debe gestionar cuidadosamente los fallos de gateways de IPFS, las respuestas lentas y los gateways alternativos.

Token URI Resolver y Arweave

Arweave es otra opción de almacenamiento utilizada para metadatos y archivos multimedia de NFT.

Los proyectos pueden elegir Arweave porque está diseñado en torno al almacenamiento de datos a largo plazo.

Un Token URI Resolver puede necesitar admitir ID de transacción de Arweave o URL de gateways de Arweave.

El resolver debe identificar si una URI apunta a Arweave, IPFS, HTTP o una URI de datos.

Cada tipo de almacenamiento tiene distintos supuestos de disponibilidad y permanencia.

Los desarrolladores deben evitar ocultar las decisiones de almacenamiento a los usuarios, ya que el almacenamiento afecta al valor a largo plazo de los NFT y a la calidad de visualización.

Un token cuya imagen depende de un servidor frágil puede ser menos duradero que un token cuyos metadatos están direccionados por contenido o almacenados permanentemente.

Sin embargo, ningún método de almacenamiento debe tratarse como perfecto sin comprobar cómo se preserva, fija, paga o replica el contenido.

Un resolver puede obtener metadatos, pero no puede garantizar que el plan de almacenamiento sea económica o técnicamente sostenible.

La durabilidad del almacenamiento es una cuestión de diseño independiente de la resolución de URI.

Token URI Resolver y metadatos HTTP

Algunos proyectos de tokens utilizan URL HTTP o HTTPS habituales para los metadatos.

Esto es sencillo para los desarrolladores porque los servidores web estándar pueden devolver JSON rápidamente.

También es flexible porque el proyecto puede actualizar metadatos, corregir errores o revelar contenido posteriormente.

La desventaja es que los metadatos HTTP pueden estar centralizados y ser mutables.

Si el servidor deja de estar disponible, los metadatos del token pueden desaparecer de las pantallas de las carteras.

Si el propietario del servidor cambia el JSON, la imagen o los rasgos del NFT pueden cambiar.

Si caduca un dominio, atacantes o partes no relacionadas podrían controlar posteriormente el endpoint de metadatos.

Un Token URI Resolver puede obtener metadatos HTTP, pero no debe asumir que son permanentes.

Los usuarios deben comprender si los metadatos de un proyecto están centralizados, son mutables, están congelados, fijados o direccionados por contenido.

Para NFT de alto valor, la durabilidad de los metadatos es un aspecto importante de la diligencia debida.

Token URI Resolver y URI de datos

Una URI de datos almacena los metadatos directamente dentro de la cadena de URI.

Para los NFT, las URI de datos suelen contener JSON codificado en base64 devuelto por el contrato inteligente.

Este enfoque puede admitir metadatos totalmente on-chain porque el propio contrato devuelve los datos que necesitan los clientes.

Un Token URI Resolver que detecte

debe descodificar los datos en lugar de intentar obtenerlos de la web.

Las URI de datos on-chain pueden mejorar la permanencia porque los metadatos están vinculados directamente al estado de la blockchain.

También pueden ser caras o limitadas porque el almacenamiento y los cálculos on-chain consumen gas.

Los proyectos que utilizan SVG on-chain suelen combinar URI de datos con lógica de arte generativo.

Esto permite construir la imagen NFT a partir de código y estado del token, en lugar de archivos alojados.

Un resolver debe gestionar cuidadosamente JSON codificado, caracteres escapados, cargas base64 y datos de imagen anidados.

Si el resolver no descodifica correctamente las URI de datos, los NFT totalmente on-chain pueden aparecer defectuosos aunque el contrato funcione adecuadamente.

Token URI Resolver y NFT dinámicos

Los NFT dinámicos son tokens cuyos metadatos pueden cambiar según el tiempo, el estado del juego, las acciones de los usuarios, los datos de oráculos, las decisiones de gobernanza o el estado del contrato.

Un Token URI Resolver dinámico puede calcular metadatos en lugar de devolver una ruta de archivo fija.

Por ejemplo, el NFT de un personaje de juego puede cambiar de nivel, apariencia o atributos tras la actividad dentro del juego.

Un NFT de membresía puede cambiar de estado cuando un usuario renueva el acceso.

Un NFT de activo del mundo real puede actualizar referencias documentales o el estado de verificación.

Un NFT generativo puede cambiar según datos de bloques u otras condiciones on-chain.

Los metadatos dinámicos pueden crear experiencias de usuario más completas.

También pueden crear problemas de confianza si el emisor puede modificar los metadatos sin límites claros.

Los usuarios deben saber si los metadatos son inmutables, están controlados por el propietario, por un administrador, por la gobernanza o se generan algorítmicamente.

Un resolver debe hacer que el comportamiento dinámico sea predecible y transparente, no misterioso.

Token URI Resolver y actualizaciones de metadatos

Los cambios de metadatos son habituales en proyectos NFT, especialmente durante eventos de revelación, progresión de juegos, actualizaciones y correcciones de errores.

La extensión de actualización de metadatos ERC-4906 añade eventos como

para que los clientes sepan cuándo han cambiado los metadatos de NFT.

Esto es importante porque las dApps y los indexadores suelen almacenar metadatos en caché para evitar obtener repetidamente los mismos archivos.

Si los metadatos cambian, pero los clientes no saben que deben actualizarlos, los usuarios pueden ver imágenes o rasgos desactualizados.

Un Token URI Resolver puede escuchar eventos de actualización de metadatos y activar una actualización.

Para actualizaciones de toda la colección, un resolver puede tener que actualizar muchos ID de token a la vez.

Para actualizaciones de un solo token, un resolver puede actualizar únicamente el token afectado.

Una buena gestión de actualizaciones de metadatos ayuda a las carteras y aplicaciones a mostrar información precisa de los tokens.

Una gestión deficiente de las actualizaciones puede generar confusión durante revelaciones y actualizaciones.

Los estándares de actualización de metadatos facilitan coordinar el comportamiento de los resolvers en todo el ecosistema.

Token URI Resolver y metadatos a nivel de contrato

Los metadatos de token describen un token concreto, mientras que los metadatos a nivel de contrato describen la colección o el contrato de token en su conjunto.

El estándar de metadatos a nivel de contrato ERC-7572 oficial estandariza

para información completa a nivel de contrato, como nombre, descripción e imagen.

Un Token URI Resolver puede trabajar junto a un resolver de URI de contrato porque muchas aplicaciones necesitan metadatos tanto a nivel de token como de colección.

Los metadatos a nivel de token responden qué es un token específico.

Los metadatos a nivel de contrato responden qué es la colección o contrato más amplio.

Por ejemplo, una colección NFT puede tener un logotipo y una descripción a nivel de contrato, mientras que cada token tiene su propio arte y rasgos.

ERC-7572 también introduce un evento de actualización para cambios de metadatos del contrato.

Esto ayuda a las dApps a saber cuándo debe actualizarse la información de la colección.

Un sistema de metadatos completo debe admitir la resolución tanto a nivel de token como de contrato.

Esto hace que la visualización de tokens sea más coherente entre carteras, exploradores y aplicaciones Web3.

Token URI Resolver de contrato inteligente

Un Token URI Resolver de contrato inteligente es un contrato on-chain que devuelve o construye URI de metadatos.

Algunos proyectos NFT mantienen la lógica de titularidad de tokens en un contrato y la lógica de resolución de metadatos en otro.

Esta separación puede facilitar la actualización, personalización o compartición de metadatos entre varios contratos de tokens.

Por ejemplo, un contrato de token puede llamar a un contrato resolver externo cada vez que se solicita

.

El resolver puede entonces construir una URI a partir del ID del token, el estado del token, los ajustes de la colección o datos on-chain.

Este patrón puede resultar útil para proyectos que desean metadatos dinámicos sin incorporar toda la lógica en el contrato NFT principal.

También puede crear riesgos de actualización y confianza si el propietario del resolver puede modificar los resultados sin el consentimiento de los usuarios.

Los usuarios deben comprobar si el resolver es inmutable, actualizable, está controlado por un administrador o gobernado por una DAO.

Los desarrolladores deben emitir eventos claros cuando cambien las direcciones de los resolvers.

Un contrato resolver puede añadir flexibilidad, pero esta debe equilibrarse con la transparencia.

Token URI Resolver backend

Un Token URI Resolver backend es un sistema del lado del servidor que recibe una solicitud y devuelve JSON de metadatos.

Esto es habitual cuando los metadatos dependen de bases de datos off-chain, cuentas de usuario, servidores de juegos, motores de renderizado o registros de cumplimiento normativo.

Un resolver backend puede ser rápido y flexible.

Puede admitir generación de imágenes, atributos basados en API, localización de idiomas, controles de acceso y procesamiento multimedia complejo.

El riesgo es que los usuarios deben confiar en que el operador backend mantenga el servicio en línea y no modifique injustamente los metadatos.

Si el backend desaparece, el token puede perder sus metadatos visibles.

Si el backend modifica registros, la apariencia o los atributos del token pueden cambiar de forma inesperada.

Los proyectos que utilizan resolvers backend deben explicar claramente qué es mutable y qué es permanente.

También deben considerar fijar los metadatos finales en almacenamiento descentralizado cuando sea posible.

Un resolver backend es práctico, pero no debe confundirse con metadatos on-chain inmutables.

Token URI Resolver frontend

Un Token URI Resolver frontend es código dentro de la interfaz de una cartera, dApp, explorador o marketplace que obtiene e interpreta metadatos.

Los resolvers frontend deben gestionar muchos casos límite reales porque los contratos de tokens suelen comportarse de manera diferente.

Algunos contratos devuelven URI de IPFS.

Algunos contratos devuelven URL de gateways.

Algunos contratos devuelven URI de datos base64.

Algunos contratos devuelven enlaces rotos.

Algunos contratos utilizan el formato de ID de token en minúsculas.

Algunos contratos utilizan campos JSON no estándar.

Algunos contratos devuelven metadatos únicamente después de un evento de revelación.

Un resolver frontend sólido utiliza alternativas, validación, caché y análisis seguro.

Esto mejora la experiencia de usuario porque los tokens se muestran correctamente en más colecciones y cadenas.

Token URI Resolver y caché

El almacenamiento en caché consiste en guardar temporalmente metadatos para poder cargarlos más rápido después.

Las carteras, dApps, exploradores e indexadores suelen almacenar metadatos NFT en caché porque obtener repetidamente cada URI de token sería lento y costoso.

La caché mejora el rendimiento, pero puede crear datos obsoletos.

Si los metadatos cambian después de una revelación, los usuarios pueden seguir viendo la imagen de marcador de posición antigua hasta que se actualice la caché.

Si un resolver almacena una solicitud fallida durante demasiado tiempo, un token puede parecer defectuoso incluso después de que los metadatos estén disponibles.

ERC-4906 puede ayudar porque los eventos de actualización de metadatos indican a los clientes cuándo deben actualizar los metadatos almacenados en caché.

Los resolvers también pueden utilizar cabeceras de control de caché, herramientas de actualización manual, reglas de reintento y suscripciones a actualizaciones de metadatos.

Una buena caché equilibra velocidad y precisión.

Una mala caché puede hacer que los usuarios crean que un token falta o es erróneo cuando el problema real son metadatos obsoletos.

Para los desarrolladores, la estrategia de caché forma parte de la fiabilidad de los metadatos.

Token URI Resolver y mecanismos de revelación

Muchos proyectos NFT utilizan revelaciones aplazadas.

Antes de la revelación, cada token puede devolver los mismos metadatos de marcador de posición.

Después de la revelación, cada token devuelve metadatos únicos con el arte y los rasgos finales.

Un Token URI Resolver puede cambiar de una URI de marcador de posición a una URI final cuando se llama a la función de revelación.

Esto puede hacerse cambiando una URI base, actualizando un contrato resolver, estableciendo URI por token o cambiando una marca de metadatos.

Los mecanismos de revelación plantean cuestiones de confianza porque el proyecto puede controlar cuándo y cómo se hacen visibles los metadatos.

Los usuarios deben preguntarse si el proceso de revelación es justo, verificable y resistente a la manipulación interna.

Los desarrolladores deben evitar diseños de revelación en los que usuarios privilegiados puedan asignar rasgos raros después de conocer los resultados de la acuñación.

Un buen resolver respalda la transparencia de la revelación y eventos de actualización claros.

Un mal resolver puede ocultar cambios injustos de metadatos tras complejidad técnica.

Token URI Resolver y riesgos de seguridad

Los Token URI Resolvers pueden crear riesgos de seguridad porque los metadatos suelen obtenerse y mostrarse en carteras y aplicaciones.

Los metadatos maliciosos pueden incluir enlaces inseguros, imágenes engañosas, texto de phishing, afirmaciones falsas sobre recompensas o scripts en contextos no compatibles.

Las carteras y dApps deben tratar los metadatos como entradas no fiables.

Deben sanitizar imágenes, evitar ejecutar metadatos como código y prevenir redirecciones peligrosas.

Los usuarios deben tener cuidado con los enlaces externos dentro de los metadatos de NFT.

La imagen o descripción de un token puede utilizarse para atraer a los usuarios a una página de reclamación falsa.

Un resolver también puede apuntar a un dominio controlado por un atacante si el dominio original caduca o se ve comprometido.

Los resolvers de contratos inteligentes pueden crear riesgos adicionales si las claves de administrador pueden cambiar metadatos por contenido malicioso.

Los desarrolladores deben proteger la titularidad del resolver, los controles de acceso y las vías de actualización.

Los usuarios deben recordar que un NFT que aparece en una cartera no significa que sea seguro interactuar con sus metadatos.

Token URI Resolver y permanencia de los metadatos

La permanencia de los metadatos significa que la información descriptiva y los archivos multimedia del token permanecen disponibles con el tiempo.

Un token puede existir para siempre on-chain mientras sus metadatos desaparecen porque la URI deja de funcionar.

Este es uno de los mayores riesgos de la titularidad de NFT.

Si un resolver apunta a un servidor inactivo, los usuarios pueden perder acceso a la imagen y los atributos que daban significado al token.

Si el resolver apunta a almacenamiento direccionado por contenido, los usuarios pueden tener mayor seguridad de que el contenido no ha cambiado.

Sin embargo, el almacenamiento direccionado por contenido aún necesita disponibilidad de contenido.

El contenido de IPFS puede necesitar pinning, compatibilidad con gateways o disponibilidad de nodos.

Los metadatos on-chain pueden ofrecer mayor permanencia, pero pueden ser más caros y limitados.

Los usuarios deben preguntar si los metadatos son permanentes, mutables o dependen de un servicio centralizado.

Los proyectos deben explicar claramente la permanencia de los metadatos antes de que los usuarios acuñen o compren tokens.

Token URI Resolver y mutabilidad

La mutabilidad significa que los metadatos pueden cambiar después de la acuñación.

Cierta mutabilidad es útil porque los juegos, membresías, credenciales y activos del mundo real pueden necesitar actualizaciones.

Otra mutabilidad es arriesgada porque los emisores de tokens pueden cambiar arte, rasgos o descripciones de formas que los usuarios no esperaban.

Un Token URI Resolver suele ser donde la mutabilidad se hace visible.

Si un resolver devuelve metadatos diferentes con el tiempo, cambia la identidad mostrada del token.

Los usuarios deben comprobar si los metadatos pueden congelarse.

También deben comprobar quién tiene permiso para cambiar el resolver, la URI base o el servidor de metadatos.

Los desarrolladores deben documentar la diferencia entre metadatos dinámicos y control arbitrario del administrador.

Los metadatos dinámicos deben seguir reglas claras.

La mutabilidad inesperada puede reducir la confianza de los usuarios y el valor del activo.

Token URI Resolver y metadatos on-chain

Los metadatos on-chain significan que el propio contrato del token almacena o genera los metadatos del token.

Esto puede reducir la dependencia de servidores externos y redes de almacenamiento.

Un Token URI Resolver para metadatos on-chain puede devolver una URI de datos que contenga JSON y datos de imagen.

Algunos proyectos generan imágenes SVG directamente on-chain.

Otros proyectos almacenan rasgos compactos on-chain y dejan que el resolver monte un objeto de metadatos completo.

Los metadatos on-chain pueden mejorar la durabilidad y la transparencia.

También pueden aumentar el coste de gas y la complejidad del contrato.

La lógica compleja de metadatos on-chain puede introducir errores o dificultar las actualizaciones.

Los desarrolladores deben probar cuidadosamente los resolvers on-chain porque los clientes pueden tener límites de tamaño de carga y formato.

Los usuarios deben entender que los metadatos on-chain no son automáticamente mejores en todos los casos, pero pueden reducir ciertos riesgos de dependencia off-chain.

Token URI Resolver y NFT cross-chain

Los NFT cross-chain plantean retos adicionales para los Token URI Resolvers.

Un NFT transferido mediante bridge puede existir en una cadena mientras sus metadatos originales se encuentran en otra cadena o red de almacenamiento.

El resolver puede necesitar preservar la URI original, traducirla o crear metadatos reflejados.

Si los metadatos no se gestionan cuidadosamente, los tokens transferidos mediante bridge pueden mostrarse de forma diferente a los tokens originales.

Los resolvers cross-chain también deben considerar ID de cadena, direcciones de contrato originales, ID de token, identificadores de tokens envueltos y registros del bridge.

Los usuarios deben comprobar si un NFT transferido mediante bridge es el activo original o una representación envuelta.

Los desarrolladores deben incluir información de procedencia cuando sea posible, para que los usuarios sepan qué representa el token.

La confusión sobre metadatos puede crear riesgo de fraude cuando aparecen NFT copiados en otra red.

Un buen resolver ayuda a preservar la identidad entre cadenas.

Un resolver deficiente puede hacer que los activos envueltos sean engañosos o imposibles de verificar.

Token URI Resolver y tokens de activos del mundo real

Los tokens de activos del mundo real pueden utilizar URI de token para apuntar a documentos, certificados, registros legales, tasaciones, imágenes o datos de verificación.

Un Token URI Resolver para activos del mundo real puede requerir controles de acceso, pistas de auditoría y versionado de documentos más estrictos que un NFT coleccionable habitual.

Por ejemplo, un token que represente un documento de propiedad puede necesitar metadatos que hagan referencia a archivos verificados y hashes de documentos.

Un token que represente un coleccionable físico puede necesitar metadatos que hagan referencia a registros de procedencia o certificados de autenticidad.

Estos casos de uso hacen que la precisión de los metadatos sea muy importante.

Si el resolver apunta a documentos desactualizados o engañosos, los usuarios pueden malinterpretar el activo.

Algunos metadatos de activos del mundo real pueden requerir controles de privacidad porque los documentos legales pueden incluir información sensible.

Esto significa que el resolver puede tener que equilibrar transparencia y confidencialidad.

Los usuarios no deben asumir que una URI de token por sí sola demuestra la titularidad legal de un activo del mundo real.

El marco legal, el custodio, el emisor, la jurisdicción y la documentación siguen siendo importantes.

Token URI Resolver y activos de juegos

Los activos de juegos suelen depender de metadatos dinámicos.

Un NFT de juego puede cambiar de apariencia, nivel, fuerza, rareza, equipamiento o estado conforme lo utiliza el jugador.

Un Token URI Resolver puede leer el estado del juego y devolver metadatos actualizados para cada token.

Esto puede hacer que los objetos de juegos blockchain parezcan vivos e interactivos.

Sin embargo, los metadatos de juegos suelen depender de servidores de juegos, herramientas de renderizado y estado off-chain.

Si el juego cierra, algunos metadatos pueden dejar de actualizarse o desaparecer.

Los desarrolladores deben explicar claramente qué partes del activo del juego están on-chain y cuáles dependen del operador del juego.

Los usuarios deben comprender que poseer un NFT de juego no garantiza necesariamente que el juego siga siendo jugable para siempre.

El resolver puede mostrar el objeto, pero el ecosistema de juego general es el que le aporta utilidad.

Por tanto, el diseño de metadatos es fundamental para la confianza de los usuarios en los juegos blockchain.

Token URI Resolver e indexadores

Los indexadores recopilan datos de blockchain y los organizan para que las aplicaciones puedan consultarlos eficientemente.

Para los NFT, un indexador puede llamar a funciones de URI de token, obtener JSON de metadatos, almacenar imágenes en caché, realizar seguimiento de actualizaciones y exponer los datos mediante API.

Un Token URI Resolver dentro de un indexador debe gestionar llamadas de contrato, formatos de almacenamiento, reintentos, tiempos de espera, análisis de JSON y eventos de actualización.

Los indexadores ayudan a las carteras y dApps a cargar rápidamente información de tokens.

Sin embargo, los indexadores también pueden discrepar cuando utilizan reglas de caché, gateways o lógica de análisis de metadatos diferentes.

Por ello, una cartera puede mostrar metadatos actualizados mientras que otra aún muestra una imagen antigua.

Los desarrolladores deben admitir eventos de actualización de metadatos y formatos URI coherentes para facilitar la indexación.

Los usuarios deben entender que los problemas de visualización de metadatos pueden deberse a retrasos del indexador en lugar de a un fallo del token.

Las herramientas de actualización manual a veces pueden corregir metadatos obsoletos.

Los indexadores fiables son una parte oculta, pero importante, de la experiencia de usuario de NFT.

Token URI Resolver y carteras

Las carteras utilizan Token URI Resolvers para mostrar activos de forma fácil de usar.

Una cartera puede llamar directamente a un resolver o depender de un indexador que ya haya resuelto los metadatos.

Sin resolución de metadatos, una cartera puede mostrar únicamente una dirección de contrato y un ID de token.

Con resolución de metadatos, la cartera puede mostrar una imagen, título, nombre de la colección y rasgos.

Las carteras deben proteger a los usuarios de metadatos inseguros filtrando enlaces, bloqueando scripts, advirtiendo sobre activos spam y evitando interacciones peligrosas automáticas.

Los usuarios no deben confiar en todos los NFT que aparecen en una cartera.

Los NFT spam pueden utilizar metadatos para anunciar recompensas falsas o sitios web maliciosos.

La visualización en una cartera no supone una recomendación del token.

Un Token URI Resolver ayuda a mostrar información, pero los usuarios aún deben verificar la autenticidad.

Un diseño seguro de cartera trata los metadatos como útiles, pero no fiables.

Token URI Resolver y dApps

Las dApps utilizan Token URI Resolvers para dar significado a los tokens dentro de las experiencias de las aplicaciones.

Un panel DeFi puede utilizar metadatos para mostrar posiciones tokenizadas.

Un juego puede utilizar metadatos para renderizar personajes y objetos.

Una aplicación social puede utilizar metadatos para mostrar insignias de membresía o coleccionables de perfil.

Una aplicación de venta de entradas puede utilizar metadatos para mostrar detalles de eventos e información de asientos.

Una aplicación de credenciales puede utilizar metadatos para mostrar nombres de certificados y datos del emisor.

El resolver hace posibles estas visualizaciones.

Sin embargo, las dApps no deben depender únicamente de los metadatos para tomar decisiones críticas de seguridad.

Los metadatos pueden modificarse, falsificarse o servirse incorrectamente.

Para lógica importante, las dApps deben verificar directamente la titularidad on-chain, las direcciones de los contratos, los estándares de token y los permisos del emisor.

Los metadatos deben mejorar la experiencia de usuario, no sustituir las comprobaciones de seguridad.

Token URI Resolver y desarrolladores

Los desarrolladores utilizan Token URI Resolvers para diseñar cómo aparecen sus tokens en el ecosistema Web3.

Un desarrollador debe decidir si los metadatos serán on-chain, descentralizados, centralizados, mutables, inmutables, dinámicos o híbridos.

El desarrollador debe elegir una estructura de URI que las carteras y dApps puedan resolver de forma fiable.

El desarrollador debe evitar formatos inusuales salvo que exista una razón de peso.

Para ERC-721, el desarrollador debe implementar correctamente

y gestionar de forma segura los ID de token inexistentes.

Para ERC-1155, el desarrollador debe implementar correctamente

y admitir la sustitución del ID de token.

El desarrollador debe emitir eventos de actualización de metadatos cuando cambien los metadatos.

El desarrollador debe documentar si los metadatos pueden modificarse y quién controla los cambios.

El desarrollador debe probar la resolución de metadatos antes de acuñar tokens públicos.

Los metadatos defectuosos pueden dañar la confianza de los usuarios incluso cuando el propio contrato del token es seguro.

Token URI Resolver y traders

Los traders deben preocuparse por los Token URI Resolvers porque la calidad de los metadatos puede afectar al valor de los NFT, la liquidez y la confianza de los compradores.

Un token con metadatos defectuosos puede ser más difícil de vender.

Un token con metadatos mutables puede conllevar riesgos ocultos.

Un token con metadatos centralizados puede depender de que el emisor mantenga los servidores en línea.

Un token con metadatos engañosos puede realizar afirmaciones de rareza o identidad que no sean fiables.

Antes de operar con un NFT de alto valor, los usuarios deben comprobar la URI del token, el tipo de almacenamiento de metadatos, el enlace de imagen, la fuente de rasgos, los permisos del contrato y el historial de actualizaciones.

También deben verificar la dirección oficial del contrato, en lugar de confiar únicamente en los metadatos.

Los traders deben tener cuidado durante los periodos de revelación porque los cambios de metadatos pueden crear volatilidad.

Si un administrador puede cambiar el resolver, esto debe formar parte de la evaluación del riesgo.

La fiabilidad de los metadatos no es solo un detalle técnico, porque puede afectar a la confianza del mercado.

Problemas habituales de los Token URI Resolvers

El primer problema habitual es la ausencia de una URI de token.

El segundo problema habitual es una URI que devuelve JSON no válido.

El tercer problema habitual es una URI de IPFS que no está fijada o disponible.

El cuarto problema habitual es un servidor HTTP que deja de estar disponible.

El quinto problema habitual son metadatos almacenados en caché obsoletos después de una revelación.

El sexto problema habitual es una sustitución incorrecta del ID de token ERC-1155.

El séptimo problema habitual son metadatos que cambian sin aviso.

El octavo problema habitual es una URI de datos que las carteras no descodifican correctamente.

El noveno problema habitual es un contrato resolver que puede ser modificado por un administrador privilegiado.

El décimo problema habitual son metadatos maliciosos que dirigen a los usuarios a sitios de phishing.

Buenas prácticas para Token URI Resolvers

Utiliza estándares ampliamente compatibles, como metadatos ERC-721 y metadatos ERC-1155, cuando sea posible.

Devuelve metadatos JSON limpios y válidos.

Utiliza almacenamiento direccionado por contenido, como IPFS, cuando la permanencia y la integridad sean importantes.

Fija o preserva los metadatos para que el contenido siga disponible.

Emite eventos estándar de actualización de metadatos cuando cambien los metadatos del token.

Documenta si los metadatos son mutables, están congelados, son dinámicos o están controlados por un administrador.

Utiliza controles de acceso claros para cualquier contrato resolver que pueda cambiar metadatos.

Prueba los metadatos en varias carteras, exploradores y dApps antes del lanzamiento.

Evita utilizar dominios caducados, servidores inestables o cadenas de redirección poco claras.

Nunca trates los metadatos como entradas fiables en lógica de aplicaciones crítica para la seguridad.

Preguntas frecuentes

¿Qué significa Token URI Resolver?

Un Token URI Resolver es un sistema que devuelve u obtiene la URI de metadatos de un token cripto, especialmente un NFT.

¿Un Token URI Resolver es lo mismo que tokenURI?

No,

suele ser una función de contrato, mientras que un Token URI Resolver es el sistema o la lógica más amplia que llama, construye, transforma o interpreta la URI.

¿Qué devuelve tokenURI?

La función

suele devolver una URI que apunta a un archivo JSON de metadatos o a una URI de datos integrada.

¿Qué es una URI de token ERC-721?

Una URI de token ERC-721 es un puntero de metadatos devuelto para un ID de token no fungible específico.

¿Qué es una URI ERC-1155?

Una URI ERC-1155 es un puntero de metadatos que puede utilizar un marcador de posición

para diferentes ID de token dentro de un contrato.

¿Puede un Token URI Resolver devolver metadatos de IPFS?

Sí, muchos resolvers devuelven URI

que apuntan a metadatos almacenados mediante identificadores de contenido de IPFS.

¿Puede un Token URI Resolver devolver metadatos on-chain?

Sí, algunos resolvers devuelven URI de datos que contienen JSON codificado e imágenes generadas directamente por contratos inteligentes.

¿Por qué no se muestra la imagen de mi NFT?

La imagen puede no mostrarse porque falta la URI del token, el servidor de metadatos no está disponible, el contenido de IPFS no está disponible, el JSON no es válido o la caché de la aplicación está desactualizada.

¿Pueden cambiar los metadatos de NFT?

Sí, los metadatos pueden cambiar si el resolver, la URI base, el servidor o la lógica de metadatos dinámicos permite actualizaciones.

¿Qué es ERC-4906?

ERC-4906 es una extensión de actualización de metadatos NFT que define eventos para informar a los clientes de cuándo deben actualizarse los metadatos.

¿Qué es ERC-7572?

ERC-7572 estandariza

para metadatos a nivel de colección o contrato.

¿Los metadatos de IPFS son permanentes?

El direccionamiento por contenido de IPFS ayuda a preservar la integridad, pero el contenido debe seguir fijado o servido para permanecer disponible.

¿Las URI de token HTTP son arriesgadas?

Las URI de token HTTP pueden ser arriesgadas porque el servidor, el dominio o los metadatos pueden cambiar o desaparecer.

¿Puede un resolver ser un contrato inteligente?

Sí, algunos proyectos utilizan un contrato inteligente independiente para resolver dinámicamente URI de token o compartir lógica de metadatos entre contratos de tokens.

¿Cuál es la configuración de metadatos más segura?

La configuración más segura depende del caso de uso, pero los diseños sólidos suelen combinar estándares claros, contratos verificados, reglas transparentes de mutabilidad, almacenamiento duradero y eventos de actualización.

Conclusión

Un Token URI Resolver es la capa de búsqueda de metadatos que conecta un token cripto con la información que los usuarios realmente ven.

Puede llamar a

, procesar marcadores de posición de ERC-1155, descodificar URI de datos, convertir enlaces IPFS, obtener JSON y actualizar metadatos después de cambios.

Para los NFT, el resolver es esencial porque la titularidad se encuentra on-chain, mientras que las imágenes, los rasgos, las descripciones y los archivos multimedia suelen estar fuera del contrato.

Un buen resolver ayuda a carteras, dApps, juegos, marketplaces, exploradores e indexadores a mostrar tokens con precisión.

Un resolver deficiente puede crear imágenes rotas, datos obsoletos, rasgos engañosos, riesgo de phishing o pérdida de metadatos a largo plazo.

Los desarrolladores deben crear resolvers con interfaces estándar, formatos URI claros, almacenamiento duradero, eventos de actualización seguros y reglas transparentes de mutabilidad.

Los usuarios deben comprobar dónde se almacenan los metadatos, si pueden cambiar, quién controla las actualizaciones y si el contenido se conserva.

Los traders deben tratar la calidad de la URI de token como parte de la diligencia debida de NFT, ya que la fiabilidad de los metadatos puede afectar a la confianza del mercado y al valor de reventa.

Los Token URI Resolvers no son solo herramientas técnicas, ya que determinan cómo se comprenden, muestran, verifican y valoran los activos cripto.

En un glosario cripto, Token URI Resolver debe entenderse como el sistema que resuelve un ID de token en metadatos y hace que la titularidad en blockchain sea visible, interpretable y utilizable en las aplicaciones Web3.