Pular para o conteúdo
LabS Atlas
Digital Assets
Entrar

Transaction Consumer

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.

Transaction Consumer é o serviço que varre os blocos da blockchain periodicamente e grava as transações num banco de dados, tornando a consulta rápida sem tirar da cadeia o papel de fonte da verdade.

A blockchain é boa para registrar, mas ruim para consultar. Não existe uma consulta simples, no estilo de um SELECT, para listar todas as transações de uma carteira: seria preciso percorrer a cadeia bloco a bloco, do primeiro ao último. Numa rede em uso com cerca de 5,5 milhões de blocos, uma listagem feita assim levaria por volta de 3 horas, e cada nova consulta repetiria o custo. Com o espelho já montado, a mesma listagem sai do banco em questão de segundos. O custo passa a ser outro: um processo rodando o tempo todo para manter o espelho em dia.

O desenho nasceu de um job equivalente que já roda em produção na moeda Sol Digital e foi reproduzido, em Java com Quarkus, no learning prototype de pesquisas via WhatsApp. Ao contrário da API do mesmo sistema, que só acessa a blockchain quando é chamada, o consumer vai ativamente até ela.

O ciclo de varredura

A cada rodada o serviço executa os mesmos passos:

  1. Busca no banco o último bloco já salvo; se ainda não houver nenhum, começa do bloco zero.
  2. Busca na blockchain o bloco mais recente.
  3. Percorre o intervalo entre os dois, bloco a bloco, listando as transações de cada um e buscando o recibo (transaction receipt) de cada transação.
  4. Pula os blocos vazios, que não geram registro, e grava as transações dos demais.
  5. Registra no log a porcentagem de blocos já processados em relação ao total da cadeia.

Terminada a rodada, o serviço espera 10 segundos e recomeça, indefinidamente, até ser desligado. O agendamento fica com o Quartz, e a comunicação com a rede usa a biblioteca Web3j, com um único cliente configurado a partir do endereço RPC da blockchain informado por variável de ambiente. Guardar o último bloco lido é o que permite retomar a varredura depois de uma parada sem reprocessar a cadeia inteira.

O que fica gravado no banco

Para cada transação, o espelho guarda número e hash do bloco, horário de validação, hash da transação, endereços envolvidos, status (sucesso ou revertida, com o motivo da reversão quando a rede o informa), o endereço do contrato relacionado e o input bruto. Contratos ainda desconhecidos pelo banco também são registrados, já que cada deploy gera uma transação. Os endereços são normalizados em minúsculas, enquanto outras ferramentas podem exibir o mesmo endereço com letras maiúsculas; qualquer comparação precisa levar isso em conta.

Nessa primeira etapa o dado fica cru. Toda transação nasce com status de não migrada.

Do dado cru ao dado decodificado

A segunda etapa aplica a Decodificação de Transações. O serviço lista as transações bem-sucedidas ainda não migradas, lê os oito primeiros dígitos hexadecimais do input, o Method ID, e procura esse identificador numa tabela de métodos conhecidos. Uma estratégia escolhe a classe de decode correspondente, os dados extraídos vão para entidades relacionais (pesquisa, resposta) e o status muda para migrado.

Todo método precisa ser cadastrado

Uma assinatura sem cadastro, como a da própria transação de deploy do contrato, é marcada como não reconhecida. Cada novo método exige registrar o identificador no banco e escrever sua classe de decode.

O espelho também serve para ligar transações da cadeia às do produto, gerar relatórios e alimentar o Monitoramento de Redes Blockchain: um bloco que não chega no tempo esperado ou uma transação que falha podem virar gatilhos de alerta. O padrão se replica para qualquer outra blockchain ou contrato.