Metadatos on-chain

¿Qué son los metadatos on-chain?

Los metadatos on-chain son información descriptiva sobre un activo cripto, un contrato inteligente, un NFT, un token, un objeto de wallet o un registro basado en blockchain que se almacena directamente en una blockchain, en lugar de limitarse a un servidor externo.

En pocas palabras, los metadatos explican qué es un activo de blockchain, mientras que los metadatos on-chain indican que esa explicación reside en el estado de la blockchain, los datos de transacción, el almacenamiento del contrato, los registros de eventos o la salida codificada del contrato.

En un NFT, los metadatos pueden incluir el nombre, la descripción, la referencia a la imagen, los atributos, los rasgos de rareza, el archivo de animación, un enlace externo, los datos del creador, los detalles de la licencia o las propiedades de un juego.

En un contrato de token, los metadatos pueden incluir el nombre, el símbolo, el logotipo, la descripción, el sitio web, los colaboradores o la información de visualización.

En un contrato inteligente, los metadatos pueden incluir la identidad del contrato, información del proyecto, detalles de la versión, referencias al esquema y enlaces a recursos relacionados.

El término es importante porque muchos activos cripto solo registran la propiedad on-chain y almacenan el archivo descriptivo o los medios en otro lugar.

Los metadatos on-chain intentan reducir esa dependencia externa al conservar más información sobre la identidad del activo dentro de la propia blockchain.

El estándar ERC-721 define una extensión opcional de metadatos en la que tokenURI puede apuntar a un archivo JSON con campos de nombre, descripción e imagen.

El estándar ERC-1155 permite que cada ID de token represente un tipo de token configurable con sus propios metadatos, oferta y atributos.

Los metadatos on-chain son especialmente importantes para los NFT, los activos tokenizados, los objetos de videojuegos, los registros de identidad digital, los activos de DAO, los proyectos de coleccionables y cualquier objeto cripto en el que sea importante la verificabilidad a largo plazo.

Ideas clave sobre los metadatos on-chain

• • Los metadatos on-chain son información sobre un activo almacenada directamente en una blockchain o devuelta directamente por un contrato inteligente.
  • Pueden describir NFT, tokens fungibles, contratos inteligentes, colecciones, tokens de activos del mundo real, objetos de juego, credenciales de identidad y registros de DAO.
  • Los campos habituales incluyen el nombre, la descripción, la imagen, la animación, los atributos, los enlaces externos, los rasgos, los niveles, los datos del creador y la información de la colección.
  • Los metadatos íntegramente on-chain pueden mejorar la permanencia, la auditabilidad y la resistencia a la censura.
  • Los metadatos on-chain pueden ser caros porque el almacenamiento y el procesamiento de blockchain son recursos limitados.
  • Muchos proyectos de NFT utilizan metadatos híbridos: el token y el URI están on-chain, mientras que el JSON o los medios se almacenan en IPFS, Arweave u otra capa de almacenamiento.
  • Los metadatos pueden ser estáticos, modificables, dinámicos, sellados o generados íntegramente mediante la lógica de un contrato inteligente.
  • Los estándares de metadatos ayudan a wallets, exploradores, juegos, indexadores y aplicaciones a mostrar los activos de forma coherente.
  • Los metadatos on-chain no demuestran automáticamente la titularidad de los derechos de autor, la originalidad artística, los derechos legales ni el valor de inversión.
  • Antes de comprar, acuñar o confiar en un activo tokenizado, los usuarios deben verificar dónde se almacenan los metadatos y los medios.

Cómo funcionan los metadatos on-chain

Los metadatos on-chain funcionan incorporando datos descriptivos o la lógica para recuperar metadatos en una transacción de blockchain o un contrato inteligente.

Un contrato sencillo puede almacenar una cadena de texto con todos los metadatos en formato JSON.

Otro contrato puede devolver un URI de datos codificado en Base64 que incluya directamente los metadatos.

También puede generar metadatos dinámicamente a partir del ID del token, los datos del bloque, el estado del juego u otras variables del contrato.

Otro contrato puede almacenar únicamente un URI on-chain, mientras que el archivo de metadatos propiamente dicho permanece off-chain.

Este último método es habitual, pero no se considera metadatos íntegramente on-chain, ya que el JSON descriptivo sigue dependiendo de otra ubicación de almacenamiento.

Un NFT íntegramente on-chain puede devolver todos los metadatos esenciales desde el propio contrato, sin depender de un sitio web normal ni de un servidor central.

Un NFT híbrido puede mantener on-chain la propiedad y un enlace direccionado por contenido, mientras almacena las imágenes o los vídeos de gran tamaño fuera de la blockchain.

La contrapartida suele ser el coste frente a la permanencia.

Almacenar todo on-chain puede ofrecer más durabilidad, pero también resultar mucho más caro y menos flexible.

Metadatos on-chain frente a metadatos off-chain

Los metadatos on-chain se almacenan o generan directamente mediante la infraestructura de blockchain.

Los metadatos off-chain se guardan fuera de la blockchain y se referencian mediante una URL, un endpoint de API, un enlace a almacenamiento descentralizado u otro puntero externo.

Por ejemplo, un contrato de NFT puede almacenar un tokenURI que apunte a un archivo JSON alojado en un sitio web.

En ese caso, la propiedad del token está on-chain, pero el archivo de metadatos está off-chain.

Si el sitio web desaparece, modifica el archivo, bloquea el acceso o devuelve datos incorrectos, la visualización del NFT puede dejar de funcionar.

Si los metadatos se almacenan directamente en el contrato, el activo depende menos del sitio web.

Los metadatos off-chain pueden ser más baratos y fáciles de actualizar.

Los metadatos on-chain pueden ser más transparentes y duraderos.

Ninguno de los dos modelos es perfecto para todos los casos de uso.

Un buen diseño de activos elige el modelo de almacenamiento que se adapta a su propósito, límites de coste, necesidades legales y vida útil prevista.

Metadatos on-chain frente a medios on-chain

Los metadatos y los medios están relacionados, pero no son lo mismo.

Los metadatos son la información descriptiva del activo.

Los medios son la imagen, animación, audio, vídeo, modelo 3D o archivo interactivo que los usuarios ven o utilizan.

Un NFT puede almacenar los metadatos on-chain y apuntar a medios off-chain.

Otro NFT puede almacenar tanto los metadatos como los medios íntegramente on-chain.

Un tercer NFT puede no almacenar ninguno de los dos íntegramente on-chain y guardar únicamente una URL que apunta a un servidor.

Esta distinción es importante porque un proyecto puede anunciar metadatos on-chain y seguir dependiendo de medios off-chain.

Por ejemplo, el contrato puede devolver un objeto JSON on-chain, pero el campo de imagen de ese JSON puede apuntar a IPFS u otro sistema de almacenamiento.

Esto puede seguir siendo un diseño sólido si los medios utilizan almacenamiento persistente y direccionado por contenido.

Sin embargo, los usuarios deben entender exactamente qué partes están on-chain y cuáles son externas.

Metadatos ERC-721

ERC-721 es el estándar de NFT más conocido de los sistemas de contratos inteligentes basados en Ethereum.

La extensión de metadatos ERC-721 incluye las funciones name, symbol y tokenURI.

La función tokenURI devuelve un URI para un ID de token específico.

Ese URI puede apuntar a un archivo JSON que siga el esquema JSON de metadatos ERC-721.

El estándar describe campos habituales como name, description e image.

En un diseño íntegramente on-chain, tokenURI puede devolver un URI de datos que contenga directamente el JSON, en lugar de apuntar a un archivo externo.

Esto permite que wallets y aplicaciones lean los metadatos sin obtenerlos de una URL externa tradicional.

Sin embargo, no todas las interfaces son compatibles por igual con todos los formatos on-chain avanzados.

Los desarrolladores deben probar cómo muestran los metadatos las wallets, los exploradores y las aplicaciones.

Un estándar puede definir la estructura, pero la visualización real depende de la compatibilidad del software.

Metadatos ERC-1155

ERC-1155 es un estándar multitoken que puede representar activos fungibles, no fungibles y semifungibles en un mismo contrato.

El estándar permite que cada ID de token represente un tipo de token distinto.

Cada tipo puede tener sus propios metadatos, oferta y atributos.

Esto hace que ERC-1155 resulte útil para juegos, coleccionables, membresías, ediciones, recompensas y colecciones de activos con muchos tipos de objetos.

Los metadatos ERC-1155 suelen utilizar un patrón de URI en el que el ID del token se inserta en la ruta de los metadatos.

Esto puede hacer más eficientes las colecciones grandes, ya que un solo contrato puede gestionar muchos tokens.

Los metadatos on-chain para ERC-1155 pueden ser útiles cuando los objetos o las ediciones de un juego necesitan una identidad duradera.

También pueden resultar caros si cada objeto contiene muchos campos únicos.

Los desarrolladores pueden almacenar las propiedades esenciales on-chain y utilizar almacenamiento direccionado por contenido para los archivos más grandes.

El mejor diseño depende de la frecuencia con que cambien los metadatos y de la cantidad de datos que necesite cada token.

Metadatos a nivel de contrato

Los metadatos a nivel de contrato describen el contrato inteligente o la colección en sí, y no un ID de token específico.

Pueden incluir el nombre de la colección, su descripción, imagen de perfil, imagen de banner, imagen destacada, sitio web, colaboradores y otros datos de visualización.

El borrador del estándar ERC-7572 contractURI propone una función contractURI para devolver metadatos a nivel de contrato.

ERC-7572 indica que la cadena devuelta puede ser un recurso off-chain o una cadena de datos JSON on-chain.

Esto es importante porque muchas aplicaciones necesitan información sobre la colección, no solo sobre cada token.

Una wallet puede querer mostrar el logotipo de una colección.

Un explorador puede querer mostrar la descripción de un contrato.

Un panel de DAO puede querer mostrar el contexto verificado del proyecto.

Los metadatos a nivel de contrato pueden mejorar la facilidad de uso cuando son precisos y están controlados de forma segura.

También pueden generar riesgos si un atacante puede actualizar la descripción, la imagen o la lista de colaboradores del contrato sin los permisos adecuados.

ERC-8049 y los nuevos desarrollos de metadatos on-chain

El borrador de la propuesta ERC-8049 define un estándar para almacenar metadatos a nivel de contrato on-chain.

Amplía el concepto de metadatos a nivel de contrato con una interfaz de almacenamiento on-chain basada en claves de texto y valores de bytes.

Este tipo de propuesta muestra que los estándares de metadatos siguen evolucionando.

Los patrones más antiguos de metadatos de tokens suelen centrarse en enlaces tokenURI.

Los desarrollos más recientes exploran la identidad del contrato, la compatibilidad entre cadenas, el almacenamiento predecible, los eventos de actualización de metadatos y una mejor localización de activos para wallets y exploradores.

Como ERC-8049 figura como borrador, los desarrolladores no deben considerarlo un requisito universal definitivo.

Aun así, pueden estudiarlo para entender hacia dónde podría dirigirse el diseño de metadatos.

La tendencia general está clara.

Las aplicaciones cripto necesitan formas más fiables de averiguar qué es un contrato, qué representa, quién puede actualizar sus datos de visualización y dónde se almacena esa información.

Los metadatos on-chain son cada vez más importantes a medida que las blockchains admiten aplicaciones más complejas que las simples transferencias.

Eventos de actualización de metadatos

En algunos proyectos, los metadatos pueden cambiar.

Un objeto de juego puede subir de nivel.

El estado de un token de membresía puede cambiar.

Un NFT dinámico puede modificar su aspecto en función del tiempo, los logros o los datos de un oráculo.

La extensión de actualización de metadatos ERC-4906 añade los eventos MetadataUpdate y BatchMetadataUpdate para tokens ERC-721.

Estos eventos ayudan a las aplicaciones a saber cuándo deben actualizar los metadatos de un token.

Esto resulta útil porque los indexadores y las wallets pueden almacenar metadatos en caché para reducir las consultas repetidas.

Si los metadatos cambian y no se emite ninguna señal, los usuarios pueden ver información desactualizada.

Los eventos de actualización ofrecen una vía más sencilla para gestionar metadatos dinámicos.

También hacen que el control de permisos sea importante, ya que las actualizaciones no autorizadas pueden dañar la confianza.

NFT con varios metadatos

Algunos NFT necesitan más de un URI de metadatos.

Un token puede tener distintos formatos de visualización para diferentes pantallas.

Una obra colaborativa puede incluir varias versiones de artistas.

Un objeto de juego puede tener un historial de mejoras.

Un activo del mundo real tokenizado puede necesitar metadatos actuales, archivados y de cumplimiento.

La extensión de metadatos múltiples ERC-7160 propone admitir varios URI de metadatos por token ERC-721 y fijar un URI principal.

Esto demuestra que los metadatos ya no son siempre un único archivo estático.

A medida que los activos cripto se vuelven más complejos, los metadatos pueden necesitar historial, versiones y opciones de visualización seleccionables por el usuario.

Los diseños con varios metadatos pueden aumentar la flexibilidad.

También pueden generar confusión si los usuarios no saben qué versión es oficial, actual, archivada o seleccionada por ellos.

Metadatos estáticos

Los metadatos estáticos son metadatos que no cambian después de la acuñación o de una revelación definitiva.

Son habituales en obras de arte fijas, coleccionables, registros históricos y tokens cuyo valor depende de la permanencia.

Los metadatos estáticos pueden almacenarse íntegramente on-chain, quedar sellados mediante un contrato inteligente o fijarse en un almacenamiento direccionado por contenido.

Los coleccionistas suelen preferir metadatos estáticos cuando quieren tener la certeza de que el activo no cambiará más adelante.

Los metadatos estáticos facilitan la verificación porque los campos previstos permanecen estables.

También pueden reducir el riesgo operativo al no existir una autoridad con permiso continuo para actualizar los metadatos.

La desventaja es que los errores pueden ser permanentes.

Si se confirma un error tipográfico, una imagen equivocada, un atributo incorrecto o un enlace roto, puede resultar difícil o imposible corregirlo.

Los metadatos estáticos funcionan mejor cuando el proyecto los revisa exhaustivamente antes de acuñar los tokens.

La finalidad solo es valiosa si los datos definitivos son correctos.

Metadatos dinámicos

Los metadatos dinámicos cambian con el tiempo.

Pueden resultar útiles para juegos, programas de fidelización, arte evolutivo, coleccionables deportivos, activos del mundo real, credenciales de identidad y sistemas de logros.

Un NFT dinámico puede cambiar de aspecto cuando un usuario completa una misión.

Un activo tokenizado puede actualizar su valoración, estado, registros de inspección o información sobre su vencimiento.

El nivel de un token de membresía puede cambiar cuando un usuario alcanza un nuevo tramo de contribución.

Los metadatos dinámicos pueden hacer que los activos de blockchain sean más útiles e interactivos.

También plantean cuestiones de confianza.

¿Quién puede actualizar los metadatos?

¿Qué reglas rigen las actualizaciones?

¿Puede el titular verificar el historial de actualizaciones?

¿Puede el emisor cambiar rasgos importantes después de la venta?

Los metadatos dinámicos deben contar con permisos, eventos, registros de auditoría y expectativas de los usuarios claramente definidos.

Metadatos íntegramente on-chain

Los metadatos íntegramente on-chain son aquellos cuyos campos descriptivos esenciales se almacenan o generan directamente mediante el contrato de blockchain.

Esto puede hacerse mediante el almacenamiento del contrato, cadenas de texto codificadas, SVG generados, JSON codificado en Base64 o lógica determinista de representación.

Los metadatos íntegramente on-chain pueden hacer que un activo sea más duradero porque no depende de un servidor web normal.

También pueden hacerlo más transparente, ya que los usuarios pueden inspeccionar el contrato y verificar cómo se generan los metadatos.

El arte generativo íntegramente on-chain es un ejemplo destacado.

El contrato puede crear la imagen y los metadatos a partir del ID del token, valores semilla o rasgos almacenados.

Este método puede facilitar la conservación a largo plazo.

Su principal inconveniente es el coste.

Cada byte almacenado on-chain consume recursos escasos de la blockchain.

Almacenar íntegramente on-chain imágenes grandes, vídeos y metadatos complejos puede resultar caro o poco práctico.

Metadatos híbridos

Los metadatos híbridos combinan almacenamiento on-chain y off-chain.

Es el modelo práctico más habitual en muchos sistemas de NFT y tokens.

El contrato puede almacenar on-chain la propiedad del token, el ID del token y un URI de metadatos.

El URI puede apuntar a IPFS, Arweave, HTTPS u otro sistema de almacenamiento.

El archivo multimedia puede almacenarse separado de los metadatos JSON.

Este método reduce los costes de blockchain y, a la vez, permite localizar el activo mediante un registro en la blockchain.

La solidez del diseño depende del método de almacenamiento externo.

Una URL web normal puede dejar de funcionar si caduca el dominio o se elimina el servidor.

Un CID de IPFS direccionado por contenido puede ayudar a los usuarios a verificar que el contenido no ha cambiado.

La guía de IPFS sobre datos de NFT recomienda planificar cómo se almacenan, direccionan y conservan los datos de NFT a lo largo del tiempo.

Direccionamiento por contenido y metadatos

El direccionamiento por contenido consiste en identificar un archivo mediante una referencia criptográfica a su contenido, en lugar de mediante la ubicación modificable de un servidor.

IPFS utiliza identificadores de contenido, también llamados CID, para identificar el contenido.

Si el archivo cambia, también cambia el CID.

Esto hace que el direccionamiento por contenido resulte útil para los metadatos de NFT, ya que los usuarios pueden detectar si se ha sustituido un archivo.

Un tokenURI que apunta a un CID de IPFS puede ser más sólido que uno que apunta únicamente a una URL web normal.

Sin embargo, el direccionamiento por contenido no garantiza automáticamente la disponibilidad.

Alguien debe fijar, alojar o conservar el contenido para que pueda recuperarse.

Por eso, el diseño del almacenamiento debe contemplar tanto la integridad como la persistencia.

La integridad significa que los datos no han cambiado.

La persistencia significa que los datos seguirán estando disponibles más adelante.

Metadatos Base64

Los metadatos Base64 son una forma habitual de devolver JSON o medios directamente desde un contrato inteligente.

Un contrato puede devolver un tokenURI que empiece con un URI de datos como data:application/json;base64.

El contenido codificado puede incluir el nombre, la descripción, la imagen y los atributos del NFT.

La propia imagen también puede estar codificada como SVG u otro formato de datos.

Este método es popular para los NFT íntegramente on-chain, ya que permite que el contrato devuelva todo lo necesario para su visualización.

También evita depender de un servidor externo de metadatos.

La desventaja es que los datos Base64 pueden aumentar el tamaño de la salida del contrato y hacer que resulte más difícil leerlos directamente.

También pueden incrementar el coste de gas si se almacenan valores grandes o se generan de forma ineficiente.

Los desarrolladores deben probar los metadatos Base64 en distintas wallets y exploradores.

Las diferentes interfaces pueden ofrecer distintos niveles de compatibilidad con imágenes codificadas, animaciones o campos poco habituales.

Metadatos on-chain para activos tokenizados del mundo real

Los activos del mundo real tokenizados necesitan un diseño cuidadoso de metadatos porque el token puede representar algo ajeno a la blockchain.

Los metadatos pueden describir una factura, una participación en un fondo, un bono, un registro de propiedad, un derecho sobre materias primas, un crédito de carbono, un coleccionable o un acuerdo legal.

Parte de esa información puede ser pública y adecuada para almacenarse on-chain.

Otra parte puede ser privada, estar regulada o contener datos personales sensibles.

Incluir datos legales o personales sensibles directamente on-chain puede ser peligroso, ya que los registros de una blockchain pública pueden ser muy difíciles de eliminar.

Un diseño mejor puede almacenar hashes, certificaciones, referencias a documentos o pruebas con permisos en la blockchain, mientras conserva los documentos privados en un almacenamiento controlado.

Los metadatos on-chain pueden favorecer la transparencia, pero no deben exponer información confidencial sin necesidad.

Los metadatos de activos del mundo real también necesitan control de versiones.

Las condiciones, el estado de las garantías, las fechas de vencimiento, las auditorías y los documentos legales pueden cambiar con el tiempo.

Los proyectos deben explicar claramente qué metadatos son autoritativos y cómo se rigen las actualizaciones.

Metadatos on-chain para juegos

Los juegos blockchain utilizan metadatos para describir objetos, personajes, aspectos, terrenos, armas, logros y consumibles.

Los metadatos on-chain pueden ayudar a los jugadores a verificar la escasez, los rasgos, la propiedad y el historial de un objeto.

Los metadatos dinámicos pueden permitir que un objeto evolucione a medida que el jugador lo utiliza.

Por ejemplo, una espada NFT puede ganar puntos de experiencia, un personaje NFT puede subir de nivel o un terreno NFT puede cambiar después de una construcción.

Los metadatos de juego íntegramente on-chain pueden mejorar la componibilidad, ya que otros contratos pueden leer directamente el estado del objeto.

Sin embargo, los juegos suelen necesitar imágenes grandes, cambios frecuentes de estado y una lógica compleja.

Almacenar todo eso directamente on-chain puede resultar demasiado caro.

Muchos juegos utilizan un modelo híbrido: la propiedad y los atributos esenciales están on-chain, mientras que los activos de gran tamaño se almacenan off-chain.

El mejor diseño de metadatos para juegos separa los rasgos permanentes de los datos de juego que cambian rápidamente.

Esto ayuda a equilibrar el coste, la velocidad y la confianza de los jugadores.

Metadatos on-chain para identidad digital

Los sistemas de identidad digital pueden utilizar metadatos para describir credenciales, certificaciones, insignias, membresías o registros de reputación.

Los metadatos on-chain pueden facilitar la verificación pública de una credencial.

También pueden entrañar riesgos para la privacidad si la información personal queda expuesta permanentemente.

Por lo general, una blockchain pública es un lugar poco adecuado para almacenar números de pasaporte, domicilios, datos de salud o registros legales privados sin procesar.

En su lugar, los sistemas de identidad suelen utilizar hashes, divulgación selectiva, pruebas de conocimiento cero, identificadores descentralizados o registros cifrados off-chain.

Los metadatos pueden describir el tipo de credencial sin revelar información sensible.

Por ejemplo, un registro on-chain puede demostrar que existe una credencial y que la ha emitido una autoridad conocida.

Los detalles privados pueden permanecer off-chain y mostrarse solo cuando sea necesario.

Los metadatos on-chain de identidad deben respetar el principio de minimización de datos.

La blockchain solo debe almacenar aquello que realmente necesite verificación pública.

Metadatos on-chain y procedencia

La procedencia es el historial de creación, propiedad, transferencia y modificación.

Los metadatos on-chain pueden ayudar a documentarla al hacer visibles en la blockchain los detalles y las actualizaciones de los activos.

En los NFT, la procedencia puede incluir la fecha de acuñación, la dirección del creador, el ID del token, el hash de los metadatos, el evento de revelación, el evento de actualización y el historial de transferencias.

En los activos tokenizados, puede incluir la emisión, las auditorías, los cambios de custodia, los reembolsos y las referencias a documentos.

Una procedencia sólida ayuda a los usuarios a verificar que un activo es lo que afirma ser.

Una procedencia débil puede dificultar la detección de copias, falsificaciones y activos engañosos.

Los metadatos por sí solos no demuestran la autenticidad.

Un estafador puede crear metadatos que afirmen representar una obra conocida o un activo real.

Los usuarios aún deben verificar el emisor, la dirección del contrato, el historial de acuñación y los derechos externos.

Los metadatos on-chain son una prueba, no una verdad automática.

Metadatos on-chain e inmutabilidad

La inmutabilidad significa que los datos son difíciles de cambiar una vez registrados on-chain.

Los metadatos inmutables pueden aumentar la confianza de los coleccionistas porque los campos importantes no pueden modificarse después.

También pueden proteger a los usuarios de cambios en los metadatos similares a un rug pull, en los que el activo mostrado se sustituye después de la venta.

Sin embargo, la inmutabilidad también puede dejar errores fijados para siempre.

Si los metadatos incluyen un enlace de imagen roto, un rasgo equivocado, un nombre mal escrito o una licencia incorrecta, quizá sea imposible corregirlos.

Los metadatos modificables permiten corregir errores, pero implican confiar en la autoridad que los actualiza.

Esto plantea una decisión de diseño.

Algunos proyectos deberían congelar los metadatos después de la revelación.

Otros deberían permitir actualizaciones conforme a una gobernanza transparente.

Otros pueden separar los rasgos esenciales inmutables de los campos de visualización modificables.

Metadatos on-chain y costes de gas

El coste de gas es una de las principales limitaciones de los metadatos on-chain.

Las blockchains públicas cobran comisiones porque el almacenamiento, el procesamiento y la gestión de transacciones son recursos limitados.

Almacenar una cadena corta puede ser asequible.

Almacenar una imagen grande, una animación larga o un archivo de metadatos complejo puede resultar caro.

Los desarrolladores suelen reducir los costes almacenando hashes, valores de rasgos compactos, lógica de generación SVG o enlaces direccionados por contenido en lugar de archivos grandes.

Las redes de capa 2 pueden reducir los costes de algunas operaciones con metadatos, pero no hacen que el almacenamiento sea gratuito.

El coste también afecta a los usuarios.

Si las actualizaciones de metadatos requieren transacciones, los usuarios o los operadores del proyecto pueden tener que pagar comisiones cada vez que cambien los datos.

Un diseño de metadatos que parece adecuado en las pruebas puede encarecerse a gran escala.

Planificar un almacenamiento eficiente forma parte de un buen diseño de contratos inteligentes.

Metadatos on-chain e indexadores

Los indexadores son servicios que leen datos de la blockchain y los organizan para las aplicaciones.

Las wallets, los exploradores, los juegos y los paneles suelen depender de indexadores para mostrar los metadatos con rapidez.

Aunque los metadatos estén on-chain, las aplicaciones siguen necesitando saber cómo encontrarlos, decodificarlos, almacenarlos en caché y actualizarlos.

Las funciones y los eventos estándar ayudan a que los indexadores funcionen de forma fiable.

Por ejemplo, tokenURI ayuda a los indexadores a encontrar metadatos de un token concreto.

contractURI puede ayudarles a encontrar metadatos a nivel de contrato.

Los eventos MetadataUpdate pueden indicar a los indexadores cuándo deben actualizar los datos almacenados en caché.

Sin estándares, cada proyecto puede necesitar una lógica de indexación personalizada.

Eso dificulta la visualización de los activos y aumenta la posibilidad de interpretarlos mal.

Los estándares de metadatos mejoran la interoperabilidad en el ecosistema cripto.

Metadatos on-chain y visualización en wallets

Las wallets utilizan metadatos para mostrar a los usuarios qué poseen.

Una wallet puede mostrar el nombre del token, el nombre de la colección, la imagen, el símbolo, la descripción, los rasgos, el saldo, la dirección del contrato y la red.

Si los metadatos faltan o están dañados, la wallet puede mostrar una imagen en blanco, un token desconocido o un marcador genérico.

Si los metadatos son engañosos, un usuario puede aprobar o intercambiar el activo equivocado.

Esto convierte los metadatos en una cuestión de seguridad para los usuarios, no solo de diseño.

Las wallets deberían mostrar las direcciones de los contratos y señales de alerta cuando los metadatos parezcan sospechosos.

Los desarrolladores deberían evitar metadatos que dependan de servidores frágiles o formatos de archivo poco claros.

Los usuarios no deberían confiar en un activo únicamente porque la imagen que aparece en la wallet les resulte familiar.

Los estafadores pueden copiar nombres, imágenes y descripciones.

La dirección del contrato y el historial del emisor suelen ser más importantes que los metadatos mostrados.

Metadatos on-chain y seguridad

Los metadatos on-chain pueden mejorar la seguridad al reducir la dependencia de servidores externos modificables.

También pueden crear nuevos problemas de seguridad si la lógica de actualización es débil.

La clave del propietario de un proyecto que permita actualizar metadatos se convierte en un objetivo importante.

Si esa clave se ve comprometida, un atacante puede cambiar imágenes, descripciones, enlaces o datos de visualización del contrato.

Los enlaces de metadatos también pueden dirigir a los usuarios a páginas de phishing, archivos maliciosos o afirmaciones falsas.

Los contratos inteligentes deben limitar las funciones de actualización de metadatos mediante controles de acceso claros.

Los proyectos deben indicar si los metadatos pueden cambiarse.

Deben explicar quién puede modificarlos y en qué condiciones.

Los usuarios deben tener cuidado con los enlaces externos incluidos en los metadatos o con las instrucciones que estos contengan.

Los metadatos legibles pueden influir en el comportamiento del usuario, por lo que deben considerarse parte de la superficie de seguridad.

Metadatos on-chain y derechos de autor

Los metadatos on-chain no conceden automáticamente derechos de autor, derechos de marca ni derechos comerciales.

Un NFT puede incluir un campo de imagen, pero eso no demuestra que quien lo acuñó sea titular de la obra.

Un token puede describir un activo del mundo real, pero eso no demuestra automáticamente su titularidad legal.

Los metadatos pueden indicar condiciones de licencia, nombres de creadores o enlaces externos.

Esas afirmaciones siguen necesitando respaldo jurídico y factual.

Los compradores deben comprobar la licencia del proyecto, el emisor, la dirección del contrato, el historial de acuñación y la documentación oficial.

En el caso de los activos de valor, los acuerdos legales pueden ser más importantes que el texto de los metadatos.

Los metadatos on-chain son excelentes para registrar afirmaciones.

No equivalen a demostrar que todas las afirmaciones sean jurídicamente válidas.

No se deben confundir la propiedad digital y los derechos de propiedad intelectual.

Metadatos on-chain y privacidad

Cualquiera puede consultar los metadatos públicos on-chain.

Esto resulta útil para la transparencia, pero entraña riesgos para la información privada.

Una vez que los datos sensibles se escriben en una blockchain pública, puede ser muy difícil eliminarlos.

Los metadatos no deben exponer datos de identidad personal salvo que exista una razón de peso y un consentimiento claro.

Incluso los metadatos que parecen inocuos pueden volverse sensibles al combinarse con el historial de una wallet.

Por ejemplo, una insignia de membresía puede revelar dónde trabaja una persona, a qué comunidad se ha unido o a qué evento ha asistido.

Los sistemas de identidad y credenciales deben evitar almacenar datos personales sin cifrar directamente on-chain.

Deberían valorar el uso de hashes, compromisos criptográficos, almacenamiento cifrado, acceso con permisos o pruebas de conocimiento cero.

La permanencia de los metadatos es poderosa.

Debe utilizarse con cuidado.

Metadatos on-chain y activos generados por IA

El arte, la música, los personajes y los activos de juego generados por IA hacen que el diseño de metadatos sea más importante.

Los metadatos pueden describir el historial de prompts, la versión del modelo, la fecha de generación, la wallet del creador, las condiciones de licencia y las notas de procedencia.

Algunos proyectos pueden almacenar esta información on-chain para aumentar la transparencia.

Otros pueden almacenar únicamente un hash o una referencia porque el registro completo de generación es voluminoso.

Los metadatos on-chain pueden ayudar a demostrar cuándo se acuñó un activo generado y qué contrato lo emitió.

No pueden demostrar automáticamente que el contenido sea original, no infrinja derechos o haya sido creado por una persona.

A medida que crezcan los activos cripto generados por IA, los metadatos deberían distinguir claramente entre las afirmaciones del creador, los datos generados por máquinas y los hechos verificados.

Unos buenos metadatos pueden reducir la confusión.

Unos malos metadatos pueden hacer que una procedencia falsa parezca oficial.

Los usuarios deben analizar con sentido crítico los metadatos, especialmente en los activos de gran valor.

Ventajas de los metadatos on-chain

La primera ventaja de los metadatos on-chain es la durabilidad.

Los datos almacenados directamente en la blockchain dependen menos de servidores externos.

La segunda es la verificabilidad.

Los usuarios pueden inspeccionar directamente los contratos inteligentes, los registros de transacciones y los datos devueltos por los metadatos.

La tercera es la resistencia a la censura.

Es más fácil retirar un sitio web normal que los datos incorporados a una blockchain descentralizada.

La cuarta es la procedencia.

Los cambios en los metadatos y los eventos de actualización pueden crear un historial visible.

La quinta es la componibilidad.

Otros contratos inteligentes pueden leer atributos on-chain y utilizarlos en juegos, DeFi, sistemas de identidad y herramientas de DAO.

La sexta es una menor dependencia de las plataformas.

Varias aplicaciones pueden mostrar los activos si siguen estándares comunes.

Riesgos y limitaciones de los metadatos on-chain

La primera limitación es el coste.

El almacenamiento en blockchain puede ser caro en comparación con el almacenamiento externo.

La segunda limitación es el tamaño.

A menudo no resulta práctico almacenar íntegramente on-chain imágenes grandes, vídeos y archivos complejos.

La tercera limitación es la permanencia de los errores.

Puede resultar difícil corregir metadatos incorrectos una vez confirmados definitivamente.

La cuarta limitación es la privacidad.

Los metadatos públicos pueden revelar información sensible.

La quinta limitación es la compatibilidad de visualización.

Algunas wallets y aplicaciones pueden no admitir todos los formatos de metadatos.

La sexta limitación es el riesgo de gobernanza.

Los metadatos modificables exigen confiar en quien controla las actualizaciones.

La séptima limitación son las afirmaciones falsas.

Los metadatos pueden afirmar una autenticidad, rareza o unos derechos que en realidad no están demostrados.

Errores habituales con los metadatos on-chain

Un error habitual es suponer que todos los NFT almacenan su imagen on-chain.

Muchos NFT almacenan la propiedad on-chain, pero guardan los medios en otro lugar.

Otro error es dar por hecho que un enlace de IPFS siempre estará disponible.

El contenido de IPFS también requiere un plan de persistencia.

Un tercer error es suponer que los metadatos inmutables siempre son mejores.

Los metadatos inmutables pueden dejar los errores fijados.

Un cuarto error es conceder a una wallet de administrador permisos ilimitados para actualizar metadatos sin informar de ello.

Un quinto error es almacenar información personal sensible en una blockchain pública.

Un sexto error es utilizar campos no estándar que las wallets y los indexadores no puedan leer.

Un séptimo error es tratar los metadatos como prueba de derechos legales.

Un octavo error es no emitir eventos de actualización para los metadatos dinámicos.

Un noveno error es depender de un servidor centralizado para activos anunciados como permanentes.

Un décimo error es no probar la representación de los metadatos en las wallets y los exploradores habituales.

Buenas prácticas para desarrolladores

Elige el modelo de almacenamiento de metadatos antes del despliegue.

Utiliza estándares de tokens consolidados, como ERC-721, ERC-1155, ERC-4906, ERC-7160 o estándares de metadatos a nivel de contrato, cuando se adapten al caso de uso.

Almacena on-chain los rasgos inmutables esenciales cuando la confianza a largo plazo sea importante.

Utiliza almacenamiento direccionado por contenido para los medios de gran tamaño cuando el almacenamiento íntegramente on-chain sea demasiado caro.

Emite eventos de actualización de metadatos cuando cambien los metadatos dinámicos.

Documenta si los metadatos son modificables, inmutables, de revelación diferida o se generan íntegramente on-chain.

Protege las funciones de actualización con controles de acceso sólidos.

Evita almacenar directamente datos personales sensibles en una blockchain pública.

Prueba tokenURI, contractURI, los URI de datos, los campos Base64 y los enlaces a medios en distintas aplicaciones.

Diseña esquemas de metadatos sencillos, coherentes y fáciles de procesar para los indexadores.

Buenas prácticas para los usuarios

Comprueba si los metadatos están íntegramente on-chain, direccionados por contenido o alojados en una URL normal.

Verifica la dirección del contrato antes de confiar en la imagen o el nombre que se muestra.

Busca documentación del proyecto que explique si los metadatos pueden modificarse.

Comprueba si el propietario del contrato puede cambiar los metadatos después de la acuñación.

Ten cuidado cuando los metadatos incluyan enlaces externos.

Entiende que la imagen del NFT que se muestra puede no coincidir con el registro de propiedad del token.

No supongas que los metadatos on-chain demuestran derechos de autor o derechos legales.

Cuando sea posible, utiliza exploradores de blockchain para inspeccionar tokenURI o contractURI.

En los activos de valor, verifica la persistencia de los medios y el historial del emisor.

Considera los metadatos una parte de la diligencia debida, no toda la verdad.

Cuándo resultan útiles los metadatos on-chain

Los metadatos on-chain resultan útiles cuando la permanencia es importante.

Son útiles cuando se quiere que un NFT o un token siga siendo comprensible aunque desaparezca un sitio web.

Son útiles para el arte generativo que puede producirse directamente mediante la lógica del contrato.

Son útiles para los juegos en los que los contratos inteligentes necesitan leer los atributos de los objetos.

Son útiles para los activos de DAO en los que las comunidades necesitan registros públicos.

Son útiles para los activos tokenizados que necesitan un estado transparente o referencias de auditoría.

Son útiles para los sistemas de identidad cuando solo se almacenan datos de verificación no sensibles.

Son útiles cuando muchas aplicaciones deben poder verificar los metadatos de forma independiente.

Son menos útiles para archivos privados grandes, medios pesados o información que quizá haya que eliminar.

Son menos útiles cuando el coste del almacenamiento importa más que la permanencia.

Metadatos on-chain en una frase

Los metadatos on-chain son datos descriptivos almacenados en una blockchain o generados por un contrato inteligente que ayudan a usuarios, wallets, exploradores y aplicaciones a entender qué representa un activo cripto o contrato sin depender por completo de servidores externos.

Preguntas frecuentes

¿Qué significan los metadatos on-chain?

Los metadatos on-chain son información descriptiva sobre un activo o contrato que se almacena directamente en una blockchain o devuelve directamente un contrato inteligente.

¿Todos los metadatos de NFT están on-chain?

No. Muchos NFT almacenan la propiedad on-chain, pero conservan los metadatos y los medios mediante URL externas, IPFS, Arweave u otros sistemas de almacenamiento.

¿Cuál es la diferencia entre metadatos y medios?

Los metadatos describen el activo, mientras que los medios son la imagen, animación, audio, vídeo o archivo real vinculado a él.

¿Qué es tokenURI?

tokenURI es una función habitual de ERC-721 que devuelve el URI de metadatos de un ID de token NFT específico.

¿Qué es contractURI?

contractURI es una función de metadatos a nivel de contrato que devuelve información de una colección o un contrato, como el nombre, la descripción y la imagen.

¿Por qué son caros los metadatos on-chain?

Son caros porque el almacenamiento y el procesamiento en una blockchain pública son recursos escasos que requieren pagar comisiones de transacción.

¿Se pueden modificar los metadatos on-chain?

Depende del diseño del contrato: algunos metadatos son inmutables, mientras que otros pueden actualizarse mediante cuentas autorizadas o reglas de contratos inteligentes.

¿Los metadatos de IPFS son lo mismo que los metadatos on-chain?

No. Los metadatos de IPFS suelen estar off-chain, aunque están direccionados por contenido; los metadatos on-chain se almacenan o generan directamente mediante el contrato de blockchain.

¿Los metadatos on-chain demuestran la titularidad de los derechos sobre una obra?

No. Los metadatos on-chain pueden registrar afirmaciones y referencias, pero los derechos legales dependen de los derechos de autor, las licencias, los contratos y la autoridad del emisor.

¿Por qué necesitan metadatos las wallets?

Las wallets necesitan metadatos para mostrar nombres, imágenes, descripciones, rasgos, información de la colección y otros detalles fáciles de entender para los usuarios.

¿Qué son los metadatos dinámicos?

Los metadatos dinámicos cambian con el tiempo debido a actualizaciones, el estado de un juego, los logros, los datos de oráculos o las reglas de los contratos.

¿Qué deben comprobar los usuarios antes de comprar un NFT?

Los usuarios deben comprobar la dirección del contrato, el método de almacenamiento de metadatos y medios, los permisos de actualización, el historial del emisor y los derechos legales vinculados al activo.

Conclusión

Los metadatos on-chain son un concepto fundamental para entender cómo los activos cripto se vuelven legibles, útiles y verificables.

Una blockchain puede demostrar que una wallet posee un token, pero los metadatos explican qué representa ese token.

En los NFT, los metadatos pueden definir el nombre, la imagen, la descripción y los rasgos que los usuarios ven en wallets y aplicaciones.

En los contratos inteligentes, pueden definir la identidad del contrato, el perfil de la colección, las imágenes de visualización y la información del proyecto.

En los activos tokenizados, pueden conectar los registros de blockchain con documentos del mundo real, derechos, estados o referencias de auditoría.

Almacenar metadatos on-chain puede mejorar la permanencia, la transparencia y la reducción de la confianza en terceros.

Puede reducir la dependencia de sitios web que podrían desaparecer o cambiar.

También puede hacer que los activos sean más componibles, ya que otros contratos y aplicaciones pueden leer directamente los metadatos.

Sin embargo, los metadatos on-chain no siempre son la mejor opción para todos los campos o archivos.

Almacenar directamente on-chain medios de gran tamaño puede ser caro.

Por lo general, la información privada no debe almacenarse en libros mayores públicos.

Los metadatos modificables pueden resultar útiles, pero requieren controles de actualización fiables.

Los metadatos inmutables pueden ser duraderos, pero también conservar los errores para siempre.

Los mejores sistemas de metadatos explican con claridad qué se almacena on-chain, qué se guarda en otro lugar y quién puede cambiarlo.

Utilizan estándares para que wallets, exploradores, juegos e indexadores puedan interpretar correctamente el activo.

Utilizan almacenamiento direccionado por contenido cuando no resulta práctico guardar todo on-chain.

Protegen los permisos de actualización y emiten eventos cuando cambian los metadatos.

Evitan confundir a los usuarios afirmando que los activos son permanentes cuando los archivos esenciales siguen dependiendo de servidores frágiles.

Para los usuarios, los metadatos on-chain deben formar parte de la diligencia debida antes de adquirir cualquier NFT o token.

No basta con que la imagen de una wallet sea atractiva.

La verdadera cuestión es dónde se encuentran los metadatos, quién los controla, si pueden cambiar y si el emisor posee los derechos que afirma tener.

En cripto, los metadatos no son solo decoración.

Son el puente entre la propiedad registrada en bruto en la blockchain y su significado comprensible para las personas.