Pular para o conteúdo
LabS Atlas
Digital Assets
Entrar

Integração Assíncrona com Mensageria

Ir para notas que citam esta
atualizado há 25 diasEntre para perguntar ao Labinho sobre esta notaO Labinho é o assistente que responde com as notas e as sessões do LabS e mostra de onde tirou cada resposta.

Integração assíncrona com mensageria é o modelo em que a aplicação publica a intenção de transação em uma fila e um consumidor cuida de enviá-la à blockchain, desacoplando a aplicação da disponibilidade da rede.

A diferença em relação à Integração Assíncrona com Transação Pendente está em quem fala com a cadeia. Ali, a própria API chama o contrato e depende de a rede estar no ar naquele instante. Aqui, a API não toca a blockchain: ela grava a transação com um identificador interno próprio e publica na fila uma solicitação com os dados da operação e esse identificador. Um serviço consumidor lê a solicitação, chama o método do contrato, recebe o hash e atualiza a transação no banco localizando-a pelo identificador interno. Só então o serviço de espelhamento, o Transaction Consumer, usa o hash para escrever o status final e os dados vindos da rede.

O desacoplamento como seguro contra indisponibilidade

O ganho principal é resiliência. Se a rede estiver fora do ar, a solicitação permanece na fila e é reprocessada quando ela voltar, em vez de falhar na hora ou virar um registro pendente sem correspondência na cadeia. Em ambiente de desenvolvimento, onde a rede sobe e desce com frequência, essa diferença é a que separa um reprocessamento silencioso de uma inconsistência que alguém precisa corrigir à mão.

A fila também abre caminho para publicação e consumo de eventos em tempo real e para tratamentos que o modelo anterior não comporta, como uma fila de reprocessamento para as transações que continuam falhando depois de várias tentativas. E a resposta ao usuário deixa de depender tanto do serviço de espelhamento quanto da cadeia, o que dá folga para escalar as partes de forma independente.

O preço em rastreamento e em consistência

Uma única transação passa a atravessar API, fila, consumidor, blockchain, serviço de espelhamento e banco de dados, com três gravações distintas no banco: o registro inicial como pendente, a inclusão do hash pelo consumidor e a atualização final de status. Rastrear onde uma operação parou exige percorrer essa cadeia inteira.

A consistência eventual se alarga

Com mais uma camada no caminho, cresce o intervalo entre a confirmação exibida e o estado real. O caso típico é o usuário ver que a transferência foi feita e, ao mesmo tempo, ver o saldo ainda intacto na carteira.

Some-se o risco de atraso e congestionamento quando o volume de solicitações ultrapassa a capacidade da fila ou do consumidor. E a previsibilidade se perde: a Integração Síncrona com Blockchain permite estimar a conclusão em poucos segundos, enquanto aqui o tempo depende de quando cada etapa intermediária for processada.

A falha que o desacoplamento introduz

Escrever no banco e publicar na fila são duas operações sem transação comum, e o modelo herda com isso o Problema das Duas Escritas. É o custo estrutural de trocar uma chamada direta por uma fila: o que se ganha em tolerância à queda da rede reaparece como risco de divergência entre o banco e o broker.