Metadatos off-chain

¿Qué son los metadatos off-chain?

Los metadatos off-chain son información descriptiva sobre un activo cripto, NFT, token, contrato inteligente, objeto de juego, registro de identidad digital o activo del mundo real tokenizado. Se almacenan fuera de la blockchain, aunque un registro on-chain hace referencia a ellos.En pocas palabras, la blockchain puede registrar quién posee el token, mientras que el archivo de metadatos que explica qué representa se encuentra en otro lugar.En un NFT, los metadatos off-chain pueden incluir el nombre, la descripción, el enlace a una imagen o animación, los atributos, los rasgos de rareza, una URL externa, información de la colección, el texto de la licencia, las propiedades del juego o los datos del creador.En un contrato de token, pueden incluir logotipos, descripciones del proyecto, banners, enlaces a redes sociales y documentación, e información de visualización utilizada por wallets y exploradores.En un activo del mundo real tokenizado, pueden incluir documentos legales, informes de auditoría, referencias a colateral, archivos de valoración o información protegida mediante controles de identidad que no debería almacenarse públicamente on-chain.

El estándar ERC-721 define una extensión opcional de metadatos en la que tokenURI puede apuntar a un archivo JSON que describe el NFT.

El estándar ERC-1155 también define el comportamiento de las URI de metadatos para contratos de múltiples tokens, incluida la sustitución de URI por ID de token.

Los metadatos off-chain son habituales porque almacenar archivos grandes directamente en una blockchain puede ser caro e ineficiente.La contrapartida es que introducen riesgos de almacenamiento, disponibilidad, mutabilidad y confianza que los usuarios deberían conocer antes de depender de un activo.

Conclusiones clave sobre los metadatos off-chain

• Los metadatos off-chain son información de un activo almacenada fuera de la blockchain y referenciada mediante una URI, hash, puntero o función del contrato on-chain.
• Se utilizan ampliamente para NFT, activos de juegos, logotipos de tokens, perfiles de contratos, activos del mundo real tokenizados, credenciales y objetos coleccionables.
• Entre las opciones de almacenamiento habituales están los servidores HTTPS, IPFS, Arweave, el almacenamiento respaldado por Filecoin, la nube y las bases de datos privadas.
• Reducen los costes de blockchain porque los archivos JSON, las imágenes, los vídeos y los documentos voluminosos no necesitan almacenarse directamente en el contrato.
• Los principales riesgos son los enlaces rotos, el cierre de servidores, la pérdida de dominios, las modificaciones no autorizadas, un pinning deficiente, la censura, las filtraciones de privacidad y los metadatos engañosos.
• El almacenamiento direccionado por contenido, como IPFS, puede mejorar la integridad porque el identificador de contenido cambia cuando este cambia.
• La persistencia no equivale al direccionamiento por contenido: el archivo aún debe seguir disponible mediante pinning, alojamiento o almacenamiento permanente.
• Los metadatos dinámicos pueden ser útiles para juegos, NFT evolutivos, membresías y activos tokenizados, pero requieren controles de actualización sólidos.
• Los metadatos no demuestran automáticamente derechos de autor, propiedad legal, autenticidad ni valor del activo.
• Los usuarios siempre deberían comprobar dónde se almacenan los metadatos, quién puede modificarlos y si todavía se puede recuperar el contenido multimedia.

Cómo funcionan los metadatos off-chain

Normalmente, los metadatos off-chain parten de un contrato inteligente que almacena o devuelve una URI.La URI puede apuntar a un archivo JSON en una página web, un CID de IPFS, una transacción de Arweave, un objeto de almacenamiento descentralizado u otra ubicación externa de datos.Una wallet, un explorador, un marketplace, un juego o una herramienta analítica lee la URI de la blockchain.A continuación, la aplicación obtiene los metadatos de la ubicación externa.El archivo indica a la aplicación cómo mostrar el activo.Por ejemplo, tokenURI puede devolver un enlace a un archivo JSON con el nombre y la descripción del token, la URI de imagen y animación y sus atributos.La wallet utiliza ese JSON para mostrar al usuario la imagen y los rasgos del NFT.La blockchain confirma quién posee el ID del token.Los metadatos off-chain explican qué se supone que representa ese ID.Esta separación es potente, pero significa que el registro del token y el contenido descriptivo pueden estar sujetos a distintos supuestos de seguridad.

Metadatos off-chain frente a metadatos on-chain

Los metadatos off-chain se almacenan fuera de la blockchain.Los metadatos on-chain se almacenan o generan directamente mediante un contrato inteligente o una transacción de blockchain.Los metadatos off-chain suelen ser más baratos, fáciles de actualizar y adecuados para archivos grandes.Los metadatos on-chain suelen ser más duraderos y transparentes, y dependen menos de infraestructuras externas.Un NFT totalmente on-chain puede devolver todos sus metadatos clave directamente desde el contrato.Un NFT off-chain típico puede almacenar únicamente tokenURI on-chain y guardar el archivo JSON en otro lugar.Un NFT híbrido puede guardar on-chain rasgos inmutables importantes y almacenar off-chain los medios o metadatos ampliados.El modelo más adecuado depende de la finalidad del activo.El arte generativo permanente puede beneficiarse de metadatos on-chain.Un objeto de juego que se actualiza con frecuencia puede beneficiarse de metadatos off-chain controlados.Un token de un activo del mundo real puede necesitar documentos off-chain, ya que no conviene que los archivos legales privados sean públicos para siempre.

Por qué los proyectos cripto utilizan metadatos off-chain

Los proyectos cripto los utilizan porque las blockchains no están diseñadas para almacenar económicamente todos los archivos grandes.Las imágenes, vídeos, archivos de audio, modelos 3D, documentos legales y datos de juegos pueden ser mucho más voluminosos que los datos de una transacción normal.Almacenar esos datos directamente on-chain puede encarecer la acuñación y las actualizaciones.El almacenamiento off-chain permite mantener más pequeñas las transacciones de blockchain.También permite cargar contenido multimedia enriquecido sin obligar a cada nodo de la blockchain a almacenar archivos grandes.Además, los metadatos off-chain pueden ofrecer experiencias dinámicas.Un juego puede actualizar el nivel de un personaje.Un NFT de membresía puede cambiar de estado.Un activo tokenizado puede actualizar un documento de valoración.Una credencial puede apuntar a registros privados sin exponer información sensible en un registro público.La ventaja es la flexibilidad; el coste, confiar más en el sistema de almacenamiento y actualización.

Campos habituales de los metadatos off-chain

El campo más habitual es el nombre del activo.El campo de descripción explica qué representa.El campo de imagen apunta a un archivo visual.El campo animation_url puede apuntar a vídeo, audio, HTML o contenido interactivo cuando las aplicaciones lo admiten.El campo de atributos o propiedades describe rasgos, rareza, niveles, estadísticas, categorías o valores del juego.El campo external_url puede apuntar a la página del proyecto o del activo.Los metadatos del contrato pueden incluir el nombre y la descripción de la colección, el símbolo, la imagen de perfil, el banner, una imagen destacada, un enlace externo y los colaboradores.

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

Los campos de metadatos adecuados deben ser claros, coherentes y fáciles de analizar para wallets e indexadores.Unos metadatos mal diseñados pueden dificultar la visualización, verificación o comparación de activos.

Metadatos off-chain y tokenURI

tokenURI es una de las funciones más importantes para los metadatos de NFT.En ERC-721, tokenURI devuelve una URI distinta para un ID de token concreto.La URI puede apuntar a un archivo JSON que describe el NFT.En muchas colecciones, tokenURI apunta a un archivo off-chain en lugar de devolver los metadatos directamente desde el contrato.Este diseño abarata la acuñación y aporta flexibilidad al almacenamiento de medios.También crea dependencia del lugar donde se almacena el archivo JSON.Si el servidor desaparece, el token puede seguir existiendo on-chain, pero la imagen y la descripción podrían dejar de cargarse.Si cambia el archivo JSON, la representación del NFT puede cambiar aunque el ID del token siga siendo el mismo.Al evaluar la calidad de un NFT a largo plazo, conviene inspeccionar tokenURI.La URI puede revelar si el proyecto utiliza un servidor convencional, IPFS, Arweave u otro método de almacenamiento.

Metadatos off-chain y sustitución de URI de ERC-1155

ERC-1155 es un estándar de múltiples tokens que permite gestionar muchos tipos de tokens en un solo contrato.El patrón de URI de metadatos ERC-1155 puede incluir la cadena {id} como marcador de posición.El software cliente sustituye el marcador por el ID real del token en un formato hexadecimal normalizado.Así, una sola plantilla de URI puede servir para muchos ID de token.Por ejemplo, una ruta base puede apuntar a muchos archivos JSON de metadatos diferentes.Esto resulta útil para juegos, ediciones, sistemas de recompensas y colecciones con muchos tipos de objetos.También exige que los desarrolladores estructuren correctamente los archivos off-chain.Si el sistema para nombrar los archivos es incorrecto, las wallets pueden no encontrar los metadatos adecuados.Si se mueve o cambia la carpeta off-chain, muchos tokens pueden dejar de funcionar a la vez.Los metadatos ERC-1155 son eficientes, pero requieren una gestión cuidadosa del almacenamiento.

Metadatos off-chain e IPFS

IPFS es una de las opciones de almacenamiento más utilizadas para metadatos y medios de NFT off-chain.

La guía de datos de NFT de IPFS recomienda utilizar URI de IPFS para enlazar contratos inteligentes con datos externos almacenados en IPFS.

IPFS utiliza identificadores de contenido, también llamados CID, para identificar archivos por su contenido.Si el contenido cambia, también cambia el CID.Esto hace que IPFS sea más adecuado que una URL web normal para detectar manipulaciones.Una URI de IPFS puede dejar claro que el archivo está direccionado por contenido y no ligado a la ubicación de un servidor concreto.Sin embargo, IPFS no garantiza automáticamente que el contenido siga disponible para siempre.Los nodos que conservan una copia aún deben fijar, alojar o preservar los datos.La guía de IPFS explica que las copias obtenidas pueden ser temporales y eliminarse con el tiempo si no se fijan.Por eso, IPFS mejora la integridad, pero la persistencia también requiere planificación.

Metadatos off-chain y Arweave

Arweave es otra red de almacenamiento utilizada para metadatos y medios cripto.

La documentación de Arweave lo describe como almacenamiento permanente de información y una web descentralizada dentro de un registro abierto.

Algunos proyectos lo utilizan cuando quieren que los metadatos o los medios tengan un modelo de permanencia más sólido.Puede ser útil para arte, archivos, registros públicos, activos históricos y colecciones cuya disponibilidad a largo plazo forme parte de su compromiso.Desde la perspectiva de otra blockchain, Arweave sigue siendo una capa de almacenamiento externa.Si el contrato de un NFT en una cadena apunta a datos de Arweave, la propiedad se registra en una cadena y los medios o metadatos se almacenan mediante Arweave.Por tanto, respecto a la cadena principal del NFT, siguen siendo metadatos off-chain.Este diseño puede ser sólido si el enlace es estable y los datos se preservan.Aun así, los usuarios deberían verificar qué se almacena, cómo se referencia y si allí están los metadatos o solo los medios.Las afirmaciones de almacenamiento permanente deben comprobarse con cuidado, porque el lenguaje de marketing puede abarcar más que la configuración técnica real.

Metadatos off-chain y almacenamiento respaldado por Filecoin

El almacenamiento respaldado por Filecoin puede contribuir a mantener los metadatos y medios off-chain disponibles.IPFS y Filecoin suelen mencionarse juntos porque IPFS direcciona el contenido, mientras que Filecoin puede añadir acuerdos de almacenamiento e incentivos económicos para conservar los datos disponibles.Un proyecto puede utilizar CID de IPFS para direccionar el contenido y almacenamiento de Filecoin para preservarlo a más largo plazo.Esto puede ayudar a resolver la diferencia entre integridad y disponibilidad.La integridad significa que el archivo puede verificarse frente a su identificador de contenido.La disponibilidad significa que realmente se puede recuperar cuando los usuarios lo necesitan.Ambas son importantes para los metadatos off-chain.Un CID perfecto no sirve de nada si nadie almacena el archivo.Un servidor muy disponible no basta si el archivo puede modificarse sin que nadie lo advierta.Un diseño sólido busca ofrecer contenido verificable y una recuperación fiable.

Metadatos HTTPS

Los metadatos HTTPS utilizan una URL web convencional como ubicación.Son fáciles de implementar para los desarrolladores y de obtener para las aplicaciones.También funcionan bien con los navegadores e infraestructuras web habituales.El problema es que suelen depender de un dominio, un servidor, una cuenta en la nube, una política de acceso y un operador del proyecto.Si caduca el dominio, los metadatos pueden desaparecer.Si hackean el servidor, pueden sustituirlos.Si el proyecto cierra la API, las wallets pueden mostrar activos con errores.Si el operador modifica el archivo JSON, la representación del NFT puede cambiar sin ninguna actualización on-chain.El almacenamiento HTTPS puede ser adecuado para activos temporales o dinámicos, pero es menos sólido para los que prometen permanencia.Los usuarios deberían actuar con cautela si NFT valiosos o activos tokenizados dependen únicamente de URL web convencionales.

Metadatos off-chain y riesgo de centralización

El riesgo de centralización es una de las principales debilidades de los metadatos off-chain.La investigación sobre la centralización de metadatos de NFT ha observado que muchos sistemas dependen de almacenamiento centralizado, lo que puede generar riesgos como censura, filtraciones de datos, cambios administrativos y pérdida de control.Un servidor centralizado puede ser rápido y cómodo, pero también convertirse en un único punto de fallo.Si una empresa controla el servidor de metadatos, podría cambiar la apariencia de los activos.Si un servicio en la nube suspende una cuenta, los metadatos podrían dejar de cargarse.Si un atacante compromete el servidor, los usuarios podrían ver enlaces maliciosos o imágenes falsas.Si desaparece el proyecto, los archivos pueden desaparecer con él.Esto no significa que todos los metadatos off-chain sean malos.Significa que la arquitectura de almacenamiento debe corresponderse con las garantías de confianza del activo.Un proyecto que prometa permanencia no debería depender únicamente de un alojamiento centralizado frágil.

Metadatos off-chain y NFT dinámicos

Los NFT dinámicos suelen depender de metadatos off-chain porque su apariencia o sus atributos pueden cambiar con el tiempo.Un personaje de juego puede subir de nivel.Un objeto coleccionable deportivo puede actualizar sus estadísticas.Un token de membresía puede cambiar de categoría.Un token de un activo del mundo real puede actualizar el estado de un documento.Una obra de arte generativo puede mostrar nuevos estados cuando se cumplen ciertas condiciones.Los metadatos off-chain facilitan estas actualizaciones porque el archivo JSON o la API pueden cambiar sin desplegar un contrato nuevo.El riesgo es que la capacidad de actualización sea demasiado amplia.Si el emisor puede cambiar cualquier rasgo en cualquier momento, el comprador quizá no sepa realmente qué posee.Los metadatos dinámicos deberían tener reglas claras, eventos de actualización, controles de acceso y documentación pública.La flexibilidad no debe convertirse en control oculto.

Eventos de actualización de metadatos

Los eventos de actualización ayudan a las aplicaciones a saber cuándo deben renovar los metadatos guardados en caché.

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

Esto es útil porque las wallets y los indexadores suelen guardar en caché los metadatos en lugar de obtenerlos cada vez.Si cambian los metadatos y no existe una señal de actualización, los usuarios pueden seguir viendo imágenes o atributos antiguos.ERC-4906 también advierte que los controles de permisos importan cuando se pueden modificar metadatos off-chain.Esto es importante porque una función de actualización puede convertirse en un permiso administrativo sensible.Si la cuenta equivocada puede activar o controlar las actualizaciones, puede dañarse la confianza de los usuarios.Los proyectos con metadatos dinámicos off-chain deberían hacer que el comportamiento de las actualizaciones sea previsible.También deberían explicar quién puede actualizar los metadatos y por qué.Los usuarios deberían comprobar si pueden cambiarse los metadatos después de acuñar o comprar el activo.

Metadatos off-chain a nivel de contrato

Los metadatos a nivel de contrato describen el contrato o la colección, no un único ID de token.Pueden incluir el nombre y la descripción de la colección, una imagen de perfil, un banner, una imagen destacada, un enlace externo y los colaboradores.ERC-7572 propone contractURI como forma de devolver metadatos a nivel de contrato.La cadena contractURI devuelta puede apuntar a un recurso off-chain o devolver datos JSON on-chain.Esto importa porque las wallets y los exploradores suelen necesitar información detallada del contrato antes de mostrárselo a los usuarios.Estos metadatos pueden mejorar la facilidad de uso, pero también engañar si se modifican de forma maliciosa.Un archivo de metadatos de contrato falso o comprometido puede mostrar un logotipo o nombre conocido.Los usuarios no deberían confiar únicamente en los metadatos del contrato.También importan la dirección del contrato, el código fuente, el historial del emisor y los canales oficiales de comunicación.Los datos de visualización deben facilitar la verificación, no sustituirla.

Metadatos off-chain y nuevos estándares de metadatos on-chain

Los estándares más recientes muestran que los desarrolladores intentan reducir algunos riesgos derivados del almacenamiento off-chain.

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

La propuesta explica que los metadatos de contratos suelen depender de URL off-chain o IPFS, lo que puede crear riesgos de confianza y disponibilidad.ERC-8049 no sustituye universalmente a todos los metadatos off-chain.Indica que el ecosistema avanza hacia una identidad de contrato más clara y mejores datos de visualización para wallets.Algunos proyectos seguirán utilizando metadatos off-chain porque no resulta práctico guardar archivos grandes y documentos privados on-chain.Otros pueden trasladar on-chain los datos esenciales de identidad y mantener off-chain solo los medios voluminosos.Es probable que el futuro pase por metadatos híbridos.Los campos de identidad críticos podrían ser más verificables on-chain.Los archivos multimedia grandes, los documentos privados y los datos que cambian con frecuencia podrían seguir off-chain, con pruebas de integridad más sólidas.

Metadatos off-chain y mecanismos de revelación

Muchas colecciones de NFT utilizan mecanismos de revelación.Antes de la revelación, todos los tokens pueden apuntar a los mismos metadatos de marcador de posición.Después, cada token recibe metadatos únicos.Este método puede generar expectación y reducir la búsqueda anticipada de rasgos raros.También requiere confianza si el proceso de revelación no es transparente.Un equipo deshonesto podría asignar injustamente los rasgos raros si no se gestionan cuidadosamente la aleatoriedad y la asignación de metadatos.Los proyectos pueden reducir este riesgo publicando compromisos sobre los metadatos, utilizando aleatoriedad verificable, bloqueando hashes de metadatos o explicando claramente el proceso.Los metadatos off-chain facilitan estos mecanismos porque los archivos pueden sustituirse o actualizarse.La misma flexibilidad puede generar sospechas si los usuarios no pueden verificar el proceso.Una revelación justa debería ser comprensible antes de que los usuarios acuñen el NFT.

Metadatos off-chain y bloqueo de metadatos

Bloquear los metadatos significa impedir que se modifiquen en el futuro a partir de un momento determinado.Un proyecto puede bloquearlos después de la revelación para que los usuarios sepan que el activo no cambiará inesperadamente.El bloqueo puede implementarse mediante la lógica del contrato, ajustes de URI inmutables, enlaces direccionados por contenido, compromisos de almacenamiento o cargas a almacenamiento permanente.Puede reforzar la confianza de los coleccionistas porque estabiliza la representación del activo.También puede dejar errores sin corregir.Si antes del bloqueo hay un enlace roto, un error ortográfico, un rasgo equivocado o una licencia incorrecta, corregirlo puede ser difícil.Los proyectos deberían auditar los metadatos antes de bloquearlos.Los usuarios deberían confirmar si están realmente bloqueados o si simplemente se describen como definitivos en el material de marketing.Una afirmación pública ofrece menos garantías que un control técnico exigible.El contrato y la configuración del almacenamiento deberían cumplir lo que promete el proyecto.

Metadatos off-chain y activos del mundo real tokenizados

Los activos del mundo real tokenizados suelen necesitar metadatos off-chain porque los registros legales y financieros pueden ser voluminosos, privados o estar sujetos a regulación.Un token puede representar exposición a un fondo, factura, inmueble, materia prima, bono, crédito de carbono u otro derecho sobre un activo real.Los metadatos pueden hacer referencia a documentos que explican derechos, obligaciones, auditorías, colateral, fechas de vencimiento o reglas de reembolso.Parte de esta información puede ser pública.Otra parte puede requerir acceso restringido.Publicar documentos legales privados directamente en una blockchain puede generar problemas de privacidad y cumplimiento.Un diseño habitual guarda on-chain el hash de un documento y conserva el documento off-chain.El hash puede ayudar a verificar que el documento no ha cambiado.El archivo puede permanecer en un almacenamiento controlado por motivos legales, de privacidad o de licencia.En los activos del mundo real, los metadatos deberían vincular los registros de blockchain con documentos legales exigibles, no sustituirlos.

Metadatos off-chain y videojuegos

Los juegos de blockchain suelen utilizar metadatos off-chain porque sus activos pueden cambiar con frecuencia.Una espada puede ganar poder.Un personaje puede subir de nivel.Una parcela puede cambiar cuando un jugador construye en ella.Un aspecto puede desbloquear nuevos estados visuales.Las actualizaciones on-chain frecuentes pueden ser caras y lentas, por lo que los estudios pueden guardar off-chain los metadatos que cambian.Esto puede hacer que el juego funcione con más fluidez.También significa que los jugadores deben confiar en las reglas de actualización del juego.Si un juego puede cambiar las estadísticas de un objeto en cualquier momento, su valor económico puede variar.Un buen diseño debería separar la propiedad permanente del estado de juego modificable.Los jugadores deberían saber qué rasgos son fijos y cuáles pueden evolucionar.

Metadatos off-chain e identidad digital

Los sistemas de identidad digital pueden utilizar metadatos off-chain para proteger la privacidad.Una credencial puede tener que demostrar que una persona posee un estatus, una membresía, una licencia o un logro.Los datos personales originales que respaldan esa credencial deberían permanecer a menudo off-chain.Una blockchain pública normalmente no es un lugar adecuado para números de pasaporte, domicilios, datos médicos, expedientes laborales o registros legales privados.En su lugar, un sistema de identidad puede guardar on-chain un hash, un compromiso, una referencia del emisor o un puntero de verificación.Los metadatos detallados de la credencial pueden permanecer off-chain y compartirse de forma selectiva.Este diseño puede facilitar tanto la verificación como la privacidad.También puede crear dependencia de los emisores de credenciales, los proveedores de almacenamiento y los sistemas de acceso.Los metadatos de identidad deberían respetar la minimización de datos.Solo debería colocarse on-chain la información que realmente necesite verificación pública.

Metadatos off-chain y privacidad

Los metadatos off-chain pueden mejorar la privacidad si los archivos sensibles se mantienen fuera de los registros públicos.Sin embargo, que estén off-chain no significa automáticamente que sean privados.Un archivo de metadatos HTTPS puede ser público.Cualquiera que conozca el CID de un archivo IPFS puede recuperarlo si el contenido está disponible.Un archivo puede revelar nombres, ubicaciones, membresías, asistencia a eventos, vínculos con wallets o imágenes privadas.Un proyecto nunca debería incluir información sensible de usuarios en metadatos públicos sin que estos comprendan claramente el riesgo.Los sistemas sensibles a la privacidad deberían valorar el cifrado, los controles de acceso, la divulgación selectiva, los hashes y los permisos off-chain.Los usuarios deberían asumir que los metadatos públicos pueden copiarse y archivarse.Eliminar el archivo del servidor original puede no eliminar todas las copias.La privacidad de los metadatos exige un diseño cuidadoso antes de publicarlos, no una limpieza posterior a la exposición.

Metadatos off-chain y derechos de autor

Los metadatos off-chain no demuestran automáticamente la titularidad de los derechos de autor.Un archivo puede afirmar que un NFT representa una imagen, canción, objeto de juego o bien del mundo real conocido.La afirmación puede ser falsa.La blockchain puede demostrar que una wallet posee un token, pero no que quien lo acuñó tuviera derechos legales sobre el contenido multimedia.El campo de imagen de los metadatos puede apuntar a una obra artística copiada.La descripción puede incluir condiciones de licencia engañosas.La página web del proyecto puede desaparecer después de que los compradores hayan confiado en ella.Antes de dar por hecho que se poseen derechos de propiedad intelectual, los usuarios deberían comprobar la identidad del creador, las condiciones de licencia, la dirección del contrato, el historial de acuñación, la documentación oficial y los derechos legales.En el caso de activos valiosos, los acuerdos legales pueden importar más que el archivo de metadatos.Los metadatos registran afirmaciones, pero no hacen que todas sean ciertas.

Metadatos off-chain y seguridad

Los metadatos off-chain pueden convertirse en un riesgo de seguridad si los usuarios confían demasiado en la información visualizada.Un archivo malicioso puede incluir enlaces de phishing.Un servidor comprometido puede sustituir una imagen segura por una llamada a la acción maliciosa.Una colección falsa puede copiar el nombre, la imagen y la descripción de un activo legítimo.Una wallet puede mostrar una marca conocida aunque la dirección del contrato sea incorrecta.Una actualización de metadatos puede cambiar la identidad aparente de un activo después de su compra.Las aplicaciones deberían tratar los metadatos como entradas no fiables.Deberían depurar los campos, advertir de enlaces sospechosos y evitar ejecutar código inseguro incluido en los metadatos.Los usuarios deberían verificar las direcciones de los contratos y evitar abrir sin precaución enlaces de las descripciones de los activos.Si la visualización de un activo depende de archivos externos, la seguridad no termina en el contrato inteligente.

Metadatos off-chain e indexadores

Los indexadores leen datos de blockchain y los organizan para wallets, exploradores, juegos, paneles y aplicaciones.Cuando los metadatos están off-chain, suelen obtener tokenURI o contractURI y guardar en caché el JSON recibido.Esto mejora la velocidad, ya que las aplicaciones no tienen que obtener todos los archivos cada vez.También puede generar datos obsoletos si los metadatos cambian y el indexador no actualiza la caché.Eventos de actualización como ERC-4906 pueden ayudar a los indexadores a saber cuándo volver a obtener los metadatos.Sin esos eventos, las aplicaciones pueden mostrar imágenes o rasgos antiguos.Los indexadores también pueden discrepar si falla una pasarela y otra funciona.Los desarrolladores deberían utilizar esquemas estándar y señales de actualización claras.Los usuarios deben recordar que lo que muestra una wallet es una interpretación de los metadatos, no la blockchain en sí.Si algo parece incorrecto, puede ser útil comprobar la URI de origen.

Metadatos off-chain y visualización en wallets

Las wallets dependen mucho de los metadatos para que los tokens sean comprensibles.Pueden mostrar el nombre, la imagen, el símbolo, la colección, los rasgos y la descripción a partir de metadatos off-chain.Si faltan metadatos, pueden mostrar una imagen en blanco o un activo desconocido.Si los metadatos tardan en cargarse, el activo puede aparecer con retraso.Si se modifican, la wallet puede mostrar una imagen o unos rasgos nuevos.Si son maliciosos, puede mostrar información engañosa.Por ello, los metadatos forman parte tanto de la experiencia como de la seguridad del usuario.La representación de un token puede influir en que el usuario firme una transacción, acepte una oferta o confíe en una colección.Cuando sea posible, las wallets deberían mostrar las direcciones de los contratos e indicadores de advertencia.Los usuarios no deberían confiar únicamente en la imagen que aparece en la wallet.

Metadatos off-chain y DAO

Las DAO pueden utilizar metadatos off-chain para propuestas, registros de gobernanza, distintivos de membresía, activos de tesorería y credenciales comunitarias.Un token de gobernanza o NFT puede apuntar a metadatos que describan derechos de voto, funciones de los miembros o historial de participación.Una propuesta puede hacer referencia a archivos externos, como presupuestos, memorandos legales, solicitudes de subvención o planes de proyecto.Guardar todos los documentos de gobernanza on-chain puede resultar caro y exponer información privada.Los metadatos off-chain pueden hacer más práctica la gobernanza de una DAO.El riesgo es que los archivos de una propuesta cambien después de que los votantes los hayan revisado.Las DAO pueden reducirlo guardando hashes de documentos, usando enlaces direccionados por contenido y archivando los materiales definitivos de la propuesta.Los votantes deberían saber si el documento que han leído es el mismo que se aprobó.La gobernanza depende de que existan registros claros.La comodidad de los metadatos off-chain no debería debilitar la rendición de cuentas.

Metadatos off-chain y activos generados por IA

Los activos generados por IA pueden utilizar metadatos off-chain para describir prompts, versiones del modelo, fechas de generación, wallets de creadores, licencias y notas de procedencia.Esta información puede ser demasiado voluminosa o sensible para almacenarla íntegramente on-chain.Los metadatos off-chain pueden conservar un registro más completo del proceso de generación.También pueden editarse o eliminarse si el diseño de almacenamiento es deficiente.Un archivo puede afirmar que una imagen se generó con un modelo o creador concreto.Esa afirmación aún debe verificarse.En los NFT generados por IA, los metadatos deberían distinguir entre datos objetivos, afirmaciones del creador y derechos legales.Un hash del contenido multimedia original o del paquete de prompts puede ayudar a demostrar que el archivo no ha cambiado.Sin embargo, un hash no demuestra que el contenido sea legal, original o que no infrinja derechos.Los metadatos de activos de IA deberían ser transparentes sin exagerar lo que permiten demostrar.

Ventajas de los metadatos off-chain

La primera ventaja es el menor coste.Los proyectos pueden almacenar archivos grandes sin pagar por cada byte de almacenamiento en la blockchain.La segunda es la flexibilidad.Los metadatos pueden admitir activos dinámicos, actualizaciones de juegos, revelaciones, correcciones y registros evolutivos.La tercera es la compatibilidad con medios enriquecidos.Es más sencillo almacenar off-chain vídeos, audio, modelos 3D e imágenes de alta resolución.La cuarta es el control de la privacidad.Los documentos sensibles pueden permanecer en un almacenamiento controlado en lugar de publicarse en un registro público.La quinta es un mejor rendimiento.Las aplicaciones pueden utilizar sistemas de distribución de contenido, pasarelas o redes de almacenamiento para cargar archivos con eficiencia.La sexta es una integración más sencilla.Las wallets, los exploradores, los juegos y los indexadores reconocen ampliamente los metadatos JSON y las URI estándar.

Riesgos y limitaciones de los metadatos off-chain

El primer riesgo son los enlaces rotos.Si la URL de los metadatos deja de funcionar, el activo puede no mostrarse correctamente.El segundo es la modificación no autorizada.Si se puede editar el archivo, el activo puede cambiar después de la compra.El tercero es la centralización.Un único servidor o una cuenta en la nube puede convertirse en un punto de fallo.El cuarto es la disponibilidad deficiente.El contenido de IPFS puede dejar de recuperarse si nadie lo fija o aloja.El quinto son las filtraciones de privacidad.Los metadatos pueden exponer información que no debería ser pública.El sexto son las afirmaciones engañosas.Pueden atribuir derechos, rareza, autenticidad o respaldo que en realidad no existen.El séptimo es la incoherencia de las cachés.Distintas wallets o indexadores pueden mostrar versiones diferentes del mismo activo.

Errores habituales con los metadatos off-chain

Un error frecuente es suponer que la propiedad de un NFT significa que sus medios están almacenados on-chain.Muchos NFT registran la propiedad on-chain y guardan los metadatos off-chain.Otro error es utilizar una URL HTTPS normal para una colección que promete permanencia.Un tercero es utilizar IPFS sin fijar los datos de forma fiable.Un cuarto es cambiar los metadatos sin emitir eventos de actualización.Un quinto es dar a una wallet administradora control ilimitado sobre los metadatos sin comunicarlo.Un sexto es almacenar información privada de usuarios en metadatos públicos.Un séptimo es tratar los metadatos como prueba legal de los derechos de autor.Un octavo es no hacer copias de seguridad de los archivos antes de acuñar.Un noveno es usar campos no estándar que las wallets no pueden leer.Un décimo es no comprobar cómo se muestran los metadatos en varias wallets y exploradores.

Buenas prácticas para desarrolladores

Elige el modelo de almacenamiento de metadatos antes de desplegar el contrato.Utiliza almacenamiento direccionado por contenido cuando importe la integridad a largo plazo.Al enlazar contenido de IPFS, utiliza URI de IPFS en lugar de URL específicas de una pasarela.Fija los metadatos y los medios de IPFS con una infraestructura fiable.Utiliza opciones de almacenamiento permanente cuando el activo prometa disponibilidad a largo plazo.Guarda hashes o compromisos on-chain cuando haya que verificar documentos externos importantes.Emite eventos de actualización cuando cambien los metadatos.Documenta si son modificables, están bloqueados, son dinámicos o dependen de una revelación.Protege las funciones de actualización con controles de acceso sólidos.No incluyas datos personales sensibles en archivos públicos de metadatos.

Buenas prácticas para los usuarios

Antes de comprar un activo valioso, comprueba tokenURI o la ubicación de los metadatos.Verifica si utilizan HTTPS, IPFS, Arweave u otro método de almacenamiento.Comprueba si el contenido de IPFS está fijado o preservado de otra forma.Busca documentación del proyecto sobre el bloqueo de metadatos y los controles de actualización.Verifica la dirección del contrato en lugar de confiar en la imagen o el nombre mostrados.Ten cuidado con los enlaces externos de las descripciones.No des por hecho que la imagen de un token demuestra la titularidad de los derechos de autor.Si es posible, utiliza exploradores de blockchain para inspeccionar las funciones de metadatos.En el caso de activos de gran valor, comprueba si se pueden recuperar los medios y metadatos por vías independientes.Considera los metadatos parte de la diligencia debida, no una prueba completa del valor.

Cuándo son útiles los metadatos off-chain

Son útiles cuando los archivos son demasiado grandes para almacenarlos eficientemente on-chain.Son útiles cuando los activos necesitan imágenes, vídeos, audio, modelos 3D o contenido interactivo de alta calidad.Son útiles cuando los metadatos deben cambiar según el estado del juego, la situación de una membresía o acontecimientos del mundo real.Son útiles cuando los documentos legales o privados no deberían ser públicos de forma permanente.Son útiles cuando un proyecto necesita cargas rápidas y amplia compatibilidad con aplicaciones.Son útiles cuando el almacenamiento direccionado por contenido o permanente puede aportar buena integridad y disponibilidad.Se utilizan en NFT, objetos de juego, activos tokenizados, credenciales de identidad, registros de DAO y datos de visualización de contratos.Son menos adecuados cuando un proyecto promete la máxima permanencia, pero depende solo de un servidor frágil.Son menos adecuados cuando los controles de actualización no están claros o son demasiado amplios.Son peligrosos cuando se exponen datos sensibles mediante archivos públicos.

Metadatos off-chain, en una frase

Los metadatos off-chain son información sobre activos cripto almacenada fuera de la blockchain y referenciada por registros on-chain; permiten gestionar de forma más económica y flexible datos detallados de NFT, tokens, juegos, identidades y activos del mundo real, pero añaden riesgos de almacenamiento, confianza, disponibilidad y actualización.

Preguntas frecuentes

¿Qué significa «metadatos off-chain»?

Son información descriptiva de un activo almacenada fuera de la blockchain, pero referenciada por un token, contrato, URI, hash o puntero de blockchain.

¿Son malos los metadatos off-chain?

No necesariamente. Pueden reducir costes y admitir medios enriquecidos, pero deben almacenarse y protegerse cuidadosamente.

¿Por qué utilizan metadatos off-chain los NFT?

Porque las imágenes, los vídeos, los archivos JSON y los atributos pueden ser demasiado voluminosos o caros para almacenarse directamente on-chain.

¿Qué es tokenURI?

Es una función habitual de los NFT que devuelve la URI donde se encuentran los metadatos de un ID de token concreto.

¿Qué riesgo tienen los metadatos HTTPS?

Pueden dejar de funcionar o cambiar si el servidor, el dominio, la cuenta en la nube o el operador del proyecto falla o sufre un ataque.

¿Los metadatos de IPFS son off-chain?

Sí. Respecto a la blockchain del token, están off-chain, aunque el direccionamiento por contenido puede ayudar a verificar la integridad del archivo.

¿IPFS garantiza la disponibilidad permanente?

No. IPFS identifica el contenido mediante un CID, pero los datos aún deben fijarse, alojarse o preservarse para que puedan recuperarse posteriormente.

¿Se pueden modificar los metadatos off-chain?

Sí, si el proyecto o el servidor controla el archivo, salvo que el diseño utilice enlaces inmutables, metadatos bloqueados o compromisos sólidos.

¿Qué son los metadatos dinámicos?

Son metadatos que cambian con el tiempo según actualizaciones, el estado de un juego, logros, datos de oráculos, la situación de una membresía o las reglas del emisor.

¿Los metadatos demuestran la titularidad de los derechos de autor?

No. Pueden describir un activo o afirmar que existen derechos, pero los derechos de autor y la propiedad legal dependen de las licencias, los contratos, la autoridad del emisor y la legislación aplicable.

¿Cómo pueden verificar los usuarios los metadatos off-chain?

Pueden inspeccionar tokenURI, comprobar el método de almacenamiento, verificar hashes o CID, revisar los permisos de actualización y probar si se pueden recuperar los metadatos y los medios.

¿Cuál es el diseño más seguro de metadatos off-chain?

Un diseño más seguro utiliza esquemas estándar, almacenamiento direccionado por contenido, persistencia fiable, hashes o compromisos on-chain, controles claros de actualización y una explicación honesta de lo que puede cambiar.

Conclusión

Los metadatos off-chain son una de las opciones de diseño más comunes en los activos cripto porque permiten conectar la propiedad registrada en una blockchain con información detallada y comprensible.Sin metadatos, un token puede ser solo una dirección, un ID de token y un saldo.Con ellos, los usuarios pueden ver un nombre, una imagen, una descripción, rasgos, documentos, medios y contexto.La razón de su uso extendido es práctica.Almacenar archivos grandes en una blockchain es caro.Los sistemas off-chain pueden guardar archivos JSON, imágenes, vídeos, datos de juegos, documentos legales y registros de identidad con menos coste y más flexibilidad.Esto facilita la creación y visualización de NFT, activos tokenizados, juegos, credenciales y perfiles de contratos.Sin embargo, los metadatos off-chain cambian el modelo de confianza.La blockchain puede proteger la propiedad, pero el significado del activo puede depender de un archivo externo.Si ese archivo desaparece, cambia o deja de estar disponible, la experiencia del usuario y el valor del activo pueden verse afectados.Los servidores web convencionales son fáciles de utilizar, pero frágiles para activos cripto a largo plazo.IPFS mejora la integridad mediante el direccionamiento por contenido, pero los archivos aún necesitan pinning y un plan de disponibilidad.Arweave y otros sistemas de almacenamiento persistente pueden mejorar el acceso a largo plazo, aunque los usuarios deberían verificar qué se almacena realmente y a qué se hace referencia.Los metadatos dinámicos pueden hacer más útiles los activos, pero también crear un control oculto si las actualizaciones no se rigen con claridad.Para los desarrolladores, el enfoque más seguro es diseñar los metadatos de forma transparente desde el principio.Utiliza estándares que entiendan las wallets y los indexadores.Utiliza almacenamiento direccionado por contenido cuando importe la integridad.Guarda hashes o compromisos para poder verificar los documentos off-chain que lo requieran.Emite eventos de actualización cuando cambien los metadatos.Protege los permisos de actualización.Evita incluir datos personales sensibles en archivos públicos.Para los usuarios, el enfoque más prudente es inspeccionar el método de almacenamiento antes de confiar en el activo.Una imagen atractiva en una wallet no basta.Lo importante es saber dónde se encuentran los metadatos, si pueden cambiar, quién los controla, si se pueden recuperar y si las afirmaciones legales son válidas.Los metadatos off-chain no son una debilidad por sí mismos.Son una contrapartida.Si se utilizan con cuidado, hacen que los activos cripto sean más expresivos, asequibles y útiles.Si se utilizan sin cuidado, pueden convertir un activo de blockchain en un enlace roto, una imagen engañosa o una promesa imposible de verificar.