Skip to main content
O Lerian SILOC é orientado a eventos nas suas bordas. Quando habilitado, ele consome mensagens SFN compatíveis da Nuclea e emite fatos de participante para a plataforma. Ele não tem consumidores de webhook voltados ao cliente. Os sistemas dependentes se inscrevem nos tópicos de streaming em vez de receber callbacks.

​
O que consome

A ingestão SFN é opcional: SFN_INGEST_ENABLED tem o valor padrão false, portanto o consumidor só inicia quando você a habilita explicitamente. Quando habilitado, o Lerian SILOC descriptografa e decodifica mensagens recebidas a partir do envelope regulado e aplica uma política fechada de (CodProdt, CodMsg). Para OT e SLC, ele roteia PAG0102, LDL0021 e PAG0103; os frames de OT são adiados de forma durável e os de SLC seguem por relay para o Lerian SLC. PAG0101 adia o status do participante para ambos os produtos. LDL0020, LDL0006 e qualquer outro par falham fechados em uma exceção de operador.

​
Semântica de ingestão e entrega

  • O relay para SLC é pelo menos uma vez. Para um frame de funding SLC decodificado com sucesso com BCMSG.NUOp não vazio, a chave de deduplicação durável é BCMSG.NUOp, não apenas o id de uma mensagem.
  • O serviço grava esse registro de mensagem processada somente após um relay bem-sucedido. Ele não cria um registro de mensagem processada para uma mensagem não decodificada ou não compatível. Uma falha antes de o registro ser gravado pode resultar em outra entrega, portanto esse comportamento não é uma garantia incondicional de exatamente uma vez de ponta a ponta.

​
O que emite

  • Fatos de participante — siloc.participant.registered e siloc.participant.updated — publicados como CloudEvents no backbone de streaming da plataforma. Os sistemas dependentes acompanham o diretório de participantes sem polling.

​
Sem ponto de contato com o Midaz

O Lerian SILOC não tem integração direta com o ledger. Ele não mantém posição contábil e não realiza aritmética monetária. Ele roteia bytes e emite fatos. Este trilho não registra dinheiro. A liquidação da posição líquida acontece no SILOC e no STR. Qualquer lançamento no ledger vive com o serviço dono do movimento de dinheiro.

​
Limite do caminho do dinheiro

O trilho STR separado, Lerian SPB, executa a perna de depósito do STR — a liquidação monetária no BACEN. O SILOC não. O Lerian SILOC transporta as mensagens do SILOC e administra a conexão. Ele nunca move dinheiro.

​
Convenções de API

  • O caminho base é /api/v1/siloc, e os erros seguem o formato problem-detail da RFC 9457.
  • A autenticação segue o esquema padrão de token bearer da plataforma.
  • O registro de participantes é idempotente por meio de uma chave de idempotência, de modo que um registro repetido não cria um duplicado.
  • Os certificados são referências, não segredos. Um certificado registrado carrega um certificado público e uma referência de custódia externa. Ele não armazena nem retorna nenhuma chave privada.