Integração Assíncrona com Transação Pendente
Ir para notas que citam estaIntegração assíncrona com transação pendente é o modelo em que a aplicação registra a operação como pendente, responde na hora ao usuário e confirma depois, quando a transação entra em um bloco.
Ele nasce como resposta ao bloqueio de interface da Integração Síncrona com Blockchain: em vez de segurar a requisição pelos segundos que a rede leva para fechar bloco, a aplicação devolve a confirmação do pedido imediatamente e deixa a validação acontecer em segundo plano. A mudança é de arquitetura, não de interface — sem alterar telas nem fluxo visível, a responsividade percebida muda de patamar.
Como o identificador da transação sustenta o estado pendente
A API chama o método do contrato e recebe de volta o identificador único da transação, o hash que a rede gera para ela. Esse hash é gravado junto com a transação no banco de dados, com status pendente, e as demais entidades da operação são salvas em seguida. A aplicação não sabe ainda se a transação será validada; sabe apenas onde encontrá-la depois.
O fechamento do ciclo fica a cargo de um serviço separado, o Transaction Consumer, que observa os blocos gerados, localiza a transação pelo hash e atualiza seu status para validada ou não validada, junto com os dados mais recentes vindos da rede. O modelo, portanto, não é autossuficiente: sem esse serviço de espelhamento, a transação pendente nunca sai do limbo.
A janela em que o sistema não sabe o que mostrou
Durante os segundos entre o pedido e a validação, a interface já apresenta a operação como feita, enquanto o sistema ainda não tem como afirmar que ela será aceita.
Essa janela cria dois problemas concretos. O primeiro é de comunicação: se a transação for invalidada depois de já ter sido exibida como concluída, a aplicação precisa de um caminho para avisar o usuário de uma reversão que ele não esperava. O segundo é de estado: os dados passam a ser eventualmente consistentes, e qualquer leitura feita dentro da janela pode mostrar um saldo ou um histórico que ainda não corresponde à cadeia.
Quando a rede cai no meio do caminho
Se a blockchain ficar indisponível — durante uma atualização ou uma queda dos nós, por exemplo — a transação pode permanecer gravada como pendente no banco sem nunca ter existido de fato na rede. O registro local fica órfão: não há hash a monitorar, não há bloco a esperar, e nenhuma parte do fluxo percebe sozinha que a operação se perdeu. É essa classe de falha que motiva a evolução para Integração Assíncrona com Mensageria, em que a solicitação fica retida em uma fila até que a rede volte, em vez de virar um registro pendente sem correspondência.
No Sol Digital, esse modelo substituiu o síncrono depois do lançamento do MVP e é o que sustenta a impressão de rapidez nas transferências entre usuários.