Skip to main content
Lerian SILOC es orientado a eventos en sus bordes. Cuando está habilitado, consume mensajes SFN compatibles de Nuclea y emite hechos de participante hacia la plataforma. No tiene consumidores de webhook orientados al cliente. Los sistemas dependientes se suscriben a los tópicos de streaming en lugar de recibir callbacks.

​
Qué consume

La ingestión SFN es optativa: SFN_INGEST_ENABLED tiene el valor predeterminado false, por lo que el consumidor se inicia solo cuando lo habilitas explícitamente. Cuando está habilitada, Lerian SILOC descifra y decodifica mensajes entrantes desde el envelope regulado y acepta PAG0102, LDL0021, LDL0020/LDL0020R2, LDL0006/LDL0006R2 y PAG0103. No enruta PAG0101.

​
Semántica de ingestión y entrega

  • La entrega y el despacho son al-menos-una-vez. Para un mensaje decodificado y compatible con un BCMSG.NUOp no vacío, la clave de deduplicación durable es (BCMSG.NUOp, CodMsg), no solo el id de un mensaje.
  • El servicio escribe el registro de mensaje procesado solo después de un despacho exitoso. No crea un registro de mensaje procesado para un mensaje no decodificado o no compatible. Una falla antes de escribir el registro puede causar otra entrega, por lo que este comportamiento no es una garantía incondicional de exactamente una vez de extremo a extremo.

​
Qué emite

  • Hechos de participante —siloc.participant.registered y siloc.participant.updated— publicados como CloudEvents en el backbone de streaming de la plataforma. Los sistemas dependientes siguen el directorio de participantes sin polling.

​
Sin punto de contacto con Midaz

Lerian SILOC no tiene integración directa con el ledger. No mantiene posición contable y no realiza aritmética monetaria. Enruta bytes y emite hechos. Este riel no registra dinero. La liquidación de la posición neta ocurre en SILOC y el STR. Cualquier asiento en el ledger vive con el servicio dueño del movimiento de dinero.

​
Límite de la ruta del dinero

El riel STR separado, Lerian SPB, ejecuta la pierna de depósito del STR —la liquidación monetaria en el BACEN. SILOC no. Lerian SILOC transporta los mensajes de SILOC y administra la conexión. Nunca mueve dinero.

​
Convenciones de API

  • La ruta base es /api/v1/siloc, y los errores siguen el formato problem-detail de RFC 9457.
  • La autenticación sigue el esquema estándar de token bearer de la plataforma.
  • El registro de participantes es idempotente mediante una clave de idempotencia, de modo que un registro reintentado no crea un duplicado.
  • Los certificados son referencias, no secretos. Un certificado registrado lleva un certificado público y una referencia de custodia externa. No almacena ni devuelve ninguna clave privada.