> ## 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.

# Integração com o Lerian SILOC

> O que o Lerian SILOC consome e emite, o relay do domínio de cartões para o Lerian SLC, os fatos de participante no backbone de streaming, a ausência de um ponto de contato com o ledger Midaz e o limite do caminho do dinheiro.

O Lerian SILOC é orientado a eventos nas suas bordas: ele consome mensagens de liquidação da Nuclea e emite frames do domínio de cartões e 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

***

O Lerian SILOC consome **mensagens de liquidação recebidas do SILOC** vindas da Nuclea sobre o gateway de mensageria regulado. Cada mensagem é descriptografada e decodificada a partir do envelope regulado, e então classificada pelo seu código de mensagem antes de qualquer sistema a jusante vê-la.

## O que emite

***

* **Frames de liquidação do domínio de cartões**, retransmitidos de forma literal para o **Lerian SLC**, o serviço de liquidação de cartões. O relay repassa o envelope decodificado byte a byte e é deduplicado pelo NUOp, de modo que o Lerian SLC recebe cada frame exatamente uma vez.
* **Fatos de participante** — `participant-registered` e `participant-updated` — publicados como CloudEvents no backbone de streaming da plataforma, de modo que 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. Registrar o dinheiro não é tarefa deste trilho — a liquidação da posição líquida acontece no SILOC e no STR, e qualquer lançamento no ledger vive com o serviço dono do movimento de dinheiro.

## Limite do caminho do dinheiro

***

A **perna de depósito do STR** — a liquidação monetária no BACEN — é executada pelo trilho STR separado, [Lerian SPB](/pt/rails/native/spb/what-is-lerian-spb), não pelo SILOC. 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; nenhuma chave privada é armazenada ou retornada.