/api/v1/siloc. A superfície viva cobre conectividade e administração. A ingestão SFN é opcional; quando habilitada, o serviço despacha os seus códigos de mensagem compatíveis. Ele também mantém os registros de participantes, certificados e cobertura que sustentam este trabalho.
Ciclo de vida da conexão do gateway
O serviço abre e mantém uma conexão de gateway de mensageria ao SILOC da Nuclea sobre a rede nacional do sistema financeiro. Quatro guardas protegem a conexão:
- um circuit breaker que dispara diante de falhas repetidas,
- reconexão automática com um backoff limitado,
- uma parada por credencial desabilitada que interrompe o gateway após a revogação de um certificado, e
- uma sonda de readiness que reporta a conexão e a saúde do gateway.
SFN_INGEST_ENABLED tem o valor padrão false. Defina-o como true para habilitar o consumidor; quando habilitada, o serviço descriptografa e decodifica mensagens recebidas a partir do envelope regulado antes de despachar uma mensagem compatível.
Despacho SFN de entrada
Depois de decodificá-la, a entrada seleciona uma rota a partir de uma política fechada de (
CodProdt, CodMsg). Os mesmos três códigos de funding têm destinos diferentes conforme o produto:
| Código | OT | SLC |
| --- | --- |
| PAG0102 | Adiamento durável da abertura de período | Relay para o Lerian SLC |
| LDL0021 | Adiamento durável da instrução de depósito | Relay para o Lerian SLC |
| PAG0103 | Adiamento durável do fechamento de período | Relay para o Lerian SLC |
| PAG0101 | Adiamento durável do status do participante | Adiamento durável do status do participante |
LDL0020, LDL0006 e qualquer outro par de produto/código não são compatíveis. Eles falham fechados em uma exceção de operador; nunca são enviados por relay como funding de liquidação. Um envelope que não pode ser decodificado ou uma mensagem com BCMSG.NUOp vazio segue o mesmo caminho fechado.
Despacho pelo menos uma vez com deduplicação durável
A fonte pode reentregar uma mensagem, portanto o relay para SLC é pelo menos uma vez. Para um frame de funding SLC decodificado com sucesso com
BCMSG.NUOp não vazio, o serviço consulta a deduplicação durável por BCMSG.NUOp antes do relay. A política trata esse número de operação como globalmente único; o serviço não usa uma chave baseada apenas no id da mensagem.
O serviço grava o registro de mensagem processada somente após um relay bem-sucedido e antes de confirmar a fonte. Ele não cria esse registro para uma mensagem não decodificada ou não compatível. Uma falha antes de o registro ser gravado pode deixar a mensagem elegível para outra entrega. Não trate esse comportamento como uma garantia incondicional de exatamente uma vez de ponta a ponta.
Resultados de falha
- Uma falha de despacho reexecutável permanece sem confirmação. Com commits de fonte seguros por offset, a mensagem é lida novamente após uma reinicialização a partir do último offset confirmado; uma falha transitória persistente pode bloquear a sua partição até a reinicialização.
- Uma falha não reexecutável, como um envelope malformado ou um par (
CodProdt,CodMsg) não compatível, falha fechada em uma exceção de operador durável. O serviço confirma a mensagem somente depois que esse registro de exceção é persistido, para que a partição possa avançar. - O registro de mensagens processadas protege apenas as mensagens decodificadas e compatíveis descritas acima. Ele não promete a retenção de cada frame nem efeitos exatamente uma vez em todos os sistemas a jusante.
Observabilidade da ingestão
- Listar mensagens processadas — o feed de auditoria das mensagens SFN compatíveis que o serviço despachou.
- Ler o status da ingestão — o estado de saúde atual do caminho de ingestão habilitado, mais a marca de tempo do último despacho.
Diretório de participantes
O Lerian SILOC mantém um diretório dos participantes do SILOC pelos quais liquida. Você registra, lista, obtém e atualiza um participante, e lê o status de um participante. Cada participante carrega o seu ISPB, o seu papel e o seu status operacional. Cada registro semeia uma entrada de histórico de status e emite um fato de participante. As escritas de registro são idempotentes por meio de uma chave de idempotência, de modo que um registro repetido não cria um duplicado.
O status operacional usa o domínio de status de sete valores do SILOC:
Certificados regulados
O serviço mantém os certificados regulados da conexão como referências, não como segredos. Você registra um certificado público junto com uma referência de custódia externa. O serviço analisa o certificado pelo seu titular, número de série e janela de validade, e não armazena nenhuma chave privada. Você então lista, obtém e revoga certificados sobre a mesma superfície.
Cobertura de capacidades
Uma listagem de capacidades somente leitura descreve as capacidades de cobertura de liquidação como uma superfície de transparência. Para cada tipo de mensagem, ele reporta a direção, o estado de implementação e a disposição.