Estándares de metadatos

¿Qué son los estándares de metadatos?

Los estándares de metadatos son reglas compartidas que definen cómo se debe nombrar, dar formato, almacenar, recuperar e interpretar la información sobre una criptomoneda, un token, una cuenta blockchain, un coleccionable digital, una transacción o una identidad descentralizada.Los metadatos son datos que describen otro activo u objeto de datos.En el ámbito cripto, los metadatos pueden describir el nombre, el símbolo, la precisión decimal, la imagen, los atributos, el creador, un recurso externo, el tipo de archivo multimedia, las condiciones de emisión o el activo subyacente de un token.Los estándares de metadatos permiten que las carteras, las aplicaciones blockchain, los exploradores, los indexadores, los sistemas de análisis y los contratos inteligentes interpreten la misma información de forma coherente.

Sin un estándar compartido, una aplicación podría utilizar el campo

, otra y una tercera quizá no entendería en absoluto la referencia al archivo multimedia.

Un estándar de metadatos puede definir funciones de contratos, campos de datos, estructuras JSON, identificadores, eventos de actualización, reglas de validación, métodos de almacenamiento y requisitos de seguridad.Algunos metadatos se almacenan directamente en una blockchain, mientras que otros se guardan en sitios web, redes de almacenamiento distribuido o bases de datos privadas.Los estándares de metadatos mejoran la interoperabilidad, pero no garantizan que la información sea verdadera, permanente, legal o segura.

¿Por qué son importantes los estándares de metadatos en cripto?

Los registros de blockchain contienen con frecuencia identificadores técnicos difíciles de entender para los usuarios habituales.La dirección del contrato de un token identifica un activo concreto, pero por sí sola no proporciona un nombre, un logotipo, una descripción o una precisión de visualización legibles.Los metadatos convierten la información técnica de la blockchain en datos estructurados que el software puede mostrar y los usuarios pueden interpretar.Una cartera puede utilizar metadatos estandarizados para mostrar el nombre y el saldo correctos de un token.Una aplicación de NFT puede utilizar metadatos para mostrar una imagen, una animación, una descripción y características.Una aplicación de identidad descentralizada puede utilizar metadatos para identificar claves de verificación, puntos de acceso a servicios, emisores, titulares de credenciales y tipos de credenciales.Los estándares reducen la necesidad de que cada aplicación cree una integración personalizada distinta para cada activo cripto.También facilitan la validación de datos, la detección de campos que faltan, la comparación de implementaciones y el traslado de información entre sistemas.

Estándares de metadatos y metadatos

Los metadatos son la información descriptiva real adjunta a un activo o asociada a él.Un estándar de metadatos es el conjunto de reglas que explica cómo debe estructurarse e interpretarse esa información.El texto «Pase de acceso digital» puede ser el nombre de un token almacenado en los metadatos.

Un estándar puede especificar que el nombre del token debe aparecer en un campo llamado

y estar representado como una cadena de texto.

Los metadatos pueden cumplir un estándar, cumplirlo parcialmente o utilizar un formato totalmente personalizado.

Estándar de metadatos y esquema de metadatos

Un estándar de metadatos describe las reglas generales para crear e intercambiar metadatos.Un esquema de metadatos define la estructura permitida, los campos, los tipos de datos y los requisitos de validación de un documento de metadatos.Un estándar puede incluir uno o varios esquemas, además de interfaces de contratos inteligentes, eventos de actualización, reglas para URI e instrucciones de procesamiento.

Un esquema puede exigir que

sea una cadena de texto, que sea una matriz y que contenga una URI.

Un documento puede ser JSON válido y, aun así, no cumplir el esquema de metadatos exigido.

Estándares de metadatos y estándares de tokens

Un estándar de token define cómo se comporta el token y cómo interactúan otras aplicaciones con su contrato inteligente.Un estándar de metadatos define cómo se representa la información descriptiva sobre ese token.Un mismo estándar de token puede incluir funciones de comportamiento y funciones de metadatos opcionales.Por ejemplo, un estándar de tokens fungibles puede definir transferencias, saldos, aprobaciones, oferta total, nombre, símbolo y precisión decimal.Un estándar de NFT puede definir funciones de titularidad y transferencia, y utilizar una URI de metadatos para localizar la información descriptiva.

Elementos principales de los estándares de metadatos cripto

Identificadores

Un identificador distingue una blockchain, un contrato, un tipo o una instancia de token, una cuenta, una credencial o un documento de metadatos de los demás.Algunos ejemplos son los identificadores de cadena, las direcciones de contrato, los ID de token, los identificadores descentralizados, las URL, las URI y los identificadores de contenido.

Nombres de campo

Los nombres de campo estandarizados permiten que el software localice información sin tener que adivinar cómo la ha etiquetado cada emisor.

Entre los campos habituales se encuentran

, , , , , y .

Tipos de datos

Un tipo de dato define si un valor debe ser una cadena de texto, un número, un entero, un valor booleano, un objeto, una matriz o un valor nulo.El uso de tipos de datos coherentes evita que una aplicación reciba un número cuando esperaba texto.

Campos obligatorios y opcionales

Un estándar puede exigir información que todas las implementaciones conformes deben proporcionar y permitir campos opcionales para funciones adicionales.El software no debe dar por sentado que un campo opcional siempre estará presente.

Reglas de URI

Un estándar de metadatos puede definir cómo devuelve un contrato la URI que se utiliza para localizar un documento de metadatos o un archivo multimedia.Una URI identifica un recurso, pero el esquema de la URI determina cómo debe recuperarlo o interpretarlo una aplicación.

Reglas de actualización

Las reglas de actualización explican si los metadatos pueden cambiar, quién puede modificarlos y cómo se informa a las aplicaciones de una actualización.

Reglas de integridad

Las reglas de integridad permiten que una aplicación compruebe si los metadatos recuperados coinciden con un hash criptográfico o un identificador de contenido esperado.

Reglas de validación

Las reglas de validación detectan metadatos mal formados, ausentes, incompatibles o no admitidos antes de que lleguen a los usuarios.

Metadatos on-chain

Los metadatos on-chain se almacenan directamente en el estado de la blockchain, el almacenamiento del contrato, los datos de una transacción u otro recurso protegido por la blockchain.Las aplicaciones pueden leer los metadatos desde un nodo sin depender de un servidor web convencional.El almacenamiento on-chain puede ofrecer una alta disponibilidad e integridad mientras la blockchain subyacente siga siendo accesible.También puede resultar caro, porque cada byte almacenado puede aumentar los costes de transacción y los requisitos de almacenamiento de la red a largo plazo.Los archivos multimedia íntegramente on-chain pueden utilizar texto compacto, gráficos vectoriales codificados, generación procedimental o URI de datos.Que los metadatos sean on-chain no significa automáticamente que sean inmutables, ya que un contrato actualizable o controlado por un administrador puede cambiar la información devuelta.

Metadatos off-chain

Los metadatos off-chain se almacenan fuera de la blockchain, mientras que la blockchain registra una referencia a ellos.La referencia puede apuntar a un recurso HTTPS, un objeto de almacenamiento distribuido, un servidor privado, una interfaz de programación de aplicaciones o un archivo direccionado por contenido.El almacenamiento off-chain permite gestionar imágenes, vídeos, documentos y conjuntos detallados de atributos más grandes con un coste menor para la blockchain.Introduce riesgos adicionales de disponibilidad, alojamiento, dominios, seguridad y modificación del contenido.Si un servidor convencional desaparece, el token puede seguir en la blockchain mientras sus metadatos dejan de estar disponibles.

Metadatos híbridos

Los metadatos híbridos combinan información on-chain con archivos off-chain.Un contrato inteligente puede almacenar on-chain el ID del token, la titularidad, la URI de metadatos y el hash del contenido, mientras que el documento JSON completo y los archivos multimedia se guardan en otro lugar.Este enfoque puede reducir los costes de almacenamiento y, al mismo tiempo, permitir que las aplicaciones verifiquen el contenido recuperado.La seguridad del resultado depende de qué campos estén protegidos on-chain y de cuáles puedan seguir cambiando.

Estándares de metadatos para tokens fungibles

Los metadatos de los tokens fungibles ayudan a que las carteras y las aplicaciones muestren correctamente activos cripto intercambiables.

El estándar definitivo de tokens ERC-20 define funciones opcionales para el nombre, el símbolo y la precisión decimal de un token.

El campo

proporciona un nombre de activo legible.

El campo

proporciona una representación más breve, similar a un ticker.

El valor

indica a las interfaces cómo convertir la unidad on-chain más pequeña en una cantidad legible para el usuario.

Un token con 18 decimales representa un token mostrado como 10¹⁸ unidades mínimas.

El nombre y el símbolo no identifican un token de forma única, ya que varios contratos no relacionados pueden utilizar los mismos valores.Una aplicación fiable debería identificar el activo mediante su blockchain y la dirección del contrato, no solo mediante su símbolo.

Metadatos decimales

Los metadatos decimales cambian la forma en que se muestra un saldo entero de tokens, pero no dividen automáticamente las unidades on-chain subyacentes.

Saldo de tokens mostrado = saldo bruto de tokens / 10^Decimales

Un saldo bruto de 250,000,000 con seis decimales se muestra como 250 tokens.Unos metadatos decimales incorrectos pueden hacer que un saldo parezca mucho mayor o menor de lo que realmente es.Los cálculos financieros deberían utilizar aritmética entera precisa en lugar de aproximaciones de coma flotante.

Estándar de metadatos ERC-721

ERC-721 es un estándar definitivo para tokens no fungibles en el que cada token tiene un identificador distinto.

La interfaz de metadatos opcional del estándar ERC-721 define las funciones

, y .

La función

devuelve una URI asociada a un ID de token concreto.

Los metadatos obtenidos suelen incluir un nombre, una descripción y una URI de imagen.Las aplicaciones pueden admitir campos adicionales, pero no se garantiza que los campos personalizados aparezcan de forma coherente en todas las interfaces.ERC-721 estandariza el acceso a los metadatos sin exigir que todos los bytes de metadatos se almacenen directamente en el contrato.

Campos habituales de metadatos ERC-721

Nombre

El campo

proporciona un nombre legible para el token individual o el activo representado.

Descripción

El campo

explica el token, el archivo multimedia, la utilidad, el historial o el objeto representado.

Imagen

El campo

contiene una URI que apunta a una imagen asociada al token.

URL de animación

El campo

puede apuntar a vídeo, audio, archivos multimedia interactivos, contenido tridimensional u otro recurso enriquecido.

URL externa

El campo

puede dirigir a los usuarios a una página oficial de información o de una aplicación.

Atributos

Una matriz

puede describir características como la categoría, el nivel, la edición, el color, el estado u otra propiedad específica del token.

Los formatos de las características deben ser coherentes en toda la colección para que las aplicaciones puedan ordenarlas y compararlas correctamente.

Estándar de metadatos ERC-1155

ERC-1155 admite varios tipos de tokens fungibles, no fungibles y semifungibles dentro de un mismo contrato inteligente.

El estándar multi-token definitivo ERC-1155 define una interfaz opcional de URI de metadatos y un esquema JSON asociado.

La función

devuelve una URI de metadatos para un tipo de token.

El estándar permite que el marcador

aparezca dentro de los valores de metadatos.

Los clientes compatibles sustituyen ese marcador por el ID del token representado, expresado como una cadena hexadecimal en minúsculas, con ceros a la izquierda hasta completar 64 caracteres y sin el prefijo

.

Esta sustitución permite que un patrón de URI dé servicio de forma eficiente a muchos ID de token.El esquema ERC-1155 incluye campos como name, description, image, decimals y properties.

Metadatos ERC-721 y ERC-1155

ERC-721 normalmente devuelve una URI específica del token mediante

.

ERC-1155 puede devolver una plantilla de URI que las aplicaciones personalizan sustituyendo el ID del token.ERC-721 está diseñado para tokens individualmente distintos, mientras que ERC-1155 puede representar varias categorías de tokens en un solo contrato.Ambos estándares suelen proporcionar metadatos en formato JSON y pueden apuntar a archivos multimedia externos.Una aplicación debería detectar y procesar la interfaz correcta, en lugar de dar por sentado que todos los NFT siguen el mismo patrón de metadatos.

Estándares de actualización de metadatos

Los metadatos mutables de NFT plantean un problema, porque las aplicaciones pueden almacenar en caché una versión anterior y no enterarse nunca de que ha cambiado.

La extensión definitiva ERC-4906 para la actualización de metadatos define eventos estandarizados para avisar a las aplicaciones de los cambios en los metadatos ERC-721.

El evento

identifica un token cuyos metadatos han cambiado.

El evento

identifica un rango consecutivo de ID de token afectados.

Las aplicaciones pueden supervisar estos eventos y recuperar los metadatos actualizados mediante la URI del token.El evento indica que los metadatos han cambiado, pero no incluye el documento actualizado completo.

Estándares emergentes de metadatos on-chain

Siguen desarrollándose nuevas propuestas de metadatos a medida que las aplicaciones blockchain requieren información on-chain más estructurada.ERC-8048 se presentó en septiembre de 2025 como propuesta preliminar para metadatos clave-valor almacenados directamente en registros multi-token y de NFT.

El borrador actual de ERC-8048 propone una función que devuelve bytes de metadatos para un ID de token y una clave de texto.

También propone un evento que las aplicaciones pueden supervisar cuando se establece un valor de metadatos.Como ERC-8048 sigue siendo un borrador, los desarrolladores no deberían describirlo como un estándar definitivo o adoptado universalmente.Las propuestas preliminares pueden cambiar, quedar estancadas o no obtener un amplio respaldo para su implementación.

JSON como formato de metadatos

JSON es un formato de texto ligero que se utiliza habitualmente para intercambiar metadatos cripto entre contratos, servidores, carteras y aplicaciones.

El estándar JSON del IETF define objetos, matrices, cadenas de texto, números, valores booleanos y valores nulos.

Un objeto JSON contiene nombres de campo y sus valores correspondientes.JSON es popular porque es legible, cuenta con un amplio respaldo y las aplicaciones web pueden procesarlo fácilmente.Que un JSON sea válido no demuestra que el documento siga un esquema de metadatos de tokens.Las aplicaciones deberían rechazar los valores duplicados o inesperados de acuerdo con sus políticas de seguridad e interoperabilidad.

Ejemplo de estructura de metadatos NFT en JSON

Este ejemplo utiliza campos habituales, pero no representa un esquema universal completo para todas las aplicaciones de NFT.La URI, la estructura de los atributos y los campos opcionales deben evaluarse según el estándar y la aplicación que los vaya a utilizar.

JSON Schema

JSON Schema proporciona reglas legibles por máquinas para validar la estructura y los valores de un documento JSON.Un esquema puede definir propiedades obligatorias, tipos de datos esperados, valores mínimos, patrones de texto, valores permitidos y reglas para objetos anidados.

El borrador 2020-12 de JSON Schema sigue siendo, en 2026, la versión publicada más reciente de la especificación general.

Un proyecto cripto puede utilizar JSON Schema para comprobar los metadatos antes de acuñar o publicar tokens.Las carteras y los indexadores también pueden utilizar esquemas para identificar datos no válidos o no compatibles.La validación del esquema confirma la estructura, pero no puede demostrar que una descripción, imagen, afirmación de titularidad o declaración del emisor sea veraz.

Metadatos JSON-LD

JSON-LD amplía JSON con semántica de datos enlazados, lo que permite conectar campos y tipos con conceptos definidos globalmente.

La recomendación estable JSON-LD 1.1 define un formato basado en JSON para datos enlazados interoperables.

La propiedad

asigna nombres de campo breves a identificadores y vocabularios más precisos.

La propiedad

puede identificar un sujeto o recurso.

La propiedad

identifica el tipo de entidad descrita.

JSON-LD puede ayudar a que los activos tokenizados, las credenciales, los registros de identidad y los sistemas de activos del mundo real intercambien metadatos con un significado coherente.Los contextos remotos generan riesgos de dependencia y seguridad cuando su contenido puede cambiar o dejar de estar disponible.

Estándares URI en los metadatos cripto

Un identificador uniforme de recursos identifica un recurso digital o físico mediante un formato de caracteres estandarizado.

El estándar de sintaxis genérica de URI define la estructura común utilizada por los esquemas URI.

Entre los esquemas habituales de metadatos cripto se encuentran

, y .

Una URI HTTPS identifica una ubicación controlada mediante un dominio web y un servidor.Una URI IPFS identifica contenido mediante un identificador de contenido.Una URI de datos integra el contenido directamente en la URI.Las aplicaciones deberían verificar qué esquemas admiten y evitar tratar una URI desconocida como si fuera un enlace web seguro.

Direccionamiento por ubicación y por contenido

El direccionamiento por ubicación indica a una aplicación dónde solicitar un recurso.El direccionamiento por contenido identifica un recurso mediante información derivada del propio contenido.Una URL HTTPS puede seguir apuntando a la misma ubicación aunque el servidor cambie el archivo.Un identificador de contenido cambia cuando cambia el contenido al que hace referencia, siempre que se mantengan las mismas reglas de codificación y hash.Por tanto, el direccionamiento por contenido mejora la verificación de integridad, pero no garantiza que el contenido siga alojado y accesible.

Metadatos IPFS

IPFS se utiliza habitualmente para almacenar metadatos y archivos multimedia de NFT mediante identificadores direccionados por contenido.

La documentación oficial de IPFS sobre el direccionamiento por contenido explica que un identificador de contenido, o CID, contiene información derivada del hash criptográfico y la codificación del contenido.

Si se utiliza la misma configuración de direccionamiento por contenido, al cambiar el contenido se genera un CID distinto.

Una URI de token puede utilizar el formato

para identificar un documento de metadatos o un archivo.

Una pasarela pública puede traducir esa URI en una solicitud HTTPS para acceder desde un navegador.La pasarela es una vía para recuperar el contenido, no la identidad subyacente del contenido.Un CID no garantiza un almacenamiento permanente, ya que al menos un proveedor accesible debe seguir poniendo los datos a disposición.

Integridad de los metadatos

La integridad de los metadatos significa que los datos recuperados no han cambiado inesperadamente desde que se creó la referencia de confianza.Se puede calcular un hash criptográfico del documento de metadatos y compararlo con un hash esperado.

La integridad de los metadatos es válida cuando el hash calculado = el hash esperado de confianza

La coincidencia del hash demuestra que los bytes coinciden, pero no prueba que el contenido original fuera correcto o estuviera autorizado.Los metadatos direccionados por contenido pueden incluir integridad en su identificador.Los metadatos direccionados por ubicación pueden utilizar un hash almacenado por separado, una firma digital u otro registro de integridad.

Autenticidad de los metadatos

La autenticidad se refiere a quién creó, aprobó o controló los metadatos.Una firma digital puede vincular un documento de metadatos a una clave criptográfica.Aun así, quien lo verifica debe determinar si esa clave pertenece al creador, emisor, autoridad del contrato u organización esperados.Una firma válida de una clave comprometida puede autenticar un documento no autorizado.Siguen siendo necesarios la rotación y revocación de claves, el control de acceso y los procedimientos para gestionar incidentes.

Metadatos inmutables

Los metadatos inmutables están diseñados para que su contenido o referencia de confianza no pueda cambiarse después de un momento determinado.La inmutabilidad puede conseguirse almacenando todos los datos on-chain, guardando un identificador de contenido inalterable o desactivando permanentemente los permisos de actualización.Un proyecto debería explicar exactamente qué partes son inmutables.Un documento JSON inmutable aún puede apuntar a una imagen externa que cambie.Un contrato inteligente inmutable también puede hacer referencia a una ubicación de servidor mutable.La verdadera inmutabilidad debe evaluarse en toda la cadena de referencias.

Metadatos mutables

Los metadatos mutables pueden cambiar después de crear un token.Pueden permitir la evolución de objetos de juego, NFT cambiantes, membresías, activos canjeables, estados de identidad, registros de mantenimiento y actualizaciones de activos del mundo real.También permiten que una parte autorizada o un administrador comprometido sustituya imágenes, descripciones, características o enlaces externos.Un estándar de metadatos debería definir la autoridad, el proceso, los eventos y el historial de actualización, así como las condiciones para bloquear cambios futuros.Las aplicaciones no deberían describir como permanentes los metadatos mutables.

Metadatos congelados

Los metadatos congelados son aquellos que antes podían editarse, pero que se han colocado en un estado en el que ya no se esperan ni se permiten más cambios.El proceso de congelación debería estar impuesto por el código del contrato u otro control que pueda verificarse de forma independiente.Una declaración en un sitio web que afirme que los metadatos están congelados es menos sólida que una restricción técnica que elimine la autoridad para actualizarlos.Los usuarios deberían comprobar si las actualizaciones de proxy, las decisiones de gobernanza o las claves de administrador pueden restablecer los permisos de cambio.

Versionado de metadatos

El versionado de metadatos registra cómo cambia con el tiempo un documento o esquema de metadatos.Un identificador de versión ayuda a las aplicaciones a determinar qué reglas deben aplicar.Una versión semántica puede utilizar números principales, secundarios y de parche para distinguir cambios incompatibles de ampliaciones y correcciones compatibles.Las versiones históricas pueden facilitar auditorías, disputas, migraciones y la visualización precisa de estados anteriores de los tokens.Una URI mutable que sobrescribe el documento anterior sin conservar un historial dificulta reconstruir qué recibieron originalmente los usuarios.

Estándares de metadatos cross-chain

Las aplicaciones cross-chain necesitan identificadores que distingan activos con nombres y direcciones similares en distintas blockchains.Un símbolo de ticker no basta, porque activos no relacionados pueden compartir el mismo símbolo.

El estándar de identificadores de activos CAIP-19 define un formato independiente de la cadena para identificar tipos de activos e instancias individuales.

Un identificador completo puede combinar un espacio de nombres de blockchain, una referencia de blockchain, un espacio de nombres de activos, una referencia de contrato o activo y un ID de token opcional.Los identificadores cross-chain reducen la ambigüedad cuando las carteras, los sistemas de pago, los bridges y las herramientas de cartera intercambian metadatos de activos.No demuestran que un token puenteado esté totalmente respaldado por el activo original.

Metadatos de activos wrapped y puenteados

Un token wrapped o puenteado representa un activo mediante otra blockchain o sistema técnico.Sus metadatos deberían identificar la blockchain actual, el contrato del token, el activo representado, el emisor o mecanismo del bridge y las condiciones de canje pertinentes.Copiar el nombre y el logotipo del activo original sin diferenciar la representación wrapped puede inducir a error a los usuarios.Las aplicaciones no deberían suponer que unos símbolos idénticos indican los mismos derechos de canje o el mismo nivel de seguridad.Los metadatos deberían aclarar si el activo es nativo, wrapped, puenteado, sintético o está representado de otra manera.

Metadatos de identificadores descentralizados

Los identificadores descentralizados pueden vincular entidades relacionadas con blockchain a métodos de verificación e información de servicios.Los documentos DID pueden contener controladores, métodos de verificación criptográfica, relaciones de autenticación y puntos de acceso a servicios.

El W3C publicó DID Core versión 1.1 como Candidate Recommendation Snapshot el 5 de marzo de 2026.

Como la versión 1.1 sigue en la vía de recomendación, quienes la implementen deberían distinguirla de la recomendación definitiva DID Core 1.0.Los metadatos DID pueden servir para emisores de tokens, organizaciones, credenciales, carteras y agentes automatizados.Un DID demuestra el control según su método, pero no demuestra automáticamente que todas las afirmaciones de su controlador sean correctas.

Metadatos de credenciales verificables

Las credenciales verificables utilizan metadatos estructurados para expresar afirmaciones que un emisor realiza sobre un titular.

El modelo de datos de credenciales verificables 2.0 del W3C se convirtió en recomendación del W3C el 15 de mayo de 2025.

El modelo define información sobre emisores, titulares de credenciales, tipos, periodos de validez, estado de las credenciales, esquemas de datos y mecanismos de protección.Las aplicaciones cripto pueden utilizar credenciales verificables para identidad, membresías, cumplimiento normativo, educación, cualificaciones profesionales y derechos de acceso tokenizados.Una prueba de credencial válida demuestra que los datos protegidos no se han alterado según el método criptográfico aplicable.El verificador debe decidir por separado si el emisor es fiable y si la credencial es adecuada para el propósito previsto.

Metadatos de activos del mundo real tokenizados

Los metadatos de un activo del mundo real tokenizado pueden describir propiedades, valores, materias primas, facturas, afirmaciones medioambientales, membresías o derechos legales.Es posible que el contrato del token no contenga por sí solo todos los documentos necesarios para entender la titularidad o el canje.Los metadatos pueden identificar acuerdos legales, emisores, custodios, fechas de valoración, jurisdicciones, identificadores de activos, auditorías, restricciones e información sobre el estado.Un enlace a metadatos no convierte automáticamente en vinculante un documento legal externo.Los usuarios deben determinar si el token les otorga un derecho exigible frente a la entidad o el activo correspondiente.La información personal y comercial sensible no debería guardarse permanentemente en una blockchain pública.

Localización de metadatos

La localización permite que los nombres, las descripciones y otros metadatos legibles aparezcan en varios idiomas.Un estándar debería identificar el idioma asociado a cada valor de texto.Las aplicaciones deberían definir qué idioma alternativo se utilizará cuando el solicitado no esté disponible.Las traducciones deben conservar la información relevante sobre riesgos, aspectos legales y canje, en vez de simplificar únicamente el contenido promocional.La codificación de caracteres debe ser coherente para evitar que los nombres se corrompan entre sistemas.

Accesibilidad de los metadatos

Los metadatos accesibles ayudan a los usuarios que utilizan lectores de pantalla, alternativas textuales, navegación con teclado u otras tecnologías de asistencia.Las imágenes deberían incluir descripciones de texto significativas cuando la aplicación o el esquema lo permitan.La información esencial no debería aparecer únicamente dentro de una imagen o animación.El color, el movimiento y el sonido no deberían ser los únicos medios para comunicar un estado importante del token.La accesibilidad mejora la usabilidad y permite que un público más amplio entienda los metadatos.

Tipos de archivos multimedia en los metadatos cripto

Un tipo de archivo multimedia describe el formato de un archivo enlazado, como JSON, PNG, SVG, MP4 u otro tipo registrado.Las aplicaciones pueden utilizar esta información para decidir cómo procesar un recurso.La extensión del archivo por sí sola no es fiable, ya que un servidor puede devolver contenido inesperado con un nombre de archivo conocido.Las aplicaciones deberían inspeccionar el tipo de respuesta, validar la estructura del archivo y aplicar reglas de representación seguras.Los formatos activos, como HTML y SVG, requieren controles más estrictos que las imágenes estáticas habituales, porque pueden contener scripts, referencias externas o funciones interactivas.

Caché de metadatos

Las carteras, los indexadores y las aplicaciones suelen almacenar metadatos en caché para mejorar el rendimiento y reducir solicitudes de red repetidas.La caché puede hacer que nombres, imágenes y atributos obsoletos sigan apareciendo después de una actualización autorizada.Los eventos de actualización, las políticas de caducidad, los identificadores de versión y las herramientas de actualización manual pueden reducir los problemas de datos desactualizados.Una copia en caché no debería tratarse como el estado actual y autorizado sin comprobar su origen y fecha.Los metadatos direccionados por contenido pueden almacenarse en caché de forma segura en cuanto a su integridad, porque el identificador cambia cuando cambia el contenido.

Indexación de metadatos

Un indexador de metadatos recopila referencias de blockchain, recupera documentos, valida campos y prepara datos para facilitar su búsqueda y visualización.El indexador puede normalizar distintos estándares en un único formato interno.La normalización puede mejorar la usabilidad, pero también eliminar campos no compatibles u ocultar diferencias entre los esquemas originales.Los indexadores deberían conservar la fuente original, la hora de recuperación, el identificador de blockchain, la dirección del contrato y el ID del token.Una aplicación para usuarios debería distinguir entre metadatos obtenidos directamente de un contrato e información añadida por una base de datos externa.

Validación de metadatos

La validación de metadatos comprueba si los datos cumplen la sintaxis, el esquema, los identificadores, los tipos de campo y las reglas de seguridad exigidos.La validación de sintaxis confirma que un documento es JSON válido o tiene otro formato esperado correctamente formado.La validación del esquema comprueba los campos, valores y estructuras obligatorios.La validación de URI comprueba si las referencias a recursos utilizan esquemas permitidos y formatos válidos.La validación de integridad compara hashes o identificadores de contenido.La validación semántica comprueba si la información tiene sentido en el contexto de la blockchain y el activo correspondientes.Ninguna capa de validación por sí sola puede demostrar todas las afirmaciones incluidas en los metadatos.

Riesgos de seguridad de los metadatos cripto

Enlaces maliciosos

Un documento de metadatos puede dirigir a los usuarios a un sitio de phishing mediante una URL externa.

Archivos multimedia maliciosos

Un campo de imagen o animación puede hacer referencia a contenido activo diseñado para aprovecharse de programas de visualización poco seguros o rastrear a los usuarios.

Archivos demasiado grandes

Un atacante puede proporcionar archivos de metadatos o multimedia enormes para consumir memoria, ancho de banda, almacenamiento o capacidad de procesamiento.

Referencias recursivas

Los metadatos pueden enlazar a recursos adicionales que se referencian entre sí repetidamente y generan solicitudes excesivas.

Suplantación Unicode

Los nombres y símbolos de los tokens pueden utilizar caracteres Unicode visualmente similares para imitar un activo fiable.

Sustitución de metadatos

Un administrador o un servidor comprometido puede sustituir metadatos mutables después de que los usuarios adquieran un token.

Manipulación de esquemas

Un esquema remoto o un contexto JSON-LD puede cambiar y alterar la forma en que se interpreta un documento.

Seguimiento de la privacidad

Una URL multimedia única puede revelar cuándo una cartera o un usuario concreto consulta los metadatos de un token.

Afirmaciones falsas

Los metadatos pueden hacer afirmaciones falsas sobre titularidad, rareza, autenticidad, derechos legales, reservas o aprobación del creador.

Metadatos y phishing en carteras

Una cartera puede detectar un token desconocido cuyos metadatos muestran un mensaje que promete una recompensa o advierte de un problema con la cuenta.Los metadatos pueden dirigir al usuario a un sitio web malicioso.Recibir un token no demuestra que su nombre, imagen, sitio web o emisor sean fiables.Los usuarios deberían verificar por separado la blockchain, la dirección del contrato, la fuente oficial y la acción que se les pide realizar con la cartera.Ningún documento de metadatos necesita la clave privada ni la frase de recuperación de un usuario.

Riesgos para la privacidad de los metadatos

Los metadatos públicos pueden exponer nombres personales, ubicaciones, credenciales, membresías, información sanitaria o relaciones financieras.Los datos almacenados directamente en una blockchain pública pueden ser difíciles o imposibles de eliminar.Cifrar los metadatos sensibles puede reducir su visibilidad pública, pero plantea problemas de gestión de claves y confidencialidad a largo plazo.Un hash público también puede revelar información si es fácil adivinar los posibles valores subyacentes.Los proyectos deberían limitar los datos personales y almacenar únicamente lo necesario para la función prevista del activo cripto.

Cómo diseñar un estándar de metadatos cripto

Definir el caso de uso

El diseñador debería identificar el activo, la identidad, la credencial o la aplicación que describirán los metadatos.

Definir identificadores únicos

Los identificadores deberían distinguir la blockchain, el contrato, el tipo de activo y el token individual sin depender de nombres o símbolos.

Elegir un formato de datos

El formato debería ser ampliamente compatible, determinista cuando sea necesario y adecuado al tamaño de datos previsto.

Definir los campos obligatorios

Solo deberían ser obligatorios los campos necesarios para una interoperabilidad fiable.

Definir los tipos de datos

Todos los campos deberían tener un tipo, un rango permitido, una codificación y una política de errores claros.

Definir el comportamiento de las URI

El estándar debería especificar los esquemas URI compatibles, las reglas para las referencias relativas, las condiciones de recuperación y las restricciones de seguridad.

Definir la mutabilidad

El estándar debería explicar quién puede actualizar los metadatos y si es posible desactivar las actualizaciones posteriormente.

Definir la protección de integridad

Los documentos externos importantes deberían utilizar hashes, identificadores de contenido, firmas u otro método de integridad verificable.

Definir el versionado

Las aplicaciones necesitan una forma fiable de identificar las versiones incompatibles de los esquemas y las futuras extensiones.

Definir qué ocurre si se produce un error

El estándar debería explicar cómo gestiona el software los metadatos ausentes, mal formados, no disponibles, demasiado grandes o no compatibles.

Documentar los aspectos de seguridad

La especificación debería abordar las entradas maliciosas, las referencias remotas, la privacidad, los controles de acceso, la autoridad para actualizar y los riesgos de denegación de servicio.

Buenas prácticas de metadatos para proyectos cripto

Utiliza la blockchain y la dirección del contrato como identidad principal del activo, no el símbolo de ticker.Sigue un estándar definitivo cuando ya cubra el caso de uso requerido.Identifica claramente las extensiones de metadatos preliminares o experimentales.Utiliza nombres de campo y tipos de datos estables en toda la colección de tokens.Valida todos los documentos de metadatos antes de publicarlos.Utiliza direccionamiento por contenido o hashes criptográficos para los recursos que deban permanecer sin cambios.Publica quién puede actualizar los metadatos y las reglas de congelación antes de que los usuarios adquieran el token.Emite eventos de actualización estandarizados cuando sea posible.Conserva las versiones históricas de los metadatos para auditorías y disputas.Evita almacenar de forma permanente datos personales o confidenciales en una blockchain pública.Limita el contenido multimedia activo y depura el contenido externo antes de mostrarlo.Proporciona descripciones de texto significativas e información sobre el idioma.Mantén almacenamiento redundante para los archivos off-chain esenciales.No afirmes que algo es inmutable si alguna referencia importante sigue pudiendo cambiar.

Cómo evaluar los metadatos de un token

Confirma la blockchain correcta y la dirección del contrato del token.Determina qué estándares de token y metadatos afirma implementar el contrato.Cuando sea técnicamente viable, lee la URI directamente del contrato.Comprueba si los metadatos se almacenan on-chain, mediante HTTPS, mediante IPFS o mediante otro sistema.Verifica los identificadores de contenido o hashes cuando estén disponibles.Revisa quién puede cambiar el contrato, la URI, los metadatos, el esquema o la referencia de almacenamiento.Comprueba si se emiten eventos de actualización de metadatos.Inspecciona con precaución los archivos multimedia y las URL externas enlazados.Compara las afirmaciones legales y sobre el respaldo de activos con documentación independiente.No confíes en un logotipo, un nombre o un símbolo de ticker como prueba de autenticidad.

Errores habituales sobre los estándares de metadatos

Un error habitual es tratar un JSON válido como prueba de que los metadatos cumplen un estándar de token.Otro error es utilizar el símbolo del token como identificador de activo único a escala mundial.Algunos proyectos almacenan metadatos en un servidor convencional y, aun así, anuncian que el activo es totalmente inmutable.Otros incluyen un CID de IPFS en un documento, pero permiten que el contrato sustituya la URI de ese documento.Un documento de metadatos puede utilizar nombres y valores de atributos incoherentes dentro de una misma colección.Algunas aplicaciones muestran archivos multimedia activos sin depurarlos ni limitar su contenido.Los desarrolladores pueden suponer que todas las carteras admiten campos de metadatos personalizados.Otro error es no emitir un evento de actualización después de cambiar metadatos mutables.Algunos proyectos utilizan una propuesta preliminar sin revelar que sus campos y comportamiento aún pueden cambiar.Almacenar permanentemente información personal sensible on-chain puede generar graves problemas de privacidad y cumplimiento normativo.

Preguntas frecuentes

¿Cuál es la definición más sencilla de los estándares de metadatos?

Los estándares de metadatos son reglas compartidas para estructurar, almacenar, recuperar e interpretar información descriptiva sobre activos cripto y registros de blockchain.

¿Qué son los metadatos cripto?

Los metadatos cripto son información que describe un token, un NFT, una cuenta blockchain, una credencial, una transacción o un activo representado.

¿Por qué necesitan metadatos los activos cripto?

Los metadatos ayudan al software a mostrar nombres legibles, símbolos, imágenes, decimales, atributos, identidades y recursos externos.

¿Se almacenan los metadatos en la blockchain?

Pueden almacenarse on-chain, off-chain o mediante un diseño híbrido que combine referencias en la blockchain con archivos externos.

¿Qué son los metadatos on-chain?

Son datos descriptivos almacenados directamente en el estado de la blockchain, el almacenamiento de un contrato inteligente o los datos de una transacción.

¿Qué son los metadatos off-chain?

Son metadatos almacenados fuera de la blockchain, mientras esta registra una URI u otra referencia a ellos.

¿Son inseguros los metadatos off-chain?

Pueden utilizarse de forma segura, pero introducen riesgos de alojamiento, integridad, disponibilidad, dominio y actualización que deben gestionarse.

¿Qué define ERC-20 sobre los metadatos?

ERC-20 define funciones opcionales para el nombre, el símbolo y la precisión decimal de un token.

¿Son únicos los nombres y símbolos de los tokens?

No. Contratos no relacionados pueden utilizar el mismo nombre y símbolo de token.

¿Cómo debe identificarse un token fungible?

Debe identificarse mediante su blockchain y la dirección del contrato, no solo mediante su símbolo.

¿Qué son los metadatos ERC-721?

Los metadatos ERC-721 utilizan una URI específica del token para proporcionar información sobre un token no fungible individual.

¿Qué son los metadatos ERC-1155?

Los metadatos ERC-1155 utilizan una interfaz URI y un esquema JSON que pueden admitir muchos tipos de tokens en un mismo contrato.

¿Qué significa el marcador

{id}

de ERC-1155?

Las aplicaciones compatibles lo sustituyen por el ID del token, con el formato de un valor hexadecimal en minúsculas de 64 caracteres y sin el prefijo

.

¿Qué es ERC-4906?

ERC-4906 es una extensión definitiva que define eventos para avisar a las aplicaciones de las actualizaciones de metadatos ERC-721.

¿Qué es ERC-8048?

ERC-8048 es una propuesta preliminar presentada en 2025 para metadatos clave-valor almacenados directamente en registros multi-token y de NFT.

¿Es ERC-8048 un estándar definitivo?

No. Sigue siendo un borrador y puede cambiar antes de su aprobación definitiva.

¿Por qué se utiliza JSON para los metadatos cripto?

JSON es legible, ligero, ampliamente compatible y adecuado para intercambiar datos estructurados.

¿Un JSON válido implica que los metadatos del token sean válidos?

No. El documento también debe cumplir el esquema de metadatos pertinente y los requisitos de la aplicación.

¿Qué es JSON Schema?

JSON Schema define reglas de validación legibles por máquinas para documentos JSON.

¿Qué es JSON-LD?

JSON-LD añade significado de datos enlazados e identificadores definidos globalmente a las estructuras JSON.

¿Qué es una URI de metadatos?

Una URI de metadatos identifica el recurso que contiene o representa los metadatos de un token.

¿Qué es un CID de IPFS?

Un CID de IPFS es un identificador de contenido derivado, en parte, del hash criptográfico y la codificación del contenido.

¿Un CID de IPFS garantiza el almacenamiento permanente?

No. Verifica la identidad del contenido, pero no garantiza que un proveedor accesible siga almacenando los datos.

¿Qué son los metadatos direccionados por contenido?

Son metadatos identificados mediante información derivada de su contenido, en vez de únicamente por la ubicación del servidor.

¿Qué es la integridad de los metadatos?

Significa que los bytes recuperados coinciden con un hash, un identificador de contenido, una firma u otra referencia de integridad de confianza.

¿La coincidencia de un hash demuestra que los metadatos son verdaderos?

No. Demuestra que los bytes coinciden con el contenido esperado, pero no que las afirmaciones incluidas sean correctas.

¿Pueden cambiar los metadatos de un NFT?

Sí. Pueden cambiar si el contrato o el sistema de almacenamiento permiten actualizaciones autorizadas.

¿Qué son los metadatos congelados?

Son información puesta en un estado que restringe o desactiva técnicamente los cambios futuros.

¿Los metadatos on-chain siempre permanecen sin cambios?

No. Los contratos actualizables y el almacenamiento controlado por administradores pueden permitir que cambien.

¿Qué es el versionado de metadatos?

El versionado de metadatos identifica y conserva los cambios realizados en esquemas o documentos a lo largo del tiempo.

¿Qué es CAIP-19?

CAIP-19 es un estándar independiente de la cadena para identificar tipos de activos cripto e instancias individuales de activos.

¿Por qué son importantes los identificadores cross-chain?

Evitan confundir activos de distintas blockchains debido a nombres, símbolos o formatos de contrato similares.

¿Qué son los metadatos DID?

Describen identificadores descentralizados, controladores, métodos de verificación y puntos de acceso a servicios.

¿Qué son los metadatos de credenciales verificables?

Describen un emisor, un titular de credencial, afirmaciones, un periodo de validez, un estado, un esquema y un método de protección.

¿Pueden los metadatos contener malware?

Pueden hacer referencia a enlaces maliciosos, scripts, archivos multimedia activos, archivos demasiado grandes y otros contenidos peligrosos.

¿Recibir un NFT puede exponer una cartera a phishing?

Sí. Los metadatos de tokens no solicitados pueden mostrar enlaces maliciosos o mensajes de recompensas falsas para engañar al usuario.

¿Deberían pedir alguna vez los metadatos una frase de recuperación?

No. Ningún documento legítimo de metadatos, emisor de tokens o proceso de asistencia necesita la frase de recuperación de una cartera.

¿Pueden los metadatos revelar información personal?

Sí. Los metadatos públicos pueden revelar identidades, membresías, ubicaciones, credenciales o relaciones financieras.

¿Cómo se pueden validar los metadatos cripto?

Pueden comprobarse mediante validación de sintaxis y esquemas, reglas de URI, hashes criptográficos, firmas y revisión semántica.

¿Cuál es la principal limitación de los estándares de metadatos?

Un estándar puede hacer que los datos sean interoperables, pero no puede garantizar que el activo, el emisor o la afirmación descritos sean legítimos.

¿Qué deberían verificar los usuarios antes de confiar en los metadatos de un token?

Deberían verificar la blockchain, la dirección del contrato, el estándar de metadatos, el método de almacenamiento, la autoridad de actualización, la referencia de integridad y las afirmaciones externas.

Conclusión

Los estándares de metadatos definen cómo se estructura e intercambia la información descriptiva sobre activos cripto, NFT, identidades, credenciales y recursos de blockchain.Permiten que las carteras, los contratos inteligentes, los indexadores y las aplicaciones interpreten de forma coherente nombres, símbolos, decimales, imágenes, características, identificadores y recursos externos.Entre los principales sistemas de metadatos cripto se encuentran los campos de tokens fungibles, las URI de token ERC-721, los esquemas de metadatos ERC-1155, los eventos de actualización ERC-4906, JSON, JSON Schema, JSON-LD, los identificadores de contenido y los identificadores de activos independientes de la cadena.Los metadatos pueden almacenarse directamente on-chain, alojarse off-chain o protegerse mediante un modelo híbrido que utilice referencias de blockchain y comprobaciones criptográficas de integridad.El almacenamiento on-chain no garantiza la inmutabilidad, mientras que el direccionamiento por contenido no garantiza la disponibilidad permanente.Las aplicaciones deben validar los esquemas, depurar el contenido externo, comprobar quién puede actualizarlo, conservar el historial de versiones y evitar tratar nombres o símbolos como identidades únicas.Los usuarios deberían considerar los metadatos información descriptiva, no una prueba de que un token sea auténtico, valioso, esté respaldado o sea jurídicamente exigible.Los estándares de metadatos bien diseñados mejoran la interoperabilidad cripto solo cuando se combinan con almacenamiento seguro, afirmaciones precisas, gobernanza clara, protección de la privacidad y validación fiable.