Extensión de metadatos

¿Qué es una extensión de metadatos?

Una extensión de metadatos es una función opcional o adicional de un contrato inteligente que permite a un token cripto mostrar información descriptiva sobre sí mismo.

En el ámbito cripto, el término se utiliza sobre todo en estándares de NFT como ERC-721, donde la extensión de metadatos permite que las carteras, los mercados, los juegos y las aplicaciones consulten el nombre y el símbolo de un token, así como su URI de metadatos.

El estándar ERC-721 define una extensión de metadatos opcional que incluye las funciones name, symbol y tokenURI.

Esto es importante porque el ID de un token en una blockchain no explica por sí solo qué aspecto tiene el activo, qué características posee ni qué representa.

Una extensión de metadatos ayuda a las aplicaciones a vincular el token on-chain con metadatos off-chain o on-chain.

Estos metadatos pueden incluir el nombre, la descripción, la imagen, la animación, los atributos, las características de rareza, las estadísticas de un juego, los datos de terrenos virtuales o archivos 3D del activo.

En pocas palabras, una extensión de metadatos es la parte de un estándar de token que ayuda a las aplicaciones a responder a la pregunta: «¿Qué es este token?»

Cómo funciona una extensión de metadatos

Una extensión de metadatos suele funcionar añadiendo funciones o eventos estandarizados a un contrato de token.

En los NFT ERC-721, la función de metadatos más importante es tokenURI.

La función tokenURI devuelve un URI que apunta al archivo de metadatos de un ID de token concreto.

Cuando una cartera o un mercado quiere mostrar un NFT, llama a tokenURI, obtiene el archivo de metadatos y lee campos como el nombre, la descripción, la imagen y los atributos.

Esto permite que muchas aplicaciones muestren el mismo NFT sin necesitar instrucciones personalizadas del equipo del proyecto.

En los activos ERC-1155, los metadatos se gestionan mediante un sistema de URI compatible con varios tipos de tokens dentro de un mismo contrato.

El estándar ERC-1155 define un esquema JSON de URI de metadatos y admite la sustitución de ID para obtener metadatos específicos de cada token.

El objetivo es la estandarización.

Si los proyectos siguen extensiones de metadatos comunes, las carteras y aplicaciones pueden admitir más activos con menos código personalizado.

Por qué son importantes las extensiones de metadatos en cripto

Las extensiones de metadatos son importantes porque los activos digitales necesitan un contexto que se pueda interpretar.

Un token puede existir on-chain, pero los usuarios necesitan saber qué representa antes de poder valorarlo, utilizarlo, operarlo o mostrarlo.

En los NFT, los metadatos pueden definir el activo visible.

En los juegos blockchain, los metadatos pueden definir el tipo de objeto, la rareza, el nivel, la potencia o el estado de mejora.

En los activos del metaverso, los metadatos pueden definir las coordenadas del terreno, la compatibilidad con avatares, los archivos de prendas, el acceso a eventos o los datos de objetos virtuales.

Sin extensiones de metadatos, cada cartera o mercado necesitaría una forma distinta de interpretar cada proyecto.

Esto dificultaría mucho el descubrimiento y el trading de NFT, los filtros, las herramientas de rareza, los listados en mercados y la integración en juegos.

Por ello, las extensiones de metadatos son una parte clave de la interoperabilidad de los NFT y de la experiencia de usuario.

Extensión de metadatos ERC-721

La extensión de metadatos ERC-721 es el ejemplo más conocido de una extensión de metadatos en cripto.

ERC-721 es un estándar para tokens no fungibles, lo que significa que cada token puede ser único.

La extensión de metadatos añade tres funciones habituales: name, symbol y tokenURI.

La función name devuelve el nombre de la colección o del contrato del token.

La función symbol devuelve un símbolo breve para la colección.

La función tokenURI devuelve el URI de metadatos de un ID de token concreto.

Esta estructura permite que las aplicaciones obtengan los metadatos correctos de cada NFT.

Por ejemplo, los ID de token 10 y 11 pueden pertenecer a la misma colección, pero tener imágenes y características distintas.

La función tokenURI ayuda a las aplicaciones a localizar el archivo de metadatos correspondiente a cada uno.

Extensión de metadatos ERC-1155

ERC-1155 es un estándar mult token que admite tokens fungibles, tokens semifungibles y NFT en un mismo contrato.

Esto lo hace útil para juegos blockchain, activos del metaverso, insignias, entradas y sistemas con muchos tipos de objetos.

Su sistema de metadatos es distinto al de ERC-721 porque un contrato puede gestionar muchos tipos de activos.

ERC-1155 puede utilizar un URI con un marcador de posición que las aplicaciones sustituyen por el ID de token correspondiente.

Esto facilita la gestión de numerosos objetos, como espadas, escudos, pociones, skins, insignias y pases para eventos.

La extensión de metadatos ERC-1155 resulta especialmente útil cuando un proyecto necesita muchas clases de tokens, en lugar de un token único por cada diseño de contrato.

Extensión de actualización de metadatos ERC-4906

ERC-4906 es una extensión de actualización de metadatos que ayuda a las aplicaciones a detectar cuándo han cambiado los metadatos de un NFT.

El estándar ERC-4906 define los eventos MetadataUpdate y BatchMetadataUpdate para los cambios en los metadatos de los NFT.

Esto resulta útil porque algunos NFT tienen metadatos dinámicos.

Por ejemplo, un personaje de un juego blockchain puede subir de nivel, una insignia puede cambiar cuando un usuario asiste a un evento o un activo del metaverso puede actualizarse al añadir un edificio.

Sin una señal de actualización estándar, es posible que los mercados y las carteras no sepan cuándo deben actualizar la visualización del NFT.

ERC-4906 ayuda a resolver este problema al ofrecer a los contratos una forma estándar de indicar que deben actualizarse los metadatos.

Esto no hace que los metadatos sean seguros ni correctos por sí mismo.

Solo mejora la comunicación entre los contratos inteligentes y las aplicaciones off-chain.

Extensiones de metadatos a nivel de contrato

Los metadatos no siempre describen un único token.

A veces, las aplicaciones necesitan metadatos sobre todo el contrato o la colección.

ERC-7572 estandariza la función contractURI para los metadatos a nivel de contrato.

El estándar ERC-7572 explica que contractURI puede devolver metadatos de un contrato, como su nombre, descripción e imagen.

Esto resulta útil para mercados, carteras, exploradores e indexadores que quieren mostrar información sobre toda una colección.

Los metadatos a nivel de token indican a los usuarios qué es un NFT concreto.

Los metadatos a nivel de contrato indican a los usuarios qué es la colección o el contrato en su conjunto.

Ambos tipos de metadatos pueden mejorar el descubrimiento de activos y la confianza de los usuarios.

Extensión de metadatos y URI de metadatos

Una extensión de metadatos y un URI de metadatos están relacionados, pero no son lo mismo.

Una extensión de metadatos es la función o interfaz del contrato que permite acceder a los metadatos.

Un URI de metadatos es el enlace o la ruta que devuelve esa función.

Por ejemplo, la extensión de metadatos de ERC-721 incluye la función tokenURI.

La función tokenURI puede devolver un enlace HTTPS, un enlace IPFS, un enlace Arweave o un URI de datos on-chain.

La extensión de metadatos es la puerta de acceso.

El URI de metadatos es la dirección que se encuentra detrás de esa puerta.

Entender esta diferencia ayuda a usuarios y desarrolladores a evaluar cómo están estructurados los metadatos de los NFT.

Extensión de metadatos y estándar de token

Un estándar de token define las reglas básicas de funcionamiento de un token.

Una extensión de metadatos añade funciones o eventos adicionales relacionados con la información descriptiva.

En ERC-721, el estándar principal define la propiedad y las transferencias.

La extensión de metadatos añade name, symbol y tokenURI.

Esta separación es importante porque algunas extensiones son opcionales.

Un token puede seguir el estándar principal y, aun así, ofrecer distintos niveles de compatibilidad con metadatos.

La mayoría de los proyectos NFT incluyen compatibilidad con metadatos porque los usuarios esperan que las carteras y los mercados muestren imágenes, nombres y características.

No obstante, los desarrolladores deben comprobar qué interfaces admite realmente un contrato.

Qué pueden incluir los metadatos

Los metadatos pueden incluir el nombre, la descripción, la imagen, la animación, una URL externa y los atributos del token.

En las colecciones de NFT, los atributos pueden incluir características como el fondo, la ropa, la clase, la rareza, el nivel o funciones especiales.

En los juegos blockchain, los metadatos pueden incluir estadísticas de objetos, durabilidad, potencia, tipo de elemento, clase de personaje o fase de mejora.

En los activos del metaverso, los metadatos pueden incluir coordenadas de terrenos, tamaño de parcelas, enlaces a archivos de avatares, compatibilidad con prendas o derechos de acceso.

En los NFT de eventos, los metadatos pueden incluir el nombre y la fecha del evento, la categoría de la entrada, el estado de asistencia acreditada o los beneficios.

Las extensiones de metadatos facilitan que las aplicaciones localicen y muestren esta información.

No garantizan que la información sea precisa, permanente o jurídicamente válida.

Almacenamiento de metadatos y extensiones de metadatos

Una extensión de metadatos suele indicar a las aplicaciones dónde encontrar los metadatos, pero no siempre define dónde deben almacenarse.

Los metadatos pueden almacenarse en un servidor HTTPS centralizado, en IPFS, en Arweave o directamente on-chain.

El almacenamiento HTTPS es sencillo, pero depende de que un servidor o una API sigan disponibles.

IPFS utiliza direccionamiento por contenido, que puede ayudar a verificar que el contenido coincide con su identificador de contenido.

La documentación de IPFS explica que los identificadores de contenido identifican los datos en función del propio contenido.

Arweave está diseñado para el almacenamiento de datos a largo plazo.

El sitio web de Arweave describe la red como un sistema para almacenar información de forma permanente.

Los metadatos on-chain pueden ser muy duraderos, pero almacenar imágenes, vídeos o archivos 3D de gran tamaño puede resultar costoso.

Extensiones de metadatos y mercados de NFT

Los mercados de NFT dependen en gran medida de las extensiones de metadatos para mostrar correctamente los activos.

Un mercado puede llamar a tokenURI, obtener el archivo JSON de metadatos y mostrar la imagen, las características, el nombre y la descripción del NFT.

La documentación de estándares de metadatos de OpenSea indica que admite metadatos estructurados según los estándares de metadatos ERC-721 y ERC-1155.

Esto demuestra por qué es importante diseñar los metadatos conforme a estándares.

Si un proyecto utiliza campos de metadatos poco habituales o enlaces rotos, los mercados pueden mostrar el NFT de forma incorrecta.

Una buena estructura de metadatos puede mejorar las búsquedas, los filtros, la clasificación por rareza, la visualización de características y la confianza de los usuarios.

Una estructura deficiente puede hacer que los activos parezcan defectuosos o poco fiables, aunque el contrato del token funcione.

Extensiones de metadatos y NFT dinámicos

Los NFT dinámicos son NFT cuyos metadatos pueden cambiar con el tiempo.

Esto puede resultar útil en juegos, programas de fidelización, aplicaciones del metaverso y sistemas de identidad.

Un NFT dinámico puede subir de nivel, cambiar de aspecto, desbloquear nuevas características o mostrar un estado actualizado.

Las extensiones de metadatos lo hacen posible al proporcionar a las aplicaciones una forma de consultar los metadatos actuales.

Las extensiones de actualización de metadatos, como ERC-4906, pueden ayudar a las aplicaciones a saber cuándo deben actualizar esos metadatos.

Los metadatos dinámicos deben ser transparentes.

Los usuarios deben saber qué puede cambiar, quién puede hacerlo y si los cambios están controlados por contratos inteligentes o servidores centralizados.

Extensiones de metadatos e inmutabilidad

Las extensiones de metadatos no hacen que los metadatos sean inmutables automáticamente.

Un contrato de token puede admitir tokenURI y, aun así, permitir que el propietario del proyecto cambie posteriormente el URI base.

Esto significa que los metadatos visibles del NFT pueden cambiar aunque el token siga existiendo on-chain.

La inmutabilidad de los metadatos depende del diseño del contrato, del tipo de almacenamiento y de los permisos de administración.

Si un proyecto busca una mayor inmutabilidad, puede bloquear el URI base, utilizar almacenamiento direccionado por contenido, guardar los metadatos on-chain o eliminar los permisos de actualización del administrador.

Los usuarios no deben dar por hecho que una extensión de metadatos implica que estos sean permanentes.

Deben comprobar si se puede cambiar el URI de metadatos y si los archivos se almacenan de forma duradera.

Ventajas de las extensiones de metadatos

La primera ventaja es una mejor experiencia de usuario.

Las carteras y los mercados pueden mostrar nombres, imágenes, descripciones y características automáticamente.

La segunda ventaja es la interoperabilidad.

Distintas aplicaciones pueden consultar la información de los tokens a través de interfaces compartidas.

La tercera ventaja es la compatibilidad con los mercados.

Los metadatos estandarizados facilitan la publicación, búsqueda, filtrado y negociación de NFT.

La cuarta ventaja es una mayor eficiencia para los desarrolladores.

Los desarrolladores pueden trabajar con interfaces conocidas en lugar de crear sistemas de metadatos personalizados.

La quinta ventaja es un diseño de activos más completo.

Los juegos, las aplicaciones del metaverso y los proyectos de creadores pueden vincular información detallada a activos tokenizados.

Riesgos de las extensiones de metadatos

El primer riesgo son los enlaces de metadatos rotos.

Si un tokenURI apunta a un archivo que no existe, es posible que el NFT no se muestre correctamente.

El segundo riesgo son los metadatos editables.

Si el propietario del contrato puede cambiar el URI, el activo podría mostrar contenido distinto más adelante.

El tercer riesgo son los metadatos falsos.

Los estafadores pueden copiar imágenes, características y descripciones de colecciones auténticas.

El cuarto riesgo son los enlaces externos maliciosos.

Los metadatos pueden incluir URL que dirijan a los usuarios a sitios web no seguros.

El quinto riesgo es la compatibilidad desigual entre aplicaciones.

Distintas carteras y mercados pueden interpretar los campos de metadatos de maneras distintas.

El sexto riesgo son las suposiciones falsas.

Los usuarios pueden pensar que la compatibilidad con metadatos significa que el NFT es auténtico, permanente o valioso, pero las extensiones de metadatos no garantizan ninguna de estas cosas.

Cómo evaluar una extensión de metadatos

Empieza por comprobar qué estándar de token utiliza el contrato.

Revisa si el contrato admite metadatos ERC-721, metadatos ERC-1155, eventos de actualización ERC-4906 o metadatos a nivel de contrato, como ERC-7572.

Comprueba si tokenURI o uri devuelve un enlace de metadatos que funciona.

Revisa si los metadatos utilizan campos comunes, como name, description, image y attributes.

Comprueba si los archivos multimedia están almacenados en HTTPS, IPFS, Arweave o mediante datos on-chain.

Busca funciones de administración que permitan cambiar el URI base o el URI del token.

Comprueba si los metadatos están congelados, son dinámicos o se pueden actualizar.

Verifica la dirección oficial del contrato antes de confiar en los metadatos que se muestran.

En el caso de los NFT de valor elevado, el diseño de los metadatos debe formar parte de las comprobaciones previas a la compra.

Malentendidos habituales sobre las extensiones de metadatos

Un malentendido habitual es creer que una extensión de metadatos almacena todas las ilustraciones de los NFT on-chain.

En muchos casos, la extensión solo devuelve un URI que apunta a metadatos almacenados en otro lugar.

Otro malentendido es creer que la compatibilidad con metadatos demuestra la autenticidad.

Un NFT falso también puede tener metadatos, por lo que los usuarios deben verificar la dirección oficial del contrato.

Un tercer malentendido es pensar que tokenURI significa que los metadatos no pueden cambiar.

Los metadatos todavía pueden cambiar si el contrato o el sistema de almacenamiento permiten actualizaciones.

Un cuarto malentendido es suponer que todas las aplicaciones muestran los metadatos de la misma manera.

Distintas carteras, mercados y juegos pueden admitir campos de metadatos diferentes.

Un quinto malentendido es creer que los metadatos dinámicos siempre son inseguros.

Los metadatos dinámicos pueden ser útiles cuando las reglas de actualización son transparentes y coherentes con el propósito del activo.

Preguntas frecuentes

¿Qué es una extensión de metadatos en cripto?

Una extensión de metadatos es una función de un contrato de token que permite a las aplicaciones acceder a información descriptiva sobre un activo cripto.

¿Qué es la extensión de metadatos ERC-721?

La extensión de metadatos ERC-721 es una interfaz opcional que añade las funciones name, symbol y tokenURI a los NFT ERC-721.

¿Para qué sirve tokenURI?

tokenURI devuelve el URI de metadatos de un ID de NFT concreto para que las aplicaciones puedan obtener los metadatos del token.

¿Una extensión de metadatos es lo mismo que un URI de metadatos?

No. La extensión de metadatos es la interfaz o función del contrato, mientras que el URI de metadatos es el enlace que devuelve esa función.

¿ERC-1155 admite metadatos?

Sí. ERC-1155 incluye un sistema de URI de metadatos y un esquema JSON para activos mult token.

¿Qué es ERC-4906?

ERC-4906 es una extensión de actualización de metadatos que define eventos estándar para notificar a las aplicaciones cuando cambian los metadatos de un NFT.

¿Una extensión de metadatos hace que los metadatos sean inmutables?

No. La inmutabilidad depende del diseño del almacenamiento, los permisos del contrato inteligente y la posibilidad de cambiar el URI de metadatos.

¿Se puede utilizar una extensión de metadatos para activos del metaverso?

Sí. Las extensiones de metadatos pueden ayudar a describir terrenos virtuales, prendas, avatares, pases para eventos, objetos de juegos y otros activos del metaverso.

¿Por qué necesitan extensiones de metadatos los mercados?

Los mercados utilizan extensiones de metadatos para mostrar nombres, imágenes, características, descripciones e información de las colecciones de NFT.

¿Qué deben comprobar los usuarios antes de confiar en los metadatos de un NFT?

Los usuarios deben verificar la dirección del contrato, el URI de metadatos, el método de almacenamiento, los permisos de actualización, el estado de bloqueo y la autenticidad del proyecto.

Conclusión

Una extensión de metadatos es un concepto importante en cripto porque conecta los tokens blockchain con los datos descriptivos que necesitan los usuarios y las aplicaciones.

En los NFT, la extensión de metadatos ERC-721 permite mostrar nombres de colecciones, símbolos y URI de metadatos específicos de cada token.

En los sistemas mult token, la compatibilidad con metadatos de ERC-1155 ayuda a los juegos, las plataformas del metaverso y las aplicaciones a gestionar eficientemente muchos tipos de activos.

Las extensiones de actualización de metadatos, como ERC-4906, ayudan a los NFT dinámicos a comunicar los cambios a las carteras y los mercados.

Los estándares de metadatos a nivel de contrato, como ERC-7572, ayudan a las aplicaciones a mostrar información más amplia sobre una colección o un contrato.

Las extensiones de metadatos mejoran la facilidad de uso, la interoperabilidad, la visualización en los mercados y el descubrimiento de activos.

Sin embargo, no garantizan automáticamente la autenticidad, la permanencia, la seguridad ni el valor.

Antes de confiar en un activo cripto o comprarlo, los usuarios deben saber dónde se almacenan los metadatos, si pueden modificarse y si el contrato es oficial.