> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Cómo funciona Lerian SILOC

> El ciclo de vida de la conexión del gateway, el demux de mensajes entrantes, el relay literal del dominio de tarjetas a Lerian SLC, la entrega exactamente-una-vez, el replay del relay, el directorio de participantes, los certificados regulados y la cobertura de capacidades.

Lerian SILOC expone su trabajo como un conjunto reducido de operaciones tipadas sobre la superficie `/api/v1/siloc`. La superficie viva es conectividad y administración: una conexión de gateway a Nuclea, un relay literal de la familia de liquidación del dominio de tarjetas a Lerian SLC, y los registros de participantes, certificados y cobertura que los sostienen.

## Ciclo de vida de la conexión del gateway

***

El servicio abre y mantiene **una** conexión de gateway de mensajería a SILOC de Nuclea sobre la red nacional del sistema financiero. La conexión está protegida por:

* un **circuit breaker** que se dispara ante fallas repetidas,
* **reconexión automática** con un backoff acotado,
* una **parada por credencial deshabilitada** que detiene el gateway cuando su certificado está deshabilitado, y
* una **sonda de readiness** que reporta si el gateway está conectado y saludable.

Cada mensaje entrante se descifra y se decodifica desde el envelope regulado antes de que comience cualquier procesamiento.

## Demux entrante y relay literal de tarjetas

***

Cada mensaje entrante decodificado se clasifica por su código de mensaje. La **familia de fondeo y clearing de tarjetas** se retransmite **byte a byte** a Lerian SLC, el servicio de liquidación de tarjetas. El relay es solo de entrada y reenvía el envelope decodificado de forma literal —el servicio no actúa sobre ninguno de los contenidos del mensaje.

| Código      | Mensaje                      |
| ----------- | ---------------------------- |
| **LDL0021** | Instrucción de depósito      |
| **LDL0020** | Crédito liquidado            |
| **LDL0006** | Crédito devuelto             |
| **PAG0102** | Apertura de período de ciclo |
| **PAG0103** | Cierre de período de ciclo   |

Cualquier otro mensaje —boleto, estado de participante, otras familias diferidas y códigos desconocidos— se registra como una **excepción de operador fail-closed**. Ese mensaje nunca se descarta ni se enruta mal; se retiene para que un operador lo revise.

## Relay exactamente-una-vez

***

El gateway puede reentregar un mensaje al menos una vez. Lerian SILOC deduplica por el **NUOp**, el identificador único por operación del BACEN: el NUOp se consulta antes de un relay y se registra solo tras un relay durable. El servicio de liquidación de tarjetas recibe así cada frame exactamente una vez.

## Resiliencia y replay del relay

***

* Un error de relay **transitorio** devuelve el frame para que el gateway lo reentregue.
* Una interrupción de relay **sostenida** estaciona el frame de forma durable como una **falla de relay** y levanta una alerta operativa de relay caído.
* Un operador **lista** las fallas de relay estacionadas y las **reprocesa** una vez que el servicio de liquidación de tarjetas se recupera.

Ningún frame se pierde y ninguno se duplica: la reentrega al-menos-una-vez combinada con la deduplicación por NUOp garantiza ambas cosas.

## Observabilidad del relay

***

* **Listar mensajes retransmitidos** — el feed de auditoría de los mensajes del dominio de tarjetas que se han retransmitido a Lerian SLC.
* **Leer el estado del relay** — el estado de salud actual del relay, más la marca de tiempo del último relay.

## Directorio de participantes

***

Lerian SILOC mantiene un directorio de los participantes de SILOC por los que liquida. **Registras**, **listas**, **obtienes** y **actualizas** un participante, y lees el **estado** de un participante. Cada participante lleva su ISPB, su rol y su estado operativo.

Cada registro siembra una entrada de historial de estado y emite un hecho de participante. Las escrituras de registro son idempotentes mediante una clave de idempotencia, de modo que un registro reintentado no crea un duplicado.

| Rol                        | Significado                                                           |
| -------------------------- | --------------------------------------------------------------------- |
| **Directo**                | Un participante directo de SILOC.                                     |
| **Indirecto**              | Un participante que liquida a través de otra institución.             |
| **Institución liquidante** | La institución que liquida en nombre de los participantes indirectos. |

El estado operativo usa el dominio de estados de siete valores de SILOC:

| Valor | Estado                         |
| ----- | ------------------------------ |
| 1     | Participando                   |
| 2     | Excluido del ciclo             |
| 3     | Excluido de SILOC              |
| 6     | En ciclo, excluido de SILOC    |
| 7     | Suspendido                     |
| 8     | Suspendido, excluido del ciclo |
| 9     | Inoperante (régimen especial)  |

## Certificados regulados

***

Los certificados regulados de la conexión se conservan como referencias, no como secretos. **Registras** un certificado público —analizado por su sujeto, serie y ventana de validez— junto con una **referencia de custodia externa**; el servicio no almacena **ninguna** clave privada. Luego **listas**, **obtienes** y **revocas** certificados sobre la misma superficie.

## Cobertura de capacidades

***

Un **listado de capacidades** de solo lectura describe las capacidades de cobertura de liquidación como una superficie de transparencia: para cada tipo de mensaje, su dirección, si está implementado y su disposición.