Skip to main content
O Lerian SILOC é orientado a eventos nas suas bordas. Com uma conexão MQ do SILOC configurada, ele consome mensagens SFN suportadas da Nuclea e emite fatos de participante na plataforma. Ele não tem consumidores de webhook voltados ao cliente. Sistemas downstream se inscrevem nos tópicos de streaming em vez de receber callbacks.

​
O que ele consome

O processamento de SFN de entrada começa quando você configura o descritor completo de conexão MQ do SILOC. Se nenhum gatilho de conexão estiver presente, o serviço inicia sem conectividade real com o SILOC. Definir MQ_HOST, MQ_CHANNEL, MQ_QUEUE_MANAGER, MQ_SEND_QUEUE ou MQ_RECEIVE_QUEUE aciona a validação do descritor completo na inicialização. Fornecer apenas parte do descritor falha de forma fail-closed e impede que o serviço inicie. Com o descritor completo configurado, o Lerian SILOC descriptografa e decodifica as mensagens de entrada a partir do envelope regulatório e, em seguida, aplica uma política fechada de (CodProdt, CodMsg). Para OT e SLC, ele roteia PAG0102, LDL0021 e PAG0103. Frames OT ficam pendentes de forma durável, enquanto frames SLC são repassados para o Lerian SLC. PAG0101 mantém o status do participante pendente para qualquer um dos dois produtos. LDL0020, LDL0006 e todo outro par falham de forma fail-closed para uma exceção de operador.

​
Semântica de ingestão e entrega

  • O repasse do SLC é pelo menos uma vez. Para um frame de funding do SLC decodificado com sucesso e com um BCMSG.NUOp não vazio, a chave de deduplicação durável é BCMSG.NUOp, não apenas um ID de mensagem.
  • O serviço grava esse registro de mensagem processada apenas depois de um repasse bem-sucedido. Ele não cria registro de mensagem processada para uma mensagem não decodificada ou não suportada. Uma falha antes da gravação do registro pode resultar em outra entrega, então esse comportamento não é uma garantia incondicional de exatamente uma vez de ponta a ponta.

​
O que ele emite

  • Fatos de participante. O Lerian SILOC publica siloc.participant.registered e siloc.participant.updated como CloudEvents no backbone de streaming da plataforma. Sistemas downstream acompanham o diretório de participantes sem fazer polling.

​
Nenhum 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 nem realiza qualquer aritmética monetária. Ele roteia bytes e emite fatos. Este trilho não contabiliza dinheiro. A liquidação da posição líquida acontece no SILOC e no STR. Qualquer lançamento contábil fica a cargo do serviço dono da movimentação 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 faz isso. O Lerian SILOC transporta as mensagens do SILOC e administra a conexão. Ele nunca movimenta dinheiro.

​
Convenções de API

  • O path base é /api/v1/siloc, e os erros seguem o formato RFC 9457 de problem-detail.
  • A autenticação segue o esquema padrão de bearer-token da plataforma.
  • O registro de participante é idempotente por meio de uma chave de idempotência, então um registro repetido não cria uma duplicata.
  • 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.