Traducción al español del siguiente documento: CIP-10 | Transaction Metadata Label Registry
#10
Registro de Etiquetas de Metadatos de Transacción
Creado el 31 de octubre de 2020 por Sebastien Guillemot
Resumen
Los metadatos de transacción de Cardano obligan a que las entradas de metadatos delimiten su contenido utilizando una clave de entero sin signo. Esta especificación es un registro de qué casos de uso han asignado qué número para evitar colisiones.
Motivación: ¿por qué es necesario este CIP?
El nivel superior del objeto CBOR de metadatos de transacción es un mapeo de “transaction_metadatum_label” al metadato real, donde “transaction_metadatum_label” representa una clave (idealmente única) para un caso de uso de metadatos. Esto permite lo siguiente:
- Búsqueda rápida para que los nodos consulten todas las transacciones que contienen metadatos que utilizan una clave específica.
- Permite que una sola transacción incluya múltiples entradas de metadatos para diferentes estándares.
Especificación
Terminología
Los metadatos de transacción se refieren a un objeto CBOR opcional en cada transacción desde el inicio de la era Shelley. Se define como la siguiente estructura de datos CDDL:
transaction_metadatum =
{ * transaction_metadatum => transaction_metadatum }
/ [ * transaction_metadatum ]
/ int
/ bytes .size (0…64)
/ text .size (0…64)
transaction_metadatum_label = uint
transaction_metadata =
{ * transaction_metadatum_label => transaction_metadatum }
Estructura
Estos son los valores reservados de “transaction_metadatum_label:”
“transaction_metadatum_label” / descripción
0 - 15 / *reservado
65536 - 131071 / reservado - uso privado
Para el registro en sí, consulte registry.json en formato legible por máquina. Por favor, abra su solicitud de extracción contra este archivo.
- Es mejor evitar el uso de 0 o cualquier número similar como 1 que otras personas probablemente usarán. En su lugar, prefiera generar un número aleatorio.
Razonamiento: ¿cómo logra este CIP sus objetivos?
Crear un registro para los valores de ¨transaction_metadatum_label" tiene el siguiente beneficio:
- Facilita a los desarrolladores saber qué “transaction_metadatum_label” usar para consultar su nodo si buscan transacciones que utilicen un estándar.
- Facilita evitar colisiones con otros estándares que utilizan metadatos de transacción.
Camino a Activar
Criterios de Aceptación
- Uso consistente y a largo plazo por parte de los implementadores de Cardano del registro de etiquetas de metadatos por todas las aplicaciones que requieren una etiqueta de metadatos universalmente reconocida.
- Uso consistente y a largo plazo en el proceso de edición del CIP: etiquetado, verificación y fusión de nuevos requisitos de etiqueta.
Plan de Implementación
- Interés confirmado y cooperación en este estándar de etiquetado de metadatos y su convención registry.json por parte de los implementadores de Cardano: incluidos los creadores de NFT, agregadores de datos y cadenas laterales.
Copyright
Este CIP está licenciado bajo CC-BY-4.0.