Marcas de tiempo

Objetivo Bre-B

Bre-B espera realizar un seguimiento preciso de los tiempos necesarios para resolver las claves y ejecutar las operaciones de transferencia.

El objetivo del banco central es eliminar la latencia de la red en los reportes de marcas de tiempo. La razón principal de este modelo es que la mayoría de los participantes utilizan un sistema basado en colas y comunicación síncrona.

Monitoreo Transfiya

La plataforma Transfiya es una plataforma nativa en la nube que registra automáticamente todas las interacciones durante las solicitudes y respuestas a las llamadas API.

El monitoreo de las marcas de tiempo se realiza automáticamente por la plataforma, siendo opcional para los participantes la adición de marcas de tiempo específicas.

Mayoria de marcas de tiempo son registradas automáticamente por la plataforma.

DICE requerimentos

Mapeo de marcas de tiempo

Las marcas de tiempo del DICE aplican únicamente a dos operaciones: el proceso de incorporación (onboarding) y la resolución de llaves.

Este mapeo se basa en el siguiente documento:

Código de mensajeNombre del mensajeDescripción del mensajePartes involucradas
admn.001.001.01Solicitud de gestión de redUtilizado para conectar/desconectar y verificar el estado de la conexión. Operaciones: SignOn, SignOff, EchoTestTransfiYa → DICE
admn.002.001.01Respuesta de gestión de redRespuesta a admn.001DICE → Transfiya
prxy.001.001.01Solicitud de registro de proxyUtilizado para gestionar llaves. Operaciones:
NEWR, AMND, DEAC, SUSP, SUSB, ACTV, ACTBTransfiya → DICE
prxy.002.001.01Respuesta de registro de proxyRespuesta a prxy.001DICE → Transfiya
admi.002.001.01Mensaje de rechazoParece ser un mensaje de error que puede devolverse como respuesta a otros mensajes. No hay flujos de ejemplo con este mensaje en la documentación.DICE → TransfiYa
prxy.003.001.01Solicitud de resolución de proxyUtilizado para resolver llaves desde el directorio de aliasTransfiya → DICE
prxy.004.001.01Respuesta de resolución de proxyRespuesta a prxy.003DICE → Transfiya

Registro de Llaves

El sistema transfiya ya permite consulta de llaves usando el protocolo de resolución de llaves y registro de marcas de tiempo.

Para cubrir el caso de incorporación (onboarding), TransfiYa añade nuevas etiquetas al payload del firmante. Estas etiquetas representan las marcas de tiempo que los participantes necesitan recopilar:

  • received → el momento en que un participante recibió una solicitud del usuario para incorporarse, cuando el usuario hace clic en la aplicación
  • dispatched → el momento en que un participante envió una solicitud de incorporación a Transfiya, cuando se llama a la API de creación de firmante

Resolución de Llaves

Este modelo es actualmente opcional y no se habilitará hasta que comencemos las pruebas de integración con MOL.

Las marcas de tiempo necesarias para la resolución de llaves siguen un patrón similar a las requeridas durante el proceso de incorporación.

Los requisitos relacionados con los participantes pueden satisfacerse mediante la incorporación de los mismos dos campos mencionados anteriormente. Dado que los participantes deben enviar estos campos y efectivamente almacenan información adicional en el sistema con esta solicitud, la petición de resolución se implementa como una solicitud POST en lugar de GET:

POST /v1/signer/lookup.dice

El cuerpo de esta solicitud contiene el valor del llave que se está resolviendo y las marcas de tiempo requeridas:

{
  "aliasValue": "@jorge22",
  "received": "2025-01-14T20:40:57.322-05:00",
  "dispatched": "2025-01-14T20:40:58.322-05:00"
}

Flujo de Resolución de Llaves:

Documento de referencia - Directorio Centralizado DICE Versión 2.2.1