URI de metadatos

¿Qué es una URI de metadatos?

Una URI de metadatos es un enlace que apunta al archivo de metadatos de un activo cripto, normalmente un NFT.En pocas palabras, indica a las carteras, los mercados, los juegos y las aplicaciones dónde encontrar información sobre un token.Esta información puede incluir el nombre y la descripción del token, una imagen, una animación, un modelo 3D, atributos, una URL externa, características de rareza y otros datos de visualización.En los NFT, la URI de metadatos es importante porque el propio token no suele almacenar directamente toda la obra gráfica ni los datos descriptivos.En su lugar, el contrato inteligente almacena o devuelve una URI que apunta a un archivo JSON de metadatos.

El estándar ERC-721 para NFT incluye una extensión de metadatos opcional con una función tokenURI que puede devolver una URI para un NFT concreto.

Esta URI ayuda a las aplicaciones a entender qué debe mostrar el NFT y cómo debe describirse.Sin una URI de metadatos operativa, el NFT puede seguir existiendo en la blockchain, pero es posible que las carteras y los mercados no sepan mostrar correctamente su imagen, nombre o características.

Cómo funciona una URI de metadatos

Una URI de metadatos conecta el ID de un token de blockchain con metadatos almacenados on-chain u off-chain.Cuando un usuario abre un NFT en una cartera o un mercado, la aplicación suele solicitar al contrato inteligente la URI del token.A continuación, la aplicación obtiene el archivo de metadatos desde esa URI.El archivo de metadatos suele estar escrito en JSON, un formato habitual para los datos estructurados.Por ejemplo, el archivo JSON puede incluir campos como name, description, image, animation_url y attributes.La cartera o el mercado lee esos campos y muestra el NFT al usuario.Este proceso facilita el uso de los NFT, ya que no es necesario almacenar archivos multimedia de gran tamaño directamente en el contrato inteligente.Sin embargo, también genera riesgos, porque la visualización del activo puede depender de que los metadatos enlazados sigan disponibles y no se modifiquen.

URI de metadatos y URI del token

URI de metadatos y URI del token son términos estrechamente relacionados.La URI del token suele referirse a la función o el valor del contrato inteligente que devuelve la ubicación de los metadatos de un token concreto.La URI de metadatos se refiere al enlace o la ruta donde se encuentran los metadatos.En muchos debates sobre NFT, ambos términos se utilizan casi indistintamente.En los NFT ERC-721, tokenURI es el nombre habitual de la función que devuelve la URI de metadatos de un ID de token.En los tokens ERC-1155, el modelo de URI puede admitir la sustitución del ID, de modo que el ID del token se inserta en la ruta de la URI.

El estándar multi-token ERC-1155 define un esquema JSON para la URI de metadatos y explica cómo los clientes pueden sustituir la cadena {id} por el ID real del token.

¿Qué información se almacena en los metadatos de un NFT?

Los metadatos de un NFT suelen almacenar la información descriptiva que necesitan las aplicaciones para mostrar el activo.Los campos más habituales son name, description, image, external_url, animation_url y attributes.El campo image puede apuntar a un archivo PNG, JPEG, GIF, SVG u otro formato multimedia compatible.El campo animation_url puede apuntar a un vídeo, un archivo de audio, una experiencia HTML, un modelo 3D o un archivo multimedia interactivo.El campo attributes suele almacenar características como el fondo, la ropa, el nivel de rareza, el tipo de objeto, la clase del personaje o las estadísticas de un juego.Estas características son especialmente importantes para las colecciones de NFT, los juegos blockchain, los proyectos de avatares, los terrenos virtuales y los activos del metaverso.Los metadatos también pueden incluir campos técnicos o específicos del proyecto, según la plataforma y el estándar del token.Unos buenos metadatos deben ser claros, precisos y coherentes con el activo que los usuarios esperan recibir.

Formatos habituales de URI de metadatos

Los formatos más habituales de URI de metadatos son los enlaces HTTPS, los enlaces IPFS, los enlaces Arweave y las URI de datos íntegramente on-chain.Una URI de metadatos HTTPS apunta a un servidor web convencional.Es fácil de usar, pero puede entrañar riesgos si el servidor deja de funcionar, cambia el archivo o elimina el contenido.Una URI de metadatos IPFS apunta a contenido almacenado mediante el InterPlanetary File System.

La documentación de IPFS sobre el direccionamiento por contenido explica que IPFS utiliza identificadores de contenido, o CID, para identificar el contenido según el propio contenido.

Esto resulta útil porque los enlaces direccionados por contenido pueden ayudar a los usuarios a verificar que el archivo obtenido coincide con el contenido esperado.Una URI de metadatos Arweave apunta a datos almacenados en Arweave, una red diseñada para el almacenamiento descentralizado permanente.

El sitio web oficial de Arweave describe Arweave como un disco duro sin permisos que almacena datos permanentemente e incentiva a los nodos a conservarlos.

Una URI de datos on-chain almacena los metadatos directamente en el contrato inteligente o devuelve metadatos codificados desde la blockchain.Los metadatos on-chain pueden ser duraderos, pero también pueden resultar más caros y estar sujetos a limitaciones técnicas.

Por qué son importantes las URI de metadatos para los NFT

Las URI de metadatos importan porque afectan a la apariencia de los NFT y a la forma en que los usuarios entienden lo que poseen.Un NFT puede tener un ID de token y una dirección de titular en la blockchain, pero los metadatos explican la identidad y el aspecto del activo.Si la URI de metadatos deja de funcionar, el NFT puede aparecer sin imágenes, sin características o con información de visualización incorrecta.Si el equipo del proyecto puede cambiar la URI de metadatos, el NFT podría mostrar otro contenido más adelante.Por eso, los coleccionistas y usuarios cripto más experimentados suelen preguntar si los metadatos están congelados, descentralizados o íntegramente on-chain.La calidad de los metadatos puede afectar a la confianza, el valor de mercado, la utilidad en juegos, la compatibilidad con el metaverso y la conservación a largo plazo.Para los proyectos cripto, el diseño de los metadatos no es solo un detalle técnico.Forma parte de la fiabilidad del activo y de la experiencia del usuario.

URI de metadatos centralizada

Una URI de metadatos centralizada suele apuntar a un archivo alojado en un servidor web convencional o en un servicio en la nube.Este formato es sencillo y rápido para los desarrolladores.También permite a los equipos actualizar los metadatos fácilmente si necesitan corregir errores o revelar los activos después de acuñarlos.Sin embargo, los metadatos centralizados generan riesgos de confianza.Si el servidor deja de funcionar, el NFT puede perder su imagen o sus características en las interfaces de las carteras.Si el equipo del proyecto cambia el archivo, el NFT puede mostrar metadatos distintos de los que esperaban los usuarios.Si el dominio caduca o alguien se hace con él, los usuarios pueden encontrar contenido dañado o malicioso.Los metadatos centralizados pueden ser aceptables para algunos proyectos, pero los usuarios deben entender el compromiso que implican.

URI de metadatos descentralizada

Una URI de metadatos descentralizada suele apuntar a contenido almacenado mediante sistemas como IPFS o Arweave.Esto puede mejorar la durabilidad y reducir la dependencia del servidor de una sola empresa.Con IPFS, los usuarios suelen ver enlaces que empiezan por ipfs:// seguidos de un CID.Con Arweave, suelen ver enlaces basados en transacciones que apuntan a datos almacenados.El almacenamiento descentralizado no es perfecto automáticamente.El contenido de IPFS debe seguir fijado (pinned) o alojado por nodos para que sea fácil recuperarlo.Arweave aspira a ofrecer almacenamiento permanente, pero los usuarios deben comprobar igualmente que los archivos correctos se hayan subido y enlazado.Los proyectos de NFT más sólidos suelen hacer que el almacenamiento de metadatos sea transparente y fácil de verificar para los usuarios.

URI de metadatos on-chain

Los metadatos on-chain son metadatos almacenados directamente en la blockchain o generados por el contrato inteligente.Este enfoque puede reducir la dependencia de servidores externos y redes de almacenamiento.Suele utilizarse en proyectos que buscan la máxima durabilidad o arte íntegramente on-chain.Los metadatos on-chain pueden utilizar una URI de datos que incluya JSON codificado directamente en la respuesta de tokenURI.Esto puede hacer que el NFT sea más autónomo, ya que no es necesario obtener los metadatos de un sitio web independiente.La principal limitación es el coste.Almacenar imágenes, animaciones o archivos 3D grandes directamente on-chain puede resultar caro o poco práctico.Por ello, muchos proyectos almacenan en la blockchain los metadatos pequeños y guardan los archivos multimedia más grandes en otro lugar.

URI base

Una URI base es una ruta de inicio compartida que utilizan muchos tokens del mismo contrato inteligente.En lugar de almacenar un enlace completo a los metadatos de cada token, el contrato puede combinar una ruta base con un ID de token.Por ejemplo, un proyecto puede utilizar una ruta base y añadir al final el número del token para localizar cada archivo de metadatos.Este diseño puede reducir los costes de almacenamiento del contrato inteligente y simplificar las colecciones grandes de NFT.Sin embargo, el diseño de la URI base también puede generar riesgos de actualización si el titular del contrato puede cambiar la ruta más adelante.Si cambia la ruta base, los metadatos de muchos tokens podrían cambiar al mismo tiempo.Los usuarios deben comprobar si la URI base es fija, actualizable o está controlada por una cartera de administrador.

Metadatos congelados

Los metadatos congelados son aquellos que el proyecto ha bloqueado para impedir que se modifiquen mediante las acciones de administración habituales.Esto es importante para los coleccionistas de NFT, porque aumenta la confianza en que el activo mostrado no se alterará más adelante.Congelar los metadatos no siempre significa que los archivos sean perfectamente permanentes.Normalmente significa que el contrato inteligente o la plataforma ya no permiten al equipo del proyecto actualizar el enlace de los metadatos.La durabilidad real sigue dependiendo del lugar donde se almacenen los metadatos y los archivos multimedia.Por ejemplo, los metadatos congelados que apuntan a IPFS o Arweave pueden ser más sólidos que los que apuntan a un servidor centralizado poco fiable.

URI de metadatos y revelaciones de NFT

Muchas colecciones de NFT utilizan URI de metadatos durante los eventos de revelación.Antes de la revelación, todos los tokens pueden apuntar a una imagen provisional o a un archivo de metadatos oculto.Después, el proyecto actualiza la URI base o los archivos de metadatos para que cada token muestre su diseño y características definitivos.Este proceso es habitual, pero requiere confianza.Los usuarios deben confiar en que la revelación será justa y que el equipo no manipulará las características raras.Los mejores proyectos explican claramente el método de revelación y, cuando es posible, utilizan aleatoriedad transparente o verificación pública.Tras la revelación, los usuarios suelen preferir que los metadatos queden congelados o se almacenen de forma duradera.

URI de metadatos en juegos blockchain

Las URI de metadatos son importantes en los juegos blockchain, porque los activos del juego suelen tener características, niveles, equipo, estadísticas e historial de mejoras.Un NFT de una espada puede incluir datos de poder de ataque, rareza, durabilidad, tipo de elemento e imagen.Un NFT de personaje puede incluir clase, nivel, habilidades, ropa y datos de animación.Algunos metadatos de juegos son estáticos, mientras que otros son dinámicos.Los metadatos dinámicos pueden cambiar cuando un jugador mejora un objeto, completa una misión o desbloquea una nueva forma.Esto permite crear activos más interactivos, pero también exige confiar en las reglas de actualización del juego.Los usuarios deben entender quién puede cambiar los metadatos y si los cambios los controlan contratos inteligentes, servidores del juego o administradores del proyecto.

URI de metadatos en el metaverso

En el metaverso, las URI de metadatos pueden definir el aspecto y el funcionamiento de los activos virtuales.Un NFT de terreno virtual puede utilizar metadatos para describir la ubicación, el tamaño de la parcela, las coordenadas, una imagen de vista previa y los datos del mundo.Un NFT de prenda puede utilizar metadatos para apuntar a un modelo 3D, archivos de textura, animaciones o detalles de compatibilidad.Un NFT de entrada a un evento puede utilizar metadatos para describir los derechos de acceso, la fecha, el tipo de insignia y las ventajas asociadas.Los activos del metaverso necesitan metadatos fiables, ya que la experiencia del usuario depende de que las aplicaciones puedan cargar el objeto digital correcto.Si los metadatos faltan o están mal estructurados, el activo puede no mostrarse correctamente en carteras, juegos o mundos virtuales.

Riesgos de seguridad de las URI de metadatos

El primer riesgo son los metadatos que dejan de funcionar.Si la URI apunta a un archivo inexistente, es posible que el NFT no se muestre correctamente.El segundo riesgo son los metadatos modificados.Si el proyecto puede cambiar la URI o el contenido del archivo, quizá los usuarios no reciban a largo plazo el activo que esperaban.El tercer riesgo son los metadatos maliciosos.Un archivo de metadatos o un enlace externo puede dirigir a los usuarios a sitios web peligrosos o páginas de phishing.El cuarto riesgo son los activos falsos.Los estafadores pueden crear NFT con imágenes copiadas, nombres engañosos o metadatos de colección falsos.El quinto riesgo es la exposición de la privacidad.Algunos enlaces a metadatos o archivos multimedia pueden revelar el comportamiento de los usuarios si se cargan mediante servidores de seguimiento.El sexto riesgo es la dependencia de una plataforma.Un NFT puede existir técnicamente en la blockchain mientras su contenido visible depende de una API privada o una aplicación centralizada.

Cómo evaluar una URI de metadatos

Empieza por comprobar si la URI utiliza HTTPS, IPFS, Arweave o datos on-chain.Comprueba que el archivo de metadatos se cargue correctamente y coincida con el activo esperado.Verifica que la imagen o el archivo multimedia también apunten a un almacenamiento duradero.Busca indicios de que los metadatos se hayan congelado o sean inmutables.Comprueba si el titular del contrato inteligente puede cambiar la URI base.Verifica que los metadatos incluyan campos claros de nombre, descripción, imagen y atributos.Evita hacer clic en enlaces externos desconocidos incluidos en los metadatos de un NFT.Compara la dirección del contrato con las fuentes oficiales del proyecto antes de confiar en los metadatos.Antes de comprar NFT de valor, revisa el contrato inteligente y el método de almacenamiento.

URI de metadatos y URI de archivos multimedia

Una URI de metadatos apunta al archivo de metadatos del token.Una URI de archivos multimedia apunta a la imagen, animación, vídeo, audio o archivo 3D al que se hace referencia dentro de los metadatos.Por ejemplo, la URI de metadatos puede apuntar a un archivo JSON.Dentro de ese archivo JSON, el campo image puede apuntar a una URI de imagen independiente.Ambos enlaces son importantes.Si la URI de metadatos funciona, pero el enlace multimedia está roto, el NFT puede seguir mostrándose de forma incorrecta.Un proyecto de NFT sólido debería utilizar un almacenamiento duradero tanto para los metadatos como para los archivos multimedia.

Malentendidos habituales sobre las URI de metadatos

Un malentendido habitual es creer que la imagen del NFT siempre se almacena directamente on-chain.En muchos casos, el contrato inteligente solo apunta a una URI de metadatos y la imagen se almacena en otro lugar.Otro malentendido es creer que IPFS garantiza automáticamente una disponibilidad permanente.IPFS utiliza direccionamiento por contenido, pero el contenido debe seguir alojado o fijado para que los usuarios puedan recuperarlo de forma fiable.Un tercer malentendido es creer que los metadatos congelados siempre implican que los archivos multimedia sean permanentes.Los metadatos congelados pueden bloquear el enlace, pero los archivos enlazados siguen necesitando un almacenamiento duradero.Un cuarto malentendido es creer que todos los NFT con metadatos son auténticos.Los estafadores pueden copiar metadatos e imágenes, por lo que los usuarios deben verificar el contrato y el origen de la colección.

Preguntas frecuentes

¿Qué es una URI de metadatos en cripto?

Una URI de metadatos es un enlace que apunta al archivo de metadatos de un token, normalmente un NFT.

¿Qué incluyen los metadatos de un NFT?

Los metadatos de un NFT pueden incluir el nombre y la descripción del token, una imagen, una animación, características, atributos, una URL externa y otra información de visualización.

¿Se almacena una URI de metadatos on-chain?

El contrato inteligente puede almacenar o devolver la URI, pero el archivo de metadatos suele almacenarse off-chain.

¿Qué es tokenURI?

tokenURI es una función habitual de ERC-721 que devuelve la URI de metadatos del ID de un NFT concreto.

¿Cuál es la diferencia entre una URI de metadatos y una URI de imagen?

La URI de metadatos apunta al archivo JSON de metadatos, mientras que la URI de imagen apunta a la imagen o al archivo multimedia que se indica dentro de esos metadatos.

¿Es IPFS mejor que HTTPS para los metadatos?

IPFS puede ofrecer almacenamiento direccionado por contenido, mientras que HTTPS depende de un servidor web; sin embargo, el contenido de IPFS también debe fijarse o alojarse para garantizar un acceso fiable.

¿Qué significa que los metadatos estén congelados?

Significa que el proyecto los ha bloqueado para que no puedan modificarse fácilmente mediante los controles de administración habituales.

¿Pueden cambiar los metadatos de un NFT después de acuñarlo?

Sí. Los metadatos pueden cambiar si el contrato inteligente o el sistema de almacenamiento permiten al equipo del proyecto o a un administrador actualizar la URI o el contenido del archivo.

¿Por qué desaparece la imagen de mi NFT?

La imagen de un NFT puede desaparecer si la URI de metadatos, la URI multimedia, el servidor, la pasarela o el proveedor de almacenamiento no consigue cargar el archivo.

¿Qué deberían comprobar los usuarios antes de comprar un NFT?

Los usuarios deberían comprobar la dirección del contrato, la URI de metadatos, el método de almacenamiento, el estado de congelación de los metadatos, los enlaces multimedia, las condiciones del proyecto y la autenticidad de la colección.

Conclusión

Una URI de metadatos es una parte fundamental de la forma en que los NFT y otros activos cripto muestran información en carteras, mercados, juegos y aplicaciones del metaverso.Conecta el ID de un token con un archivo de metadatos que describe el nombre, la imagen, la descripción, las características y los enlaces multimedia del activo.Las URI de metadatos hacen que los NFT sean flexibles y más fáciles de mostrar, pero también generan riesgos de almacenamiento, seguridad y confianza.Una configuración sólida de URI de metadatos debe ser transparente, duradera, precisa y difícil de manipular después de que los usuarios compren el activo.Los usuarios deben saber si los metadatos están centralizados, descentralizados, on-chain, congelados o son actualizables.También deben comprobar si los archivos multimedia se almacenan de forma fiable y si el contrato del NFT es auténtico.En cripto, la titularidad es solo una parte de la historia del activo.La URI de metadatos ayuda a definir el aspecto del activo, cómo se describe y si los usuarios pueden confiar en que se mostrará correctamente a largo plazo.